Content
51%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.
The body is a lean, well-organized catalogue stub with clean structure and no token waste, but its core workflow is not executable: the pivotal 'install the upstream bundle' step has no concrete command or path, and it defers even path discovery to the user. Progressive disclosure is excellent given the skill's deliberate minimal footprint.
Suggestions
Replace the `open https://github.com/figma/skills` snippet with an executable install command (e.g., the actual `git clone` command and the destination skills-directory path) so the install step is copy-paste ready.
Add a verification checkpoint after the install step (e.g., 'confirm the skill appears in the agent's skill list before invoking') to give the workflow a feedback loop.
Deduplicate content: the description is repeated verbatim in 'What it does' and the upstream URL appears twice — trimming these would push conciseness to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean (~27 lines), assumes Claude's competence, and explains nothing the model already knows — it fits anchor 4 ('Efficient; minor instances... that could be trimmed'). Not 5 because of redundancy: the frontmatter description is repeated verbatim in 'What it does' and the upstream URL appears in both the 'Source' section and the code block; not 3 or below since there is no padded or unnecessary explanation. | 4 / 5 |
Actionability | The central instruction — 'install the upstream bundle into your active agent's skills directory' — has no executable command (no clone command, no destination path), and the snippet's own comment concedes the gap: 'Inspect the upstream README for exact paths'. The only concrete command is `open https://github.com/figma/skills`, which merely opens a webpage. This matches anchor 2 ('Minimal concrete guidance; high-level hints but missing the specific steps to execute') rather than 3, which would require some complete executable guidance. | 2 / 5 |
Workflow Clarity | A rough sequence exists (inspect upstream README → install bundle → invoke by name or trigger phrase), but the middle step is undefined and there are no checkpoints confirming the install succeeded before invocation. This matches anchor 2 ('Rough sequence present but... steps poorly defined; validation absent'). It is not 3 because the key step (install) is left entirely unspecified rather than merely lacking checkpoints; the operation is non-destructive, so the destructive-op cap does not apply, and the simple-skill exception cannot raise it because the single action is not unambiguous. | 2 / 5 |
Progressive Disclosure | No bundle directories (references/, scripts/, assets/) exist, so there is nothing misfiled; the body is well under 50 lines with clearly labeled sections ('What it does', 'Source', 'How to use') and a single clearly-signaled external pointer (the upstream repo). Per the rubric's simple-skill note, a short skill with no need for external references scores 5 with just well-organized sections, which this has. | 5 / 5 |
Total | 13 / 20 Passed |