Content
82%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 tightly written, repo-specific editorial standard: dense rules with no filler, copy-ready exclusion commands, and a validated 7-step workflow. The residual gaps are the absence of an explicit fix-and-revalidate loop, judgment guidance that stays abstract by delegating all worked examples to the reference file, and an inline-heavy coverage list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and rule-dense ("Write enough to preserve the contract, then remove reasoning transcripts, repetition, and decoration") with every sentence carrying policy; the only definitions given ("A contract is an obligation, invariant, precondition, postcondition, or compatibility promise...") define repo-local terminology Claude cannot know. There is no padding, no restatement of concepts Claude already knows, and no over-explanation — matching the 5 anchor's "every token earns its place". | 5 / 5 |
Actionability | Concrete, executable directives are present: exact command suffixes ("end ripgrep commands with `--glob '!vendor/**'`", "give Git commands an explicit `:(exclude)vendor/**` pathspec"), explicit input/mode handling, and a fixed classification taxonomy ("keep, add, trim, restore, restructure, or defer"). It is not a 5 because the core semantic-judgment guidance is inherently abstract and worked before/after examples are delegated to the external examples file rather than shown inline. | 4 / 5 |
Workflow Clarity | The 7-step workflow is clearly sequenced with explicit validation in step 6 ("Run the narrow relevant checks, documentation gates, `git diff --check`, and behavior tests... Verify the final diff contains no `vendor/` path") and a feedback loop ("Re-check analogous passages after learning a new rule"). It stays at 4 rather than 5 because there is no explicit fix-and-re-validate loop when a check fails, and the reporting format in step 7 is a list of contents rather than a template. | 4 / 5 |
Progressive Disclosure | The bundle matches the body: a single one-level-deep reference (references/examples.md) is well signaled ("For calibration or unfamiliar cases, read [the distilled examples](references/examples.md)") and external material (repo docs, sibling skills) is linked rather than duplicated. It is a 4 rather than 5 because the long per-location coverage list is fully inline and the examples reference is surfaced only in two spots rather than a dedicated navigation point. | 4 / 5 |
Total | 17 / 20 Passed |