Content
88%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.
An instruction-heavy but highly actionable body: the deterministic path is fully executable against a bundled script, decision rules name concrete statuses, warning codes, and envelope fields, and the repair loop is explicitly bounded with re-verification and a hard stop. The only notable costs are tri-stated no-false-claim caveats that could be consolidated and reliance on sibling-skill reference files that sit outside this bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with no explanation of concepts Claude already knows, but the model-only/no-false-claim guard is repeated three times ('Never claim it ran unless the current host executed it', 'Report this review as model-only rather than claiming the deterministic validator performed it', 'Do not claim the deterministic validator checked semantic representation details that it does not implement') and several lawyerly caveat sentences could be trimmed — fitting 'efficient; minor instances of over-explanation' rather than the every-token-earns-its-place anchor at 5. | 4 / 5 |
Actionability | Fully executable guidance: a copy-paste CLI command ('node scripts/validate.js --residual-policy warn before.md after.md'), a working require() example against the real bundled script, concrete statuses (PASS/REVIEW/FAIL), named warning codes (number-added, number-missing, residual-grew), and specific envelope fields (execution_evidence.verifier, verification_summary.status, pass.index, pass.max). | 5 / 5 |
Workflow Clarity | The skill is itself a validation checkpoint: incoming contract (require both versions or return to router), deterministic path, separate semantic review, explicit PASS/REVIEW/FAIL decision rules with repair-owner routing by source kind, and a bounded feedback loop ('At most one repair re-entry… After repair, verify once more. If that check still fails, stop and report'). Sequence and validation checkpoints are explicit throughout. | 5 / 5 |
Progressive Disclosure | The body is well sectioned (Connection contract, deterministic path, protected constraints, Result handling, Repair-loop limit, Output) and the heavy validator logic is correctly delegated to the bundled scripts/validate.js and patterns.js, both present. It falls short of 5 because four load-bearing references (../avoid-ai-writing/SKILL.md, ../avoid-ai-writing-router/references/handoff-contract.md, skill-graph.json, agency-role-lenses.md) point to sibling skills outside this bundle, so the envelope and routing semantics they define are not available for standalone navigation. | 4 / 5 |
Total | 18 / 20 Passed |