Content
100%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 exemplary instruction-only skill body: a strict, gated two-phase sequence with feedback loops, explicit validation checkpoints, hard caps, and stop conditions, delivered with near-zero token waste. Delegations to other skills/playbooks are explicit and appropriately one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~60-line body is dense and imperative with zero concept explanation β every sentence carries operational content (caps, thresholds, stop conditions, tool delegations). Phrases like "Cap at 4. Still not π’ after that β Phase 2 anyway, capped" assume Claude's competence and earn their tokens, matching the lean-and-efficient anchor; nothing to trim to reach level 5, and it is far above the 'mostly efficient' level 3. | 5 / 5 |
Actionability | Guidance is concrete and executable: "Run `gh pr ready <n>` or `origin pr ready <n>`", "A few passes is normal. Cap at 4", "Still missing 30 minutes after... is a stop", and "passes `--allow-draft` to the watcher". For an instruction-only skill, this copy-paste-ready specificity with explicit thresholds covers the common cases, matching the fully-executable anchor rather than level 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | The sequence is explicit and gated: Step 0 classifies with a precise small-and-low-risk definition, Phase 1 is a validateβfixβre-run feedback loop with branch conditions per verdict and a hard cap, and Phase 2 has three ordered steps with validation checkpoints (Bugbot listed on the SHA, 30-minute stop, re-review after behavior-changing pushes that loops back to Phase 1). This matches the anchor with explicit validation, error-recovery loops, and checklists; level 4 would leave checkpoints merely implicit. | 5 / 5 |
Progressive Disclosure | The skill bundle has no references/, scripts/, or assets/ directories, and the body is a self-contained single-task workflow that needs none; per the scoring note, a skill with no need for external references can score 5 with well-organized sections, which this has (Classify / Phase 1 / Phase 2 / Hard rules / Reply). Cross-skill pointers ([../dyl-mode/references/requirements.md], poteto-mode/playbooks/babysit.md) are clearly signaled one level deep rather than buried nesting. | 5 / 5 |
Total | 20 / 20 Passed |