From 93167de5d6cf110dc5437741cd94360684fdc5fe Mon Sep 17 00:00:00 2001 From: Jess Kuras Date: Mon, 31 Aug 2026 23:00:06 +0000 Subject: [PATCH 1/5] [docs] Add custom agents and Flutter accessibility agent documentation - Add Custom agents to the core capabilities overview in /ai/get-started. - Add Custom agents to the tooling ecosystem overview and comparison matrix in /ai/tools. - Document the Flutter Accessibility (a11y) custom agent (flutter_a11y_agent) and its core review capabilities. - Add usage instructions for invoking the accessibility agent in Antigravity. --- sites/docs/src/content/ai/get-started.md | 9 ++-- sites/docs/src/content/ai/tools.md | 57 +++++++++++++++++++++--- 2 files changed, 58 insertions(+), 8 deletions(-) diff --git a/sites/docs/src/content/ai/get-started.md b/sites/docs/src/content/ai/get-started.md index c618114f1f..df5c615741 100644 --- a/sites/docs/src/content/ai/get-started.md +++ b/sites/docs/src/content/ai/get-started.md @@ -20,16 +20,19 @@ An **agent plugin** bundles the tools and knowledge that an AI assistant needs to understand and modify your Flutter codebase. When you install an official Flutter agent plugin, it connects your assistant -to two core capabilities: +to three core capabilities: -* **[Agent skills](/ai/tools#agent-skills)**: On-demand procedural guides from +* **[Agent skills](/ai/tools#agent-skills)**: on-demand procedural guides from the official Flutter and Dart repositories that teach the assistant how to perform specific tasks, such as creating responsive layouts, managing state, or writing widget tests. * **[Dart and Flutter MCP server](/ai/tools#dart-and-flutter-mcp-server)**: - A Model Context Protocol (MCP) server that connects the assistant to the + a Model Context Protocol (MCP) server that connects the assistant to the Dart SDK, giving it real-time access to analyzer diagnostics, symbol resolution, test runners, and runtime inspection. +* **[Custom agents](/ai/tools#custom-agents)**: specialized assistant personas + tailored for dedicated workflows, such as the Flutter Accessibility (`a11y`) + agent for automated accessibility audits and code remediations. These tools work together automatically: the assistant uses MCP tools to query live project state and static analysis, while using agent skills to guide its diff --git a/sites/docs/src/content/ai/tools.md b/sites/docs/src/content/ai/tools.md index 333a9b4d5d..687061acd2 100644 --- a/sites/docs/src/content/ai/tools.md +++ b/sites/docs/src/content/ai/tools.md @@ -12,18 +12,21 @@ development tasks accurately. ## Tooling ecosystem overview -The Flutter AI tooling ecosystem consists of four complementary components: +The Flutter AI tooling ecosystem consists of five complementary components: -1. **Agent skills**: Task-oriented blueprints that teach assistants how to +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 +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 +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` +4. **Package skills**: skills published directly inside third-party `pub.dev` packages, giving assistants instant expertise on specific libraries. +5. **Custom agents**: specialized agent personas equipped with focused tools + and system instructions for isolated workflows, such as accessibility + auditing. --- @@ -108,6 +111,49 @@ To learn how to install or publish package skills, check out --- +## Custom agents + +**Custom agents** are specialized AI assistants configured with dedicated +system prompts, curated tool sets, and focused skill subsets. + +While agent skills guide general-purpose assistants during active coding, +custom agents run in isolated contexts to perform deep, single-purpose +workflows without cluttering your primary conversation history. + +### Flutter Accessibility agent + +The **Flutter Accessibility (`a11y`) agent** is an official custom agent +designed to audit Flutter widget trees and recommend accessibility +improvements. The accessibility agent is currently available in +[Google Antigravity](https://antigravity.google). + +Key capabilities of the accessibility agent include: + +* **Semantic label inspection**: identifies interactive widgets (such as + `IconButton` or `InkWell`) that lack descriptive semantic labels. +* **Touch target validation**: flags interactive elements with hit test + areas smaller than the recommended 48x48 dp standard. +* **Contrast and visual checks**: highlights potential contrast ratio issues + and missing focus indicators. +* **Automated code remediation**: generates idiomatic Flutter fixes (such as + wrapping widgets in `Semantics` or adjusting tap bounds) that you can review + and accept. + +### Using the accessibility agent in Antigravity + +After installing the official [Dart and Flutter plugin]( +https://antigravity.google/docs/build-with-google/#dart-and-flutter) +in Antigravity, you can invoke the accessibility agent directly when chatting +with Antigravity by selecting the **Flutter Accessibility Agent** from the +agent picker, mentioning `@flutter_a11y_agent`, or asking your assistant to +review your code for accessibility: + +```text +@flutter_a11y_agent Audit this screen for accessibility issues. +``` + +--- + ## When to use what Use the following mental model to understand how different AI mechanisms @@ -119,6 +165,7 @@ interact: | **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 | +| **Custom agent** | Isolated subagent | Dedicated tasks (such as a11y audits) | {:.table .table-striped} From 238e6d4d2931dd5abe52b3ec5352b3e3b0d263b4 Mon Sep 17 00:00:00 2001 From: Jess Kuras Date: Mon, 31 Aug 2026 23:22:06 +0000 Subject: [PATCH 2/5] Address review feedback: use logical pixels and spell out accessibility in table --- sites/docs/src/content/ai/tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sites/docs/src/content/ai/tools.md b/sites/docs/src/content/ai/tools.md index 687061acd2..b17b5adafb 100644 --- a/sites/docs/src/content/ai/tools.md +++ b/sites/docs/src/content/ai/tools.md @@ -132,7 +132,7 @@ Key capabilities of the accessibility agent include: * **Semantic label inspection**: identifies interactive widgets (such as `IconButton` or `InkWell`) that lack descriptive semantic labels. * **Touch target validation**: flags interactive elements with hit test - areas smaller than the recommended 48x48 dp standard. + areas smaller than the recommended 48x48 logical pixels. * **Contrast and visual checks**: highlights potential contrast ratio issues and missing focus indicators. * **Automated code remediation**: generates idiomatic Flutter fixes (such as @@ -165,7 +165,7 @@ interact: | **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 | -| **Custom agent** | Isolated subagent | Dedicated tasks (such as a11y audits) | +| **Custom agent** | Isolated subagent | Dedicated accessibility audits | {:.table .table-striped} From 64e87a9beb58ee3b5e0a39c5a93fe0db639e4637 Mon Sep 17 00:00:00 2001 From: Jess K <49662805+jesskuras@users.noreply.github.com> Date: Mon, 31 Aug 2026 16:43:21 -0700 Subject: [PATCH 3/5] Update sites/docs/src/content/ai/tools.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- sites/docs/src/content/ai/tools.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sites/docs/src/content/ai/tools.md b/sites/docs/src/content/ai/tools.md index b17b5adafb..703cb6d036 100644 --- a/sites/docs/src/content/ai/tools.md +++ b/sites/docs/src/content/ai/tools.md @@ -141,8 +141,8 @@ Key capabilities of the accessibility agent include: ### Using the accessibility agent in Antigravity -After installing the official [Dart and Flutter plugin]( -https://antigravity.google/docs/build-with-google/#dart-and-flutter) +After installing the official +[Dart and Flutter plugin](https://antigravity.google/docs/build-with-google/#dart-and-flutter) in Antigravity, you can invoke the accessibility agent directly when chatting with Antigravity by selecting the **Flutter Accessibility Agent** from the agent picker, mentioning `@flutter_a11y_agent`, or asking your assistant to From 4888d0ec528b16848081558b770ed43e38d4501f Mon Sep 17 00:00:00 2001 From: Jess Kuras Date: Thu, 3 Sep 2026 19:50:27 +0000 Subject: [PATCH 4/5] Address review feedback: adopt specialized agents, code fixes, and drop dedicated --- sites/docs/src/content/ai/get-started.md | 6 +++--- sites/docs/src/content/ai/tools.md | 19 ++++++++++--------- 2 files changed, 13 insertions(+), 12 deletions(-) diff --git a/sites/docs/src/content/ai/get-started.md b/sites/docs/src/content/ai/get-started.md index df5c615741..0aa286dd9f 100644 --- a/sites/docs/src/content/ai/get-started.md +++ b/sites/docs/src/content/ai/get-started.md @@ -30,9 +30,9 @@ to three core capabilities: a Model Context Protocol (MCP) server that connects the assistant to the Dart SDK, giving it real-time access to analyzer diagnostics, symbol resolution, test runners, and runtime inspection. -* **[Custom agents](/ai/tools#custom-agents)**: specialized assistant personas - tailored for dedicated workflows, such as the Flutter Accessibility (`a11y`) - agent for automated accessibility audits and code remediations. +* **[Specialized agents](/ai/tools#specialized-agents)**: focused assistant + personas tailored for dedicated workflows, such as the Flutter Accessibility + (`a11y`) agent for automated accessibility audits and code fixes. These tools work together automatically: the assistant uses MCP tools to query live project state and static analysis, while using agent skills to guide its diff --git a/sites/docs/src/content/ai/tools.md b/sites/docs/src/content/ai/tools.md index 703cb6d036..e099bc67be 100644 --- a/sites/docs/src/content/ai/tools.md +++ b/sites/docs/src/content/ai/tools.md @@ -24,7 +24,7 @@ The Flutter AI tooling ecosystem consists of five complementary components: 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. -5. **Custom agents**: specialized agent personas equipped with focused tools +5. **Specialized agents**: dedicated agent personas equipped with focused tools and system instructions for isolated workflows, such as accessibility auditing. @@ -111,13 +111,14 @@ To learn how to install or publish package skills, check out --- -## Custom agents +## Specialized agents -**Custom agents** are specialized AI assistants configured with dedicated -system prompts, curated tool sets, and focused skill subsets. +**Specialized agents** (referred to as custom agents in platforms like +Antigravity) are AI assistants configured with dedicated system prompts, +curated tool sets, and focused skill subsets. While agent skills guide general-purpose assistants during active coding, -custom agents run in isolated contexts to perform deep, single-purpose +specialized agents run in isolated contexts to perform deep, single-purpose workflows without cluttering your primary conversation history. ### Flutter Accessibility agent @@ -135,14 +136,14 @@ Key capabilities of the accessibility agent include: areas smaller than the recommended 48x48 logical pixels. * **Contrast and visual checks**: highlights potential contrast ratio issues and missing focus indicators. -* **Automated code remediation**: generates idiomatic Flutter fixes (such as +* **Automated code fixes**: generates idiomatic Flutter fixes (such as wrapping widgets in `Semantics` or adjusting tap bounds) that you can review and accept. ### Using the accessibility agent in Antigravity -After installing the official -[Dart and Flutter plugin](https://antigravity.google/docs/build-with-google/#dart-and-flutter) +After installing the official [Dart and Flutter plugin]( +https://antigravity.google/docs/build-with-google/#dart-and-flutter) in Antigravity, you can invoke the accessibility agent directly when chatting with Antigravity by selecting the **Flutter Accessibility Agent** from the agent picker, mentioning `@flutter_a11y_agent`, or asking your assistant to @@ -165,7 +166,7 @@ interact: | **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 | -| **Custom agent** | Isolated subagent | Dedicated accessibility audits | +| **Specialized agent** | Isolated subagent | Accessibility audits | {:.table .table-striped} From e350da63afe73f3ff93d1e4abb129df5779b007c Mon Sep 17 00:00:00 2001 From: Jess Kuras Date: Thu, 3 Sep 2026 19:57:30 +0000 Subject: [PATCH 5/5] Update Flutter Accessibility agent description to official specialized agent --- sites/docs/src/content/ai/tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sites/docs/src/content/ai/tools.md b/sites/docs/src/content/ai/tools.md index e099bc67be..7d430fbf04 100644 --- a/sites/docs/src/content/ai/tools.md +++ b/sites/docs/src/content/ai/tools.md @@ -123,7 +123,7 @@ workflows without cluttering your primary conversation history. ### Flutter Accessibility agent -The **Flutter Accessibility (`a11y`) agent** is an official custom agent +The **Flutter Accessibility (`a11y`) agent** is an official specialized agent designed to audit Flutter widget trees and recommend accessibility improvements. The accessibility agent is currently available in [Google Antigravity](https://antigravity.google).