Content
92%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 dense, well-structured overview: lean directive prose, a sequenced Setup with an explicit bounded-verification checkpoint and failure fallback, and a Commands table that cleanly fans out to one-level-deep references. The only minor gap is that copy-paste executable examples are deferred to the reference files rather than shown inline.
Suggestions
Include one or two short inline command invocations with expected output in the body so the most common path (e.g. running `impeccable context` and its result) is executable without opening a reference.
Tighten the Setup step 1 sentence, which packs path resolution, Windows fallback, binary behavior, --target, loaded artifacts, and directives into a single long clause.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Terse directive prose ("The brief wins.", "Refinement preserves; redesign replaces.") that assumes Claude's competence and never explains basic design or programming concepts; every line carries an instruction or a routing rule. | 5 / 5 |
Actionability | Concrete executable commands are given ("impeccable context", ".github/skills/impeccable/scripts/impeccable pin <pin|unpin> <command>", "/impeccable hooks <on|off|status|...>", "--target <path>"), but full worked examples and code live in the referenced per-command files, leaving minor gaps in the body itself. | 4 / 5 |
Workflow Clarity | A numbered Setup sequence is paired with an explicit validation checkpoint ("Verify in bounded passes... inspect once with a batched round... confirm with at most one more round, and stop polishing") and a launcher-failure feedback loop with a prescribed fallback message. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with a Commands table linking to one-level-deep per-command references (e.g. [reference/shape.md](reference/shape.md)), with content appropriately split and easy to navigate; references are clearly signaled rather than buried. | 5 / 5 |
Total | 19 / 20 Passed |