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 excels at actionability and workflow clarity — an explicit seven-pass sequence with loop-back checkpoints, runnable scoring scripts, and concrete before/after examples. It is dragged down by significant redundancy (each sweep's twin bullet lists, the verbatim checklist restatement, inline tables duplicating a bundled reference) and one orphaned reference file, making the ~500-line body noticeably less token-efficient than its content warrants.
Suggestions
Collapse each sweep's 'What to check' and 'Common issues' lists into a single deduplicated list, and cut the per-sweep loop-back sentences in favor of one statement of the return-chain rule at the top of the framework — this alone would remove well over a hundred lines.
Move the 'Copy Editing Checklist' section into a reference file (e.g., references/copy-editing-checklist.md) and keep only a pointer, since it restates all seven sweeps; likewise replace the inline word-replacement tables with a pointer to references/plain-english-alternatives.md.
Link references/ai-detection-patterns.md from the AI-Pattern Check section so the detector's output can be interpreted with the bundled patterns, and ensure every bundle file is reachable from SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose through systematic duplication: every sweep carries two overlapping bullet lists (e.g., Sweep 3's 'What to check: Features without benefits / Claims without consequences...' vs. 'Common So What failures: Feature lists without benefit connections...'), a per-sweep loop-back note that restates the return chain seven times, a ~50-line 'Copy Editing Checklist' that restates all seven sweeps nearly verbatim, and a word-replacement table ('Utilize→Use, Leverage→Use...') that duplicates the bundled references/plain-english-alternatives.md. This matches anchor 2 ('noticeably verbose; several unnecessary explanations or padded sections') — the duplicated material is domain-specific rather than concepts Claude already knows, so it is not the severe padding of anchor 1, but 'mostly efficient' (anchor 3) does not hold for a ~500-line body whose second half repeats its first. | 2 / 5 |
Actionability | Guidance is fully executable for an instruction-only skill: two runnable commands with flags and expected outputs ('python3 scripts/readability_scorer.py --file draft.md' with '--json', 'python3 scripts/ai_content_detector.py draft.md --json'), numbered per-sweep processes, a concrete before/after example (❌ 'Our platform uses AI-powered analytics' → ✅ benefit-bridged rewrite), specific vague→specific replacement tables, symptom/fix problem patterns, and an output-artifacts table mapping requests to deliverables. It matches anchor 5 — copy-paste-ready commands with specific examples covering the common cases. | 5 / 5 |
Workflow Clarity | The Seven Sweeps Framework is a clearly sequenced multi-step process with explicit checkpoints: each sweep ends with a return-loop instruction ('After this sweep: Return to So What, Voice and Tone, then Clarity'), Sweep 1 embeds a mechanical validation loop ('re-run the scorer; the Flesch score should improve, not regress'), and the collaborative workflow closes with 'Repeat until clean — Continue until a full sweep finds no new issues.' Editing is non-destructive and the AI-detector pre-check gates the workflow ('polishing AI mush produces polished AI mush'). This matches anchor 5: clear sequence, explicit validation steps, feedback loops, and a checklist. | 5 / 5 |
Progressive Disclosure | Structure exists (clear section headers, one properly signaled reference: '[Plain English Alternatives](references/plain-english-alternatives.md)', and both scripts referenced with usage), but scored against the actual bundle it has real gaps: references/ai-detection-patterns.md exists in the bundle yet is never linked from SKILL.md — the AI-Pattern Check section runs the detector but does not point to the patterns file — and substantial content that belongs in reference files is inlined (the word-level 'Cut these/Replace these' tables duplicate plain-english-alternatives.md, and the full checklist section restates the sweeps). This matches anchor 3 ('some structure... content that should be separate is inline') rather than anchor 4, where most content would be appropriately placed. | 3 / 5 |
Total | 15 / 20 Passed |