Content
40%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 is a thin catalogue entry that defers nearly all executable detail to an upstream README rather than providing actionable guidance in the body. Structure and disclosure are reasonable, but actionability and workflow clarity are weak because no concrete, runnable steps or validation are given.
Suggestions
Replace the 'inspect the README' instruction with concrete install steps (e.g. the exact clone/copy commands into the active agent's skills directory) so the body is runnable without external browsing.
Add a short validation checkpoint after installation (e.g. 'confirm the skill appears via the agent's skill list before invoking') to give the workflow a feedback loop.
Cut the verbatim repetition of the frontmatter description in 'What it does' or replace it with one distinguishing line to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and mostly efficient, but the 'What it does' section repeats the frontmatter description verbatim and the prose around installing the upstream bundle could be tightened. | 3 / 5 |
Actionability | Guidance is high-level ('Inspect the upstream README for exact paths', 'install the upstream bundle') with no concrete, runnable steps to actually execute the skill; the only command is 'open https://github.com/figma/skills'. | 2 / 5 |
Workflow Clarity | A rough sequence exists (inspect README, install bundle, invoke by name), but steps are poorly defined and lack any validation checkpoints for confirming the bundle is correctly installed or the skill is available. | 2 / 5 |
Progressive Disclosure | Sections are well organized and the single external reference (the upstream repo) is clearly signaled one level deep with no nested reference chains, though the body is essentially a pointer rather than self-contained guidance. | 4 / 5 |
Total | 11 / 20 Passed |