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.
The body delivers highly actionable, well-sequenced editing workflows with pervasive validation requirements, and it correctly pushes the pattern catalog to a one-level-deep reference file. Its weaknesses are verbosity from extensive rule restatement across sections and bundle/reference mismatches: cited examples/ and detector/ paths do not exist, and one bundled script is orphaned.
Suggestions
Consolidate the editing-pass budget, protected-content, and verification rules into one authoritative section (Editing contract or Output format) and reference it from the other sections instead of restating each rule three to four times.
Fix the bundle/reference mismatches: either include the examples/ directory (README.md and sample configs like technical.json) referenced by the --style section or remove those citations, and reference scripts/markdown-prose.js (or remove it from the bundle) so every bundled file is discoverable.
Trim the research-citation digression in "What this skill is and isn't" to one or two sentences of misuse guidance; the full study citations are context Claude does not need to execute the editing task.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 310-line body is mostly skill-specific policy rather than explanation of concepts Claude already knows, but it is heavily padded with restatement: the editing-pass budget is explained in "Iterate to convergence," again in the marks pass, twice in "Rewrite mode (default)," and again in "Edit mode"; protected-content rules appear in the Editing contract, the marks pass, and the Verification sections. The ~20-line detector-research digression (Liang et al., Jabarian & Imas, arXiv citations) and lawyerly restatements like "A pass count alone is not a stop reason" could be cut to roughly half the length. Not 2: nearly every paragraph carries a skill-specific rule rather than filler or generic explanation. | 3 / 5 |
Actionability | Guidance is largely executable: exact commands with flags 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"), quoted mode-trigger phrases, and per-mode numbered step lists with required output sections. Not 5: "examples/README.md" and "examples/<name>.json" are cited as the schema documentation for --style configs but the examples/ directory does not exist in the bundle, so that guidance dead-ends. | 4 / 5 |
Workflow Clarity | Each mode has a clear numbered sequence (rewrite: audit → rewrite → summarize; edit: read → minimal in-place edits → re-read and verify) with explicit validation checkpoints — the four-item Verification checklist (Editing passes, Checks, Residuals, Stop reason), the before-delivery source comparison, the mechanical preservation validator, and feedback loops (repair within remaining pass budget, re-validate, report unresolved failures). Not 4: validation is not merely present but structurally required at every exit point, including no-op and failure paths. | 5 / 5 |
Progressive Disclosure | The single deep reference (references/patterns.md) is well signaled with a mandatory-load directive and holds the pattern catalog, and scripts are referenced by path — one level deep, matching the anchor-4/5 structure. Not 5: the bundle structure is inconsistent with the body — "examples/README.md", "examples/<name>.json", and "detector/validate.js" are referenced but absent, while bundled scripts/markdown-prose.js is never mentioned anywhere in SKILL.md. | 4 / 5 |
Total | 16 / 20 Passed |