Skip to content
Back to search

flutter-steering

MarketplaceWorks with Claude CodeGitHub

Claude Code plugin for senior Flutter work: stack-aware standards, review/test/onboarding agents, audits, guardrail hooks and the Dart & Flutter MCP server.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gryllifish--flutter-steering/badge.svg)](/listings/gryllifish--flutter-steering)

HTML

<a href="/listings/gryllifish--flutter-steering"><img src="/api/listings/gryllifish--flutter-steering/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.

Both plugins, in Claude Code:

/plugin marketplace add flutter/agent-plugins
/plugin install dart-flutter@dart-flutter
/plugin marketplace add gryllifish/flutter-steering
/plugin install flutter-steering@flutter-steering

Or in `~/.claude/settings.json`:

{
  "extraKnownMarketplaces": {
    "dart-flutter": { "source": { "source": "github", "repo": "flutter/agent-plugins" } },
    "flutter-steering": { "source": { "source": "github", "repo": "gryllifish/flutter-steering" } }
  },
  "enabledPlugins": {
    "dart-flutter@dart-flutter": true,
    "flutter-steering@flutter-steering": true
  }
}

Requirements: `bash`, `jq` and a Dart SDK 3.9+ on `PATH`. Without `jq` the hooks turn themselves off instead of blocking. flutter-steering works without the official plugin, but then Claude has no analyzer, hot reload or runtime-error MCP tools; the session-start hook points that out.

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 · 13 lines
  1. {
  2. "name": "flutter-steering",
  3. "owner": {
  4. "name": "Francisco Páez"
  5. },
  6. "plugins": [
  7. {
  8. "name": "flutter-steering",
  9. "source": "./",
  10. "description": "Senior Flutter engineering workflow for Claude Code."
  11. }
  12. ]
  13. }
README.md · README · 150 lines
  1. # flutter-steering
  2. [![CI](https://github.com/gryllifish/flutter-steering/actions/workflows/ci.yml/badge.svg)](https://github.com/gryllifish/flutter-steering/actions/workflows/ci.yml)
  3. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  4. A [Claude Code](https://claude.com/claude-code) plugin for working on Flutter
  5. projects with an agent, built to sit next to the official
  6. [Dart and Flutter plugin](https://github.com/flutter/agent-plugins). The
  7. official plugin teaches Claude Flutter tasks (layouts, routing, tests, JSON,
  8. localization) and provides the Dart MCP server. This one adds what a team
  9. needs around those tasks: guardrails that keep the agent's diff clean,
  10. getting a foreign codebase running, finding the cause of an error in a long
  11. log, review, audits, and release workflows.
  12. It doesn't impose a stack. On session start it reads the project's
  13. pubspecs (Riverpod, Bloc, Provider, go_router, freezed, FVM, melos...) and
  14. tells Claude to follow what the project already does. Outside a Flutter or
  15. Dart project it stays quiet.
  16. ## Install
  17. Both plugins, in Claude Code:
  18. ```
  19. /plugin marketplace add flutter/agent-plugins
  20. /plugin install dart-flutter@dart-flutter
  21. /plugin marketplace add gryllifish/flutter-steering
  22. /plugin install flutter-steering@flutter-steering
  23. ```
  24. Or in `~/.claude/settings.json`:
  25. ```json
  26. {
  27. "extraKnownMarketplaces": {
  28. "dart-flutter": { "source": { "source": "github", "repo": "flutter/agent-plugins" } },
  29. "flutter-steering": { "source": { "source": "github", "repo": "gryllifish/flutter-steering" } }
  30. },
  31. "enabledPlugins": {
  32. "dart-flutter@dart-flutter": true,
  33. "flutter-steering@flutter-steering": true
  34. }
  35. }
  36. ```
  37. Requirements: `bash`, `jq` and a Dart SDK 3.9+ on `PATH`. Without `jq` the
  38. hooks turn themselves off instead of blocking. flutter-steering works
  39. without the official plugin, but then Claude has no analyzer, hot reload or
  40. runtime-error MCP tools; the session-start hook points that out.
  41. ## How the two plugins split the work
  42. | | Official `dart-flutter` | `flutter-steering` |
  43. |---|---|---|
  44. | Dart MCP server | analyzer, LSP, hot reload/restart, runtime errors, widget inspector, pub, pub.dev search | only the app lifecycle tools the official config leaves off: `list_devices`, `launch_app`, `get_app_logs`, `list_running_apps`, `stop_app` |
  45. | Skills | how to do Flutter tasks: `flutter-fix-layout-issues`, `flutter-add-widget-test`, `flutter-setup-declarative-routing`, `flutter-apply-architecture-best-practices`... | how to work in a codebase: onboarding, verify gate, triage, review, audits, dependencies, CI, release |
  46. | Always-on rules | none in Claude Code (plugin rules aren't loaded; the docs say to copy them into `CLAUDE.md`) | injected by the `SessionStart` hook: stack summary, project-first rule, baseline before changes, hot reload after `lib/` edits, no commits without approval |
  47. | Hooks and agents | none | guardrail hooks and three agents (below) |
  48. The two MCP configurations expose disjoint tool sets, so nothing is
  49. duplicated. That is deliberate: Claude Code has no reliable way to
  50. persistently disable one MCP server inside a plugin.
  51. ## What's inside
  52. ### Skills
  53. Invoked as `/flutter-steering:<name>`, or loaded by Claude when the task
  54. matches the description. Every description says when **not** to use the
  55. skill, pointing to the official skill or Claude Code built-in that fits
  56. better. `release` and `commit` are manual-only because they have side effects.
  57. | Skill | What it does |
  58. |---|---|
  59. | `standards` | Only what changes the agent's defaults: the project wins, on-task diffs in foreign code, and a table of deprecated APIs agents still generate (`withOpacity`, `WillPopScope`, `MaterialState`, Riverpod 3, freezed 3, go_router 10...). |
  60. | `onboard` | Detects the stack, checks the project can build here (SDK constraints and pins, codegen outputs, env/define files, flavors, Firebase config), maps the codebase through `flutter-explorer`, can draft a project `CLAUDE.md`. |
  61. | `verify` | Definition of Done gate. Runs the project's own gate if it has one, otherwise infers the steps (FVM, codegen, l10n, format, analyze, test). Prints only failures. |
  62. | `triage` | Root cause of an error from any log: `flutter run`/`test`, logcat, iOS simulator, Gradle, Xcode, CocoaPods, pub, analyzer, CI. A Dart extractor turns a 200-line log into the distinct errors with only the project's own frames; then the skill traces it to the code and proves the fix. |
  63. | `feature` | Builds a feature end to end by mirroring the project's most complete feature: plan first, verify gate last. |
  64. | `review` | Flutter-specific review of a diff, branch or PR through `flutter-reviewer`, beyond what the analyzer reports. |
  65. | `perf-audit` | Static scan for rebuild, list, image and isolate problems, plus profiling, app size and startup guidance. |
  66. | `a11y-audit` | Semantics, tap targets, contrast, text scaling, focus, and `meetsGuideline` tests. |
  67. | `l10n-audit` | Hardcoded strings, ARB key and placeholder parity across locales, RTL-unsafe layout. |
  68. | `deps` | Evaluates a package before adding it (with approval), upgrades in small verified steps, migrates the Flutter SDK. |
  69. | `ci` | Sets up or reviews GitHub Actions: pinned actions, minimal permissions, generated-files check, Dependabot. |
  70. | `release` | Version bump, changelog from Conventional Commits, pre-release checks, obfuscated builds. |
  71. | `commit` | Proposes atomic Conventional Commits and commits only after approval. |
  72. ### Agents
  73. They run in their own context, so a large review or a codebase walk doesn't
  74. fill up the main conversation.
  75. | Agent | Tools | Role |
  76. |---|---|---|
  77. | `flutter-explorer` | read-only | Maps a codebase: architecture, one feature traced end to end, conventions, commands, risks. |
  78. | `flutter-reviewer` | read-only | Findings ranked by severity with `path:line` and a concrete fix. Leaves to the analyzer what the analyzer catches, and checks that new tests would fail if the fix were reverted. |
  79. | `flutter-test-writer` | read/write | Writes tests in the project's style and runs them until they pass. Reports production bugs instead of bending tests around them. |
  80. ### Hooks
  81. Rules that must hold every time are hooks, not instructions.
  82. | Event | Hook |
  83. |---|---|
  84. | `SessionStart` | Adds the stack summary and the session rules above. Suggests the official plugin if it isn't enabled. |
  85. | `PreToolUse` | Denies edits to generated files (`*.g.dart`, `*.freezed.dart`, files with a generated header...) and points to the generator. |
  86. | `PreToolUse` | Denies access to secrets (`.env`, keystores, `key.properties`, service accounts, `.p8`); build tools may still reference them (`flutter run --dart-define-from-file=.env`). Asks before force push, hard reset, `git clean`, broad `rm -rf` and `pub publish`. |
  87. | `PostToolUse` | Runs `dart format` on each Dart file Claude edits, unless the committed version wasn't formatted: in a codebase that doesn't use `dart format`, a one-line edit stays a one-line diff. |
  88. | `Stop` | Runs `dart analyze` on the files touched in the session. Issues on lines Claude changed block the turn once and go back to Claude; pre-existing issues elsewhere are mentioned, never forced. |
  89. ## Design notes
  90. - **Complement, don't duplicate.** Where the Flutter team ships a skill, this
  91. plugin points to it instead of carrying its own.
  92. - **Only information the model doesn't have.** Following the Flutter team's
  93. [guidance for skills](https://github.com/flutter/flutter/tree/main/.agents/skills)
  94. ("tell the agent what it needs to know, not what it already knows"),
  95. general best practice is left out; what remains is project-first behavior,
  96. deprecated APIs and checkable procedures.
  97. - **Small footprint in someone else's code.** No reformatting of files the
  98. team doesn't format, no blocking on lint debt Claude didn't create, no
  99. drive-by refactors. The diff should contain the task and nothing else.
  100. - **Deterministic where possible.** Formatting, analysis, generated files
  101. and secrets are enforced by hooks, which don't depend on the model
  102. remembering a rule.
  103. - **Cheap on context.** Skill bodies load only when used; scripts print
  104. compact output (`✓`/`✗` per step, distinct errors only).
  105. - **Nothing outward-facing without approval.** Adding dependencies,
  106. committing, pushing, tagging and publishing all stop for confirmation.
  107. - **Portable scripts.** Hooks run on the bash 3.2 that ships with macOS and
  108. fail open if a prerequisite is missing; the log extractor is Dart with no
  109. dependencies.
  110. ## Workflows
  111. [docs/workflows.md](docs/workflows.md) has walkthroughs for joining an
  112. existing codebase, building a feature from scratch and getting a change
  113. ready for review.
  114. ## Development
  115. ```sh
  116. for t in tests/*_test.sh; do "$t"; done # hooks, triage extractor, l10n scripts
  117. dart pub global run skills_lint --skills-directory skills \
  118. --check-relative-paths --check-trailing-whitespace --no-disallowed-field
  119. ```
  120. CI also runs shellcheck and `dart analyze` on the scripts. To try local
  121. changes, add the clone as a marketplace:
  122. `/plugin marketplace add /path/to/flutter-steering`.
  123. ## License
  124. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

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