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.
The skill body is a thin catalogue entry pointing to an upstream bundle; it is reasonably structured but offers little concrete, executable guidance and an undefined install workflow. Its main weakness is actionability, since the actual task is deferred to upstream with only high-level hints locally.
Suggestions
Replace the macOS-only `open https://...` with portable, concrete steps (e.g. `git clone` the repo and copy the skill folder into the agent skills directory) so the install workflow is executable.
Drop the duplicate "What it does" section and trim the Open Design/planning meta-prose to tighten token efficiency.
Add an explicit invocation example showing the trigger phrase or `figma-create-new-file` call so the final step is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short, but the "What it does" section repeats the frontmatter description verbatim and the "How to use" prose explains catalogue/planning mechanics Claude does not need, so it is mostly efficient with some unnecessary explanation. | 3 / 5 |
Actionability | Guidance is high-level ("install the upstream bundle", "ask the agent to invoke this skill"), and the only concrete command (`open https://github.com/figma/skills`) just inspects a README and is not portable, leaving the specific executable steps missing. | 2 / 5 |
Workflow Clarity | A rough sequence is implied (install bundle -> inspect README -> invoke by name/trigger), but the install step is undefined and no concrete sub-steps are given, matching the rough-sequence-with-many-gaps anchor. | 2 / 5 |
Progressive Disclosure | The body is well organized into clear sections with a single one-level-deep external reference (the upstream repo URL) that is clearly signaled; it stops short of a 5 only because the skill is essentially a stub pointer with no content split to navigate. | 4 / 5 |
Total | 11 / 20 Passed |