Content
78%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.
A well-structured instruction-only skill body: novel pattern definitions with smell/move pairs, explicit ordering rules, and a verification checklist, with no padding of concepts Claude already knows. The main weaknesses are a workflow scattered across four sections instead of one ordered procedure, an unspecified method for computing the risk-balance split, and minor chattiness in the feed-me section and the pattern-3 anecdote.
Suggestions
Define how the risk-balance 'share of capacity' is computed (initiative count vs. effort/spend weighting) so the Explore/Discovery vs. Build & Deliver split is reproducible rather than judged.
Collapse the workflow into one ordered procedure (feed inputs → choose scan approach → stale-status sweep → check the six patterns → run Quality Gates → emit the chosen output mode) so the sequence doesn't have to be reconstructed from Prerequisite, Rules, and Quality Gates.
Tighten the lowest-density passages: shorten the pattern-3 anecdote caveat ('treat it as an anecdote...not a benchmark') and the first-person 'How to Run Me — What to Feed Me' framing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence — it never explains what a Kanban or portfolio is, and the patterns/rules/gates all carry novel information. Minor trimming opportunities exist: the 'How to Run Me — What to Feed Me' first-person framing and the pattern-3 anecdote caveat ('treat it as an anecdote to calibrate against, not a benchmark') are chattier than needed. Mostly efficient with minor over-explanation, so anchor 4 rather than the lean-every-token-earns-its-place anchor 5. | 4 / 5 |
Actionability | Concrete guidance dominates: each pattern has a Smell and a Move ('merge, make one a sub-issue', 're-cut to the riskiest assumption, or graduate it honestly'), plus a scan-approach selection table and three defined output modes. Minor executable gaps remain: how to compute the 'share of capacity' risk-balance split (initiative count vs. effort/spend) is unspecified, and the stale-status sweep procedure is delegated wholesale to the external base skill. Mostly actionable with minor gaps, so 4 rather than fully-executable 5. | 4 / 5 |
Workflow Clarity | Ordering constraints are explicit ('A stale-status sweep comes before any risk-balance claim', 'Run (or assume) base sniff-test reads... first') and the Quality Gates section is a verification checklist including a retry loop ('correct the stages, then re-read the balance'). However, the end-to-end sequence must be assembled from Prerequisite, Scan Approaches, Rules, and Quality Gates rather than one ordered procedure. Clear sequence with most checkpoints present, so 4 rather than the fully-checkpointed 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist and the inline content (the six patterns, rules, output modes, gates) is the core payload that belongs in SKILL.md. External references — '../sniff-test/SKILL.md' and its 'references/', and '../../CREDITS.md' — are one level deep and clearly signaled in a dedicated References section. Sections are well-organized and easy to navigate, matching the clear-overview anchor rather than the minor-organization-gaps level below. (The referenced sibling skill is not present in this review sandbox, but it is a cross-skill dependency, not a buried or nested reference.) | 5 / 5 |
Total | 17 / 20 Passed |