Skip to main content

How Flutter AI tools work

Learn how agent skills, the Dart and Flutter MCP server, and package skills interact to assist your development workflow.

Flutter and Dart provide an integrated suite of tools designed to help AI coding assistants understand your codebase, follow best practices, and execute development tasks accurately.

Tooling ecosystem overview

#

The Flutter AI tooling ecosystem consists of four complementary components:

  1. Agent skills: Task-oriented blueprints that teach assistants how to perform specific workflows (such as creating responsive layouts or writing tests).
  2. Dart and Flutter MCP server: A Model Context Protocol (MCP) server exposing real-time SDK diagnostics, symbol resolution, and runtime introspection to assistants.
  3. Developer Knowledge MCP server: A cloud-hosted documentation search server giving assistants direct access to official Flutter and Dart docs.
  4. Package skills: Skills published directly inside third-party pub.dev packages, giving assistants instant expertise on specific libraries.

Agent skills

#

Agent skills provide a standardized way to equip AI assistants with procedural domain expertise.

Progressive disclosure

#

Skills use progressive disclosure to conserve model context:

  • Discovery phase: The assistant initially reads only skill metadata (name and short description) from the .agents/skills directory.
  • Execution phase: When the assistant determines a skill is relevant to your prompt, it loads the complete instructions (SKILL.md) and supporting reference scripts.

Official skills repositories

#
  • flutter/agent-plugins: Provides skills for Flutter development, including widget construction, declarative navigation, responsive design, and state management.
  • dart-lang/skills: Provides skills for Dart development, including unit test authoring, dependency resolution, and static analysis remediation.

Dart and Flutter MCP server

#

The Dart and Flutter MCP server implements the open Model Context Protocol (MCP), connecting AI assistants to live Dart SDK and Flutter tooling over standard I/O (stdio).

Key capabilities provided by the MCP server include:

  • Static analysis & diagnostics: Inspect and fix analyzer errors and warnings across your project.
  • Symbol resolution: Resolve symbols to their definitions, signatures, and documentation.
  • Runtime introspection: Query the state of a running Flutter application during active debugging sessions.
  • Package management: Search pub.dev and manage dependencies in pubspec.yaml.
  • Testing & formatting: Execute unit and widget tests and format code using dart format rules.

Developer Knowledge MCP server

#

While the local Dart and Flutter MCP server focuses on local codebase analysis and runtime debugging, you can also equip your assistant with search access to official online documentation.

The Developer Knowledge MCP server connects AI assistants to Google's developer documentation corpus, including docs.flutter.dev, dart.dev, and official API references. This allows assistants to retrieve up-to-date guides, migration notes, and API references directly during conversation.


Package skills

#

In addition to core Flutter skills, library authors can bundle official skills directly inside their packages on pub.dev.

When you add a dependency to your project, you can discover and install its skills using the skills CLI:

bash
dart run skills@ get

To learn how to install or publish package skills, check out Package skills.


When to use what

#

Use the following mental model to understand how different AI mechanisms interact:

Mechanism Scope and behavior Best suited for
Agent skill On demand Multi-step recipes, patterns
Dart MCP server Local SDK tools Diagnostics, tests, runtime
Developer Knowledge MCP Online search Live docs, API references
Package skill From dependencies Library APIs, code generation

Next steps

#