Agent skill

Flutter Architecture

by MADTeacher in MADTeacher/mad-agents-skills

Design, refactor, review, or implement Flutter app architecture using MVVM, layered UI/Data/optional Domain boundaries, feature-first or layer-first project structure, repositories, services…

MITAuto-check passedMobile

Install Flutter Architecture

skills CLI
$ npx skills add MADTeacher/mad-agents-skills --skill flutter-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MADTeacher/mad-agents-skills flutter-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MADTeacher/mad-agents-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/flutter-architecture .claude/skills/flutter-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
flutter-architecture
GitHub stars
110
Token cost
~1.4k tokens
SKILL.md length
625 words
Files
9 (incl. references, assets)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Design, refactor, review, or implement Flutter app architecture using MVVM, layered UI/Data/optional Domain boundaries, feature-first or layer-first project structure, repositories, services…

  • Works in 7 steps: Confirm the target is a Flutter or Dart… → Preserve existing conventions unless… → Choose the smallest architecture that… → …
  • Asked to add a Flutter feature
  • SKILL.md covers Core Contract, Clarification Rules, Resource Routing and Architecture Defaults, plus 1 more section
  • Runs Dart scripts from its folder; calls flutter

What it does

Flutter Architecture is an agent skill from MADTeacher/mad-agents-skills. Design, refactor, review, or implement Flutter app architecture using MVVM, layered UI/Data/optional Domain boundaries, feature-first or layer-first project structure, repositories, services, dependency injection, Result and Command patterns, offline-first or optimistic UI flows. Use when asked to add a Flutter feature, audit layer dependencies, fix cross-feature imports, migrate to feature-first, choose architecture for a Flutter project, or create scalable maintainable Flutter code organization.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files and assets (for example `assets/examples/README.md`, `references/concepts.md` and `references/design-patterns.md`).

It sits in Mobile, covering Cross-platform mobile apps. It works with Flutter. The repository describes itself as: Collection of agent skills for AI assistants working with Dart and Flutter projects. The licence is MIT.

When your agent uses it

  • Asked to add a Flutter feature
  • Audit layer dependencies
  • Fix cross-feature imports
  • Migrate to feature-first

Example prompts

  • “/flutter-architecture”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Confirm the target is a Flutter or Dart package by inspecting pubspec.yaml,
  2. Preserve existing conventions unless they conflict with a clear architecture
  3. Choose the smallest architecture that fits the project
  4. Keep Views declarative and thin, ViewModels responsible for UI state and
  5. For implementation tasks, change the project structure and code using local
  6. For review tasks, report layer violations, cross-feature imports, state
  7. Validate with the repo's normal commands. Prefer flutter analyze and

What it can do on your machine

Read from SKILL.md and the folder at commit 2fb67e3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Dart), which the agent can run.

    Shell commands in SKILL.md call:

    • flutter

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Flutter Architecture loads about 1.4k tokens when it runs, and up to ~10k if it reads all its reference files. Until then it costs about 131 tokens; SKILL.md has 625 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~131
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~10k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MADTeacher/mad-agents-skills at commit 2fb67e3, republished under its MIT licence (© MADTeacher). 625 words, ~1,387 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-architecture/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
flutter-architecture
description
Design, refactor, review, or implement Flutter app architecture using MVVM, layered UI/Data/optional Domain boundaries, feature-first or layer-first project structure, repositories, services, dependency injection, Result and Command patterns, offline-first or optimistic UI flows. Use when asked to add a Flutter feature, audit layer dependencies, fix cross-feature imports, migrate to feature-first, choose architecture for a Flutter project, or create scalable maintainable Flutter code organization.
metadata.author
Stanislav [MADTeacher] Chernyshev
metadata.version
1.0

Flutter Architecture

You are an architecture agent for Flutter apps. Turn existing project facts into concrete structure, code organization, dependency rules, and validation steps. Do not treat this skill as a report: use it to inspect, decide, implement or review, and verify.

Core Contract

  1. Confirm the target is a Flutter or Dart package by inspecting pubspec.yaml, lib/, and existing state-management, routing, DI, networking, persistence, and test conventions.
  2. Preserve existing conventions unless they conflict with a clear architecture requirement or the user explicitly asks to migrate.
  3. Choose the smallest architecture that fits the project:
    • Use feature-first for medium/large apps, team work, frequent feature changes, or clearly bounded business capabilities.
    • Use layer-first for small apps, solo work, or simple CRUD flows.
    • Use a Domain layer only for complex, reusable, or multi-repository business logic. ViewModels may call Repositories directly for simple flows.
  4. Keep Views declarative and thin, ViewModels responsible for UI state and commands, Repositories as the single source of truth for app data, and Services as stateless wrappers around external data sources.
  5. For implementation tasks, change the project structure and code using local patterns first. Add templates from this skill only after checking that their imports, Dart SDK features, state-management style, and naming fit the app.
  6. For review tasks, report layer violations, cross-feature imports, state ownership problems, missing tests, and unclear dependency boundaries before broad style advice.
  7. Validate with the repo's normal commands. Prefer flutter analyze and relevant flutter test suites when available; otherwise explain the missing verification.

Clarification Rules

Ask the user only when a high-impact decision cannot be inferred from the project:

  • product boundary of a new feature;
  • expected scale of team or app when structure choice is ambiguous;
  • offline-first, sync, or conflict-resolution requirements;
  • whether a migration should be incremental or all-at-once.

If the project is unavailable or is not a Flutter project, give an architecture plan or review based on the provided context, do not invent repository facts, and state that code validation could not be performed.

Show full SKILL.md (290 more words)Show less

Resource Routing

Read only the references needed for the current task:

NeedReadUse for
Basic principles or vocabularyconcepts.mdSeparation of concerns, SSOT, UDF, UI as state
Layer boundaries or testslayers.mdUI/Data/optional Domain responsibilities and validation
Feature-first structure or migrationfeature-first.mdFolder layout, shared code, cross-feature dependency rules
MVVM relationshipsmvvm.mdView, ViewModel, Repository, Service relationships
Command, Result, Repository, DI, offline, optimistic UIdesign-patterns.mdPattern selection and code examples
Command templatecommand.dartCopy only after adapting import path and state-management fit
Result templateresult.dartCopy only when the app lacks an equivalent typed result/error model
Illustrative snippetsexamples/README.mdUse as examples, not as a required workflow

Architecture Defaults

  • Canonical dependency rule: lower layers must not depend on upper layers. ViewModels may call Repositories directly for simple operations; use-cases are introduced only when they reduce duplication or isolate complex business logic.
  • Feature modules should not import another feature's implementation files. Move shared behavior to shared/, depend on stable interfaces through DI, or merge features when the boundary is artificial.
  • Repositories own data mutation and synchronization for their data type. Services should stay stateless and should not own business state.
  • Do not add folders just to satisfy a diagram. Empty domain/, use-cases/, or barrel files are optional until the feature needs them.

Validation

Before finishing an implementation or review:

  1. Check that new imports respect the chosen feature/layer boundary.
  2. Check that ViewModels do not perform platform, file, or network I/O directly.
  3. Check that repositories remain UI-independent and service interactions are testable.
  4. Run the closest available validation:
    • flutter analyze
    • focused flutter test suites for changed features
    • template-only validation with dart format --output=none --set-exit-if-changed for copied Dart assets
  5. Report commands run, failures, skipped checks, and residual architecture risks.

© MADTeacher, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references, assets) in flutter-architecture of MADTeacher/mad-agents-skills.

  • SKILL.md
  • assets/command.dart
  • assets/examples/README.md
  • assets/result.dart
  • references/concepts.md
  • references/design-patterns.md
  • references/feature-first.md
  • references/layers.md
  • references/mvvm.md

Open the folder on GitHubat commit 2fb67e3

Compare with similar skills

Flutter Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Flutter Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Architecture this skillMADTeacher/mad-agents-skills110—~1.4kAutomated safety check: PassMIT
Add Flutter Docusaurus Localematthiasn/lotti1.2k—~1.2kAutomated safety check: PassGPL-3.0
Tm Launcher DesignFar-Se/tabame372—~3.1kAutomated safety check: PassMIT
Flutter Initbear2u/my-skills932—~2.5kAutomated safety check: PassNone
Mobile App UI Designceorkm/mobile-app-ui-design409—~2kAutomated safety check: PassNone
Marionette Flutter Drive Appleancodepl/marionette_mcp482—~11kAutomated safety check: PassApache-2.0

Similar skills

  • Add, complete, or audit a locale across a Flutter application's ARB catalogs and a localized Docusaurus manual, including generated localization code, locale selectors, native platform declarations…

    1.2k GitHub stars~1.2k tokensUpdated today
    MobileAuto-check passed
  • Tm Launcher Design

    Far-Se/tabame

    Create or revise Tabame's Flutter launcher designs: frames, search bars, result rows, palettes, typography, and action dialogs.

    372 GitHub stars~3.1k tokensUpdated today
    MobileAuto-check passed
  • Flutter Init

    bear2u/my-skills

    A skill your agent uses when user wants to create a new Flutter project (Todo/Habit/Note/Expense/Custom domain) with Clean Architecture, Riverpod 3.0, Drift, and modern Flutter stack

    932 GitHub stars~2.5k tokensUpdated 3 mo ago
    MobileAuto-check passed
  • Mobile App UI Design

    ceorkm/mobile-app-ui-design

    Design high-quality mobile app UI/UX screens, flows, and components.

    409 GitHub stars~2k tokensUpdated 3 mo ago
    MobileAuto-check passed
  • Marionette Flutter Drive App

    leancodepl/marionette_mcp

    Set up and drive a running Flutter app (debug or profile) with Marionette — an AI agent's hands and eyes for the app.

    482 GitHub stars~11k tokensUpdated 4 days ago
    MobileAuto-check passed
  • Flutter Screenshot

    JustLookAtNow/pt_mate

    Capture and show two Flutter UI screenshots for this project: one landscape/large-screen preview and one portrait/mobile preview, without using Flutter Web.

    503 GitHub stars~511 tokensUpdated 4 days ago
    MobileAuto-check passed

More from MADTeacher/mad-agents-skills

All 11 skills in this repo
  • Flutter Internationalization

    MADTeacher/mad-agents-skills

    Add, fix, audit, and maintain Flutter internationalization with gen-l10n, ARB files, AppLocalizations, flutterlocalizations, intl formatting, plural/select messages, RTL support, locale-specific…

    110 GitHub stars~1.7k tokensUpdated 5 mo ago
    Auto-check passed
  • Flutter Networking

    MADTeacher/mad-agents-skills

    Implement, fix, debug, review, or refactor Flutter networking code for HTTP/REST APIs, WebSocket realtime flows, authentication and token refresh, request headers, timeouts, retries, JSON parsing…

    110 GitHub stars~1.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Agents Md Generator

    MADTeacher/mad-agents-skills

    Create, generate, update, repair, trim, or split minimal AGENTS.md files for repository roots and confirmed nested modules using progressive disclosure.

    110 GitHub stars~1.4k tokensUpdated 5 mo ago
    Auto-check passed
  • Dart Drift

    MADTeacher/mad-agents-skills

    Build, fix, audit, and migrate Drift persistence in Dart CLI, server-side, and non-Flutter desktop apps.

    110 GitHub stars~1.2k tokensUpdated 5 mo ago
    Auto-check passed
  • Flutter Duit Bdui

    MADTeacher/mad-agents-skills

    Integrate, fix, review, migrate, test, or debug Duit / flutterduit backend-driven UI in Flutter applications.

    110 GitHub stars~1.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Flutter Testing

    MADTeacher/mad-agents-skills

    Write, fix, review, debug, and validate Flutter tests for apps, packages, and plugins.

    110 GitHub stars~1.5k tokensUpdated 5 mo ago
    Auto-check passed

Works with

Categories

Questions about Flutter Architecture

What does Flutter Architecture do?

Design, refactor, review, or implement Flutter app architecture using MVVM, layered UI/Data/optional Domain boundaries, feature-first or layer-first project structure, repositories, services…. Flutter Architecture is an agent skill from MADTeacher/mad-agents-skills. Design, refactor, review, or implement Flutter app architecture using MVVM, layered UI/Data/optional Domain boundaries, feature-first or layer-first project structure, repositories, services, dependency injection, Result and Command patterns, offline-first or optimistic UI flows.

When should I use Flutter Architecture?

Flutter Architecture fits situations like: asked to add a Flutter feature; audit layer dependencies; fix cross-feature imports; migrate to feature-first.

How do I install Flutter Architecture in Claude Code?

Run `npx skills add MADTeacher/mad-agents-skills --skill flutter-architecture -a claude-code`. Or copy the skill folder (flutter-architecture in MADTeacher/mad-agents-skills) into .claude/skills/flutter-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Flutter Architecture in Codex?

Run `npx skills add MADTeacher/mad-agents-skills --skill flutter-architecture -a codex`. Or copy the skill folder (flutter-architecture in MADTeacher/mad-agents-skills) into .agents/skills/flutter-architecture in your project. Codex loads it when a task matches its description.

Can I use Flutter Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MADTeacher/mad-agents-skills --skill flutter-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flutter-architecture, .gemini/skills/flutter-architecture, .github/skills/flutter-architecture and .opencode/skills/flutter-architecture in your project.

What does Flutter Architecture need to run?

Going by SKILL.md and its folder, Flutter Architecture needs Dart for the scripts in its folder and the command-line tools its instructions call (flutter).

Does Flutter Architecture access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Flutter Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Flutter Architecture use?

Flutter Architecture is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter Architecture use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.6k tokens, read only when the agent opens those files.

What are the alternatives to Flutter Architecture?

Skills that share tags, products or a category with Flutter Architecture: Add Flutter Docusaurus Locale (matthiasn/lotti, 1.2k stars), Tm Launcher Design (Far-Se/tabame, 372 stars), Flutter Init (bear2u/my-skills, 932 stars) and Mobile App UI Design (ceorkm/mobile-app-ui-design, 409 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Architecture?

MADTeacher (a GitHub user) maintains it in MADTeacher/mad-agents-skills, which has 110 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on May 1, 2026.

Source: MADTeacher/mad-agents-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.