Content
71%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 well-sequenced, highly actionable guide with skill-specific knowledge (tell vocabulary, replacement tables, thresholds, before/after examples) rather than padding. Its main defect is bundle integrity: all three referenced files (two references, one script) do not exist, breaking both the progressive-disclosure navigation and the validation feedback loop.
Suggestions
Ship the referenced bundle files — create references/ai-tells-checklist.md, references/voice-techniques.md, and scripts/humanizer_scorer.py, or remove/inline the references; as delivered, every link and the scoring command is broken.
Add a fallback validation step for when the scorer script is unavailable (e.g., a manual tell-count heuristic per 500 words) so the 're-run and confirm the score moves' checkpoint always has an executable form.
Trim the rhetorical framing ('This is not a cleaning service...') and merge the Communication section into Output Artifacts to cut ~15-20 lines of token cost without losing guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient: the body teaches skill-specific knowledge Claude cannot be assumed to have (the AI-tell vocabulary, phrase-replacement table, rhythm patterns, scoring thresholds) rather than explaining known concepts. Minor trimming opportunities exist — the rhetorical framing ('This is not a cleaning service. You're not just removing "delve" and calling it a day.'), the Communication section overlapping the Output Artifacts table, and duplicated What+Why guidance in Mode 3 keep it below lean. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: an exact script invocation ('python3 scripts/humanizer_scorer.py draft.md --json') with decision thresholds (80+ / 60-79 / below 60), an AI-phrase → human-alternative replacement table, explicit before/after examples with named changes, and specific user questions to ask. Falls short of 5 because the scorer script referenced by the command is absent from the bundle, so the primary executable step cannot actually be run as shipped. | 4 / 5 |
Workflow Clarity | Clear three-mode sequence (Detect → Humanize → Voice Injection) with guidance on running sequentially vs. jumping, a preflight context check, and a genuine feedback loop ('Re-run after humanizing; the score must move') plus a proactive-triggers section covering failure paths (missing voice context, over-editing risk). Not 5 because the validation checkpoint depends on the missing scorer script, and there is no fallback validation stated for when it is unavailable. | 4 / 5 |
Progressive Disclosure | The structure is well designed on paper — SKILL.md stays an overview and points to references/ai-tells-checklist.md and references/voice-techniques.md with context for each — but the bundle contains no references/ or scripts/ directories, so both linked files and the scorer script are dangling references. Navigation fails in practice, and the inlined core tell list is content the missing checklist was supposed to carry. Between anchors 3 and 4; broken referenced paths pull it to 3. | 3 / 5 |
Total | 15 / 20 Passed |