Content
88%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 dense, disciplined instruction skill: an unambiguous four-step workflow with validation as an explicit deliverable (step 3), exact repo paths and analyzer IDs, and executable evidence-collection commands. The only weaknesses are minor — no example code for the constraint-authoring step itself and a single-file layout that inlines repo-specific catalogs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line is either compressed doctrine ("A repeated correction is an environment bug. Fix the kitchen, not the dish."; "Cost is what you pay to write it plus what you pay to keep it true.") or concrete instruction, with no explanation of concepts Claude already knows — mutation survivors, analyzers, and gh are used without preamble. The brief philosophical lines are load-bearing heuristics rather than padding, matching the "every token earns its place" anchor. | 5 / 5 |
Actionability | The evidence step is copy-paste ready (gh pr list, gh run list, scan.py, run-mutation-smoke.sh, the gh api loop with REPO assigned) and the layer table gives exact paths (.editorconfig, BannedSymbols.txt, src/Zipper.Analyzers/, tests/goldens/) plus existing analyzer IDs ZIP001–ZIP004. Minor gaps keep it below a 5: the core deliverable — writing the analyzer/test/hook — has concrete procedures ("a case in src/Zipper.Analyzers.Tests/ that fails on the bad shape and passes on the fixed shape") but no example code, and PR must be set manually mid-block. | 4 / 5 |
Workflow Clarity | A clear four-step sequence (collect evidence, pick the narrowest layer, prove the constraint fires, land one change) with explicit validation throughout: "Do not fix the individual instances yet", "test: red first, then implement", "make a scratch change that violates the rule, run the gate, paste the failure, then revert". It even handles the edge case where validation cannot exercise itself ("the pre-push gate exits green without running the new operator. Prove it manually"), and the Red flags section acts as a checklist — matching the top anchor with feedback loops and no missing checkpoints. | 5 / 5 |
Progressive Disclosure | Clean single-level structure with well-organized sections ("## When this applies", numbered steps 1–4, "## Red flags") and nothing buried or nested. It scores 4 rather than 5 because at ~117 lines it exceeds the under-50-line simple-skill exception, and repo-specific catalogs (the layer table, the analyzer ID registry, the evidence commands) are inlined in one file rather than split into one-level-deep reference files. | 4 / 5 |
Total | 18 / 20 Passed |