Content
81%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 content is a well-sequenced, executable protocol with strong validation gates and concrete shell commands throughout. Its main room for improvement is trimming repeated jargon and possibly externalizing some inline detail.
Suggestions
Consolidate the repeated 'force-robust / verifier-first / does not stall, run away, or claim false success' phrasing so it appears once rather than being restated across the intro, §5, and §6.
Consider moving the full runner-resolution shell block and the route-decision branch table into a referenced reference file so SKILL.md reads as a lean overview.
Replace the '<the user's goal>' placeholder in the §3 example with a concrete illustrative goal so the command is fully copy-paste-ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is action-oriented and avoids explaining basics Claude already knows, but recurring phrases like 'force-robust', 'verifier-first', and the restated loop invariants in §6 add some padding that could be trimmed. | 4 / 5 |
Actionability | It provides concrete, mostly copy-paste-ready shell snippets (runner resolution, 'auth ensure', 'hep-storm ... --research-evidence', 'hep-call ... --project .') and a concrete branch table, with only minor placeholder gaps like '<the user's goal>'. | 4 / 5 |
Workflow Clarity | A clear numbered sequence (§1–§7) with explicit validation checkpoints — scope-lock, issue contract, verify, bounded repair/retry, final-gate — and feedback loops for a destructive/batch-class operation, satisfying the validation requirement rather than capping at 3. | 5 / 5 |
Progressive Disclosure | Single self-contained file with well-organized numbered sections and no bundle files to reference; no nested links, though some inline detail (e.g. the full runner-resolution script and branch table) could be split out for an even cleaner overview. | 4 / 5 |
Total | 17 / 20 Passed |