Content
86%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-engineered orchestration skill: deterministic routing, explicit stage sequencing, exact git/pnpm commands, numeric scope thresholds, and a clean one-level-deep reference bundle with an anti-restatement contract. The only weaknesses are mild verbosity in the policy sections and the absence of an explicit fix-and-re-validate loop after failed validation in the body itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense rule-specification with essentially no teaching of concepts Claude already knows, and it deliberately delegates detail to references ("this section grants the authority and never restates the mapping"), but at ~2,300 words it could still be tightened — e.g., repeated "explicit user wording" phrasing and the multi-clause interruption examples. Not level 5 because a few passages over-elaborate; not level 3 because there is no padded or tutorial-style explanation. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact commands (`git merge-base origin/{main\|master} HEAD`, `git diff --numstat`, `git rev-parse --verify`, `pnpm test:main <file>`), numeric thresholds ("CHANGED_LINES <= 1000, CHANGED_FILES <= 20"), a first-match rule list, a scope-resolution table, and a copy-paste usage-examples block. Not level 4 because the concrete commands cover the common cases with specific caveats (e.g., why `pnpm test <path>` is wrong). | 5 / 5 |
Workflow Clarity | Stages are explicitly sequenced (the 5-stage table with "A later stage reviews only what survived the earlier ones"), routing is a deterministic top-to-bottom rule list, and there is a validation section after applied fixes plus input validation (endpoint `git rev-parse --verify`, empty-scope exit). Not level 5 because the body lacks an explicit failed-validation feedback loop (it says to run validation and report results but not to fix and re-validate), and no level 3 because validation checkpoints are present, not missing. | 4 / 5 |
Progressive Disclosure | SKILL.md acts as a well-signaled routing hub: every one of the ten referenced files (local-review, teams-review, pr-review, cherry-review-guidance, consumer-review, code-checklist, doc-checklist, judgment-matrix, diagnosis, checklist-evolution) exists in references/ and is exactly one level deep, with a single-source-of-truth stage table and explicit rules preventing re-referencing ("a leaf flow may not widen, narrow, or re-reference a stage"). Not level 4 because the split is clean and navigation is trivial — the body keeps only binding skill-wide policy and delegates all checklists and flows. | 5 / 5 |
Total | 18 / 20 Passed |