Content
73%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 well-sequenced, highly structured process skill with explicit validation loops and concrete quantitative style rules, undermined by systematic restatement of the same rules across overlapping sections and by referenced resource files that are not included in the bundle.
Suggestions
Consolidate duplicated rules: state each rule (claim-evidence handling, verb selection, hedging calibration, mode branching) once — in Guardrails or the canonical workflow — and remove the repetitions across Scheduling, Scenes, Transitions, and the failure table.
Include the referenced `resources/` files (anti-ai-checklist, sentence-structure-reference, academic-verb-tiers, hedging-guide) in the bundle, or inline their essential tables so the signposted navigation actually resolves.
Add one compact worked example per mode (a short original→revised block for `revise`, and a filled Claim-Evidence Map row) so the named output formats are concrete rather than described.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly operational guidance rather than concept explanation, but the same rules are restated across many sections: 'weaken or remove' unsupported claims appears in Transitions, the failure table, Guardrail 9, and Canonical workflow step 5; verb-selection guidance repeats in Entry, Scene ACT, the failure table, and Guardrail 4. This systematic duplication across Scheduling/Scenes/Actions/Canonical-workflow is padding that could be consolidated — anchor 3 ('could be tightened'), not 5; not 2 because none of it explains things Claude already knows. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is largely concrete: named modes with defined output formats, quantified style rules ('Em dashes ≤ 1 per paragraph; semicolons ≤ 2 per 1000 words'), a 3-column Claim-Evidence Map, and a Topic-Support-Conclude template. Minor gaps: the mode output formats are named but never exemplified, and no sample before/after revision is shown, which keeps it below 'fully executable' anchor 5. | 4 / 5 |
Workflow Clarity | The sequence is explicit — Entry → PREPARE/ACQUIRE/ACT/VERIFY/FINALIZE → Exit — with validation checkpoints (VERIFY audit, read-aloud test, PASS/FAIL compliance report), a failure/recovery table, and genuine feedback loops ('If the same anti-AI flag survives one fix attempt → restructure the surrounding two sentences'; 'every fix loops back through the anti-AI checklist'). This matches the anchor-5 pattern of clear sequencing, explicit validation, and error-recovery loops, exceeding anchor 4's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | Structure is good: detailed protocols are pushed to clearly signaled one-level-deep references (`resources/anti-ai-checklist.md`, `sentence-structure-reference.md`, `academic-verb-tiers.md`, `hedging-guide.md`, plus shared core files), each with a stated purpose in Dependencies and a References section. It does not reach 5 because the referenced `resources/` and `../_shared/core/` files are not present in this bundle (only SKILL.md ships), so the signposted navigation cannot be verified or followed. | 4 / 5 |
Total | 16 / 20 Passed |