zakariaf/flutter-skills

---

Each skill is a short, high-signal playbook that an agent loads only when your task matches it, then follows — the rules, the anti-patterns, and a definition of done. The rules are applied consistently across sessions, projects, and agents without bloating context.

Built on the Agent Skills open standard, so the same files work in Claude Code, Cursor, Codex, Copilot, Gemini CLI, Windsurf, Cline, OpenCode and 70+ more — not only Claude Code.

These skills were distilled from more than ten production Flutter apps’ private skill libraries (~120 skills), merged into one best-of-breed set, reconciled to a single canonical stack, and adversarially reviewed for API correctness — then extended with the shipping, monetization and determinism lessons from a multi-app studio that ships to the App Store. Design-token specifics (exact colours, radii, shadows, named design systems) and app-domain skills were intentionally left out — this is the general foundation, not any one app’s look or domain.

Quick start

# Any agent (installs into 70+ tools via the open skills CLI)
npx skills add zakariaf/Flutter-Skills            # all skills
npx skills add zakariaf/Flutter-Skills --list     # browse first
npx skills add zakariaf/Flutter-Skills --skill flutter-architecture

Prefer a native integration? See How to use these skills below.

Design principles

• Riverpod 3.x first, but not Riverpod-only. State/DI skills lead with a state-management-agnostic core, give the Riverpod 3.x “how”, and close with a Provider / ChangeNotifier appendix so they still serve an app on Flutter’s official-guide stack.
• Single-package first, workspace-aware. Everything works for a plain single-package app; monorepo / pub-workspace / Melos guidance is fenced under “when multi-package”.
• One canonical stack. Feature-first layout, Riverpod 3.x, go_router, Drift, package:clock, Material 3 — reconciled to a single vocabulary so the 40 skills never contradict each other.
• Structure, not aesthetics. Design-system and component skills teach how tokens, themes, components, pages, and views are structured — never “the colour must be #…”.
• Progressive disclosure. Core skills ship a lean SKILL.md plus on-demand references/, examples/, and runnable scripts/; simpler skills are a single SKILL.md.
• Correct by construction. Every snippet is idiomatic and conceptually compiles; rules come with the why, anti-patterns, a definition-of-done, and often a grep/analyze script that enforces them.

The skills

Skills marked (rich) ship references/, examples/, and runnable scripts/ alongside SKILL.md. (manual-only) skills are side-effecting runbooks an agent never fires on its own.

Core Flutter & Dart

Architecture

Structure & foundations

Data

Quality & testing

Internationalization & accessibility

Shipping & monetization

Workflows & tooling

A full, searchable catalog with descriptions and filters lives on the website.

How to use these skills

Skills auto-load when a task matches their description — you rarely invoke them by hand. You can also run one explicitly with / (or, installed as a plugin, /flutter:).

Any agent — the universal installer

npx skills add zakariaf/Flutter-Skills

The open skills CLI places the skills where your agent expects them (Cursor, Codex, Copilot, Cline, Windsurf, Gemini CLI, …).

Claude Code — plugin marketplace

/plugin marketplace add zakariaf/Flutter-Skills
/plugin install flutter@flutter-skills

Copy into a single project

git clone https://github.com/zakariaf/Flutter-Skills
mkdir -p .claude/skills && cp -R Flutter-Skills/skills/* .claude/skills/

Personal-global (every project on your machine)

for d in /path/to/Flutter-Skills/skills/*/; do
  ln -s "$d" "$HOME/.claude/skills/$(basename "$d")"
done

Agents that read AGENTS.md

AGENTS.md carries an intent → skill map and usage instructions for any agent (Codex, Cursor, Copilot, …). Copy its guidance into a consuming project’s own AGENTS.md.

Repository layout

.
├── .claude-plugin/          # Claude Code plugin + marketplace manifests
├── .codex-plugin/           # Codex plugin manifest
├── AGENTS.md                # cross-agent entry file (intent → skill map)
├── skills/
│   └── /
│       ├── SKILL.md         # frontmatter (name + description) + the playbook
│       ├── references/      # on-demand deep-dives            (rich skills)
│       ├── examples/        # complete, correct .dart samples  (rich skills)
│       └── scripts/         # runnable grep/analyze checks     (rich skills)
├── skills.json              # machine-readable catalog (for tooling & the site)
├── docs/                    # the GitHub Pages website
├── README.md · CONTRIBUTING.md · LICENSE

Validating

claude plugin validate . --strict          # plugin + marketplace manifests
find skills -name '*.sh' -print0 | xargs -0 -n1 bash -n   # scripts parse

Contributing

See CONTRIBUTING.md for the skill format, the house conventions every skill must follow, and the checks to run before opening a PR.

Provenance

Distilled and merged from the skill libraries of more than ten production Flutter apps, reconciled to one canonical stack, then adversarially reviewed for API correctness (Riverpod 3.x, Drift, gen-l10n, WCAG) and scrubbed of design-token and app-domain specifics so they apply to any Flutter app.

License

MIT © 2026 Zakaria Fatahi