Content
92%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-orchestrated, highly actionable skill body with concrete tool invocations, an explicit user-review feedback loop, and correctly externalized templates. The only notable weakness is redundancy between the Purpose, When to Use, and Context Compaction sections, which could be consolidated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely efficient: it assumes Claude's competence (no explanation of what subagents or web research are) and the depth tables and dispatch example earn their tokens. However, the 'Purpose' bullet list substantially duplicates the 'When to Use' section, and the 'Context Compaction' section restates the rationale already given in step 6 — more than minor trimming opportunities, but not the padding of anchor 3. | 4 / 5 |
Actionability | Fully executable guidance throughout: concrete tool calls ('Task tool calls with run_in_background: true', 'TaskOutput block: false', 'AskUserQuestion', '/clear', '/draft'), a literal example dispatch block for a realistic feature, exact artifact path pattern 'docs/plans/YYYY-MM-DD-{topic}-research.md', and named subagent types. Specific examples cover the common cases; nothing remains pseudocode. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with explicit checkpoints: step 3 defines thin-result handling ('note the gap — do NOT dispatch a follow-up agent'), step 5 is marked REQUIRED and contains a feedback loop ('If the user requests edits → update the artifact in place... Repeat until the user approves'), and step 6 mandates stopping with clear prohibitions. Not destructive/batch work, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | The body is a proper overview with both detailed materials externalized one level deep via clearly signaled links: 'see [agent prompts](references/agent-prompts.md) for full templates' and 'Use the [research artifact template](references/template.md)' — both verified to exist and contain exactly the promised content. No monolithic inline content that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |