readlisted

# fig:read — collecting every frame in a Figma file Takes a single Figma file URL, walks the page → frame structure automatically, and collects every top-level frame on the pages you pick as metadata plus screenshots. It works without selecting anything in the desktop app. ## When to invoke - The user hands over a Figma **file** URL (no node specified) and says "read all of it", "show me the structure", "pull every frame" - Taking a screen inventory before spec or canonical-page work - An explicit "/fig:read" ## When NOT to invoke - Frame naming and section tidying → `/fig:prep` - Auditing rule violations → `/fig:lint` - Auditing whether working changes landed in the canonical page → `/fig:sync` - Design context for a code implementation → the `figma:figma-design-to-code` skill · carrying it into the front-end repo → `/fig:code` ## Inputs - `figma_url` (required): a URL of the form figma.com/design/:fileKey/... - A node-id parameter is ignored and the whole file is used (the user picks the page) ## Procedure ### 1. Parse the URL Extract the fileKey from the Figma URL: - Pattern: `figma.com/design/([A-Za-z0-9]+)/...` - If no fileKey comes out, ask the user for the exact URL again ### 1.5 Check the token first Before going down the REST API path, confirm the token's state with a light ping. The environment variable's name is set by `tools.figma_token_env` (default `FIGMA_TOKEN`). ```bash source ~/.zshrc 2>/dev/null VAR=$(python3 ${CLAUDE_PLUGIN_ROOT}/_common/scri