Skip to content
alyn
davila7

Deep Research skill

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

$npx skills add davila7/claude-code-templates --skill deep-research
GitHub stars
33,273
Pack installs
285k
Alyn Score
75/99
Updated
7 h ago
License
MIT
Research

Install Deep Research

Pick your agent. Every command is ready to paste.

$npx skills add davila7/claude-code-templates --skill deep-research

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads deep-research when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the deep-research skill”. In Codex, type $deep-research.

The skill itself

SKILL.md

GitHub

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

  1. Get a Gemini API key from Google AI Studio
  2. 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

  1. 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 results
  5. Use --continue for follow-up questions

Exit Codes

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

Tips for Deep Research

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • It is part of a pack with 40 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Deep Research

What does the Deep Research skill do?

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

How do I install Deep Research?

Run "npx skills add davila7/claude-code-templates --skill deep-research" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Deep Research work in Cursor and Codex?

Yes. Deep Research uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Deep Research free?

Deep Research is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.

Who made Deep Research?

Deep Research is published by davila7 in the davila7/claude-code-templates repository, together with 39 other skills.

Similar skills. From other creators.