Content
82%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 tight, executable instruction file: commands are concrete and verified against the bundled detector, the sequence is clear, and heavy pattern data is properly split out of SKILL.md. The main gaps are minor — repeated detect-only constraints and no handling of detector command failures.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of padding or explanations of concepts Claude already knows, but the detect-only/no-rewrite constraint is repeated across the intro ('Never rewrite unless the user changes the request'), the produce/outgoing rules, 'Stop conditions', and 'Output' ('no rewritten version unless control has explicitly passed to a rewrite owner'), which could be consolidated. | 4 / 5 |
Actionability | The body gives copy-paste-ready commands for the common cases (stdin via "printf '%s' \"$TEXT\" | node scripts/detect.js --context general", file input, and --source-mode rendered-markdown for frontmatter-bearing Markdown), with concrete flag values that match the actual scripts/detect.js contract, plus an explicit fallback when Node is unavailable. | 5 / 5 |
Workflow Clarity | A clear 6-step numbered 'Preferred path' with explicit stop conditions and a no-Node fallback sequences the work well, but there is no error-recovery guidance for command failure (detect.js exits 2 on usage or I/O errors, yet the body never says what to do on a non-zero exit). No destructive/batch cap applies since the workflow is read-only. | 4 / 5 |
Progressive Disclosure | The ~94-line body is a well-sectioned overview that correctly pushes the 180KB pattern engine into scripts/ and references the real, one-level-deep scripts/detect.js. However, four referenced paths (../avoid-ai-writing/SKILL.md and the three ../avoid-ai-writing-router/references/ files) point outside the shipped bundle and cannot be navigated from what is present here. | 4 / 5 |
Total | 17 / 20 Passed |