Content
92%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 excellent orchestration skill body: concrete tool-call specs, a gated wave loop with explicit validation and merge stops, and clean one-level reference files that all exist. The only weakness is minor redundancy in the anti-patterns' restated ALWAYS lines.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no concept tutorials, no library explainers — but has minor trimmable padding: each anti-pattern's trailing "ALWAYS ..." sentence restates the section heading (e.g., "ALWAYS paste the focus text unedited" after "NEVER paraphrase the task description"), and the "Consequence:" paragraph in the last anti-pattern is motivational rather than instructional. Not 5 because of these redundant echoes; well above 3 since almost everything earns its place. | 4 / 5 |
Actionability | Fully executable guidance: exact Agent call parameters ("subagent_type: general-purpose", "isolation: worktree", "description: Wave N: <branch>"), concrete tier resolution steps pointing at references/model-map.yaml, a verbatim report message for the merge gate, and runnable build-check commands ("make build && make test", "npm run build && npm test"). Copy-paste ready for the common cases; nothing is pseudocode. | 5 / 5 |
Workflow Clarity | The 2a–2g loop is clearly sequenced with explicit checkpoints: gate check against ticked Verification items, a hard STOP merge gate with verbatim message, waiting for user confirmation, and post-merge build validation with error consequence spelled out. Blocked-phase handling and the 'skip DONE waves' rule close the remaining gaps; this is a batch operation and validation is present throughout. | 5 / 5 |
Progressive Disclosure | Clear overview body with well-signaled, one-level-deep references: references/per-agent-template.md, references/model-tier-guide.md, and references/model-map.yaml all exist in the bundle, are cited at their point of use (steps 2b.5/2c) and again in a closing References section with per-file purpose notes. The only external pointers (wave-execution-planner's wave-format.md and status-tracking.md) are clearly attributed cross-skill references, not nested indirection. | 5 / 5 |
Total | 19 / 20 Passed |