Content
73%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-structured, highly disciplined policy skill: modes are crisply defined, validation and feedback loops are exceptionally thorough, and the heavy pattern catalog is properly externalized to a one-level-deep reference. The main costs are cross-section redundancy that inflates the 317-line body, and dangling bundle paths (examples/README.md, examples/<name>.json, detector/validate.js) referenced in the --style and mechanical-check sections that don't resolve.
Suggestions
Consolidate the rules stated multiple times across sections — protected-content exemptions (Editing contract, marks pass, Output format residuals) and editing-pass accounting (Iterate to convergence, marks pass, Output format) — into single stated-once sections; this is the largest conciseness lever in the file.
Fix or remove the dangling bundle paths: "examples/README.md", "examples/<name>.json", and "detector/validate.js" are referenced with operational weight (config schema, verification command) but do not exist in this bundle — either ship them or explicitly mark them as not bundled.
Inline a minimal --style config example (one small JSON snippet) so the preferred config path is executable without the missing examples/README.md, and add a short worked example of the <rewritten-prose> scratch-file marks-pass workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body does not explain concepts Claude already knows — nearly all 317 lines are novel operational policy — but the same rules are restated multiple times: protected-content gates appear in the Editing contract, the marks-pass paragraph, and the Output format residuals section, and editing-pass accounting is covered in "Iterate to convergence," "Automatic marks pass," and again across ~10 overlapping Output-format paragraphs. This matches "mostly efficient but includes some unnecessary explanation or could be tightened." Not a 2 because the verbosity is redundant policy rather than padded filler or pedagogy, and not a 4 because the cross-section repetition is substantial enough that consolidating would meaningfully shrink the file. | 3 / 5 |
Actionability | Concrete, executable commands are given with exact invocations and exit codes ("node scripts/normalize-quotes.js <rewritten-prose> --reference <original> --write", "node scripts/check-style.js <file> --config <path>" with "exit 0 clean / 1 hard violation / 2 tool error", "node detector/validate.js --residual-policy warn <original> <rewritten>") plus explicit natural-language invocation examples. Not a 5 because the --style config schema is deferred to "examples/README.md", which does not exist in the bundle, and the <rewritten-prose> scratch-file workflow is described abstractly without a worked example — minor gaps that keep it from fully covering the common cases copy-paste ready. | 4 / 5 |
Workflow Clarity | Each mode has an explicit numbered step list (rewrite: Audit/Rewrite/Summarize; detect: Audit/Assess; edit: Read/Edit-in-place/Verify), and validation is everywhere: re-read the file after editing, a four-item Verification checklist (Editing passes, Checks, Residuals, Stop reason), compare-final-with-source accounting, repair-within-remaining-budget feedback loops, and explicit failure reporting when a check cannot run. This matches the anchor-5 pattern of clear sequencing with explicit validation and error-recovery loops; the "Only proceed when validation passes" discipline is fully present. | 5 / 5 |
Progressive Disclosure | The 107KB pattern catalog is correctly split into references/patterns.md, clearly signaled once at the top ("read references/patterns.md in full") and one level deep, and the two invoked scripts are referenced with exact runnable paths that resolve in the bundle (markdown-prose.js is an internal dependency of those scripts, appropriately not surfaced). Not a 5 because the body references paths that do not exist in this bundle — "examples/README.md" ("Schema and rationale: examples/README.md"), "examples/<name>.json", and "detector/validate.js" — and the severity-tier catalog section (P0/P1/P2 pattern lists) partially duplicates material that lives in the reference file. Not a 3 because the references that do exist are clearly signaled, correctly scoped, and easy to navigate. | 4 / 5 |
Total | 16 / 20 Passed |