Skip to content
Get packs

Guide · Agent skill

How to use the Flutter Expert agent skill (flutter-expert)

Updated · written with AI from the project's own documentation and checked against our catalogue data

Flutter Expert is an agent skill: a folder of instructions and reference notes that you add to an AI coding agent so it works on Flutter and Dart projects the way an experienced Flutter engineer would. It is aimed at developers building cross-platform mobile or web apps who want consistent state management, routing and performance habits. After this guide you will know what the skill changes, how to install it, how to ask for help in plain language and what to check before trusting the output.

Flutter ExpertJeffallan/claude-skills · MIT

Quick start

  1. 1Download the ZIP. Download the flutter-expert ZIP from this page.
  2. 2Unzip into a skills folder. Unzip it into ~/.claude/skills/ for personal use, or into your project's .claude/skills/ folder to share it with a repository.
  3. 3Or upload it in the Claude apps. In the Claude apps, open Settings, then Capabilities, then Skills, and upload the skill.
  4. 4Prepare your Flutter environment. Make sure the Flutter SDK, Dart toolchain and Flutter DevTools are available, then run flutter pub get in your project.
  5. 5Ask for what you need. Describe the Flutter task in plain language and name the relevant area, such as Riverpod, Bloc, GoRouter or performance.
  6. 6Verify the result. Check that flutter analyze and flutter test pass, and review the file changes before committing.

What the Flutter Expert skill makes the agent do

Once the skill is loaded, the agent acts like a senior Flutter engineer. It can scaffold Flutter projects, choose between Riverpod and Bloc for state, set up GoRouter navigation and favour const widgets and scoped rebuilds.

The skill also gives the agent a workflow: set up the project, define state, build widgets, test, then profile. At each stage it runs flutter analyze, flutter test and DevTools profiling, and it loads detailed reference notes on a topic when that topic comes up.

  • Riverpod providers and notifiers, or Bloc and Cubit classes
  • GoRouter routes, redirects and deep linking
  • Reusable, const-optimised widgets and Material or Cupertino styling
  • Jank and rebuild fixes using DevTools, the Performance overlay and compute()

How to install the flutter-expert skill

Download the ZIP for this skill from this page and unzip it. You have two places to put it, depending on how you want to use it. A personal install makes the skill available to all your projects. A project install keeps it inside one repository, so teammates who clone the repo get it too.

If you use the Claude apps, you can instead upload the skill under Settings, then Capabilities, then Skills.

  • Personal install: unzip into ~/.claude/skills/ so the flutter-expert folder sits inside it
  • Project install: unzip into the .claude/skills/ folder of your Flutter project
  • Claude apps: go to Settings → Capabilities → Skills and upload the skill
~/.claude/skills/flutter-expert/SKILL.md

How to trigger the skill with natural requests

You do not need a special command. The skill is meant to be picked up when your request touches its topics. The skill's trigger words include Flutter, Dart, widget, Riverpod, Bloc, GoRouter and cross-platform, so naming one of these in your request helps the agent select it.

Describe the outcome you want and mention the Flutter area involved. Be specific about the package you prefer, such as Riverpod or Bloc, if you already have a choice.

  • Set up Riverpod state for a shopping cart in my Flutter app and show the consuming widget.
  • Use GoRouter to add a login redirect and a details route with an id parameter.
  • Our Flutter list screen rebuilds too often while scrolling. Find the cause and fix it.
  • Create a Bloc for a three-step signup wizard with tests.

What the skill needs on your machine

The skill guides code and test work, but the agent runs local Flutter tooling to do it. You therefore need a working Flutter SDK and Dart toolchain. The commands the skill uses are flutter pub get, flutter analyze, flutter test and flutter run --profile. For profiling you also need Flutter DevTools.

Packages such as Riverpod, Bloc and GoRouter are referenced in the guidance and come from pub.dev. The skill itself does not publish or deploy anything.

  • Flutter SDK and Dart toolchain
  • Flutter DevTools for profiling
  • Packages from pub.dev such as Riverpod, Bloc and GoRouter, added to your project
flutter pub get flutter analyze flutter test flutter run --profile

Safety notes: scripts and network

This skill runs scripts. The agent executes local Flutter commands, and those can change files in your project, for example when adding dependencies or fixing lint issues. Review the diff before you commit.

The skill does not use the network itself. Packages are fetched only when the Flutter tooling resolves dependencies, such as during flutter pub get. Keep the project under version control so you can revert any change the agent makes.

  • Runs scripts: yes, through local Flutter tooling
  • Uses network: no, according to the skill's own metadata
  • Use version control and review changes before committing

Example workflow from request to verified code

A typical session follows the skill's workflow. The agent first sets up the project and dependencies, then defines state and runs flutter analyze. If analysis reports problems, it is expected to fix them and re-run until the output is clean.

Next it builds widgets and runs flutter test after each feature. Before you merge, check that coverage has not dropped; the skill uses flutter test --coverage for that. When performance is the issue, it profiles with flutter run --profile and DevTools.

  • Setup: scaffold, flutter pub get, configure routing
  • State: define providers or Bloc classes, then flutter analyze
  • Widgets: build components, then flutter test
  • Test: widget and integration tests, then flutter test --coverage
  • Optimise: flutter run --profile and DevTools
flutter analyze flutter test flutter test --coverage flutter run --profile

Tips and troubleshooting

If analysis errors appear after you add a package, run flutter pub get first, since missing imports are a common cause. If a widget test fails after async state changes, the skill suggests tester.pumpAndSettle() and checking your finders.

If hot reload does not show a change to state held in a Notifier, use a hot restart (R in the terminal) to reset the full app state. For jank, the skill points to RepaintBoundary, compute() for heavy work and const widgets.

  • Build fails after adding a package: check pub.dev compatibility, then try flutter pub upgrade --major-versions
  • Jank or dropped frames: look for expensive build() calls and heavy main-thread work
  • Hot reload not reflecting state changes: use a hot restart

What people use it for

  • Starting a new cross-platform Flutter app with GoRouter routes and a Riverpod state layer
  • Adding Bloc or Cubit state to a feature with complex business logic such as forms or auth
  • Finding and fixing unnecessary widget rebuilds in a slow list or animation screen
  • Writing widget tests for a feature and checking coverage before a merge

Frequently asked questions

How do I install the flutter-expert skill?

Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder. In the Claude apps you can instead upload it under Settings, then Capabilities, then Skills.

Is the flutter-expert skill free to use?

The skill is released under the MIT licence, as stated in its metadata. You still need your own Flutter SDK and tooling, and any packages you add come from pub.dev under their own terms.

What do I need to run the flutter-expert skill?

You need a Flutter SDK and Dart toolchain, since the agent uses commands such as flutter pub get, flutter analyze, flutter test and flutter run --profile. Flutter DevTools is needed for profiling.

Does the flutter-expert skill use the internet?

According to the skill's metadata it does not use the network. It does run scripts, which means the agent executes local Flutter commands that can change project files, so review changes before committing.

Should I pick Riverpod or Bloc with this skill?

The skill's guidance suggests Riverpod for simple mutable state and Bloc for event-driven workflows, forms, auth and feature modules. Name your preference in your request if you already have one.

Can flutter-expert replace React Native or native iOS and Android skills?

No. It is for Flutter and Dart projects and does not apply to React Native or native iOS and Android code. The skill lists react-native-expert as a related skill for that work.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Flutter Expert is a good fit if you build cross-platform apps with Flutter and Dart and want consistent Riverpod or Bloc state, GoRouter routing and help with jank. It is not for non-Flutter projects, and it will not publish or deploy your app, so keep version control in place because the agent's local commands can change files.

Download the skill