Content
85%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 an unusually well-engineered router: executable commands, a numbered setup with error recovery, explicit routing rules, and bounded verification. Its structure design is textbook progressive disclosure, but as bundled none of the referenced reference files exist, so the disclosure chain — which carries essentially all command-level detail — is broken at every link; a motivational intro paragraph is the only other notable cost.
Suggestions
Ship the referenced `reference/*.md` files (new-work.md, craft-floor.md, routing.md, and the 23 command references) inside the skill bundle — the Commands table and Routing rules route every request to them, but none exist in the provided files, so progressive disclosure dead-ends at every link.
State in Setup which files ship with the skill versus which are project-generated (e.g., reference/*.md vs. PRODUCT.md / DESIGN.md), so a missing file is distinguishable from one the user was expected to create.
Trim the motivational opening ("award-winning design director", "Dream big and bold. Distinct, beautiful, outstanding and highly inspiring work.") to a single operational directive — it is persona padding Claude does not need and is the main conciseness cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly lean — the Setup steps, Modes, Commands table, and Routing rules carry maximal routing information per token — but the opening paragraph ("you now approach every design task as an award-winning design director with impeccable understanding for what makes exceptional design work") and principle flourishes ("Dream big and bold. Distinct, beautiful, outstanding and highly inspiring work.") are motivational padding Claude does not need. Fits the score-4 anchor "efficient; minor instances of over-explanation that could be trimmed"; not 3 because the padding is confined to the intro and a couple of principle bullets, not spread through the actionable sections. | 4 / 5 |
Actionability | Commands are copy-paste ready and fully specified: "Run `<skill-base-dir>/scripts/impeccable context` once per session" with base-dir resolution rules, the Windows fallback ".agents/skills/impeccable/scripts/impeccable.cmd", "impeccable pin <pin|unpin> <command>", "$impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset>", and "--target <path>". Even the failure branch scripts the exact message to send ("Context loading did not run; I'll read the existing project context directly.") — fully executable guidance covering the common cases, matching the score-5 anchor. | 5 / 5 |
Workflow Clarity | Setup is a numbered 1–3 sequence with pre-edit checkpoints ("Inspect target and incumbent visual truth before editing"; "read reference/craft-floor.md immediately before any UI edit"), an explicit error-recovery feedback loop ("Launcher unavailable ... Then read existing PRODUCT.md and DESIGN.md without inventing missing context, follow applicable steps 2–3, and continue"), and a bounded post-edit validation protocol ("inspect once with a batched round ... fix everything it shows in one batch, confirm with at most one more round, and stop polishing"). Checkpoints are explicit for both pre-edit and post-edit phases, matching the score-5 anchor rather than 4's "minor validation gaps". | 5 / 5 |
Progressive Disclosure | The body is a genuine overview and the Commands table signals one-level-deep references clearly (23 rows like "[reference/critique.md](reference/critique.md)" plus routing pointers to routing.md, new-work.md, operate.md, hooks.md, doctor.md) — but none of the ~31 referenced `reference/*.md` files exist in the provided bundle (only `scripts/` is present), so every disclosure link dead-ends and the skill's actual per-command content is unreachable as shipped. Signaling and one-level depth are above anchor 2's "references are buried", but the broken file chain is worse than anchor 4's "minor organization gaps", leaving 3 as the best fit. | 3 / 5 |
Total | 17 / 20 Passed |