Content
53%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 brief, well-structured catalogue stub: concise and easy to navigate, but it delegates all operational content to an upstream repo it never concretely teaches the reader to install or invoke. Its weakest area is actionability — the only code block opens a webpage rather than performing any step of the skill's task.
Suggestions
Include the actual invocation that creates the file (e.g., the upstream MCP tool call with its required arguments) so the body is actionable on its own instead of only linking to the repo.
Replace the placeholder `open https://github.com/figma/skills` step with the real installation steps (clone URL, target skills-directory path, and the copy/clone command), making the bash block executable end-to-end.
Add a post-install checkpoint — e.g., list the skills directory or verify the skill is discoverable by name — so the workflow has an explicit validation step before invoking the skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and well-sectioned with no concept over-explanation; every section is short and on-topic. Only minor trimming is possible — "What it does" restates the frontmatter description verbatim, and the OpenDesign catalogue framing sentence is marginally redundant — which matches the 'efficient; minor instances of over-explanation' anchor rather than the fully lean anchor 5. | 4 / 5 |
Actionability | The single code block (`open https://github.com/figma/skills`) merely opens a repo page — its own comment admits "Inspect the upstream README for exact paths" — and "install the upstream bundle into your active agent's skills directory" is a high-level hint with no concrete steps. Nothing executable actually creates a Figma file, matching the 'minimal concrete guidance; high-level hints but missing the specific steps' anchor. It is not a 3 because even the suggested pseudocode-equivalent stops short of any install or invocation command. | 2 / 5 |
Workflow Clarity | A three-step sequence is present and ordered (inspect upstream README → install bundle → invoke by name or trigger phrase), with the final step concrete (exact skill name plus pointer to frontmatter triggers). It sits at anchor 3 rather than 4 because the install step is undefined (no command, no destination path) and there is no checkpoint confirming the bundle installed correctly; it is above anchor 2 because the ordering is coherent and the terminal action is fully specified. | 3 / 5 |
Progressive Disclosure | The body is under 50 lines, single-purpose, and cleanly sectioned (What it does / Source / How to use), with one clearly signaled upstream pointer (github.com/figma/skills) that is only one level deep. It is not a 5 under the simple-skill exception because the skill does need external content to function — all operational detail lives in the upstream repo rather than in bundled, well-labeled reference files — which is a minor organization gap matching anchor 4. | 4 / 5 |
Total | 13 / 20 Passed |