Skip to content
Back to search

flutter-ai-rules

MarketplaceWorks with Claude CodeGitHub

Flutter and Dart agent skills derived only from official Flutter, Dart, Firebase, and package documentation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/evanca/flutter-ai-rules with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/evanca/flutter-ai-rules'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/evanca-flutter-ai-rules/badge.svg)](/listings/evanca-flutter-ai-rules)

HTML

<a href="/listings/evanca-flutter-ai-rules"><img src="/api/listings/evanca-flutter-ai-rules/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npx skills add evanca/flutter-ai-rules

That's it. The [Skills CLI](https://www.npmjs.com/package/skills) discovers the packages under [`skills/`](./skills) and installs them for supported agents. It needs **Node 22.20 or newer** — on older versions it exits with `SyntaxError: ... does not provide an export named 'styleText'` before it does anything. Every other install route below works on any Node version, or none at all.

Browse before installing, or take just one:

npx skills add evanca/flutter-ai-rules --list
npx skills add evanca/flutter-ai-rules --skill flutter-best-practices

Install as a plugin

This repo is also a plugin marketplace, so agents that support plugins can install the whole set and keep it updated in place. The manifests live at `.claude-plugin/`, `.codex-plugin/`, `.cursor-plugin/`, `.agents/plugins/`, and `plugin.json` — all pointing at the same [`skills/`](./skills) directory.

**Claude Code** — [plugin marketplaces](https://code.claude.com/docs/en/plugin-marketplaces):

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

Skills then load as `flutter-ai-skills:bloc`, `flutter-ai-skills:riverpod`, and so on.

**Codex** — [plugins](https://developers.openai.com/codex/plugins/build):

codex plugin marketplace add evanca/flutter-ai-rules
codex plugin install flutter-ai-skills@flutter-ai-rules

**Cursor** — [plugins](https://cursor.com/docs/plugins): in Cursor, run `/add-plugin`, or add the repo as a team marketplace under **Dashboard → Settings → Plugins → Import from Repo**:

https://github.com/evanca/flutter-ai-rules

**Antigravity** — [plugins](https://antigravity.google/docs/plugins):

git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git
agy plugin install ./flutter-ai-rules

**Windsurf / Devin** has no plugin manifest, but Cascade already scans `.agents/skills/` and `~/.agents/skills/`, so the manual copy below is the install path. **GitHub Copilot** doesn't read `SKILL.md` at all — see [Rules and combined sets](#️-rules-and-combined-sets-legacy) for what to use instead.

Prefer to do it by hand? Copy or symlink any skill folder into your agent's skills directory — `.claude/skills/`, `.cursor/skills/`, `.codex/skills/`, `.agents/skills/` (Antigravity, Codex, Windsurf), `.windsurf/skills/`. Or vendor the whole set into your project:

git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git temp_repo && mkdir -p .skills && cp -r temp_repo/skills/* .skills && rm -rf temp_repo

With a `.skills/` folder you can also reference a skill explicitly when you want it: *"Read `@.skills/bloc/SKILL.md` and create test coverage for the new methods."*

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 36 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "flutter-ai-rules",
  3. "owner": {
  4. "name": "Ivanna Kaceviča",
  5. "url": "https://happycode.studio"
  6. },
  7. "description": "Flutter and Dart agent skills derived only from official Flutter, Dart, Firebase, and package documentation.",
  8. "version": "1.0.0",
  9. "plugins": [
  10. {
  11. "name": "flutter-ai-skills",
  12. "source": "./",
  13. "displayName": "Flutter AI Skills",
  14. "description": "Flutter, Dart, and Firebase skills sourced only from official documentation.",
  15. "version": "1.0.0",
  16. "author": {
  17. "name": "Ivanna Kaceviča",
  18. "url": "https://happycode.studio"
  19. },
  20. "homepage": "https://github.com/evanca/flutter-ai-rules",
  21. "repository": "https://github.com/evanca/flutter-ai-rules",
  22. "license": "MIT",
  23. "category": "development",
  24. "tags": [
  25. "flutter",
  26. "dart",
  27. "firebase",
  28. "bloc",
  29. "riverpod",
  30. "provider",
  31. "testing",
  32. "mobile"
  33. ]
  34. }
  35. ]
  36. }
README.md · README · 213 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Flutter AI Skills for Claude Code, Codex, Cursor, Antigravity, and Other AI Coding Agents
  2. <img src="media/flutter_ai_skills.jpg" width="600" alt="An agent prompt reading &quot;Add Google sign-in to the profile screen&quot; on the left; on the right, the firebase-auth and flutter-app-architecture skills are auto-selected from a list of dozens">
  3. **36 Flutter and Dart skills your coding agent loads by itself, sourced only from official documentation.**
  4. A skill is a folder with a `SKILL.md` file. Your agent reads the description, decides a task matches, and pulls in the guidance — you don't paste anything into a rules file or remember to `@`-mention a doc. Install once, and Firebase Auth guidance shows up when you touch auth, Riverpod guidance when you touch providers.
  5. A comprehensive, (almost) non-opinionated collection: everything here is derived from official Flutter, Dart, Firebase, and package documentation. No personal preferences, no invented conventions.
  6. ## ⚡ Quick start
  7. ```sh
  8. npx skills add evanca/flutter-ai-rules
  9. ```
  10. That's it. The [Skills CLI](https://www.npmjs.com/package/skills) discovers the packages under [`skills/`](./skills) and installs them for supported agents. It needs **Node 22.20 or newer** — on older versions it exits with `SyntaxError: ... does not provide an export named 'styleText'` before it does anything. Every other install route below works on any Node version, or none at all.
  11. Browse before installing, or take just one:
  12. ```sh
  13. npx skills add evanca/flutter-ai-rules --list
  14. npx skills add evanca/flutter-ai-rules --skill flutter-best-practices
  15. ```
  16. ### Install as a plugin
  17. This repo is also a plugin marketplace, so agents that support plugins can install the whole set and keep it updated in place. The manifests live at `.claude-plugin/`, `.codex-plugin/`, `.cursor-plugin/`, `.agents/plugins/`, and `plugin.json` — all pointing at the same [`skills/`](./skills) directory.
  18. **Claude Code** — [plugin marketplaces](https://code.claude.com/docs/en/plugin-marketplaces):
  19. ```sh
  20. /plugin marketplace add evanca/flutter-ai-rules
  21. /plugin install flutter-ai-skills@flutter-ai-rules
  22. ```
  23. Skills then load as `flutter-ai-skills:bloc`, `flutter-ai-skills:riverpod`, and so on.
  24. **Codex** — [plugins](https://developers.openai.com/codex/plugins/build):
  25. ```sh
  26. codex plugin marketplace add evanca/flutter-ai-rules
  27. codex plugin add flutter-ai-skills@flutter-ai-rules
  28. ```
  29. **Cursor** — [plugins](https://cursor.com/docs/plugins): in Cursor, run `/add-plugin`, or add the repo as a team marketplace under **Dashboard → Settings → Plugins → Import from Repo**:
  30. ```
  31. https://github.com/evanca/flutter-ai-rules
  32. ```
  33. **Antigravity** — [plugins](https://antigravity.google/docs/plugins):
  34. ```sh
  35. git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git
  36. agy plugin install ./flutter-ai-rules
  37. ```
  38. **Windsurf / Devin** has no plugin manifest, but Cascade already scans `.agents/skills/` and `~/.agents/skills/`, so the manual copy below is the install path. **GitHub Copilot** doesn't read `SKILL.md` at all — see [Rules and combined sets](#️-rules-and-combined-sets-legacy) for what to use instead.
  39. Prefer to do it by hand? Copy or symlink any skill folder into your agent's skills directory — `.claude/skills/`, `.cursor/skills/`, `.codex/skills/`, `.agents/skills/` (Antigravity, Codex, Windsurf), `.windsurf/skills/`. Or vendor the whole set into your project:
  40. ```sh
  41. git clone --depth 1 https://github.com/evanca/flutter-ai-rules.git temp_repo && mkdir -p .skills && cp -r temp_repo/skills/* .skills && rm -rf temp_repo
  42. ```
  43. With a `.skills/` folder you can also reference a skill explicitly when you want it: *"Read `@.skills/bloc/SKILL.md` and create test coverage for the new methods."*
  44. ## 🧠 What's in the box
  45. ### Flutter and Dart foundations
  46. | Skill | Loads when you're… |
  47. |---|---|
  48. | [`flutter-best-practices`](./skills/flutter-best-practices) | Writing, reviewing, or planning Flutter code |
  49. | [`effective-dart`](./skills/effective-dart) | Writing Dart, naming things, adding doc comments |
  50. | [`dart-3-updates`](./skills/dart-3-updates) | Using records, patterns, sealed classes, switch expressions |
  51. | [`flutter-app-architecture`](./skills/flutter-app-architecture) | Scaffolding a project or refactoring into layers |
  52. | [`architecture-feature-first`](./skills/architecture-feature-first) | Designing folder structure for a new feature |
  53. | [`flutter-errors`](./skills/flutter-errors) | Hitting RenderFlex overflows, unbounded constraints, layout errors |
  54. | [`flutter-use-column-row-first`](./skills/flutter-use-column-row-first) | Building responsive layouts with Row, Column, Expanded, Flexible |
  55. | [`flutter-pre-caching`](./skills/flutter-pre-caching) | Preloading fonts, images, animations, or config |
  56. ### State management
  57. | Skill | Loads when you're… |
  58. |---|---|
  59. | [`bloc`](./skills/bloc) | Creating a Cubit or Bloc, modeling state, wiring providers |
  60. | [`riverpod`](./skills/riverpod) | Setting up providers, combining requests, managing disposal |
  61. | [`provider`](./skills/provider) | Consuming state, optimizing rebuilds, using ProxyProvider |
  62. | [`flutter-change-notifier`](./skills/flutter-change-notifier) | Setting up ChangeNotifier models and consuming them |
  63. ### Testing and review
  64. | Skill | Loads when you're… |
  65. |---|---|
  66. | [`testing`](./skills/testing) | Writing unit, widget, or golden tests; fixing flaky tests |
  67. | [`mockito`](./skills/mockito) | Generating mocks, stubbing, verifying interactions |
  68. | [`mocktail`](./skills/mocktail) | Mocking without codegen, registering fallback values |
  69. | [`patrol-e2e-testing`](./skills/patrol-e2e-testing) | Writing E2E tests that touch native permissions or dialogs |
  70. | [`code-review`](./skills/code-review) | Reviewing a PR, branch, or diff |
  71. ### Firebase
  72. | Skill | Loads when you're… |
  73. |---|---|
  74. | [`flutterfire-configure`](./skills/flutterfire-configure) | Adding Firebase to a project, running `flutterfire configure` |
  75. | [`firebase-auth`](./skills/firebase-auth) | Setting up auth, managing auth state, social sign-in |
  76. | [`firebase-cloud-firestore`](./skills/firebase-cloud-firestore) | Designing schemas, CRUD, listeners, pagination |
  77. | [`firebase-database`](./skills/firebase-database) | Syncing real-time data, structuring JSON trees |
  78. | [`firebase-storage`](./skills/firebase-storage) | Uploading and downloading files, managing metadata |
  79. | [`firebase-analytics`](./skills/firebase-analytics) | Logging events, setting user properties |
  80. | [`firebase-crashlytics`](./skills/firebase-crashlytics) | Capturing fatal and non-fatal errors |
  81. | [`firebase-messaging`](./skills/firebase-messaging) | Setting up FCM, handling background messages |
  82. | [`firebase-in-app-messaging`](./skills/firebase-in-app-messaging) | Running in-app campaigns |
  83. | [`firebase-remote-config`](./skills/firebase-remote-config) | Implementing feature flags or A/B tests |
  84. | [`firebase-app-check`](./skills/firebase-app-check) | Configuring attestation and debug tokens |
  85. | [`firebase-cloud-functions`](./skills/firebase-cloud-functions) | Calling callable functions, handling errors |
  86. | [`firebase-ai`](./skills/firebase-ai) | Generating text or chat with Gemini via `firebase_ai` |
  87. | [`generate-images-with-firebase-ai`](./skills/generate-images-with-firebase-ai) | Generating or editing images with a Gemini image model (Nano Banana) |
  88. | [`firebase-data-connect`](./skills/firebase-data-connect) | Writing GraphQL queries against Data Connect |
  89. ### Shipping and product
  90. | Skill | Loads when you're… |
  91. |---|---|
  92. | [`accessibility`](./skills/accessibility) | Working on a11y, WCAG, screen readers, focus order |
  93. | [`inclusive-design`](./skills/inclusive-design) | Handling i18n, global name/address forms, low-end devices |
  94. | [`revenuecat-testing`](./skills/revenuecat-testing) | Testing purchases, subscriptions, sandbox flows, experiment readiness |
  95. | [`developing-genkit-dart`](./skills/developing-genkit-dart) | Building AI agents in Dart with Genkit |
  96. ## 🗂️ Rules and combined sets (legacy)
  97. Before skills existed, this repo shipped rule files you pasted into a config, plus pre-merged bundles squeezed under Windsurf's character cap. Both still work and both are still updated, but **skills are the recommended path** — they load contextually instead of consuming your context window on every request.
  98. Reach for these only if your tool has no skills support, or you want one static file you fully control:
  99. - **[`rules/`](./rules)** — six broad foundation files: `effective_dart.md`, `flutter_app_architecture.md`, `flutter_errors.md`, `dart_3_updates.md`, `testing.md`, `code_review.md`. Drop them in your project and reference them by name: *"Read @rules/effective_dart.md and follow its conventions."* Package-specific guidance (Bloc, Riverpod, Firebase, Mockito…) is **skills-only** now.
  100. - **[`combined/`](./combined)** — seven topic bundles, each in a full and an `__under_6K` variant. Paste one into your global or local rules config and you're done. The trimmed variants stay under 6,000 characters to fit Windsurf's `global_rules.md` hard limit.
  101. **GitHub Copilot** lives here rather than in the skills section, because it has no `SKILL.md` support. Three options, in the order Copilot documents them:
  102. - Copy a [`combined/`](./combined) bundle to `.github/copilot-instructions.md` for repo-wide guidance.
  103. - Copy [`rules/`](./rules) files into `.github/instructions/` as `<name>.instructions.md`, each with `applyTo: "**/*.dart"` frontmatter, so they only load for Dart files.
  104. - Copilot also reads a root `AGENTS.md`, so a bundle pasted there works for Copilot, Codex, and Antigravity at once.
  105. ## 📏 Recommended file sizes by tool
  106. Size guidance from each tool's **own official documentation**, for rule/instruction files and for `SKILL.md` files (accessed 2026-07-11).
  107. | Tool | Rule file — recommended size | `SKILL.md` — recommended size |
  108. |------|------------------------------|-------------------------------|
  109. | **Claude Code** | `CLAUDE.md`: under **200 lines** *(soft)* | Under **500 lines** *(soft)*; `description` **1,536 chars** *(hard)* |
  110. | **Cursor** | `.mdc` rule: under **500 lines** *(soft)* | **No numeric limit** — "keep focused, move detail to separate files" |
  111. | **OpenAI Codex** | `AGENTS.md`: **no limit stated** | Skill bundle: zip **≤ 50 MB**, uncompressed file **≤ 25 MB**, **≤ 500** files/version (no per-`SKILL.md` text limit) |
  112. | **Google Antigravity** | rule file: **12,000 chars** each *(hard)* | **No numeric limit stated** |
  113. | **Windsurf** | `global_rules.md`: **6,000 chars**; `.windsurf/rules/*.md`: **12,000 chars**/file *(hard)* | **No numeric limit** — "keeps your context window lean" |
  114. | **GitHub Copilot** | `copilot-instructions.md`: **≤ 2 pages** *(soft, approx.)* | **Not supported** — no repo-level `SKILL.md` |
  115. **Notes:**
  116. - **Hard** = enforced/truncated at the limit; **soft** = a documented quality recommendation.
  117. - **Only Claude Code publishes a numeric `SKILL.md` *length* recommendation** (under 500 lines). Cursor, Windsurf, and Antigravity just say "keep it focused/lean" with no figure; **OpenAI** documents skill-*bundle* limits (50 MB zip / 25 MB per file / 500 files) rather than a text length; and **GitHub Copilot has no repo-level `SKILL.md`** — it uses `copilot-instructions.md` plus path-specific `*.instructions.md` (no size limit stated for the latter).
  118. - **Claude Code** loads `CLAUDE.md` in full regardless of length, but notes files over 200 lines "consume more context and reduce adherence"; its auto-memory `MEMORY.md` loads only the "first 200 lines or 25KB, whichever comes first."
  119. - **Windsurf** is still named Windsurf; its docs are served through Cognition (`docs.windsurf.com` → `docs.devin.ai`) and reference `.windsurf/rules` and `.windsurf/skills`.
  120. - This repo keeps the [`combined/`](./combined) sets under **6,000 characters** to satisfy the strictest hard limit above (Windsurf `global_rules.md`).
  121. **Official sources:** Claude Code — [memory](https://code.claude.com/docs/en/memory) · [skills](https://code.claude.com/docs/en/skills) | Cursor — [rules](https://cursor.com/docs/context/rules) · [skills](https://cursor.com/docs/skills) | OpenAI Codex — [AGENTS.md](https://agents.md/) · [skills](https://developers.openai.com/api/docs/guides/tools-skills#limits-and-validation) | Google Antigravity — [rules](https://antigravity.google/docs/rules-workflows) · [skills](https://antigravity.google/docs/skills) | Windsurf — [rules & skills](https://docs.windsurf.com/windsurf/cascade/memories) | GitHub Copilot — [instructions](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions)
  122. ## 📌 No opinions, just documentation
  123. Every skill is sourced from official documentation — no personal preferences or subjective interpretations. That's intentional. You're free to alter them to taste, but this repo stays objective by sticking to the source.
  124. One consequence worth knowing: skills can contradict each other, because their sources do. If one package recommends a folder layout and another recommends a different one, you'll see both.
  125. Content is re-fetched from upstream docs on a schedule, so skills track the official guidance as it changes rather than freezing at whatever was true when they were written.
  126. ## 🛠️ Contributing
  127. Contributions are welcome:
  128. 1. Fork this repository.
  129. 2. Add or modify a skill in [`skills/`](./skills), or a rule in [`rules/`](./rules).
  130. 3. Open a pull request explaining the change.
  131. **Include an official documentation link** for anything you add or change. That's the one hard requirement — it's what keeps the repo objective and reviewable. If your source isn't already listed in [ATTRIBUTION.md](./ATTRIBUTION.md), add it there with its license — and if that license isn't a permissive one, restate the guidance instead of quoting it.
  132. ## 📚 Sources
  133. Official documentation these skills are built from:
  134. **Flutter** — [App Architecture](https://docs.flutter.dev/app-architecture) · [Common Errors](https://docs.flutter.dev/testing/common-errors) · [Simple State Management](https://docs.flutter.dev/data-and-backend/state-mgmt/simple)
  135. **Dart** — [Effective Dart](https://dart.dev/effective-dart) · [Language tour](https://dart.dev/language) · [Records](https://dart.dev/language/records) · [Patterns](https://dart.dev/language/patterns) · [Pattern types](https://dart.dev/language/pattern-types) · [Branches](https://dart.dev/language/branches)
  136. **State management** — [Bloc](https://bloclibrary.dev/) · [Riverpod](https://riverpod.dev/) · [Provider](https://pub.dev/packages/provider)
  137. **Testing** — [Mockito](https://pub.dev/packages/mockito) · [Mocktail](https://pub.dev/packages/mocktail) · [Patrol](https://patrol.leancode.co/)
  138. **Firebase** — [Firebase for Flutter](https://firebase.google.com/docs/flutter/setup) · [FlutterFire](https://firebase.flutter.dev/) · [Multiple flavors with the FlutterFire CLI](https://codewithandrea.com/articles/flutter-firebase-multiple-flavors-flutterfire-cli/)
  139. ## 📄 License
  140. [MIT](./LICENSE) — for this repository's own content: the choice of topics, the trigger
  141. descriptions, and the wording and structure of every skill.
  142. The underlying documentation keeps its own terms. Most of it is CC BY 4.0 (Flutter, Dart, Firebase),
  143. with code samples under BSD-3 or Apache 2.0, package READMEs under MIT or Apache 2.0, and a few
  144. sources — Apple, Google Play, RevenueCat — that aren't openly licensed and are therefore restated
  145. as fact rather than copied. [**ATTRIBUTION.md**](./ATTRIBUTION.md) maps every source to its license
  146. and to the skills built on it.
  147. If you redistribute this repo or lift a single skill out of it, keep the source links — that's what
  148. the CC BY attribution requirement actually asks for.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.