CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

77

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

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

A strong, information-dense body: executable commands for every common task, tight tables instead of prose, and clean one-level-deep reference deferral. The only notable gap is that the multi-step task workflows don't wire validation steps in-line (verify commands exist but live in a separate section), which leaves workflow_clarity just below top.

Suggestions

Add an explicit final step to each Common Tasks workflow that runs the relevant validation inline, e.g. 'Add support for a new Figma property' step 4: run `pnpm --filter @grida/io-figma test -- __tests__/iofigma.kiwi.test.ts` and iterate until green, and 'Debug a clipboard paste failure' step 5: re-run the failing clipboard test to confirm the schema fix.

Reference the Verification commands (typecheck/test) from within the task workflows rather than only in the standalone Verification section, so the validate→fix→retry loop is embedded where edits are made.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence throughout — dense tables for key files, input formats, test coverage, and fixtures, with no space spent explaining known concepts ('Clipboard issues = Figma changed their Kiwi schema' is maximally compressed). Every token carries project-specific information; even the .env guardrail earns its place as a security rule. This matches the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

Commands are copy-paste ready and cover the common cases: 'pnpm --filter @grida/io-figma fig2grida input.fig', 'npx tsx packages/grida-canvas-io-figma/fig2grida.ts input.fig --pages 0,2', the figma_archive.py invocations with argument placeholders, test commands, and verification commands. The two multi-step workflows give concrete, executable steps (e.g. 'Run readHTMLMessage(html) → inspect raw Message').

5 / 5

Workflow Clarity

The 'Add support for a new Figma property' and 'Debug a clipboard paste failure' workflows have clear, well-sequenced steps, but neither inlines an explicit validation checkpoint (no 'run the new test' or 're-run the suite' step inside the workflow — verification commands appear only in a separate terminal section). This fits anchor 4 'clear sequence with most checkpoints present; minor validation gaps' — above 3 because sequencing and checkpoints are mostly present, below 5 because there is no inline validate→fix→retry loop.

4 / 5

Progressive Disclosure

The body is a well-organized overview that defers depth one level deep with clear signals: a References table points to '.ref/figma/' (Kiwi schema), the glossary deep-dive, and the README; the bundle's scripts/figma_archive.py is referenced with the correct path and its full documentation deferred to the script header. Sections are cleanly split (architecture, key files, tasks, tests, limitations, verification), matching the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

19

/

20

Passed

Description

100%Weight 40%Scale 1-5

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

An exemplary description: third-person voice, dense with concrete package-specific capabilities, and an explicit 'Use when…' clause enumerating the exact tasks a developer would name. Both what and when are answered with distinct, low-conflict trigger terms.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — 'fig-kiwi binary parser, Kiwi→REST→Grida conversion pipeline, fig2grida CLI, REST API JSON conversion, and testing with clipboard/fig/REST fixtures' — with comprehensive coverage of the package's work areas and no generic filler. It clearly matches the anchor 'lists multiple specific concrete actions; comprehensive coverage', not the level below where minor gaps would exist.

5 / 5

Completeness

Both questions are explicitly answered: 'Covers the fig-kiwi binary parser…' states what the skill does, and 'Use when adding node type support, fixing conversion bugs, extending fig2grida, working on the fig-kiwi parser…' states when to use it with concrete trigger phrases. This matches the anchor for a clear and explicit what AND when.

5 / 5

Trigger Term Quality

Natural user phrasings are present throughout: 'fixing conversion bugs', 'writing tests for Figma import', 'debugging clipboard paste failures after a Figma update', plus tool-specific triggers like 'fig2grida' and 'fig-kiwi parser'. For this domain the keyword coverage is comprehensive, matching the top anchor rather than the 'a few natural terms missing' level.

5 / 5

Distinctiveness Conflict Risk

The scope is tightly pinned to 'the Figma I/O package (@grida/io-figma, packages/grida-canvas-io-figma/)' with distinctive triggers ('fig-kiwi parser', 'clipboard paste failures after a Figma update'), giving it a clear niche with minimal conflict risk against other skills.

5 / 5

Total

20

/

20

Passed

Validation

100%

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
Reviewed

Table of Contents

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.