CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

figma-generate-library

Build or update a professional-grade design system library in Figma from a codebase. Useful for keeping the Figma source of truth in sync with shipped components.

46

Quality

57%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/figma-generate-library/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This SKILL.md is a catalog stub rather than a functioning skill: it is brief and cleanly structured but contains essentially no executable guidance, deferring all real instructions to an external upstream repository via a non-executable `open` command. Both actionability and workflow clarity are weak because a user or agent following it cannot actually accomplish anything without improvising the install steps.

Suggestions

Replace the `open https://github.com/figma/skills` hint with concrete install commands (e.g. `git clone` plus a copy step into the skills directory) so the setup sequence is executable.

Inline or bundle the core upstream workflow steps locally in SKILL.md (or a single references/ file) so the skill is self-contained rather than a pointer to an external repo.

Add a validation checkpoint, e.g. how to confirm the skill is installed and invocable before asking the agent to run it, and remove the frontmatter-mirroring 'What it does'/'Source' duplication.

DimensionReasoningScore

Conciseness

The body is short, well-bounded, and explains nothing Claude already knows, but it restates the frontmatter description verbatim in 'What it does' and repeats the upstream URL and category already in the frontmatter — minor over-explanation that could be trimmed. Not a 5 because those duplicated lines spend tokens without adding guidance; not a 2-3 because there is no padding beyond that.

4 / 5

Actionability

The only 'command' is `open https://github.com/figma/skills`, which is a browser hint rather than an executable step, and 'install the upstream bundle into your active agent's skills directory' gives no concrete commands or paths — matching 'Minimal concrete guidance; high-level hints but missing the specific steps to execute'. Not a 1 because it does identify a real upstream source and the invocation mechanism (skill name / trigger phrases).

2 / 5

Workflow Clarity

A rough sequence exists (inspect upstream README → install bundle → invoke by name or trigger) but each step is underspecified, there are no concrete commands for acquiring or installing the bundle, and there is no way to verify the install succeeded — matching 'Rough sequence present but many gaps; steps poorly defined'. Not a 3 because even the individual steps lack actionable definition, not just checkpoints.

2 / 5

Progressive Disclosure

Sections are clear and there are no nested references, but the body is a stub whose substantive content lives entirely outside the bundle in an external repository (no local references/, scripts/, or assets/ exist), so it 'could be better organized' with the actual material one level deep inside the skill. Not a 2 because the structure that exists is clean and not monolithic; not a 4 because a skill whose real guidance is absent from the bundle cannot be considered well-split.

3 / 5

Total

11

/

20

Passed

Description

53%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 serviceable but generic description: it states a clear 'what' with a well-defined Figma/design-system niche, but lacks an explicit 'Use when...' trigger clause and has thin keyword coverage for the actions it performs. It sits at the midpoint of the rubric across most dimensions.

Suggestions

Add an explicit 'when' clause, e.g. 'Use when the user asks to create, update, or sync a Figma library/design system from code, components, or design tokens.'

Enumerate the concrete actions the skill performs (generate components, styles, variables/tokens, publish library) to lift specificity beyond 'build or update'.

Fold natural user phrasings such as 'design tokens', 'UI kit', 'component library', and 'Figma variables' into the description's keyword set.

DimensionReasoningScore

Specificity

The description names the domain ('design system library in Figma') and two actions ('Build or update') but gives no concrete detail on what building entails — comparable to 'Processes PDF files and extracts content'. It is not vague enough for a 2 (domain and actions are named) but lacks the several specific actions needed for a 4.

3 / 5

Completeness

The 'what' is clear ('Build or update a professional-grade design system library in Figma from a codebase') but the 'when' is only weakly implied by 'Useful for keeping the Figma source of truth in sync' — there is no explicit 'Use when...' trigger guidance, which per the guidelines caps completeness at 3. Not a 2 because the 'what' is concrete, not a 4 because the 'when' clause is absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Relevant keywords are present ('design system library', 'Figma', 'sync', 'codebase') but common variations and synonyms a user would naturally say ('Figma components', 'design tokens', 'UI kit') are missing, matching the 'Some relevant keywords but missing common variations' anchor. The richer trigger phrases only appear in the frontmatter `triggers` field, not the description being evaluated.

3 / 5

Distinctiveness Conflict Risk

The combination 'Figma' + 'design system library' + 'from a codebase' carves out a fairly distinct niche with minimal conflict risk against unrelated skills, matching 'Mostly distinct; minor overlap risk'. Not a 5 because it could still collide with other Figma/design-system generation skills that share this trigger space.

4 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

nexu-io/open-design

Path

skills/figma-generate-library/SKILL.md

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.