techmefr/mentis/flutter-conventions

Claude Code and agent skill by techmefr/mentis

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when writing or reviewing Flutter/Dart: BuildContext across async gaps, disposal, widget decomposition, rebuild scope, layout and overflows, the four async UI states, navigation, state management, storage, network and platform security, Dart language habits, tests.

Install

npx vskill@latest install techmefr/mentis/flutter-conventions

SKILL.md

The same SKILL.md was published earlier as techmefr/mentis/flutter-conventions.

flutter-conventions

Step 6 of the pipeline (WORKFLOW.md). Frames the writing and review of Flutter/Dart code. Special status: no production mobile experience behind this block — content comes from the framework's own documentation, its analyzer lints and an org catalogue for the stack. The matching reviewer (faramir) asks questions rather than asserting, for the same reason.

Relation to an org skill catalogue. Where a company ships its own versioned catalogue and a shared UI kit, both are the authority — its components, its SDK, its structure — and override this block wherever they differ. A shared UI kit in particular inverts several rules below: where one exists, its component is preferred over the raw framework widget, and the generic advice here applies only to what the kit doesn't cover. Internal package names are deliberately absent (rule C).

An applied override is recorded, not hidden. Write the code the governing rule actually requires, and leave one short neutral trace addressed to whoever can decide (a line in the PR description, the task summary or an ADR): which rule was overridden, by what, and that it is a resolved case. Never phrase it as "a conflict between mentis and the house rules" to a non-technical stakeholder — that framing reads as broken even when the case is a normal, resolved one, and has already caused a real project to get abandoned and restarted over nothing. Raise one specific, named question to the decider only when no rule anywhere actually resolves the case.

When

As soon as a widget, a screen, a state holder, a repository or a route is written or modified, during code (6) or tdd (5).

Steps

Read only the sections the task actually touches. The rules live one file per section under references/; loading all of them for a change that only renames a variable is waste, and a section read is a section that has to be applied. If you are reviewing a whole diff, pick the rows whose trigger the diff meets, not the whole table.

§CoversRead it whenFile
1The two mistakes that crash in productionalways, before anything else on this stack`01-two-mistakes-crash.md`
2Widgets and rebuildsa widget is written, or a rebuild looks too wide`02-widgets-rebuilds.md`
3Layouta screen is laid out, or an overflow shows up`03-layout.md`
4Screen statesa screen renders async data`04-screen-states.md`
5Navigationa route, back handling, a deep link`05-navigation.md`
6Lists and formsa list, a pagination, a form, the keyboard`06-lists-forms.md`
7State managementa cubit, a bloc, any state holder`07-state-management.md`
8Data, storage, permissionspersistence, a secret, a platform permission`08-data-storage-permissions.md`
9Text, motion, monitoringuser-visible text, an animation, crash reporting`09-text-motion-monitoring.md`
10Naming, structure, testsa file is placed or named, or tests are written`10-naming-structure-tests.md`
11Network, platform and build securityan HTTP client, a deep link or intent, a web view, a manifest or property list, or a release build is touched`11-network-platform-security.md`
12Dart language habitsan import, an unawaited future, generated code, a forced null, a decoded payload or the analyser configuration`12-dart-language-habits.md`
13Testing state holders, doubles, time and flowsa state holder, a repository, a debounce, a golden or a device-level flow gets a test`13-testing-state-holders-time.md`
14App variants, forced update, web inputa dev/staging/prod variant is added or audited, a minimum-version gate is built or triggered, or a tappable element ships to web or desktop`14-variants-forced-update-web.md`

Output / checkpoint

Code compliant with the sections above, analyzer clean, no new lint introduced by the diff. Checked by gate (7) and by faramir at review time in the review step (8).

Guardrails

No comments in the code produced. Where a shared UI kit exists, its component wins over a raw framework widget — and over the generic advice here. This block has never been confronted with a real production Flutter project: if a rule diverges from a real observed need, fix this block rather than treating it as settled, and prefer a question to an assertion when reviewing (that's faramir's register too). Where an org catalogue is installed and disagrees, it wins.

Origin

Rules mined from market catalogues, linters and internal review feedback, rewritten in the house voice; the full provenance, the source stamps and the refresh log are in `references/origin.md`. Read it when checking whether a rule is still current, not when applying one.

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/techmefr/mentis/flutter-conventions/badge)](https://verified-skill.com/skills/techmefr/mentis/flutter-conventions)

Something wrong with this skill or its page? Tell us.