Generate structured research reports. Use when the user wants to research a topic, compare technologies, evaluate a GitHub repo or tool, says "research", "调研", "对比", "评估", "compare", "evaluate", or "/research".
Generate structured research reports through a 6-phase adaptive pipeline.
Run this command via Bash to get the current date. Use it in all time-sensitive searches.
date +%Y-%m-%d
Extract the user's research topic from the arguments. Check for --auto flag — if present, remove it from the topic and enable autonomous mode.
Look for an existing research-*/state.json in the current directory matching this topic. If found:
state.jsonAnalyze the query to determine the research type:
| Signal | Type |
|---|---|
| Multiple named entities + comparison verbs (vs, 对比, compare, 比较, versus) | comparison |
| Single named project/tool + decision verbs (评估, 是否, 值不值得, should I use, worth, evaluate) | evaluation |
| Topic/question without specific entities or decision intent | deep |
Unless --auto mode is enabled, present the classification to the user via AskUserQuestion:
Create the output directory: research-{topic_slug}/
Slugify the topic: lowercase, replace spaces/special chars with hyphens, truncate to 50 chars.
Write state.json:
{
"phase": 1,
"type": "comparison|evaluation|deep",
"topic": "the research topic",
"auto": false,
"date": "YYYY-MM-DD",
"topic_slug": "slugified-topic"
}
After Phase 1 completes, sequentially invoke each sub-skill. After each phase, update state.json with the current phase number.
Read the research-structure skill from ~/.claude/skills/research/skills/research-structure/SKILL.md and follow its instructions. Pass the output directory path and state.json contents.
Read the research-retrieve skill from ~/.claude/skills/research/skills/research-retrieve/SKILL.md and follow its instructions.
Read the research-validate skill from ~/.claude/skills/research/skills/research-validate/SKILL.md and follow its instructions.
Read the research-critique skill from ~/.claude/skills/research/skills/research-critique/SKILL.md and follow its instructions.
If --auto mode and the topic appears lightweight (short query, no technical depth), skip Phase 5.
Read the research-report skill from ~/.claude/skills/research/skills/research-report/SKILL.md and follow its instructions.
After Phase 6, report to the user:
report.md for English, report-zh.md for Chinese)