Content
77%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 orchestration skill with a clearly sequenced workflow, explicit validation loops, and exemplary progressive disclosure into two real reference files. The main weakness is redundancy at the end, where the same termination and handoff instructions are repeated across three sections.
Suggestions
Delete the '## After Research' section — it restates Workflow steps 4-6 (artifact written, user reviews, /clear, /draft) almost verbatim, adding ~10 lines of pure duplication.
Merge '## STOP — Phase Complete' into Step 6, whose closing 'Then STOP. Do not take any further actions' already conveys the same boundary; keep the do/don't bullets as a short list under Step 6.
Trim '## Context Compaction' to 2-3 lines or fold it into '## Purpose' — its before/after framing repeats the purpose bullets and the /clear rationale already given in Step 6's 'Why /clear?' note.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core workflow, depth tables, and anti-patterns are efficient and earn their tokens, but the ending is stated three times — Step 6's 'Then STOP. Do not take any further actions', the entire '## STOP — Phase Complete' section, and the '## After Research' section all restate the same termination and /clear → /draft handoff. The 'Context Compaction' section also partially re-explains the Purpose rationale; tightening these would lift it to 4-5. | 3 / 5 |
Actionability | Highly actionable throughout: a concrete dispatch example ('Add discount codes to orders'), exact artifact path pattern ('docs/plans/YYYY-MM-DD-{topic}-research.md'), explicit tool usage ('TaskOutput block: false/true'), a verbatim copy-paste Step 6 output block, and links to real reference files. Not a 5 because the Task dispatch snippet ('Task(Explore): "..."') is illustrative pseudo-syntax rather than literal tool invocations, and agent counts are given as ranges. | 4 / 5 |
Workflow Clarity | Six clearly numbered, sequenced steps with explicit validation checkpoints: a REQUIRED user-review step with an edit→re-ask feedback loop ('Repeat until the user approves'), thin-results handling guidance in Step 3, an explicit stop condition, and an anti-patterns checklist. This matches the anchor-5 pattern of clear sequence with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The body is a workflow overview that appropriately delegates detail to two real, one-level-deep, clearly signaled references — [agent prompts](references/agent-prompts.md) for full Task prompt templates and [research artifact template](references/template.md) for the output format. Both files exist, are linked with descriptive context, and no content that belongs in a separate file is inlined. | 5 / 5 |
Total | 17 / 20 Passed |