Agent skill

Flutter Navigation

by MADTeacher in MADTeacher/mad-agents-skills

Implement, fix, refactor, review, migrate, or validate Flutter navigation and routing.

MITAuto-check passedMobile

Install Flutter Navigation

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

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

GitHub CLI
$ gh skill install MADTeacher/mad-agents-skills flutter-navigation --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-navigation .claude/skills/flutter-navigation && 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-navigation
GitHub stars
110
Token cost
~2.1k tokens
SKILL.md length
1,014 words
Files
9 (incl. references, assets)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Implement, fix, refactor, review, migrate, or validate Flutter navigation and routing.

  • Works in 7 steps: Identify the request: simple screen… → Inspect the local Flutter project first… → Choose the smallest routing model that… → …
  • Working with Navigator
  • SKILL.md covers Principle 0, Workflow, Decision Guide and Resource Routing, plus 3 more sections
  • Runs Dart scripts from its folder; calls flutter, dart and xcrun

What it does

Flutter Navigation is an agent skill from MADTeacher/mad-agents-skills. Implement, fix, refactor, review, migrate, or validate Flutter navigation and routing. Use when working with Navigator, MaterialPageRoute, Router API, gorouter, route guards, redirects, ShellRoute or StatefulShellRoute, nested Navigators, passing and returning route data, deep links, Android App Links, iOS Universal Links, custom URI schemes, Flutter web URL strategy, browser history, 404 routing, route tests, or navigation-state bugs.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files and assets (for example `references/deep-linking.md`, `references/go_router-guide.md` and `references/navigation-patterns.md`).

It sits in Mobile, covering Cross-platform mobile apps and Android development. It works with Flutter, Android and iOS. 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

  • Working with Navigator
  • MaterialPageRoute
  • StatefulShellRoute
  • Nested Navigators

Example prompts

  • “/flutter-navigation”

Workflow steps

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

  1. Identify the request: simple screen transition, data passing, returned
  2. Inspect the local Flutter project first when code is available: pubspec.yaml,
  3. Choose the smallest routing model that satisfies the product requirement
  4. Model route data deliberately. Use constructor arguments for local Navigator
  5. Implement in the app's existing style. Preserve stable URLs, route names,
  6. Add or update tests for the changed route behavior when feasible. Cover route
  7. Validate with the strongest local checks available. Report skipped runtime,

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
    • dart
    • xcrun

    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 Navigation loads about 2.1k tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 115 tokens; SKILL.md has 1,014 words of instructions outside code blocks.

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

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). 1,014 words, ~2,125 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-navigation/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
flutter-navigation
description
Implement, fix, refactor, review, migrate, or validate Flutter navigation and routing. Use when working with Navigator, MaterialPageRoute, Router API, go_router, route guards, redirects, ShellRoute or StatefulShellRoute, nested Navigators, passing and returning route data, deep links, Android App Links, iOS Universal Links, custom URI schemes, Flutter web URL strategy, browser history, 404 routing, route tests, or navigation-state bugs.
metadata.author
Stanislav [MADTeacher] Chernyshev
metadata.version
2.0

Flutter Navigation

You are a Flutter navigation implementation agent. Your job is to make route state, browser/deep-link behavior, and screen transitions fit the target app without breaking existing state, auth flows, or platform expectations.

Principle 0

Navigation is user state. Do not replace an app's routing model or add deep-link claims before inspecting the current MaterialApp, Router, Navigator, state-management, auth, supported platforms, and tests. After changing navigation, verify analyzer-clean Dart and the route behaviors affected by the change.

Workflow

  1. Identify the request: simple screen transition, data passing, returned result, route migration, deep-link setup, web browser history, nested tabs or shells, auth redirect, route error handling, or navigation test.
  2. Inspect the local Flutter project first when code is available: pubspec.yaml, lib/, app root, existing route definitions, navigation calls, auth/state providers, platform folders, web hosting config, and relevant tests.
  3. Choose the smallest routing model that satisfies the product requirement:
    • Use Navigator with MaterialPageRoute for local, non-addressable flows in simple apps.
    • Use go_router for deep links, web URLs, browser history, auth redirects, nested navigation, multiple Navigators, or scalable route tables.
    • Avoid new legacy MaterialApp.routes named routes unless preserving a small existing app that already uses them and does not need custom deep-link behavior.
  4. Model route data deliberately. Use constructor arguments for local Navigator pushes, path parameters for required addressable identity, query parameters for optional URL state, and extra only for non-addressable in-memory data.
  5. Implement in the app's existing style. Preserve stable URLs, route names, selected tab state, back behavior, state restoration, analytics observers, and auth redirect semantics unless the user asked to change them.
  6. Add or update tests for the changed route behavior when feasible. Cover route parsing, redirects, shell/tab selection, result returns, and not-found/error screens according to the requested change.
  7. Validate with the strongest local checks available. Report skipped runtime, device, server, or deep-link validation explicitly.

Decision Guide

NeedDefault approach
Push one detail screen and returnNavigator.push<T> with MaterialPageRoute<T>
Share/bookmark/browser routego_router with URL-based locations
Required resource identityPath parameter, for example /users/:userId
Optional filters, tabs, or search stateQuery parameters via Uri(...).toString()
Auth gate or onboarding gatego_router redirect or onEnter, tied to app auth state
Persistent navigation chromeShellRoute; use StatefulShellRoute when branches need independent stacks
Web path URLsusePathUrlStrategy() plus SPA server rewrite to index.html
Native verified web linksAndroid App Links or iOS Universal Links plus hosted association files
Custom app-only URICustom scheme, with explicit security and fallback tradeoffs

Resource Routing

Read only the resources needed for the current task:

TaskRead/usePurpose
Choosing Navigator vs go_router or reviewing route tradeoffsnavigation-patterns.mdApproach comparison, data passing, and browser/deep-link limitations
Implementing or fixing go_router route tables, redirects, shells, errors, named routes, or route datago_router-guide.mdCurrent go_router APIs and common pitfalls
Configuring Android App Links, iOS Universal Links, custom schemes, or deep-link testsdeep-linking.mdPlatform setup, association files, Flutter handler notes, and test commands
Fixing Flutter web URLs, browser history, SPA rewrites, or non-root hostingweb-navigation.mdURL strategies, server rewrites, and web-specific validation
Need a minimal Navigator starternavigator_basic.dartCopy only after adapting class names and app shell
Need a minimal go_router startergo_router_basic.dartCopy only after adding the dependency and adapting routes
Need local data passing with Navigatorpassing_data.dartCopy only after replacing demo model and screen names
Need returned data with Navigatorreturning_data.dartCopy only after handling null/cancelled results appropriately

Do not read every reference by default. Treat references as routed detail and assets as starter examples, not production modules.

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

Implementation Rules

  • Do not mix primary navigation models casually. If the app uses go_router, prefer context.go, context.push, context.goNamed, or context.pushNamed for main app routes. Use imperative Navigator only for local overlays or flows that are intentionally not deep-linkable.
  • Build query-string locations with Uri(path: ..., queryParameters: ...).toString() or go_router named-route APIs. Do not pass a queryParameters argument to context.push or context.go.
  • Read query parameters from state.uri.queryParameters and path parameters from state.pathParameters.
  • Do not store complex state only in a URL. Parse and validate route strings, convert IDs and enum-like values safely, and handle missing or invalid values with redirect, error screen, fallback UI, or 404 behavior.
  • Do not use extra for data that must survive refresh, browser restore, sharing, or a native deep link. If complex extra is required on web, configure a codec or accept that data can be dropped.
  • Keep auth redirects loop-free. Preserve intended destination when login or onboarding should return the user to their original route.
  • For iOS Universal Links, configure Associated Domains in Xcode or ios/Runner/Runner.entitlements, not as an Info.plist route table.
  • For web path strategy, update web/index.html base href and server rewrites when hosting below a non-root path. Do not encode the hosting prefix into every GoRoute.path unless the target app already uses that convention.
  • Do not copy assets blindly. Adapt imports, route names, keys, app shell, package versions, null-safety, lints, and tests to the target project.

Validation

After changing a Flutter project:

  1. Run dart format on edited Dart files.
  2. Run flutter analyze for the project or closest package.
  3. Run focused flutter test suites when route parsing, redirects, shell/tab state, returned results, or navigation UI changed.
  4. For web URL changes, run the app in Chrome when feasible and verify direct load, refresh, back, forward, and not-found behavior for changed routes.
  5. For deep links, test the exact target URLs with adb, xcrun simctl, or Flutter DevTools Deep Links validation when the platform and device are available.
  6. If only this skill's Dart assets changed, validate them in a scratch Flutter app with the required dependencies, then run dart format --output=none --set-exit-if-changed and flutter analyze.

If validation cannot run, report the command, blocker, and the route behavior that remains unverified. Do not present navigation, browser-history, or deep-link behavior as verified from static reading alone.

Fallback

If the target project is unavailable, provide a route plan or patch sketch based only on the user's supplied files and state the missing verification. If the app already has an inconsistent routing model, make the smallest reversible fix first, then propose a staged migration rather than replacing routing wholesale.

© 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-navigation of MADTeacher/mad-agents-skills.

  • SKILL.md
  • assets/go_router_basic.dart
  • assets/navigator_basic.dart
  • assets/passing_data.dart
  • assets/returning_data.dart
  • references/deep-linking.md
  • references/go_router-guide.md
  • references/navigation-patterns.md
  • references/web-navigation.md

Open the folder on GitHubat commit 2fb67e3

Compare with similar skills

Flutter Navigation 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 Navigation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Navigation this skillMADTeacher/mad-agents-skills110—~2.1kAutomated safety check: PassMIT
Developing Mobile Appstelagod/code-abyss244—~258Automated safety check: PassMIT
Senior Mobileborghei/Claude-Skills874—~1.9kAutomated safety check: PassMIT
Compose Multiplatformericrisco/rsc-harness156—~2.7kAutomated safety check: PassMIT
Android Designhashgraph-online/awesome-codex-plugins1.2k—~2.5kAutomated safety check: PassApache-2.0
Cometchatcometchat/cometchat-skills129—~2.9kAutomated safety check: PassMIT

Similar skills

  • Developing Mobile Apps

    telagod/code-abyss

    Mobile development knowledge reference covering iOS (SwiftUI), Android (Jetpack Compose), React Native, and Flutter.

    244 GitHub stars~258 tokensUpdated 2 mo ago
    MobileAuto-check passed
  • Senior Mobile

    borghei/Claude-Skills

    A skill your agent uses when the user asks to "build a mobile app", "scaffold React Native project", "create SwiftUI views", "set up Jetpack Compose", "optimize mobile performance", "configure Expo…

    874 GitHub stars~1.9k tokensUpdated yesterday
    MobileAuto-check passed
  • Compose Multiplatform

    ericrisco/rsc-harness

    A skill your agent uses when building one shared Compose UI in Kotlin across Android, iOS, and desktop — commonMain @Composables, expect/actual, source-set placement, native interop, multiplatform…

    156 GitHub stars~2.7k tokensUpdated yesterday
    MobileAuto-check passed
  • Android Design

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when the user asks for an Android app, Compose UI, Material 3, Material You, Material 3 Expressive, Pixel-style app, foldable/adaptive layout, Play Store deliverable, React…

    1.2k GitHub stars~2.5k tokensUpdated yesterday
    MobileAuto-check passed
  • Cometchat

    cometchat/cometchat-skills

    Entry point for any CometChat task on any platform. An agent skill from cometchat/cometchat-skills.

    129 GitHub stars~2.9k tokensUpdated 2 days ago
    MobileAuto-check passed
  • Mobile Apps Create

    forcedotcom/sf-skills

    The entry point for building any Salesforce native mobile app on iOS or Android.

    1.1k GitHub stars~1.4k tokensUpdated 5 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

Categories

Questions about Flutter Navigation

What does Flutter Navigation do?

Implement, fix, refactor, review, migrate, or validate Flutter navigation and routing. Flutter Navigation is an agent skill from MADTeacher/mad-agents-skills. Implement, fix, refactor, review, migrate, or validate Flutter navigation and routing.

When should I use Flutter Navigation?

Flutter Navigation fits situations like: working with Navigator; materialPageRoute; statefulShellRoute; nested Navigators.

How do I install Flutter Navigation in Claude Code?

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

How do I install Flutter Navigation in Codex?

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

Can I use Flutter Navigation 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-navigation -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-navigation, .gemini/skills/flutter-navigation, .github/skills/flutter-navigation and .opencode/skills/flutter-navigation in your project.

What does Flutter Navigation need to run?

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

Does Flutter Navigation 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 Navigation 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 Navigation use?

Flutter Navigation 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 Navigation use?

About 2.1k tokens (SKILL.md is roughly 8.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 4.8k tokens, read only when the agent opens those files.

What are the alternatives to Flutter Navigation?

Skills that share tags, products or a category with Flutter Navigation: Developing Mobile Apps (telagod/code-abyss, 244 stars), Senior Mobile (borghei/Claude-Skills, 874 stars), Compose Multiplatform (ericrisco/rsc-harness, 156 stars) and Android Design (hashgraph-online/awesome-codex-plugins, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Navigation?

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.