flutter / skills
✓ Official★ 2,600A skill package that teaches your agent 13 capabilities — every one documented and browsable below, no GitHub required · by flutter.
Each skill below is one capability this package teaches your agent. Install the whole package, or open a skill to install just that one.
Instructions for adding a new validation rule and CLI flag to dart_skills_lint.
1 file — installable on its own
Use the dart_skills_lint CLI to validate skills. Choose the appropriate workflow based on your environment:
1 file — installable on its own
Mandatory checks to run before completing any task that touches md files or dart code in this repository.
1 file — installable on its own
Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project,…
1 file — installable on its own
Adds interactive widget previews to the project using the previews.dart system. Use when creating new UI components or updating existing screens to ensure…
1 file — installable on its own
Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating…
1 file — installable on its own
Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.
1 file — installable on its own
Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on…
1 file — installable on its own
Fixes Flutter layout errors (overflows, unbounded constraints) using Dart and Flutter MCP tools. Use when addressing "RenderFlex overflowed", "Vertical…
1 file — installable on its own
Create model classes with `fromJson` and `toJson` methods using `dart:convert`. Use when manually mapping JSON keys to class properties for simple data…
1 file — installable on its own
Configure `MaterialApp.router` using a package like `go_router` for advanced URL-based navigation. Use when developing web applications or mobile apps that…
1 file — installable on its own
Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when…
1 file — installable on its own
Use the `http` package to execute GET, POST, PUT, or DELETE requests. Use when you need to fetch from or send data to a REST API.
1 file — installable on its own
Flutter Agent Skills
Agent skills for Flutter, maintained by the Flutter team. A collection of skills providing tailored instructions for happy path Flutter app development workflows. By giving the agent actual domain expertise and repeatable workflows, you drastically reduce mistakes and ensure agents reliably complete the task following best practices.
Skills are essentially simple folders of files that can be seen as complementary to MCP, where MCP gives an agent access to specialized tools and a Skill teaches the agent “how” to use tools for a specific task.
You can also install the Agent Skills for Dart for Dart tasks.
Installation
To install all skills into your project, run the following command.
The --agent universal flag puts it in the standard .agents/skills
folder that most agents use.
npx skills add flutter/skills --skill '*' --agent universal --yesUpdating Skills
To update, run the following command:
npx skills updateAvailable Skills
| Skill | Description | Example prompt |
|---|---|---|
| flutter-add-integration-test | Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project, exploring UI components via MCP, or automating user flows with the integration_test package. | Add an integration test that validates the checkout experience |
| flutter-add-widget-preview | Adds interactive widget previews to the project using the previews.dart system. Use when creating new UI components or updating existing screens to ensure consistent design and interactive testing. | Create a preview for the ProductCard widget with different price states |
| flutter-add-widget-test | Implement a component-level test using WidgetTester to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating that a specific widget displays correct data and responds to events as expected. | Add a widget test for the CustomButton to verify the onTap callback is called |
| flutter-apply-architecture-best-practices | Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability. | Refactor the authentication flow to follow the recommended layered architecture |
| flutter-build-responsive-layout | Use LayoutBuilder, MediaQuery, or Expanded/Flexible to create a layout that adapts to different screen sizes. Use when you need the UI to look good on both mobile and tablet/desktop form factors. | Make the home screen responsive so it displays a grid on tablets and a list on phones |
| flutter-fix-layout-issues | Fixes Flutter layout errors (overflows, unbounded constraints) using Dart and Flutter MCP tools. Use when addressing "RenderFlex overflowed", "Vertical viewport was given unbounded height", or similar layout issues. | Fix the overflow error on the profile page when the keyboard is visible |
| flutter-implement-json-serialization | Create model classes with fromJson and toJson methods using dart:convert. Use when manually mapping JSON keys to class properties for simple data structures. | Implement JSON serialization for the User model class |
| flutter-setup-declarative-routing | 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. | Set up GoRouter with paths for home, details, and settings |
| flutter-setup-localization | Add flutter_localizations and intl dependencies, enable "generate true" in pubspec.yaml, and create an l10n.yaml configuration file. Use when initializing localization support for a new Flutter project. | Setup localization and add English and Spanish translations |
| flutter-use-http-package | Use the http package to execute GET, POST, PUT, or DELETE requests. Use when you need to fetch from or send data to a REST API. | Use the http package to fetch the list of products from the API |
Contributing
We aren't accepting pull requests at this time, but we would love to hear your feedback!
Please see CONTRIBUTING.md for more information.
Code of Conduct
Please see CODE_OF_CONDUCT.md for more information.
Install the whole package (13 skills):
npx skills add https://github.com/flutter/skillsOr install a single skill:
npx skills add https://github.com/flutter/skills --skill <name>Pick the skill name from the Skills tab — each entry there installs independently.