Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clearly sequenced, validation-gated workflow and clean one-level reference structure, though it carries redundant gating lists and repeated fail-fast directives that inflate length.
Suggestions
Merge the overlapping command lists in "Invocation and Visibility Proof Requirements" and "Baseline validation to confirm first" into a single gated-checklist section to remove duplication.
State the fail-fast rule once in a canonical location and reference it elsewhere instead of repeating it verbatim three times.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is directive and avoids explaining concepts Claude already knows, but it repeats itself: the "Invocation and Visibility Proof Requirements" and "Baseline validation to confirm first" sections duplicate the same ./bin/ask gating commands, and the fail-fast directive is stated three times, so it could be tightened rather than earning the lean-every-token-earns-its-place anchor at 3. | 2 / 3 |
Actionability | Provides concrete, copy-pasteable commands ("./bin/ask skills resolve unslopify --json", "./bin/ask repo validate --ephemeral", "rg", "fd") plus a decision matrix and ordered implementation batches, matching the fully-executable-guidance anchor rather than the pseudocode/incomplete anchor at 2. | 3 / 3 |
Workflow Clarity | Six numbered phases are clearly sequenced with explicit validation checkpoints ("Re-run relevant validation after each batch", baseline validation, fail-fast gates) and feedback loops (validate -> fix -> rerun the failed gate), matching the clear-sequence-with-validation anchor; it is not the 2 anchor because checkpoints are explicit, not implicit. | 3 / 3 |
Progressive Disclosure | A dedicated "Progressive Disclosure" section signals one-level-deep references to references/contract.yaml, references/evals.yaml, and references/task-profile.json, all verified to exist as real files, with no nested-reference chains; this matches the clear-overview-with-well-signaled-references anchor rather than the weakly-signaled anchor at 2. | 3 / 3 |
Total | 11 / 12 Passed |