Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, actionable wrapper skill with a clear validated workflow; its main weaknesses are some over-explanatory prose and a bundle that omits the vendored upstream/ tree the body and detector both depend on.
Suggestions
Trim the `technical`-mode and CLAUDE_PLUGIN_ROOT/Codex asides to the essential one-liner each; Claude does not need the context-vs-voice distinction spelled out at length.
Ship the referenced `upstream/` directory (upstream/SKILL.md, upstream/UPSTREAM-PIN, upstream/detector/patterns.js) or note explicitly that detect.js is unavailable until the plugin fetches it, since detect.js fails with MODULE_NOT_FOUND without it.
If upstream/ is intentionally not bundled, replace the unconditional "run the bundled detector" instruction with a guarded step so the workflow does not dead-end on a missing dependency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with executable commands and a tight wrapper framing, but includes some over-explanation Claude doesn't need — the `technical`-mode digression ("It does not broadly relax vocabulary checks... context and voice are separate axes") and the CLAUDE_PLUGIN_ROOT-vs-Codex aside could be trimmed. | 2 / 3 |
Actionability | Gives copy-paste-ready commands ("node \"$SKILL_DIR/scripts/detect.js\" FILE"), lists valid modes, and describes the JSON output fields — fully executable, not pseudocode. | 3 / 3 |
Workflow Clarity | A numbered run sequence with an explicit validation/convergence feedback loop ("repeat the audit -> revise cycle until a scored result has no issues, or the cap of 2 passes") plus the UNSCORED edge-case checkpoint, matching the top anchor. | 3 / 3 |
Progressive Disclosure | Structurally a concise overview pointing one level deep to upstream/SKILL.md and the detector, but the referenced upstream/ directory is absent from the bundle (only scripts/detect.js ships, and it requires the missing upstream/detector/patterns.js), so the signaled references do not fully resolve. | 2 / 3 |
Total | 10 / 12 Passed |