# deep-research

Runs a topic investigation in the shape of a survey paper: pins the questions, searches from several angles, checks every reference and answers each question in the final report. Useful before you commit to a topic.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 496 installs · ★ 10652
- Author: HKUSTDial
- License: CC-BY-NC-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HKUSTDial/Supervisor-Skills/tree/HEAD/skills/deep-research/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/hkustdial-deep-research

## What it does

The skill will not start searching until a brief exists: topic, two or three answerable research questions, the angle, and who the report is for. A vague request gets turned into questions first. From there it opens three to five search perspectives, among them the mainstream line of work, its critics, nearby disciplines, methodology and deployment. Each perspective searches broad, then narrows using terms the first pass turned up. If the environment can spawn sub-agents, the perspectives run side by side; otherwise you run them one after another, same method.

Every candidate reference goes through a two-step check, and a paper that cannot be confirmed stays out of the corpus. Findings are then sorted into a MECE taxonomy, and sections are written one at a time, each citing only the works assigned to it. Sources get compared within a sentence. Where studies disagree, the report explains under what conditions, rather than splitting the difference. A self-adversarial pass follows: three retrospective questions plus a check for an omitted perspective.

Six internal gates watch the work — angle, coverage, citation, taxonomy, calibration, weaving. Failing citation or coverage sends you back for a targeted supplement rather than a restart. No retrieval, no run: the skill states that plainly instead of writing a survey from memory. The report follows a paper layout, from abstract and methodology to open problems and references.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-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 HKUSTDial/Supervisor-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 HKUSTDial/Supervisor-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 HKUSTDial/Supervisor-Skills deep-research
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/HKUSTDial/Supervisor-Skills --path 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 HKUSTDial/Supervisor-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/HKUSTDial/Supervisor-Skills/tree/HEAD/skills/deep-research/SKILL.md

## When to use it
- turn a loose topic into answerable research questions
- find the key works on every side, critics included
- drop invented or misquoted references
- group the corpus by theme without gaps or overlaps
- produce a report whose conclusion answers each question

## Example prompts
- Survey the literature on CRISPR in clinical trials and start by defining the questions
- I need a review of what is known about social media and adolescent mental health
- Map the research on this topic and point out where the studies disagree

## Similar
- [anysearch](https://affpapa.org/en/nevibecode/skills/anysearch.md) — skill · 38500 installs
- [academic-paper](https://affpapa.org/en/nevibecode/skills/academic-paper.md) — skill · 10800 installs
- [nature-figure](https://affpapa.org/en/nevibecode/skills/nature-figure.md) — skill · 18800 installs
- [academic-paper-reviewer](https://affpapa.org/en/nevibecode/skills/academic-paper-reviewer.md) — skill · 9800 installs
- [nature-polishing](https://affpapa.org/en/nevibecode/skills/nature-polishing.md) — skill · 17500 installs
- [nature-citation](https://affpapa.org/en/nevibecode/skills/nature-citation.md) — skill · 15600 installs

## Other versions with the same name
- [deep-research · affaan-m](https://affpapa.org/en/nevibecode/skills/affaan-m-deep-research.md) — 5100 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) — 10200 installs
- [deep-research · ruvnet](https://affpapa.org/en/nevibecode/skills/ruvnet-deep-research.md) — 893 installs
- [deep-research · claude-office-skills](https://affpapa.org/en/nevibecode/skills/claude-office-skills-deep-research.md) — 5000 installs

From the same set: [hkustdial/supervisor-skills](https://affpapa.org/en/nevibecode/by/hkustdial/supervisor-skills.md) — 12 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
