How do I install the Deep Research skill?

Run npx skillmds@latest add bouclem/deep-research in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Deep Research safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Deep Research?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Deep Research free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Deep Research?

bouclem (@bouclem) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Deep Research by bouclem — Agent Skill

Name: Deep Research
Rating: 4.666666666666667 (3 reviews)
Author: bouclem

File contents

Gemini Deep Research Skill

Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.

When to Use This Skill

Use this skill when:

Performing market analysis
Conducting competitive landscaping
Creating literature reviews
Doing technical research
Performing due diligence
Need detailed, cited research reports

Requirements

Python 3.8+
httpx: pip install -r requirements.txt
GEMINI_API_KEY environment variable

Setup

Get a Gemini API key from Google AI Studio
Set the environment variable:
```
export GEMINI_API_KEY=your-api-key-here
```
Or create a .env file in the skill directory.

Usage

Start a research task

python3 scripts/research.py --query "Research the history of Kubernetes"

With structured output format

python3 scripts/research.py --query "Compare Python web frameworks" \
  --format "1. Executive Summary\n2. Comparison Table\n3. Recommendations"

Stream progress in real-time

python3 scripts/research.py --query "Analyze EV battery market" --stream

Start without waiting

python3 scripts/research.py --query "Research topic" --no-wait

Check status of running research

python3 scripts/research.py --status <interaction_id>

Wait for completion

python3 scripts/research.py --wait <interaction_id>

Continue from previous research

python3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id>

List recent research

python3 scripts/research.py --list

Output Formats

Default: Human-readable markdown report
JSON (--json): Structured data for programmatic use
Raw (--raw): Unprocessed API response

Cost & Time

Metric	Value
Time	2-10 minutes per task
Cost	$2-5 per task (varies by complexity)
Token usage	~250k-900k input, ~60k-80k output

Best Use Cases

Market analysis and competitive landscaping
Technical literature reviews
Due diligence research
Historical research and timelines
Comparative analysis (frameworks, products, technologies)

Workflow

User requests research → Run --query "..."
Inform user of estimated time (2-10 minutes)
Monitor with --stream or poll with --status
Return formatted results
Use --continue for follow-up questions

Exit Codes

0: Success
1: Error (API error, config issue, timeout)
130: Cancelled by user (Ctrl+C)

Limitations

Use this skill only when the task clearly matches the scope described above.
Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

---name: deep-researchdescription: Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.---# Gemini Deep Research SkillRun autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.## When to Use This SkillUse this skill when:- Performing market analysis- Conducting competitive landscaping- Creating literature reviews- Doing technical research- Performing due diligence- Need detailed, cited research reports## Requirements- Python 3.8+- httpx: `pip install -r requirements.txt`- GEMINI_API_KEY environment variable## Setup1. Get a Gemini API key from [Google AI Studio](https://aistudio.google.com/)2. Set the environment variable: ```bash export GEMINI_API_KEY=your-api-key-here ``` Or create a `.env` file in the skill directory.## Usage### Start a research task```bashpython3 scripts/research.py --query "Research the history of Kubernetes"```### With structured output format```bashpython3 scripts/research.py --query "Compare Python web frameworks" \ --format "1. Executive Summary\n2. Comparison Table\n3. Recommendations"```### Stream progress in real-time```bashpython3 scripts/research.py --query "Analyze EV battery market" --stream```### Start without waiting```bashpython3 scripts/research.py --query "Research topic" --no-wait```### Check status of running research```bashpython3 scripts/research.py --status <interaction_id>```### Wait for completion```bashpython3 scripts/research.py --wait <interaction_id>```### Continue from previous research```bashpython3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id>```### List recent research```bashpython3 scripts/research.py --list```## Output Formats- **Default**: Human-readable markdown report- **JSON** (`--json`): Structured data for programmatic use- **Raw** (`--raw`): Unprocessed API response## Cost & Time| Metric | Value ||--------|-------|| Time | 2-10 minutes per task || Cost | $2-5 per task (varies by complexity) || Token usage | ~250k-900k input, ~60k-80k output |## Best Use Cases- Market analysis and competitive landscaping- Technical literature reviews- Due diligence research- Historical research and timelines- Comparative analysis (frameworks, products, technologies)## Workflow1. User requests research → Run `--query "..."`2. Inform user of estimated time (2-10 minutes)3. Monitor with `--stream` or poll with `--status`4. Return formatted results5. Use `--continue` for follow-up questions## Exit Codes- **0**: Success- **1**: Error (API error, config issue, timeout)- **130**: Cancelled by user (Ctrl+C)## Limitations- Use this skill only when the task clearly matches the scope described above.- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

Frequently asked questions

Deep Research