Content
60%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.
The body is a thorough, well-structured research-ideation workflow with concrete tool calls, explicit gates, and well-signaled reference files. Its main weakness is heavy redundancy — the same ideation protocol is restated across multiple sections — which inflates token cost without adding guidance.
Suggestions
Consolidate the diverge/converge/refine guidance (currently restated in Stage purpose, Non-negotiable rules, Direction-shaping protocol, Creative-divergence protocol, Integrated ideation workflow, and Workflow steps) into a single canonical section; reference it from the others instead of repeating it.
Cut general methodology explanations Claude already knows (MECE, SCQA, pyramid principle, what a hypothesis is) or move them to a reference file; keep the body focused on the DeepScientist-specific artifact calls, gates, and thresholds.
Promote the inlined ideation-lens catalog and failure-mode/recovery-move lists into a reference file (alongside idea-generation-playbook.md) so the SKILL.md body stays a lean overview pointing to one-level-deep details.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Noticeably verbose: the diverge/converge/refine pattern and the '5-10' paper floor are restated nearly verbatim across seven overlapping sections, and general methodology Claude already knows (MECE, SCQA, pyramid principle) is re-explained. | 2 / 5 |
Actionability | Provides concrete tool-call signatures (artifact.submit_idea, artifact.arxiv, memory.search), file paths, and numeric thresholds (5-10 papers, 6-12 raw ideas, 7/10 gate), with minor gaps where guidance stays abstract and delegates to references. | 4 / 5 |
Workflow Clarity | A clear numbered 8-step workflow with explicit gates (paper floor, 7/10 selection gate, narrative defensibility precheck) and feedback loops (route back to scout, re-widen); validation is present but scattered rather than in one checklist. | 4 / 5 |
Progressive Disclosure | Seven real one-level-deep reference files are all clearly signaled in the body; the gap is the monolithic 1290-line body inlining protocol content that overlaps the reference playbooks. | 4 / 5 |
Total | 14 / 20 Passed |