io-figma

Guides work on the Figma I/O package (@grida/io-figma, packages/grida-canvas-io-figma/). Covers the fig-kiwi binary parser, Kiwi→REST→Grida conversion pipeline, fig2grida CLI, REST API JSON conversion, and testing with clipboard/fig/REST fixtures. Use when adding node type support, fixing conversion bugs, extending fig2grida, working on the fig-kiwi parser, writing tests for Figma import, or debugging clipboard paste failures after a Figma update.

Quality

100%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered skill body: concise and table-driven, with concrete executable commands, clearly sequenced workflows that include verification, and a clean reference structure that points one level deep. It assumes Claude's competence and adds only package-specific knowledge.

Dimension	Reasoning	Score
Conciseness	The body is lean and table/diagram-driven, assumes Claude's competence, and avoids explaining what Figma or parsers are; every section (architecture, key files, tasks, tests) earns its place without padding.	3 / 3
Actionability	Provides copy-paste-ready, executable commands throughout — 'pnpm --filter @grida/io-figma fig2grida input.fig', 'npx tsx packages/.../fig2grida.ts input.fig --pages 0,2', the figma_archive.py invocation, and verification commands — plus specific file targets per task.	3 / 3
Workflow Clarity	Multi-step tasks (add a property, debug clipboard paste, create fixtures) are clearly numbered and sequenced, the clipboard-debug flow has an explicit diff-against-schema feedback loop, and a dedicated Verification section supplies the typecheck/test checkpoint.	3 / 3
Progressive Disclosure	A clear overview with a dedicated References table signaling one-level-deep pointers (.ref/figma/, the fig.kiwi glossary, the README) and cross-links to sibling skills (io-grida, render-reftest) for deeper detail, with content appropriately split into focused sections rather than inlined.	3 / 3
	Total	12 / 12 Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that states concrete capabilities and pairs them with an explicit, scenario-based 'Use when' trigger list. It is specific, complete, and clearly niche-scoped to the Figma I/O package.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete capabilities — 'fig-kiwi binary parser', 'Kiwi→REST→Grida conversion pipeline', 'fig2grida CLI', 'REST API JSON conversion', 'testing with clipboard/fig/REST fixtures' — matching the 'lists multiple specific concrete actions' anchor.	3 / 3
Completeness	Explicitly answers both 'what' (the covered converters/pipeline/CLI/testing) and 'when' via a dedicated 'Use when ...' clause, matching the 'clearly answers both what AND when with explicit triggers' anchor rather than the implied-only level 2.	3 / 3
Trigger Term Quality	The 'Use when' clause covers natural developer phrasings — 'adding node type support', 'fixing conversion bugs', 'debugging clipboard paste failures after a Figma update' — that a maintainer of this package would actually say, satisfying the 'good coverage of natural terms' anchor.	3 / 3
Distinctiveness Conflict Risk	Scoped tightly to the @grida/io-figma package with Figma-specific triggers (fig-kiwi, fig2grida, clipboard paste), giving it a clear niche unlikely to collide with other skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: gridaco/grida
Path: .agents/skills/io-figma/SKILL.md
Commit: 2e0d276

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.