Skill

The fossui skill teaches a coding agent the library's idioms so the code it writes compiles and stays on theme the first time. It is self-contained: it ships the hand-authored idioms (SKILL.md) beside a generated component catalog (reference.md), so it works with no MCP server. When the server is connected, the skill routes to its tools for the same content, live.

Install

Add it from the registry:

npx skills add fossui/ai

Or copy the skill folder in directly:

# for one project
cp -r skill/fossui <your-project>/.claude/skills/fossui

# or for every project
cp -r skill/fossui ~/.claude/skills/fossui

When it activates

The skill switches on for any fossui work: a Foss-prefixed widget, FossThemeData, context.fossTheme, or an import of package:fossui/fossui.dart.

What it carries

• The idioms: theme once and read tokens through context.fossTheme, enums not strings for variants and sizes, no per-instance token props, and how the group and launcher APIs work.
• The full catalog (reference.md): every component with its enums, companion params, launcher functions, and token families, so the agent never guesses a constructor. It is generated from the package and committed, so it never drifts.

With the server

The skill, the rules snippet, and the MCP server carry the same guidance from one source of truth. The skill is the richest for Claude Code; pair it with the server for the freshest per-component API on demand.