`rhds-handoff-annotations` skill

[bennypowers]

Important

Agents working on this issue must read all comments and take them into account, and act according to consensus from discussions in the issue thread.

AI-assisted design handoff annotations with real RHDS token names.

From user stories by Corey Vickery and Marionne Patel (C10).

User story

As a designer handing off to engineering, I want AI-assisted annotation that references our real token names, so that engineers get accurate specs without extra manual work from me.

Goals

• Figma designs are annotated with correct RHDS token names for colors, spacing, typography
• Engineers receiving handoffs see real token references (e.g. --rh-space-lg) instead of raw pixel/hex values
• Reduces manual annotation work for designers

Non-goals

• Generating implementation code from annotations (see rhds-component-usage skill #12 for component usage)
• Modifying the design itself

Implementation notes

Depends on #24 (token naming fidelity -- AI must know real token names to annotate correctly).

Skill file: plugins/design/skills/rhds-handoff-annotations/SKILL.md

MCP tools:

• get_design_context (Figma) for reading design values
• search_tokens (asimonim) for matching values to token names
• use_figma (Figma) for adding annotation nodes
• get_variable_defs (Figma) for checking existing variable bindings