Content
82%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.
The body is a deliberately minimal pointer stub that delegates all content to a single shared skill via one clearly signaled, one-level-deep reference with a concrete path. It is fully concise and actionable for its single purpose, with only minor gaps: no overview of the delegated content and no handling for the case where the shared path is unavailable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a maximally lean two-line pointer ('Load and follow the shared skill at `~/.agents/skills/small-change/SKILL.md`') with no explanation of concepts Claude already knows; the only extra line is a one-line provenance comment ('Generated by scripts/agent-harnesses.py; do not edit directly.') that also serves as edit guidance. Every token earns its place. | 5 / 5 |
Actionability | 'Load and follow the shared skill at `~/.agents/skills/small-change/SKILL.md`' is a single concrete, executable instruction with an exact path, matching 'mostly executable guidance'. It falls short of a 5 because there is no verification or fallback for the delegation (e.g., what to do if the shared path is absent) and no example beyond the single case, but it is far above 3 since nothing is vague or pseudocode. | 4 / 5 |
Workflow Clarity | For a single-purpose pointer skill the one action is unambiguous, and the simple-skill exception applies, but there is a minor validation gap: no checkpoint confirming the shared skill was actually loaded/followed. It is not 3 because the single step is clear rather than a gapped multi-step sequence, and not 5 because no explicit validation of the delegation exists. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and the body contains exactly one clearly signaled, one-level-deep reference ('Load and follow the shared skill at `~/.agents/skills/small-change/SKILL.md`') with no nesting. It misses 5 because the body provides no overview at all of what the delegated skill contains, so nothing can be discovered from this file alone. | 4 / 5 |
Total | 17 / 20 Passed |