This skill provides workflows and best practices specific to the genui repository.
Workflows
1. Running Tests and Fixes
The repository uses a custom tool to run tests, apply fixes, and format code before committing.
It should typically only be run before committing, since it is inefficient and slow to run it on every change.
It will run dart fix --apply, dart format, and flutter test on all packages in the repository.
Command:
dart run tool/test_and_fix/bin/test_and_fix.dart
When to use:
Before committing changes, to ensure project health.
Instead of running flutter test manually for each project in the repo.
2. Creating a New Component in the genui package
When creating a new UI component in genui:
Location: Place component files in packages/genui/lib/src/components/.
Inheritance: Components must extend UiComponent.
A2UI Compliance: Ensure the component matches the A2UI specification.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: flutter-genui-genui-helper3description: GenUI Development Helper4---56# GenUI Development Helper78This skill provides workflows and best practices specific to the `genui` repository.910## Workflows1112### 1. Running Tests and Fixes1314The repository uses a custom tool to run tests, apply fixes, and format code before committing.15It should typically only be run before committing, since it is inefficient and slow to run it on every change.1617It will run `dart fix --apply`, `dart format`, and `flutter test` on all packages in the repository.1819**Command:**20```bash21dart run tool/test_and_fix/bin/test_and_fix.dart22```2324**When to use:**25- Before committing changes, to ensure project health.26- Instead of running `flutter test` manually for each project in the repo.2728### 2. Creating a New Component in the genui package2930When creating a new UI component in `genui`:31321. **Location**: Place component files in `packages/genui/lib/src/components/`.332. **Inheritance**: Components must extend `UiComponent`.343. **A2UI Compliance**: Ensure the component matches the A2UI specification.354. **Documentation**: Follow strict Dart documentation standards.3637### 3. Updating Documentation3839- Documentation source of truth is in `docs/`.40- Use `mkdocs` context if mentioned, but primarily edit the markdown files directly.41- Ensure strict adherence to "Natural Writing" standards (no AI-isms).4243## Key Constants & Patterns4445- **Current A2UI Version**: v0.946- **State Management**: Uses `SurfaceController` from `genui`.4748## References4950- A2UI Specification51 - Available in the submodule at @packages/genui/submodules/a2ui52 - The specification documentation is available in @packages/genui/submodules/a2ui/specification/v0.9/docs53 - The specification schemas are available in @packages/genui/submodules/a2ui/specification/v0.9/json54 - Because it is a submodule, you may need to update the submodule to get the latest specification.55- To find out details of a specific dart compiler diagnostic message, use the following url format to look up the details:56 - https://dart.dev/tools/diagnostics/<message_id>57 - Example: https://dart.dev/tools/diagnostics/ambiguous_import58- To find out details of a specific analyzer lint message, use the following url format to look up the details:59 - https://dart.dev/tools/linter-rules/<lint_rule_id>60 - Example: https://dart.dev/tools/linter-rules/always_declare_return_types6162---63> Converted and distributed by [TomeVault](https://tomevault.io/claim/flutter) — claim your Tome and manage your conversions.64<!-- tomevault:4.0:skill_md:2026-04-16 -->
Run npx skillmds@latest add tomevault-io/flutter-genui-genui-helper in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
GenUI Development Helper It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.