This repository contains an AI agent skill for Cursor/Claude that documents flow, UX, and business rules as native Figma annotations via the figma-console MCP.
- Uses only the native Figma Annotation system (shortcut
Y). - Does not create cards, frames, sections, or comments to simulate annotations.
- Creates and applies native categories (colored pills) to each annotation.
- Validates context against 5 critical points before writing annotations.
- Updates annotations in-place with
figma_execute.
- Cursor (or Claude with local skills support)
- Figma Desktop open
figma-consoleMCP configured and connected- Edit permission on the target Figma file
See the full step-by-step guide in INSTALL.md.
Example prompt:
Generate strategic Figma annotations for this flow: [Figma URL]. Use native annotations only, native categories only.
Expected agent flow:
- Validates the 5 critical points.
- Maps/creates native categories.
- Applies annotations to existing components.
- Removes textual category prefixes (e.g.
[Business Rule]) when applicable.
This repository can be public for download/fork while keeping edit access restricted to the owner:
- Visibility:
public - Collaborators: no direct write access
- Changes via Pull Request
- Branch protection on
main(recommended)
See the commands and checklist in INSTALL.md.