Content
70%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 delivers unusually actionable review guidance: a sequenced five-step workflow, per-principle false-positive gates, calibrated severity/confidence rules, and a strict output contract, with details correctly pushed to three real reference files. Weaknesses are noticeable token redundancy (routing rules stated three times, a long inline report template) and, more seriously, references to 'required' shared/ policy files that are absent from the bundle, which undermines both actionability and navigation.
Suggestions
Fix or remove the dangling 'required' links to shared/base/*.md and shared/workflow-contract.md — either package those files in the bundle or drop the policy-link scaffolding, since following them currently fails.
Consolidate the routing guidance currently spread across 'Purpose and activation', 'Routing Boundary', and 'Example routing' into a single routing section to reduce token cost.
Move the full report template (the ~35-line output contract) into a reference file and keep only the required-section summary inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with little textbook explanation of known concepts, but routing guidance is repeated across three sections ('Purpose and activation', 'Routing Boundary', 'Example routing'), the Base Framework policy block adds boilerplate, and the ~35-line output-contract template inflates the main file. This matches 'mostly efficient but... could be tightened' rather than the 4 anchor's minor trims. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is highly concrete: per-principle diagnostic questions with false-positive gates, explicit severity/confidence rubrics, a copy-paste output template, mode-specific rules, and named tooling. It falls short of fully executable because the 'Required packaged policies' (shared/base/*.md) are referenced as required but do not exist in the bundle, leaving a gap in the guidance. | 4 / 5 |
Workflow Clarity | The five-step workflow is clearly sequenced (scope/trace, build design map, diagnose with false-positive gate, assess impact, propose safe path) with explicit validation checkpoints — the evidence -> change scenario -> impact -> improvement -> trade-off -> test chain, evidence classification tiers, tests-before-structural-advice rule, and a final quality checklist. This matches the 5 anchor's explicit validation steps and error-recovery guidance. | 5 / 5 |
Progressive Disclosure | The three real reference files (principles-and-evidence.md, refactoring-and-language.md, examples.md) are one level deep, well-signaled, and loaded at point of need. However, ten referenced paths (nine shared/base/*.md policy files and shared/workflow-contract.md) do not exist in the bundle despite being labeled 'Required', and the long output-contract template could live in a reference file — structure is present but organization has real gaps. | 3 / 5 |
Total | 15 / 20 Passed |