Working with Agents

How to give Claude (or any MCP-capable agent) full knowledge of the Helix design system.

[!NOTE] Draft — expanded in the machine-readable-surfaces work (llms.txt, manifest URLs land there).

Claude Code plugin

The Helix plugin bundles the MCP server and ten skills. Install from this repo's plugin marketplace (.claude-plugin/), then verify with /mcp — the helix server should list six tools: get_component, search_components, get_tokens, get_pattern, check_accessibility, get_registry.

Skills

The plugin ships skills covering component usage, tokens, patterns, app layouts, form patterns, data patterns, copy patterns, compound components, accessibility, and setup. Claude loads them automatically when relevant.

Workflow

Follow the AI agent workflow: consult the relevant pattern skill before generating Helix UI, use semantic tokens only, and run accessibility checks on generated output.