flutter

Mandatory checks to run before completing any task that touches md files or dart code in this repository.

Instructions for adding a new validation rule and CLI flag to dart_skills_lint. Use this skill when asked to create a new rule that validates aspects of skills (like frontmatter metadata).

How to integrate, update, and configure the dart_skills_lint validation tool within a repository. Make sure to use this skill whenever the user asks to update dart_skills_lint, configure skills validation tests, fix skills linter dependency drifts, verify repository state before editing, optimize lint rules execution, or draft pull request submission commands.

A deliberately broken fixture used by example/README.md to show what each rule's error output looks like.

Reference fixture for dart_skills_lint. Demonstrates a SKILL.md that passes every default rule: hyphen-lowercase name matching the parent directory, a properly sized description, and no other frontmatter fields that would trigger the disallowed-field check.

Use this skill when you need to set up validation for AI agent skills in a Dart project for the first time. Adds the linter as a dev_dependency, creates a configuration file, and generates a baseline for legacy repos.

Use this skill when you need to validate AI agent skills with dart_skills_lint — running the linter, interpreting failures, fixing violations, and authoring custom rules.

Contains well-defined rules for creating natural, accurate, and readable writing. Use whenever authoring longer text, like analysis documents, PR or CL descriptions, or documentation.

Add a new unit test for a class that currently lacks one or add a new test case to an existing test file, verifying improvement with Kover.

Ensure the plugin's custom UI components are accessible to users with screen readers and other assistive technologies.

Optimize plugin size and security by removing unused dependencies and updating outdated libraries.

Prevent UI freezes and ensure a responsive user experience by validating threading rules and migrating blocking calls off the Event Dispatch Thread (EDT).

Reduce technical debt and improve code quality by systematically resolving static analysis warnings.

Reduce plugin size by scanning resources/icons and removing unreferenced assets.

Optimize memory usage, consistency, and performance by migrating standard Java/Kotlin classes to IntelliJ's specialized com.intellij.util implementations.

Eliminate plugin verification warnings and errors (Internal API usage, Override-only API usage, etc.) identified by ./gradlew verifyPlugin.

Automate shepherding, updating, and landing both your own open PRs and approved third-party contributor PRs in the flutter/flutter repository. When to use: - When you need to check the status of your open PRs or approved third-party PRs. - When you need to update stale branches or apply the 'autosubmit' label to land approved PRs. When not to use: - Do not use for PRs that are not approved (unless they are your own and you want to check status). - Do not use for repositories other than flutter/flutter.

How to land a formal cherry-pick of a merged PR for the flutter/flutter repo stable or beta channel. Only use for flutter/flutter landed pull requests. Only use when the cherry pick request is into "stable", "beta" or a branch that has the format with flutter-<major>.<minor>-candidate.0.

Contains well-defined rules for creating natural, accurate, and readable writing. Use whenever authoring longer text, like analysis documents, PR or CL descriptions, or documentation.

Upgrades Flutter's Android SDK dependency to a new Android API version (or preview/canary release) in packages.txt, verifies CIPD tag uniqueness, and packages/uploads the binaries using create_cipd_packages.sh across macOS, Linux, and Windows. Use whenever a user wants to pick up a new version of Android or upload Android SDK packages to CIPD.

Expertise in analyzing flake github issues in the flutter/flutter repository. Use when a user wants to analyze the flakiness of a specific link to a flutter github issue.

Rebuilds the Flutter tool and CLI. Use when a user asks to compile, update, regenerate, or rebuild the Flutter tool or CLI.

A skill to find the lowest Dart and Flutter release containing a given commit. Use this skill whenever users ask about when a commit landed in Flutter or Dart releases, inquire about release versions for specific SHAs, or want to know if a commit is included in stable, beta, or dev channels for Flutter/Dart projects.

Parse failures from Dart and Flutter test logs.

Executes the required pre-push steps for the flutter/packages repository. Call this tool immediately whenever the user asks to push, asks if the user/you are ready to push, or wants to validate their local changes are ready to become a pull request.

Run this skill to check if the repository is ready for new work. Use this skill whenever the user asks to "check readiness", "see if we are ready to start work", or when starting a new task in the camera_android_camerax package.

Write and organize unit tests for functions, methods, and classes using `package:test`. Use when creating new logic or fixing bugs to ensure code remains correct and regression-free.

Collect coverage using the coverage packge and create an LCOV report

Define and generate mock objects for external dependencies using `package:mockito` and `build_runner`. Use when unit testing classes that depend on complex external services like APIs or databases.

Execute `dart analyze` to identify warnings and errors, and use `dart fix --apply` to automatically resolve mechanical lint issues. Use during development to ensure code quality and before committing changes.

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.

Find and close obsolete, stale, or not reproducible issues in the flutter/devtools repository.

Use when documenting changes in CHANGELOG.md files for devtools_shared, devtools_app_shared, or devtools_extensions.

Guides updating dependency versions in published packages to avoid mono-repo resolution failures.

Adds copyright headers to files based on file type. Use when creating new files or when asked to verify copyright headers.

Adds user-facing change descriptions to DevTools release notes. Use when documenting improvements, fixes, or new features in the NEXT_RELEASE_NOTES.md file.

Guides the creation of high-quality, effective skills for agentic workflows. Use when creating or modifying skills in the .agents/skills/ directory.

Prepare a pull request by running presubmit with fixes. Use when preparing to commit or send a PR.

Creates a shell script to build and run the Flutter web app on Cloud Shell using a local HTTP server.

Execute Step 3 of the GenUI Workshop, creating the empty Flutter project and adding dependencies.

Execute Step 4 of the GenUI Workshop, setting up the GenUI scaffolding and initial chat interface.

Execute Step 5 of the GenUI Workshop, integrating the GenUI package into the Flutter app.

Execute Step 6 of the GenUI Workshop, creating the weather input widget and updating the system prompt.

Execute Step 7 of the GenUI Workshop, creating the weather card widget and fake forecast data.

Orchestrates the discovery, mapping, design, and implementation of a premium Flutter-based frontend for an Agent Development Kit (ADK) agent written with Python.

Add or update a dart_mappable data model in lib/src/models/content/, including adding format validation, regenerating code, and adding tests. Use when adding a new content type or modifying an existing model's fields.

Extracts a part of a website and converts it to a Jaspr component. Use when you need to migrate a part of a website to Jaspr.

Extracts YouTube transcripts and generates professional Flutter showcase blog posts in Markdown format. Use when you need to create a technical marketing case study from a video success story.

Update and maintain the llms.txt file. Use when the user wants to add sections, add links, correct information, or review the llms.txt file.

Proofreads Markdown files against Google guidelines.

Stages the Flutter site locally. This includes checking for broken links, verifying excerpts, updating formatting, and serving the dev site.

Development helper for the GenUI repository. Use this skill when the user asks about GenUI workflows, running tests, creating components, finding A2UI or Dart references, or adhering to repository standards.

Use this skill when the user asks to create a new CatalogItem, data class, and/or widget class based on a JSON Schema definition in an application that uses Flutter's `genui` package.

Use this skill when the user asks to integrate the genui package and get a simple conversation going with Firebase AI Logic.

Copy JetBrains LSP sources into the Dart plugin and patch them to prevent conflicts and ensure proper configuration.

Perform a pedantic, multi-perspective code review on the current diff or git changes against the styleguide and software engineering best practices.