Content
71%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 well-structured, actionable routing skill with clear sequencing and an explicit bounded-verification loop. Its main weakness is that the extensive reference/*.md navigation it depends on points to files not present in the bundle, undermining the progressive-disclosure design.
Suggestions
Ship the reference/*.md files (craft-floor.md, new-work.md, routing.md, and one per command) in a references/ bundle so the body's navigation links actually resolve.
Trim the motivational opening paragraph ('out-of-distribution craft', 'award-winning design director') to operational essentials to tighten conciseness.
Inline a one-line summary of the most critical reference (e.g. craft-floor.md's absolute bans) so the quality floor is not entirely gated behind a missing file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is overwhelmingly operational and lean (Setup steps, Modes, Commands table, Routing), with only a minor trim-able motivational opening ('design that earns to be called out-of-distribution craft... award-winning design director'); no concept-teaching padding. | 4 / 5 |
Actionability | Concrete executable guidance throughout — specific commands (impeccable context, impeccable pin, /impeccable hooks, /impeccable doctor), a full command-to-reference table, and explicit file paths — with minor gaps because the executable detail lives in the referenced (and here, absent) reference files. | 4 / 5 |
Workflow Clarity | Clear sequenced Setup (once-per-session context, then craft-floor before any edit) with an explicit bounded-verify feedback loop ('inspect once with a batched round... fix everything... confirm with at most one more round, and stop') and a launcher-failure recovery fallback; minor validation detail is delegated to referenced docs. | 4 / 5 |
Progressive Disclosure | Structure and signaling are excellent — a clear overview/router with a Commands table pointing to one-level-deep reference files — but the referenced reference/*.md files (craft-floor.md, new-work.md, routing.md, one per command) are absent from the bundle (only scripts/ exists), so the disclosure is broken in practice. | 3 / 5 |
Total | 15 / 20 Passed |