scaffold-flutter-a2ui

Scaffolds an A2UI rendering host for Flutter projects with a cross-platform parity test.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/GQAdonis/artifact-refiner-skill --skill scaffold-flutter-a2ui-gqadonis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scaffold-flutter-a2ui
Source: https://github.com/GQAdonis/artifact-refiner-skill/tree/main/skills/scaffold-flutter-a2ui
Command: npx skills add https://github.com/GQAdonis/artifact-refiner-skill --skill scaffold-flutter-a2ui-gqadonis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires genui, a2ui_core, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Bringing agent-generated UI to Flutter mobile apps requires manually wiring message intake, surface rendering, and version translation, with no guarantee the mobile output matches what web or MCP-UI hosts render. This Skill generates the Flutter A2UI host layer and verifies it against the same document the web host renders. ## Core Features & Use Cases - Flutter A2UI host scaffolding: Emits a surface controller, surface widget, and v1.0-to-v0.9 translation layer under lib/a2ui/ using the genui renderer and a2ui_core message types. - Parity verification: Runs a parity test asserting the Flutter surface produces the same observable output (heading, body text, labelled buttons) as the web and MCP-UI hosts before reporting success. - Use Case: You are building a mobile app whose screens are driven by agent output over AG-UI or MCP-UI. Run the scaffolder against your Flutter project to get a verified rendering host that stays consistent with your web surfaces. ## Quick Start Ask the agent to scaffold an A2UI rendering host into your Flutter project and run the parity test to confirm it matches the web host output.

Frequently Asked Questions about scaffold-flutter-a2ui

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render A2UI agent output in a Flutter app?

Run the scaffold script against your Flutter project to generate an A2UI host layer under lib/a2ui/, including a surface controller, surface widget, and translation layer. It uses the genui package as the renderer and a2ui_core for message types.

How do I verify Flutter A2UI output matches the web host?

The scaffolder generates and runs a parity test that drives the same A2UI document as the web host and asserts identical observable facts such as heading, body text, and labelled buttons. The scaffolder fails loudly if parity is not confirmed.

Is a2ui_flutter the official Flutter SDK for A2UI?

No. At version 0.0.1-wip002, a2ui_flutter is an unmodified dart create template with no implementation. The scaffolder uses genui as the renderer and a2ui_core for message types instead.

What should I do when the A2UI parity test fails after a dependency bump?

A failing parity test after a dependency bump means the surfaces have drifted apart. Fix the drift in the rendering layer rather than relaxing the test assertion, since the test is the guarantee of cross-host consistency.

Can A2UI render the same UI across web, MCP, and Flutter clients?

Yes. A2UI is the shared UI vocabulary across transports, so an agent's UI is identical whether a client arrives over AG-UI on the web, MCP-UI in MCP clients, or Flutter on mobile. The parity test enforces this consistency.