К основному содержанию
плагин CX Codex

flutter-ai-skills — плагин для Claude Code

Плагин flutter-ai-skills для Claude Code и Codex содержит 36 скиллов по Flutter, Dart и Firebase на основе официальной документации. Агент загружает их при работе с соответствующим кодом.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает flutter-ai-skills

Плагин подключает к ассистенту каталог инструкций по Flutter, Dart 3 и сервисам Firebase. Каждая тема вынесена в отдельную директорию со своим файлом SKILL.md. Агент считывает описания и автоматически берёт нужные инструкции, когда вы работаете с соответствующим кодом: Riverpod при редактировании провайдеров или Firebase Auth при настройке входа.

Внутри собраны рекомендации по управлению состоянием через Bloc, Riverpod и Provider, тестированию с помощью Mocktail и Patrol, исправлению ошибок вёрстки вроде RenderFlex overflow, а также интеграции Firebase. Содержимое строго опирается на официальную документацию фреймворка и библиотек без личных соглашений автора.

Для пакетной установки через утилиту npx skills add требуется Node версии 22.20 или новее, иначе процесс завершится ошибкой из-за метода styleText. При установке штатными командами плагина для Claude Code или Codex Node не понадобится.

Какие задачи решает

  • настроить авторизацию через Firebase Auth и social sign-in
  • смоделировать состояние приложения на BLoC или Riverpod
  • разобрать ошибки вёрстки вроде RenderFlex overflow
  • написать E2E-тесты с нативными окнами через Patrol

Примеры запросов агенту

  • Помоги настроить Firebase Auth с Google sign-in на экране профиля
  • Создай Cubit и состояния для экрана корзины с помощью flutter-ai-skills:bloc
  • Исправь ошибку переполнения RenderFlex в списке контактов

Как установить flutter-ai-skills

Через маркетплейс плагинов

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

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о flutter-ai-skills

Как установить flutter-ai-skills в Claude Code?

Выполните в консоли агента две команды: /plugin marketplace add evanca/flutter-ai-rules, затем /plugin install flutter-ai-skills@flutter-ai-rules.

Что делает flutter-ai-skills?

Плагин автоматически передаёт агенту официальные правила и практики по Dart, Flutter и Firebase при решении конкретных задач.

Какая версия Node нужна для работы?

При установке через маркетплейс плагинов Node не требуется вовсе. Версия 22.20 или новее нужна только для альтернативной утилиты npx skills add.

Исходный текст

SKILL.md · MIT
# Flutter AI Skills for Claude Code, Codex, Cursor, Antigravity, and Other AI Coding Agents

<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">

**36 Flutter and Dart skills your coding agent loads by itself, sourced only from official documentation.**

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.

A comprehensive, (almost) non-opinionated collection: everything here is derived from official Flutter, Dart, Firebase, and package documentation. No personal preferences, no invented conventions.

## ⚡ Quick start

```sh
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:

```sh
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):

```sh
/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):

```sh
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):

```sh
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:

```sh
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's in the box

### Flutter and Dart foundations

| Skill | Loads when you're… |
|---|---|
| [`flutter-best-practices`](./skills/flutter-best-practices) | Writing, reviewing, or planning Flutter code |
| [`effective-dart`](./skills/effective-dart) | Writing Dart, naming things, adding doc comments |
| [`dart-3-updates`](./skills/dart-3-updates) | Using records, patterns, sealed classes, switch expressions |
| [`flutter-app-architecture`](./skills/flutter-app-architecture) | Scaffolding a project or refactoring into layers |
| [`architecture-feature-first`](./skills/architecture-feature-first) | Designing folder structure for a new feature |
| [`flutter-errors`](./skills/flutter-errors) | Hitting RenderFlex overflows, unbounded constraints, layout errors |
| [`flutter-use-column-row-first`](./skills/flutter-use-column-row-first) | Building responsive layouts with Row, Column, Expanded, Flexible |
| [`flutter-pre-caching`](./skills/flutter-pre-caching) | Preloading fonts, images, animations, or config |

### State management

| Skill | Loads when you're… |
|---|---|
| [`bloc`](./skills/bloc) | Creating a Cubit or Bloc, modeling state, wiring providers |
| [`riverpod`](./skills/riverpod) | Setting up providers, combining requests, managing disposal |
| [`provider`](./skills/provider) | Consuming state, optimizing rebuilds, using ProxyProvider |
| [`flutter-change-notifier`](./skills/flutter-change-notifier) | Setting up ChangeNotifier models and consuming them |

### Testing and review

| Skill | Loads when you're… |
|---|---|
| [`testing`](./skills/testing) | Writing unit, widget, or golden tests; fixing flaky tests |
| [`mockito`](./skills/mockito) | Generating mocks, stubbing, verifying interactions |
| [`mocktail`](./skills/mocktail) | Mocking without codegen, registering fallback values |
| [`patrol-e2e-testing`](./skills/patrol-e2e-testing) | Writing E2E tests that touch native permissions or dialogs |
| [`code-review`](./skills/code-review) | Reviewing a PR, branch, or diff |

### Firebase

| Skill | Loads when you're… |
|---|---|
| [`flutterfire-configure`](./skills/flutterfire-configure) | Adding Firebase to a project, running `flutterfire configure` |
| [`firebase-auth`](./skills/firebase-auth) | Setting up auth, managing auth state, social sign-in |
| [`firebase-cloud-firestore`](./skills/firebase-cloud-firestore) | Designing schemas, CRUD, listeners, pagination |
| [`firebase-database`](./skills/firebase-database) | Syncing real-time data, structuring JSON trees |
| [`firebase-storage`](./skills/firebase-storage) | Uploading and downloading files, managing metadata |
| [`firebase-analytics`](./skills/firebase-analytics) | Logging events, setting user properties |
| [`firebase-crashlytics`](./skills/firebase-crashlytics) | Capturing fatal and non-fatal errors |
| [`firebase-messaging`](./skills/firebase-messaging) | Setting up FCM, handling background messages |
| [`firebase-in-app-messaging`](./skills/firebase-in-app-messaging) | Running in-app campaigns |
| [`firebase-remote-config`](./skills/firebase-remote-config) | Implementing feature flags or A/B tests |
| [`firebase-app-check`](./skills/firebase-app-check) | Configuring attestation and debug tokens |
| [`firebase-cloud-functions`](./skills/firebase-cloud-functions) | Calling callable functions, handling errors |
| [`firebase-ai`](./skills/firebase-ai) | Generating text or chat with Gemini via `firebase_ai` |
| [`generate-images-with-firebase-ai`](./skills/generate-images-with-firebase-ai) | Generating or editing images with a Gemini image model (Nano Banana) |
| [`firebase-data-connect`](./skills/firebase-data-connect) | Writing GraphQL queries against Data Connect |

### Shipping and product

| Skill | Loads when you're… |
|---|---|
| [`accessibility`](./skills/accessibility) | Working on a11y, WCAG, screen readers, focus order |
| [`inclusive-design`](./skills/inclusive-design) | Handling i18n, global name/address forms, low-end devices |
| [`revenuecat-testing`](./skills/revenuecat-testing) | Testing purchases, subscriptions, sandbox flows, experiment readiness |
| [`developing-genkit-dart`](./skills/developing-genkit-dart) | Building AI agents in Dart with Genkit |

## 🗂️ Rules and combined sets (legacy)

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.

Reach for these only if your tool has no skills support, or you want one static file you fully control:

- **[`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.
- **[`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.

**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:

- Copy a [`combined/`](./combined) bundle to `.github/copilot-instructions.md` for repo-wide guidance.
- Copy [`rules/`](./rules) files into `.github/instructions/` as `<name>.instructions.md`, each with `applyTo: "**/*.dart"` frontmatter, so they only load for Dart files.
- Copilot also reads a root `AGENTS.md`, so a bundle pasted there works for Copilot, Codex, and Antigravity at once.

## 📏 Recommended file sizes by tool

Size guidance from each tool's **own official documentation**, for rule/instruction files and for `SKILL.md` files (accessed 2026-07-11).

| Tool | Rule file — recommended size | `SKILL.md` — recommended size |
|------|------------------------------|-------------------------------|
| **Claude Code** | `CLAUDE.md`: under **200 lines** *(soft)* | Under **500 lines** *(soft)*; `description` **1,536 chars** *(hard)* |
| **Cursor** | `.mdc` rule: under **500 lines** *(soft)* | **No numeric limit** — "keep focused, move detail to separate files" |
| **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) |
| **Google Antigravity** | rule file: **12,000 chars** each *(hard)* | **No numeric limit stated** |
| **Windsurf** | `global_rules.md`: **6,000 chars**; `.windsurf/rules/*.md`: **12,000 chars**/file *(hard)* | **No numeric limit** — "keeps your context window lean" |
| **GitHub Copilot** | `copilot-instructions.md`: **≤ 2 pages** *(soft, approx.)* | **Not supported** — no repo-level `SKILL.md` |

**Notes:**
- **Hard** = enforced/truncated at the limit; **soft** = a documented quality recommendation.
- **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).
- **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."
- **Windsurf** is still named Windsurf; its docs are served through Cognition (`docs.windsurf.com` → `docs.devin.ai`) and reference `.windsurf/rules` and `.windsurf/skills`.
- This repo keeps the [`combined/`](./combined) sets under **6,000 characters** to satisfy the strictest hard limit above (Windsurf `global_rules.md`).

**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)

## 📌 No opinions, just documentation

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.

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.

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.

## 🛠️ Contributing

Contributions are welcome:

1. Fork this repository.
2. Add or modify a skill in [`skills/`](./skills), or a rule in [`rules/`](./rules).
3. Open a pull request explaining the change.

**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.

## 📚 Sources

Official documentation these skills are built from:

**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)

**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)

**State management** — [Bloc](https://bloclibrary.dev/) · [Riverpod](https://riverpod.dev/) · [Provider](https://pub.dev/packages/provider)

**Testing** — [Mockito](https://pub.dev/packages/mockito) · [Mocktail](https://pub.dev/packages/mocktail) · [Patrol](https://patrol.leancode.co/)

**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/)

## 📄 License

[MIT](./LICENSE) — for this repository's own content: the choice of topics, the trigger
descriptions, and the wording and structure of every skill.

The underlying documentation keeps its own terms. Most of it is CC BY 4.0 (Flutter, Dart, Firebase),
with code samples under BSD-3 or Apache 2.0, package READMEs under MIT or Apache 2.0, and a few
sources — Apple, Google Play, RevenueCat — that aren't openly licensed and are therefore restated
as fact rather than copied. [**ATTRIBUTION.md**](./ATTRIBUTION.md) maps every source to its license
and to the skills built on it.

If you redistribute this repo or lift a single skill out of it, keep the source links — that's what
the CC BY attribution requirement actually asks for.

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

Похожие плагины

Все плагины по теме «Мобильная разработка» →
flutter-expert https://github.com/Jeffallan Скилл flutter-expert для разработки кросс-платформных приложений на Flutter 3+ и Dart. Помогает с виджетами, управлением состоянием через Riverpod или Bloc, маршрутизацией GoRouter и оптимизацией производительности. CX Codex +1 14 900установок flutter-dev MiniMax-AI Скилл flutter-dev для Claude Code помогает создавать Flutter-приложения и настраивать управление состоянием, навигацию и тесты. Он подключается к задачам с виджетами, адаптивной вёрсткой и производительностью. CX Codex +1 2 000установок flutter-development aj-geddes Скилл flutter-development для разработки мобильных приложений на Flutter и Dart: виджеты, состояние через Provider или BLoC, навигация, интеграция с API. CX Codex +1 727установок flutter Mindrally Задаёт правила разработки на Flutter и Dart: чистую архитектуру по фичам, управление состоянием через Riverpod или BLoC и ограничения на вложенность виджетов. CX Codex +1 975установок Flutter App taste f Промпт Flutter App taste для ChatGPT задаёт стандарты разработки кроссплатформенных мобильных приложений на Flutter. Задействуется при проектировании архитектуры и написании кода. GP ChatGPT ★ 178 201звёзд репо flutter-riverpod-expert juparave Скилл flutter-riverpod-expert обучает агента архитектуре Flutter Riverpod с кодогенерацией и AsyncNotifier. Он нужен при настройке реактивного стейта, разделении слоёв и борьбе с лишними перерисовками. CX Codex +1 1 200установок

Из того же набора39

Весь набор →
accessibility Скилл accessibility разбирает задачу по чек-листу WCAG — клавиатура, скринридер, контраст, формы — и находит конкретные нарушения доступности. Включается по словам a11y, ARIA, alt text, focus order, contrast. CX Codex +1 ★ 674звёзд репо firebase-cloud-firestore Скилл firebase-cloud-firestore учит агента настраивать Cloud Firestore во Flutter-проекте: схему данных, запросы, листенеры и правила безопасности. CX Codex +1 ★ 674звёзд репо generate-images-with-firebase-ai Скилл generate-images-with-firebase-ai помогает настроить генерацию картинок через Firebase AI Logic и Gemini в Flutter, избегая ошибок квот, сбоев App Check и пустых ответов. CX Codex +1 ★ 674звёзд репо code-review Скилл code-review проверяет изменения в Flutter/Dart-проекте по чек-листу: от логики и тестов до безопасности и стиля. Пригодится перед слиянием PR или MR. CX Codex +1 ★ 674звёзд репо bloc Помогает создавать Cubit и Bloc, выбирать форму состояния и подключать bloc-виджеты к дереву. Помогает унифицировать state management в проекте. CX Codex +1 ★ 674звёзд репо firebase-auth Скилл firebase-auth настраивает авторизацию Firebase в приложениях на Flutter. Помогает подключить почту, социальные сети, эмулятор и корректно отслеживать сессии пользователей. CX Codex +1 ★ 674звёзд репо firebase-messaging Скилл firebase-messaging для Claude Code настраивает Firebase Cloud Messaging в Flutter: разрешения, токены и обработку push-уведомлений в фоне и открытом приложении. CX Codex +1 ★ 674звёзд репо flutter-pre-caching Скилл flutter-pre-caching подсказывает, как заранее загрузить шрифты, картинки и анимации во Flutter, чтобы убрать мигание и задержку первого рендера. CX Codex +1 ★ 674звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой