Agent skill

Flutter Expert

by FNOSP in FNOSP/FlyNarwhal

A skill your agent uses when building cross-platform applications with Flutter 3+ and Dart.

MITAuto-check passedMobile

Install Flutter Expert

skills CLI
$ npx skills add FNOSP/FlyNarwhal --skill flutter-expert -a claude-code

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

GitHub CLI
$ gh skill install FNOSP/FlyNarwhal flutter-expert --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/FNOSP/FlyNarwhal.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/flutter-expert .claude/skills/flutter-expert && 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-expert
GitHub stars
495
Used in
2 other repos
Token cost
~758 tokens
SKILL.md length
275 words
Files
7 (incl. references)
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when building cross-platform applications with Flutter 3+ and Dart.

  • Works in 5 steps: Setup - Project structure, dependencies,… → State - Riverpod providers or Bloc setup → Widgets - Reusable, const-optimized… → …
  • Building cross-platform applications with Flutter 3+ and Dart
  • SKILL.md covers Role Definition, When to Use This Skill, Core Workflow and Reference Guide, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flutter Expert is an agent skill from FNOSP/FlyNarwhal. Use when building cross-platform applications with Flutter 3+ and Dart. Invoke for widget development, Riverpod/Bloc state management, GoRouter navigation, platform-specific implementations, performance optimization.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/bloc-state.md`, `references/gorouter-navigation.md` and `references/performance.md`).

It sits in Mobile, covering Cross-platform mobile apps and State management. It works with Flutter and Dart. The repository describes itself as: 基于 Flutter 框架开发的适用于飞牛影视的跨平台客户端. The licence is MIT.

When your agent uses it

  • Building cross-platform applications with Flutter 3+ and Dart
  • Tasks that involve Cross-platform mobile apps
  • Tasks that involve State management

Example prompts

  • “/flutter-expert”

Workflow steps

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

  1. Setup - Project structure, dependencies, routing
  2. State - Riverpod providers or Bloc setup
  3. Widgets - Reusable, const-optimized components
  4. Test - Widget tests, integration tests
  5. Optimize - Profile, reduce rebuilds

What it can do on your machine

Read from SKILL.md and the folder at commit c94d847. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

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

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 FNOSP/FlyNarwhal at commit c94d847, republished under its MIT licence (© FNOSP). 275 words, ~758 tokens.

Download SKILL.mdSave it as .claude/skills/flutter-expert/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
flutter-expert
description
Use when building cross-platform applications with Flutter 3+ and Dart. Invoke for widget development, Riverpod/Bloc state management, GoRouter navigation, platform-specific implementations, performance optimization.
license
MIT
metadata.author
https://github.com/Jeffallan
metadata.version
1.0.0
metadata.domain
frontend
metadata.triggers
Flutter, Dart, widget, Riverpod, Bloc, GoRouter, cross-platform
metadata.role
specialist
metadata.scope
implementation
metadata.output-format
code
metadata.related-skills
react-native-expert, test-master, fullstack-guardian

Flutter Expert

Senior mobile engineer building high-performance cross-platform applications with Flutter 3 and Dart.

Role Definition

You are a senior Flutter developer with 6+ years of experience. You specialize in Flutter 3.19+, Riverpod 2.0, GoRouter, and building apps for iOS, Android, Web, and Desktop. You write performant, maintainable Dart code with proper state management.

When to Use This Skill

  • Building cross-platform Flutter applications
  • Implementing state management (Riverpod, Bloc)
  • Setting up navigation with GoRouter
  • Creating custom widgets and animations
  • Optimizing Flutter performance
  • Platform-specific implementations

Core Workflow

  1. Setup - Project structure, dependencies, routing
  2. State - Riverpod providers or Bloc setup
  3. Widgets - Reusable, const-optimized components
  4. Test - Widget tests, integration tests
  5. Optimize - Profile, reduce rebuilds

Reference Guide

Load detailed guidance based on context:

TopicReferenceLoad When
Riverpodreferences/riverpod-state.mdState management, providers, notifiers
Blocreferences/bloc-state.mdBloc, Cubit, event-driven state, complex business logic
GoRouterreferences/gorouter-navigation.mdNavigation, routing, deep linking
Widgetsreferences/widget-patterns.mdBuilding UI components, const optimization
Structurereferences/project-structure.mdSetting up project, architecture
Performancereferences/performance.mdOptimization, profiling, jank fixes

Constraints

MUST DO
  • Use const constructors wherever possible
  • Implement proper keys for lists
  • Use Consumer/ConsumerWidget for state (not StatefulWidget)
  • Follow Material/Cupertino design guidelines
  • Profile with DevTools, fix jank
  • Test widgets with flutter_test
MUST NOT DO
  • Build widgets inside build() method
  • Mutate state directly (always create new instances)
  • Use setState for app-wide state
  • Skip const on static widgets
  • Ignore platform-specific behavior
  • Block UI thread with heavy computation (use compute())

Output Templates

When implementing Flutter features, provide:

  1. Widget code with proper const usage
  2. Provider/Bloc definitions
  3. Route configuration if needed
  4. Test file structure

Knowledge Reference

Flutter 3.19+, Dart 3.3+, Riverpod 2.0, Bloc 8.x, GoRouter, freezed, json_serializable, Dio, flutter_hooks

© FNOSP, 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 6 other files (references) in .agents/skills/flutter-expert of FNOSP/FlyNarwhal.

  • SKILL.md
  • references/bloc-state.md
  • references/gorouter-navigation.md
  • references/performance.md
  • references/project-structure.md
  • references/riverpod-state.md
  • references/widget-patterns.md

Open the folder on GitHubat commit c94d847

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in FNOSP/FlyNarwhal, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Flutter Expert 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 Expert compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flutter Expert this skillFNOSP/FlyNarwhal4952 repos~758Automated safety check: PassMIT
Flutter Bloc and Cubitandrewyng/context-hub14k—~998Automated safety check: PassMIT
Flutter Riverpod State Managementandrewyng/context-hub14k—~1.1kAutomated safety check: PassMIT
BlocVeryGoodOpenSource/vgv-ai-flutter-plugin169—~2kAutomated safety check: PassMIT
Flutter Dart Code Reviewaffaan-m/ECC274k2 repos~5.8kAutomated safety check: NotesMIT
Signals for Flutterrodydavis/signals.dart819—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • Flutter Bloc and Cubit

    andrewyng/context-hub

    Helps choose between Bloc and Cubit in Flutter and sets defaults for packages, lifecycle, widget binding and tests.

    14k GitHub stars~998 tokensUpdated 4 mo ago
    MobileAuto-check passed
  • Guides Flutter state management with Riverpod: choosing provider types, wiring ConsumerWidgets, handling async state and lifecycle, and overriding providers in tests.

    14k GitHub stars~1.1k tokensUpdated 4 mo ago
    MobileAuto-check passed
  • Bloc

    VeryGoodOpenSource/vgv-ai-flutter-plugin

    Best practices for Bloc state management in Flutter/Dart, covering Cubit versus Bloc, event and state naming, sealed classes with Equatable, the Page/View split with BlocProvider, BlocBuilder…

    169 GitHub stars~2k tokensUpdated yesterday
    MobileAuto-check passed
  • Library-agnostic Flutter/Dart code review checklist covering widget best practices, state management patterns (BLoC, Riverpod, Provider, GetX, MobX, Signals), Dart idioms, performance…

    274k GitHub starsUsed in 2 repos~5.8k tokens
    MobileAuto-check: notes
  • Signals for Flutter

    rodydavis/signals.dart

    Reference for the signals_flutter package: reactive signals, computed values, effects, async signals and collection signals bound to Flutter widgets.

    819 GitHub stars~1.9k tokensUpdated 23 days ago
    MobileAuto-check passed
  • Signals Core Advanced Primitives

    rodydavis/signals.dart

    Reference for the advanced parts of Dart's signals_core: reactive primitives, async signals, reactive collections and utility types, with a linked page for each.

    819 GitHub stars~1.7k tokensUpdated 23 days ago
    DevelopmentAuto-check passed

More from FNOSP/FlyNarwhal

All 8 skills in this repo
  • GitHub Actions Creator

    FNOSP/FlyNarwhal

    A skill your agent uses when the user wants to create, generate, or set up a GitHub Actions workflow.

    495 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Automate GitHub workflows with AI assistance. An agent skill from FNOSP/FlyNarwhal.

    495 GitHub starsUsed in 7 repos~5.4k tokens
    Auto-check passed
  • Flutter Tester

    FNOSP/FlyNarwhal

    A skill your agent uses when creating, writing, fixing, or reviewing tests in a Flutter project.

    495 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Release Publishing

    FNOSP/FlyNarwhal

    A skill your agent uses when publishing a new release of FlyNarwhal desktop.

    495 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Remote API Development

    FNOSP/FlyNarwhal

    A skill your agent uses when adding, modifying, or refactoring any remote/HTTP API call in this Flutter project.

    495 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Swift Expert

    FNOSP/FlyNarwhal

    A skill your agent uses when building iOS/macOS applications with Swift 5.9+, SwiftUI, or async/await concurrency.

    495 GitHub stars~813 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Flutter Expert

What does Flutter Expert do?

A skill your agent uses when building cross-platform applications with Flutter 3+ and Dart. Flutter Expert is an agent skill from FNOSP/FlyNarwhal. Use when building cross-platform applications with Flutter 3+ and Dart.

When should I use Flutter Expert?

Flutter Expert fits situations like: building cross-platform applications with Flutter 3+ and Dart; tasks that involve Cross-platform mobile apps; tasks that involve State management.

How do I install Flutter Expert in Claude Code?

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

How do I install Flutter Expert in Codex?

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

Can I use Flutter Expert 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 FNOSP/FlyNarwhal --skill flutter-expert -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-expert, .gemini/skills/flutter-expert, .github/skills/flutter-expert and .opencode/skills/flutter-expert in your project.

What does Flutter Expert need to run?

SKILL.md names no scripts, command-line tools or credentials: Flutter Expert is instructions for the agent only.

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

Flutter Expert is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Flutter Expert use?

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

What are the alternatives to Flutter Expert?

Skills that share tags, products or a category with Flutter Expert: Flutter Bloc and Cubit (andrewyng/context-hub, 14k stars), Flutter Riverpod State Management (andrewyng/context-hub, 14k stars), Bloc (VeryGoodOpenSource/vgv-ai-flutter-plugin, 169 stars) and Flutter Dart Code Review (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flutter Expert?

FNOSP (a GitHub organization) maintains it in FNOSP/FlyNarwhal, which has 495 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 6, 2026.

Source: FNOSP/FlyNarwhal on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.