deep-research · autohandai — Claude Code skill: research and install
This skill investigates a topic across multiple sources and saves a cited report. Use it when claims need checking, comparison, and a documented trail.
npx skills add autohandai/code-cli --skill deep-research -a claude-codeWhat deep-research does
The skill turns a research request into a set of concrete subquestions, then tracks the work with todo_write. It discovers material through web_search, reads selected pages with fetch_url, records source details, and checks for stale or conflicting claims. Broad topics can be split across available agent or task tools found with tool_search.
It writes a self-contained Markdown report to the path supplied by the slash command. The report includes a title, summary, findings, open questions, and numbered citations linked to a sources section. The environment must provide web_search, fetch_url, todo_write, read_file, and write_file; without the first two, the source-gathering phase cannot run.
What it helps with
- turn a broad topic into researchable subquestions
- find and read primary sources
- check claims across independent references
- save a cited report with documented uncertainty
Example prompts for the agent
- Research this question across primary sources and save the report to
research/report.md. - Compare official documentation and papers on this topic, flag contradictions, and write the result to
docs/research.md. - Break this request into subquestions, verify each one with multiple sources, and save the Markdown report at
reports/topic.md.
How to install deep-research
1Skills CLI (Vercel)
npx skills add autohandai/code-cli --skill deep-research -a claude-code2Manually: put the files in place
~/.claude/skills/deep-research/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/deep-research/
1Skills CLI (Vercel)
npx skills add autohandai/code-cli --skill deep-research -a codex2Manually: put the files in place
.agents/skills/deep-research/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add autohandai/code-cli --skill deep-research -a cursor2Manually: put the files in place
.cursor/skills/deep-research/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install autohandai/code-cli deep-research2Manually: put the files in place
.github/skills/deep-research/SKILL.md1Skills CLI (Vercel)
npx skills add autohandai/code-cli --skill deep-research -a gemini-cli2Platform CLI
gemini skills install https://github.com/autohandai/code-cli --path src/skills/builtin/deep-researchManually: put the files in place
.devin/skills/deep-research/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add autohandai/code-cli --skill deep-research -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about deep-research
How do I install deep-research in Claude Code?
Run npx skills add autohandai/code-cli --skill deep-research -a claude-code, then check ~/.claude/skills/deep-research/SKILL.md.
What does deep-research do?
It decomposes a research request, gathers and reads sources, checks claims against each other, and writes a cited Markdown report to the requested path.
Which tools does deep-research require?
The skill uses todo_write, web_search, fetch_url, tool_search, read_file, and write_file. web_search and fetch_url are needed to gather source material.
Source text
SKILL.md · Apache-2.0
--- name: deep-research description: Conduct iterative, multi-source deep research on a topic and produce a cited project report. allowed-tools: todo_write web_search fetch_url tool_search read_file write_file --- You conduct iterative, multi-source deep research and produce a reusable cited research report. ## Scope The Question 1. Restate the user's research topic or question in concrete terms. 2. Identify 4-8 subquestions that would fully answer it. 3. Ask at most one clarifying question only when the topic is too ambiguous to research safely. 4. Track the research phases and subquestions with `todo_write`. ## Gather Evidence For each subquestion: 1. Use `web_search` to discover current sources. 2. Use `fetch_url` to read the strongest sources instead of relying on snippets. 3. Prefer primary sources, official documentation, papers, standards, release notes, or direct project/company material. 4. Record each source URL, source title, publication date when available, fetched date, and confidence. 5. Look for disagreement, stale claims, and missing context. 6. Continue pulling threads until every subquestion is answered or the gap is explicitly documented. Use `tool_search` to find available agent, task, or parallel research tools when the research topic is broad enough to benefit from delegation. ## Synthesize 1. Cross-check load-bearing facts against at least two independent sources when possible. 2. Note whether evidence is recent, historical, speculative, or contradicted. 3. Resolve contradictions when the evidence supports a resolution; otherwise flag them. 4. Keep unverified claims out of the report. ## Report Write a self-contained markdown report to the path supplied by the slash command. Required sections: - `# <clear title>` - `## Summary` - `## Findings` - `## Open questions / uncertainty` - `## Sources` Findings must be organized by theme or subquestion and include inline numbered citations like `[1]`. The Sources section must number every cited source and include title, URL, publication date if known, and fetched date when useful. Do not stop until the report is saved with `write_file` and the final response includes the exact saved path.
© autohandai · Apache-2.0 · autohandai/code-cli
Similar skills
All skills for Agent setup: memory, context, orchestration →deep-research by other authors comes first.