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 strong, lean detect-only skill body: executable commands verified against the real bundled script, a well-sequenced preferred path with fallback and stop conditions, and appropriate externalization of the rulebook and pattern data. Remaining gaps are minor — no failure-handling for detector errors, slight duplication between the Authority and evidence-lens sections, and non-linked file references.
Suggestions
Add a short failure-handling step to the Preferred path, e.g., "If the command exits 2, report the usage/I/O error and fall back to the manual detect-only workflow".
Trim the evidence-lens bullets that duplicate the Authority section's cautions, and reduce the three bash examples to the stdin and file variants (the --source-mode flag can be shown once).
Convert referenced file paths (../avoid-ai-writing/SKILL.md, router references, scripts/detect.js) into markdown links so navigation is one click.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and skill-specific — no generic concept explanations, and the heavy pattern data is correctly left in scripts/patterns.js. It stops short of anchor 5 because the "AI-engineering evidence lens" bullets partially restate cautions already covered in the Authority section, and three near-identical bash examples (stdin, file, rendered-markdown) could be compressed to two. It is well above anchor 3 since nothing explains material Claude already knows. | 4 / 5 |
Actionability | The Preferred path gives copy-paste-ready commands ("printf '%s' \"$TEXT\" | node scripts/detect.js --context general", "--file path/to/draft.md --source-mode rendered-markdown") whose flags and values match the actual bundled scripts/detect.js interface, covers the common input cases, specifies decision criteria for --context and --source-mode, and defines the fallback when Node is unavailable. This matches anchor 5: fully executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The Preferred path is a clear numbered sequence with condition points, an explicit fallback branch, an execution-integrity checkpoint ("Never claim execution unless the command actually ran", enforced by execution_evidence executed vs model_only), and explicit Stop conditions. It misses anchor 5 because there is no guidance for handling command failure (detect.js exits 2 on usage or I/O errors), leaving a minor validation gap — though the operation is read-only, so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | Structure is good and matches the actual bundle: the rulebook detail is delegated to ../avoid-ai-writing/SKILL.md, graph policy to the router references, and pattern mass to scripts/, with one-level-deep, clearly named paths. It falls short of anchor 5 because references are bare code paths rather than navigable links, and the lens bullets plus several contract details are inlined in SKILL.md where anchor 5's example would signal them as short pointer references. | 4 / 5 |
Total | 17 / 20 Passed |