# deep-research

deep-research turns a topic into an extendable outline, sends parallel agents through each item, then writes a markdown report. Built for comparing a set of things across shared fields.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 120 installs · ★ 61 repo stars
- Author: akillness
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/deep-research/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/akillness-deep-research

## What it does

The skill acts as a router. It sorts a request into one of four phases: outline, deep, report, web-search. Then it loads the matching instruction file from `references/` and follows the steps: build an extendable outline for the topic, run a separate web search per item in parallel, write the findings as JSON with a field-coverage check, render a markdown report with a table of contents. Each phase stops at a checkpoint and waits for your go-ahead.

Four pipelines carry their own prompt templates and output contract. Outline can add items and fields, deep runs the per-item agents, report writes the TOC and the field-by-field text, web-search splits queries across five source modules: GitHub debugging, general web, academic papers, Chinese tech sources, Stack Overflow. Everything is plain Markdown, so it runs in Claude, Codex, Gemini CLI, Cursor, Copilot and OpenCode.

Deep and report need Python 3 with `pyyaml`, since `validate_json.py` will not check field coverage without it. On OpenCode, web search needs `OPENCODE_ENABLE_EXA=1` set first. Ready-made slash commands for Claude, OpenCode and Codex live upstream and get copied by `WITH_UPSTREAM=1 bash scripts/install.sh`.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-research -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/deep-research/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/deep-research/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-research -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/deep-research/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-research -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/deep-research/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills .agent-skills/deep-research/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/deep-research/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-research -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/deep-research
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/deep-research/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill deep-research -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/deep-research/SKILL.md

## When to use it
- draft a comparison outline for a set of tools or papers
- fan out per-item web searches in parallel
- validate that no outline field is left empty
- render a shareable markdown report with a TOC
- extend an existing outline with more items or fields

## Example prompts
- Build a research outline for open-source vector databases with fields for licence, language and GPU support.
- Now go deep on every item and check that each field is filled.
- Generate `report.md` with a table of contents from the collected JSON.

## Similar
- [github-deep-research](https://affpapa.org/en/nevibecode/skills/github-deep-research.md) — skill · 2900 installs
- [github-research](https://affpapa.org/en/nevibecode/skills/github-research.md) — skill · 1800 installs
- [research-deep](https://affpapa.org/en/nevibecode/skills/research-deep.md) — skill · 971 installs
- [parallel-web](https://affpapa.org/en/nevibecode/skills/parallel-web.md) — skill · 2200 installs
- [deep-dive](https://affpapa.org/en/nevibecode/skills/rohitg00-deep-dive.md) — skill · ★ 2858 repo stars
- [Research Report Generator — Multi-Source Analysis](https://affpapa.org/en/nevibecode/mcp/research-report-generator-multi-source-analysis.md) — MCP server · 5001 installs

## Other versions with the same name
- [deep-research · imbad0202](https://affpapa.org/en/nevibecode/skills/imbad0202-deep-research.md) — 8200 installs
- [deep-research · affaan-m](https://affpapa.org/en/nevibecode/skills/affaan-m-deep-research.md) — 7000 installs
- [deep-research · bytedance](https://affpapa.org/en/nevibecode/skills/bytedance-deep-research.md) — 2800 installs
- [deep-research · 199-biotechnologies](https://affpapa.org/en/nevibecode/skills/199-biotechnologies-deep-research.md) — 10500 installs
- [deep-research · ruvnet](https://affpapa.org/en/nevibecode/skills/ruvnet-deep-research.md) — 894 installs

From the same set: [akillness/jeo-skills](https://affpapa.org/en/nevibecode/by/akillness/jeo-skills.md) — 99 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
