skills/review-comments/SKILL.md
Fetches comments from a Figma file and surfaces unresolved ones grouped by node. Use when the user runs /figma-differ:review-comments with a Figma URL, or says "show Figma comments", "what are the open Figma comments", "review Figma feedback", or "check Figma annotations".
npx skillsauth add tokyo-megacorp/figma-differ review-commentsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Extract fileKey from the Figma URL. Note nodeId if present (used for filtering).
Check for --all-comments flag in arguments.
Verify a Figma token is loadable: bash scripts/auth.sh status (if it fails, tell the user to run bash scripts/auth.sh set and stop).
~/.figma-differ/)bash $CLAUDE_PLUGIN_ROOT/scripts/figma-api.sh fetch_comments <fileKey>
From the JSON response:
resolved_at is null (unresolved only)--all-comments: include all commentsclient_meta.node_id (the node the comment is anchored to)created_at descending (newest first)Figma Comments — <fileKey>
<N> unresolved comments (run with --all-comments to see resolved)
Node: <node_name or node_id>
- [<author>] <message> (<relative_time>)
- [<author>] <message> (<relative_time>)
Node: <node_name or node_id>
- [<author>] <message> (<relative_time>)
File-level comments (no node anchor)
- [<author>] <message> (<relative_time>)
If no unresolved comments: No unresolved comments in this file.
testing
Subscribe to a Figma file for automatic syncing and semantic search. Adds the file to tracked.json, runs initial index + snapshot-all + frame.md generation, and initializes the QMD search collection. Use when the user runs /figma-differ:track or says "track this Figma file", "subscribe to Figma", "watch this design file", or "add to tracked files".
documentation
Refresh snapshots and search index for tracked Figma files. Fetches current state from Figma, generates frame.md documents, and updates the QMD search index. Use when the user runs /figma-differ:sync or says "sync Figma", "refresh snapshots", "update the Figma index", or "re-sync tracked files".
tools
Takes a snapshot of a Figma node — fetches its JSON structure and PNG screenshot and stores both to ~/.figma-differ/ for later diffing. Use when the user runs /figma-differ:snapshot with a Figma URL, or says "snapshot this Figma frame", "save a Figma baseline", or "take a Figma snapshot".
development
Bulk snapshots every frame in a Figma file — fetches all node JSONs, exports PNGs, and stores comments. Uses a single API call for the tree and batched image exports. Use when the user runs /figma-differ:snapshot-all with a Figma file URL, or says "snapshot all frames", "bulk snapshot", "baseline the whole file", or "snapshot everything in this Figma file".