Content
43%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |