Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-architected, highly actionable skill body with a clear sequenced workflow, validation feedback loops, and properly split bundle references. Its main weakness is length — some framing is restated across sections and could be condensed.
Suggestions
Tighten conciseness: the sibling-contract and architecture-invariants material is partly restated across the description, the 'Sibling contract' table, and the 'Architecture invariants' list — consolidate to remove overlap.
The body references an evals/ directory ('See evals/') that does not exist in the bundle; either include it or drop the reference to avoid a dead pointer.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and mostly free of concept padding, but at ~200 lines it carries repeated framing (sibling-contract restated, invariants restated in prose and table) that could be tightened, so it sits at 'mostly efficient but could be tightened' rather than the lean level 3. | 2 / 3 |
Actionability | It gives concrete executable commands ('uv run apm <verb> --help', 'grep -n src/apm_cli/', 'python -c "import ..."'), named scripts, schema-validated returns, and specific wave shapes — copy-paste-ready guidance rather than abstraction. | 3 / 3 |
Workflow Clarity | The 8-step process is explicitly sequenced with validation checkpoints (schema validation of returns, alignment-loop re-grep, max 2 redrafts, single-writer git interlock), satisfying the feedback-loop requirement for batch operations. | 3 / 3 |
Progressive Disclosure | SKILL.md is a clear overview with well-signaled, one-level-deep references to real bundle files (assets/subagent-prompt-template.md, assets/panelist-return-schema.json, scripts/scan-cross-corpus-drift.sh), all present; content is appropriately split rather than inlined. The referenced evals/ dir is absent but that does not undermine the structure. | 3 / 3 |
Total | 11 / 12 Passed |