Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-engineered, highly actionable multi-phase workflow with strong sequencing and validation checkpoints. It loses points on conciseness (some padding) and progressive disclosure (a long single-file body with no supporting reference files to split detail into).
Suggestions
Move the IDEA_REPORT.md template and the Phase 2 MCP brainstorm prompt into a references/ file (e.g. references/report_template.md) and link to them, shrinking SKILL.md to an overview.
Trim editorial sentences such as 'This is the key differentiator from paper-only validation' that restate what the section heading already conveys.
Extract the tools/research_wiki.py command catalog into a references/ or scripts/ file so the wiki integration steps become a short pointer rather than inline pseudocode.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and assumes Claude's competence (no beginner explanations of what research or papers are), but the ~270-line body includes some removable editorializing ('This is the key differentiator from paper-only validation') and templated prose that could be tightened. | 2 / 3 |
Actionability | Provides concrete executable commands (python3 tools/research_wiki.py ...), a copy-paste-ready MCP config block with a full prompt, and a complete report template; guidance is specific and actionable throughout even though it orchestrates sibling skills. | 3 / 3 |
Workflow Clarity | The seven phases are clearly sequenced with explicit validation checkpoints (first-pass filtering, novelty check, devil's-advocate review), feedback loops (re-rank on pilot results), and budget/time guards (PILOT_TIMEOUT_HOURS, MAX_TOTAL_GPU_HOURS). | 3 / 3 |
Progressive Disclosure | The body is well-sectioned but monolithic: everything (constants, MCP prompt, full report template, wiki commands) lives inline in a single SKILL.md with no bundle files in references/, scripts/, or assets/ to offload detail to. | 2 / 3 |
Total | 10 / 12 Passed |