Content
63%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 is a tightly written procedural contract with a clear sequenced workflow, explicit verification feedback loop, and disciplined stop conditions. Its weaknesses are the delegation of the core editing rules to a sibling file absent from this bundle and the scattered, hard-to-parse editing-pass rules.
Suggestions
Inline a minimal summary of the core editing rules (pattern categories, rewrite mechanics, protected-region handling) in this SKILL.md so the skill remains actionable when the sibling `../avoid-ai-writing/SKILL.md` is not present.
Split workflow step 9 into short, separate rules for pass counting and consolidate the pass-state rules currently repeated across Workflow, Repair path, Stop conditions, and Output into a single section.
Reproduce or summarize the essential fields of the referenced handoff files (handoff-contract.md, skill-graph.json) within the bundle, or add a references/ directory containing them, so navigation to detail content does not depend on external skills.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, directive prose with no padding or explanation of concepts Claude already knows — every section issues rules rather than background. It falls short of the 5 anchor because the editing-pass rules are stated redundantly across Workflow step 9, the Repair path, Stop conditions, and Output, which could be consolidated. It is well above the 3 anchor since there is no genuinely unnecessary explanation. | 4 / 5 |
Actionability | Process guidance is concrete ("increment the editing-pass count from 0 to 1", "Change only the spans implicated by the blocking preservation errors", "Return the full text exactly once under **Final rewrite**"), but the core how-to-rewrite rules are delegated: "Rewrite text using the complete rules in `../avoid-ai-writing/SKILL.md`. Its editing contract is the authority for … mechanics", and that file is not part of this bundle. This matches the 3 anchor (some concrete guidance but incomplete, missing key details) rather than the 4 anchor, whose gaps are minor rather than the skill's central mechanics. | 3 / 5 |
Workflow Clarity | A clear 10-step workflow with an explicit verification checkpoint ("Send before/after content to `preservation-verifier`") and a genuine feedback loop (FAIL → repair implicated spans → re-verify once → stop), satisfying the anchors above 3. It misses the 5 anchor because step 9 packs the entire pass-counting protocol into one convoluted compound sentence and pass-state rules are scattered across four sections, making the sequence harder to follow than the anchor's crisp checklist style. | 4 / 5 |
Progressive Disclosure | Sections are well organized (Connection contract, Conditional guard, Workflow, Repair path, Voice handling, Stop conditions, Output) and references are clearly signaled, but every substantive detail file — the editing contract, handoff contract, skill graph, and role lenses — lives outside this bundle ("../avoid-ai-writing/SKILL.md", "../avoid-ai-writing-router/references/…") and no references/, scripts/, or assets/ directories exist here, so the overview-to-detail navigation cannot be exercised within the bundle. This sits between the 3 anchor (organization present but the detail layer fails) and the 4 anchor; the missing authority content is more than a minor organization gap. | 3 / 5 |
Total | 14 / 20 Passed |