CtrlK
BlogDocsLog inGet started
Tessl Logo

figma-use

**MANDATORY prerequisite** — you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context — e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

66

Quality

80%

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

81%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 highly actionable, well-sequenced skill body with strong validation feedback loops and a genuinely useful progressive-disclosure structure. The main cost is token efficiency: core rules are duplicated across the Critical Rules, dedicated sections, and the pre-flight checklist, and the query-selector API spec is inlined where a reference file would keep the overview lean.

Suggestions

Consolidate the duplicated guidance: state each rule once (Critical Rules or the dedicated section), and reduce the Pre-Flight Checklist (Section 8) to a short pointer like "re-check Critical Rules 1-17" plus only the checklist items that add new detail (e.g. lineHeight/letterSpacing format, resize-before-sizing-modes).

Move the query() selector grammar, QueryResult method table, and editor-mode node-type lists (Sections 5 and 4) into a reference file (e.g. references/query-api.md), keeping only 2-3 high-value examples in SKILL.md.

Merge the overlapping error-recovery tables: the self-correction table in Section 7 substantially duplicates gotchas.md's WRONG/CORRECT coverage — keep the table in one place and cross-reference it from the other.

DimensionReasoningScore

Conciseness

Content is mostly tool-specific knowledge Claude cannot know (atomicity, wrapper semantics, font-preload-before-appendChild), but the same rules are restated repeatedly: return-IDs appears in Critical Rule 15, Section 3, and workflow step 4; setCurrentPageAsync appears in Rule 9 and twice within Section 2; the Pre-Flight Checklist (Section 8) restates rules 1-17 nearly verbatim. Not 4: the repetition goes beyond "minor instances that could be trimmed" — consolidating the duplicated rule statements would cut a meaningful fraction of the file.

3 / 5

Actionability

Fully executable throughout: copy-paste-ready JS for page iteration, query/set/auto-layout/screenshot APIs, inspection scripts, a selector-syntax spec, and an error-message→likely-cause→fix table. Not 4: examples cover the common cases with exact, runnable code and concrete fix steps, leaving no gaps.

5 / 5

Workflow Clarity

Section 6 gives a clear sequenced workflow (inspect → skeleton → fill → validate → fix) with a per-step validation table, an explicit step order for complex tasks, and Section 7 adds a full feedback loop (stop → read error → fix → retry) plus atomicity guarantees. The pre-flight checklist covers batch/mutating operations. Not 4: validation checkpoints are explicit at every step, not just most.

5 / 5

Progressive Disclosure

Good structure: all referenced files (gotchas.md, common-patterns.md, the pattern docs, plugin-api-standalone.index.md/.d.ts, working-with-design-systems/wwds.md) verified to exist, one level deep, with a when-to-load table (Section 10) and explicit "grep, don't load" guidance for the 455KB d.ts. Not 5: Section 5's selector grammar and QueryResult method table are reference-grade API surface inlined in SKILL.md rather than split into a reference file, making the overview heavier than ideal.

4 / 5

Total

17

/

20

Passed

Description

80%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.

A specific, well-triggered description with a comprehensive list of concrete Figma actions and an explicit trigger clause. Its main weaknesses are an indirect statement of what the skill itself does (capability is framed through the user's task and mandate language) and some overlap risk with closely related Figma skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically" — covering the write/unique-read surface comprehensively. Not 4: there are no minor gaps in coverage of the tool's action space; the enumerated list is broad and concrete.

5 / 5

Completeness

Has both a "what" (JavaScript execution in the Figma file context for write/unique-read actions) and an explicit "when" ("Trigger whenever the user wants to perform a write action..."). Not 5: the "what" is stated only obliquely — the skill's actual function (running Plugin API code via use_figma) is described from the user's task angle and wrapped in mandate language ("MANDATORY prerequisite... you MUST invoke") rather than stated as a capability.

4 / 5

Trigger Term Quality

Good coverage of natural terms (Figma file context, nodes, variables or tokens, components and variants, auto-layout, fills, bind variables), but common user phrasings like "edit my Figma design", "styles", or "prototype" are absent. Not 3: the included terms are exactly what users requesting Figma manipulation would say, not generic.

4 / 5

Distinctiveness Conflict Risk

Clear niche — Figma file manipulation via JavaScript execution in the use_figma context — with distinct, specific triggers. Not 5: write-action triggers like "build components and variants" or "modify auto-layout or fills" overlap with closely related companion skills (figma-generate-design for screen building, figma-use-slides), so minor overlap risk remains.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 1 deeper-than-1-level

Warning

Total

14

/

16

Passed

Repository
novuhq/novu
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.