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 tidy, well-structured catalogue entry that points clearly to its upstream source, but it offers little actionable guidance — the real workflow lives in the external repo rather than in the skill. Conciseness is good aside from a duplicated description.
Suggestions
Inline the core installation/invocation steps (e.g., the exact skills-directory path and clone command) instead of only opening the upstream URL, so the skill is actionable without an external round-trip.
Remove the verbatim repetition of the frontmatter description in the 'What it does' section to save tokens.
Tighten the workflow into explicit numbered steps with a verification checkpoint (e.g., confirm the skill appears in the agent's skill list before invoking).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence, but the 'What it does' section repeats the frontmatter description verbatim, a minor redundancy that could be trimmed. | 4 / 5 |
Actionability | Concrete guidance is minimal — the only executable command is 'open https://github.com/figma/skills', while the actual build/install workflow is delegated to the upstream repo with no specific steps inlined. | 2 / 5 |
Workflow Clarity | A rough sequence is present (inspect upstream → install bundle → invoke by name/triggers), but the steps are vague on specifics such as where and how to install, with no checkpoints. | 3 / 5 |
Progressive Disclosure | Content is well-organized into clear sections (What it does, Source, How to use) with a clearly signaled one-level external reference; no local bundle files exist, and the structure is appropriate for a short catalogue entry. | 4 / 5 |
Total | 13 / 20 Passed |