figma-version-history — list, snapshot & diff Figma versions

Version history lives only in Figma's REST API, so this skill calls REST directly with a personal access token (PAT). It does three things:

1. List a file's version history (label, description, author, timestamp, version id).
2. Snapshot the file (or just some nodes) as it existed at a given version_id.
3. Diff two versions — a cheap page-structure diff always, plus optional deep per-component diffs at depth=2.

Setup — terminal + token required. This skill runs shell commands, so it works in Claude Code (including the "Code" tab inside Claude Desktop), Cursor, Codex, or Gemini CLI — it does not run in plain Claude Desktop or claude.ai chat (no shell). The Figma connector's OAuth login does not authorize these REST calls, so you must supply your own Figma personal access token: in Figma go to Settings → Security → Personal access tokens, generate one with scope File content: read (plus File versions: read), then set it in your shell: export FIGMA_TOKEN="figd_…". The script reads it from the environment at runtime — never put the token in a skill file.

Setup & skill boundaries

• All requests go to https://api.figma.com with the header X-Figma-Token: $FIGMA_TOKEN.
• Endpoint reference: references/endpoints.md.

Derive the file key