flutter-setup-declarative-routing Skill for Claude: What It Does and How to Install It

Makes Claude set up go_router in a Flutter app, including deep links for Android and iOS and tabs that keep their state.

Installs: 38.7K; on skills.sh
Stars: 3.1K; on GitHub
Updated: Nov 2026; last repo commit

This is the Flutter team's routing skill. Claude installs go_router, defines a GoRouter, plugs it into MaterialApp.router and sets the web URL strategy so addresses lose the #.

It also walks through deep link setup for Android and iOS, and nested navigation with StatefulShellRoute. Several steps edit native files and need a domain you control.

Good for

Flutter developers building web apps that need clean URLs and browser history
Mobile teams adding Android and iOS deep links
Anyone adding a bottom navigation bar that remembers each tab

Install flutter-setup-declarative-routing

Claude Code

Copy this prompt.

Install the flutter-setup-declarative-routing skill in Claude Code. Run this command:

npx skills add https://github.com/flutter/agent-plugins --skill flutter-setup-declarative-routing

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Configure `MaterialApp.router` using a package like `go_router` for advanced URL-based navigation. Use when developing web applications or mobile apps that require specific deep linking and browser history support.

Sections in SKILL.md

Contents
Core Concepts
Workflow: Initializing the Application and Router
Task Progress
1. Scaffold the Application
2. Configure the Router
Workflow: Configuring Platform Deep Linking
Task Progress
If configuring for Android:
If configuring for iOS:
Validation Loop
Workflow: Implementing Nested Navigation
Task Progress
Examples
High-Fidelity Shell Widget Implementation
Programmatic Navigation

Key facts

Author: Flutter team
License: BSD-3-Clause
Installs on skills.sh: 38,725 (Nov 2, 2026)
GitHub stars: 3,136 for the whole flutter/agent-plugins repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
What it includes: 1 file: SKILL.md (no scripts)
Needs: A Flutter project. Deep links need a domain where you can host assetlinks.json and apple-app-site-association
Part of: flutter/agent-plugins, which lists 10 Flutter skills in its README
Works in: Not listed. The README names no supported clients and links to docs.flutter.dev/ai/get-started for setup in your preferred agent

What it includes

Creates the app, adds go_router and builds a GoRouter
Runs flutter create and flutter pub add go_router, calls usePathUrlStrategy() and binds the router to MaterialApp.router. Auth redirects use the redirect parameter.
Try: “Set up GoRouter with paths for home, details and settings.”
Runs code · Initialise the router
Adds an intent filter and an assetlinks.json file
Edits AndroidManifest.xml with an autoVerify intent filter and gives the assetlinks.json you host at /.well-known/.
Write · Android deep links
Edits Info.plist, entitlements and the AASA file
Turns on FlutterDeepLinkingEnabled, adds the associated domain to Runner.entitlements and gives the apple-app-site-association JSON to host.
Write · iOS deep links
Tests links with adb and xcrun
Opens a test URL on an Android device with adb and on a booted iOS simulator with xcrun simctl openurl.
Runs code · Validate links
Builds tabs with StatefulShellRoute.indexedStack
Creates one StatefulShellBranch per tab and a shell widget with a NavigationBar that keeps each branch's state.
Write · Nested navigation
Uses context.go, push, goNamed and pop
Explains when to replace the route stack with go and when to add to it with push.
Write · Programmatic navigation

From the official docs

Permissions

Medium risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It edits native Android and iOS config files
Deep link setup changes AndroidManifest.xml, Info.plist and Runner.entitlements. Review each diff. github.com
It runs adb and xcrun against your device or simulator
The validation step opens a test URL in your app on a connected Android device or a booted iOS simulator. Use a test device. github.com
You host the link files yourself
The skill only provides the file contents. Publishing them on your domain is a step you do. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. Use version control.
Talks to	Package downloads when flutter pub add runs. Your domain must serve assetlinks.json and apple-app-site-association; the skill gives the contents to host
Sign-in and keys	SKILL.md does not mention any account or key.
Scopes	Edits AndroidManifest.xml, Info.plist, Runner.entitlements, pubspec.yaml and Dart files Runs flutter create, flutter pub add, adb and xcrun

Questions

What does the flutter-setup-declarative-routing skill do?

It guides Claude through URL-based navigation in Flutter with go_router. That covers the router config, platform deep links and tab navigation that keeps state.

How do I install flutter-setup-declarative-routing?

Use the install box at the top of this page. The skill is one SKILL.md file, so there is nothing else to download. Start a new session afterwards so it loads.

Does it only work with go_router?

Yes. The description says "a package like go_router", but every step and example uses go_router.

Do I need my own domain for deep links?

For deep links, yes. Android and iOS link verification need assetlinks.json and apple-app-site-association served from your domain. The skill gives the file contents but you host them. Plain in-app routing does not need a domain.

What if I already use a deep linking plugin like app_links?

The skill notes that with a third-party deep linking plugin you should set FlutterDeepLinkingEnabled to NO in Info.plist to avoid conflicts.

Is flutter-setup-declarative-routing safe?

It edits your project and runs commands, so review each step. It changes AndroidManifest.xml, Info.plist and Runner.entitlements, and runs adb or xcrun against a device or simulator. Keep the project under version control so you can undo edits.

Does flutter-setup-declarative-routing work in Codex or Cursor?

The README does not list supported clients. It links to https://docs.flutter.dev/ai/get-started for installing the plugins in your preferred agent, so follow that guide for Codex or Cursor.

Information

updated Nov 2, 2026

Repository: flutter/agent-plugins
Folder: skills/flutter-setup-declarative-routing

flutter/agent-plugins skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

flutter-setup-declarative-routing SKILL.md · github.com
Flutter agent-plugins README · github.com