Content
81%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.
A disciplined, rule-dense skill body with an exemplary validated workflow: numbered method, automated stopping checks, a final checklist, and a rebuild-verification loop. The main defects are a missing bundle file (`templates/figure.mjs`) that the core drawing steps depend on, and moderate duplication between the body and its reference files.
Suggestions
Ship `templates/figure.mjs` in the bundle (or inline a minimal starter script in SKILL.md), since Method steps 6-7 and the Files section all depend on a file that is not present.
Remove the duplicated nine-kinds table and fixed hue-meaning table from the body (or from `references/kinds.md` / `references/grammar.md`) so each fact lives in one place.
Trim the intro sentence enumerating agents ("Claude, Cursor, Codex, OpenClaw, Hermes, or any agent that reads SKILL.md can use it") — it adds tokens without changing behavior.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, prescriptive, and assumes competence ("No ellipsis in labels. No text over text."), with no explanations of concepts Claude already knows. Not 5 because of trimmable redundancy: the nine-kinds table is duplicated verbatim in `references/kinds.md`, the fixed hue meanings appear both inline and in `references/grammar.md`, and the intro sentence listing agents ("Claude, Cursor, Codex, OpenClaw, Hermes...") earns little. | 4 / 5 |
Actionability | Guidance is highly concrete: exact commands ("Run `node templates/figure.mjs out.svg`"), exact formats ("`var(--m-rose-ink, #b0344d)`", "Dashed is `5 4`"), numeric constraints (640-unit grid, 40 KB cap), and a worked caption example. Not 5 because the central executable artifact the method depends on ("Start from `templates/figure.mjs`" — steps 6 and 7) is absent from the bundle, so the primary draw-and-run path cannot be executed as shipped. | 4 / 5 |
Workflow Clarity | The 10-step Method is clearly sequenced with explicit validation and feedback loops: step 7 "It stops on a label that is too small", step 8 "Run the checks in `references/checks.md`. Fix every finding", step 9 render and inspect at 100% and 50%, plus a full "Check before you finish" checklist and a rebuild-verify loop ("build again and confirm that the committed SVG equals the script output"). This matches the top anchor with checkpoints, error-recovery loops, and a checklist. | 5 / 5 |
Progressive Disclosure | The Files section clearly signals three real one-level-deep references (`references/kinds.md`, `references/grammar.md`, `references/checks.md`), each referenced at the right point in the body, and each exists with substantive content. Not 5 because `templates/figure.mjs` is listed in Files and used in the Method but is missing from the bundle, and some reference content (kinds table, hue meanings) is duplicated inline rather than split cleanly. | 4 / 5 |
Total | 17 / 20 Passed |