Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A dense, highly actionable router skill with concrete tool invocations, explicit validation gates, and clean one-level reference splitting. Its one notable weakness is conciseness: parallelism/sequencing rules are restated across several emphasized sections and could be consolidated.
Suggestions
Merge the overlapping dispatch-sequencing guidance in 'Default Agy Fan-Out', 'HARD GATE', 'Parallel Execution Rules', and 'Parallel only when axes differ' into a single canonical sequencing section to remove redundancy.
Reduce repeated emphasis markers (⚠/🟢/⛔) and inline restatements of the ≤1-agy rule; state each constraint once at its canonical location.
Confirm gotchas.md exists at the skill root alongside references/, since it is referenced as 'gotchas.md' rather than under references/.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence and never explains known concepts, but dispatch-sequencing guidance is spread redundantly across 'Default Agy Fan-Out', 'HARD GATE', 'Parallel Execution Rules', and 'Parallel only when axes differ', and heavy ⚠/🟢/⛔ emphasis markers could be consolidated — so it could be tightened. | 2 / 3 |
Actionability | It gives concrete, copy-paste-ready invocations — 'agy-agent --model pro --grounded "<question>"', 'exa → get_code_context_exa', 'mcp__plugin_agentmemory_agentmemory__memory_smart_search({ query: ..., limit: 5 })' — and a signal→tool table mapping each case to a specific primary and escalation tool. | 3 / 3 |
Workflow Clarity | The flow (Bootstrap → Mode → Depth Calibration → Detection → dispatch → Synthesis → Follow-Up) is sequenced with explicit validation gates (the HARD GATE requiring primary output to be read before OMO dispatch, the Max Mode cost guard), an error-recovery feedback loop (partial-failure synthesis naming failed lanes), and a persist-insight checklist. | 3 / 3 |
Progressive Disclosure | SKILL.md acts as a router overview with well-signaled, one-level-deep references — 'See references/max-mode.md for...', plus synthesis-rules.md, prompt-templates.md, and type-a-notes.md — and all four referenced files exist in references/, with detail appropriately split out rather than inlined. | 3 / 3 |
Total | 11 / 12 Passed |