Skill

Deep Research

Execute autonomous multi-step research using Google Gemini Deep Research Agent. Use for: market analysis, competitive landscaping, literature reviews, technical research, due diligence. Takes 2-10 minutes but produces detailed, cited reports. Costs $2-5 per task.

Type: Skill
Repository: sanjay3290/ai-skills
GitHub stars: 426
License: Apache-2.0
Repo last updated: Sep 10, 2026
Source file: skills/deep-research/SKILL.md

What Deep Research is

Deep Research is a skill published in the sanjay3290/ai-skills repository on GitHub, which has about 426 stars. The repository describes itself as: “24 cross-platform agent skills for Claude Code, Cursor, Codex & Gemini CLI — databases, messaging, research, TTS, DevOps, and Google Workspace”

A skill is a folder with a SKILL.md file: frontmatter with a name and a description, followed by instructions Claude follows. Claude loads a skill automatically when a task matches its description, and you can also run it directly with a slash and its name.

Skills work in Claude Code and in Claude Cowork, which makes Deep Research a portable way to give Claude the same method everywhere.

How to install Deep Research

Claude Code

Download the deep-research folder from the repository.
Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project.
Claude loads it automatically when a task matches; you can also run it with / and its name.

Claude Cowork

Zip the skill folder so SKILL.md sits at the top level of the folder.
Open Customize → Skills, click +, then upload the ZIP.
Start a task that matches the description, or call it by name with /.

New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.

Inside the source file

An excerpt from skills/deep-research/SKILL.md, shared under the repository's Apache-2.0 license. Read the full file on GitHub.

Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive 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

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)

Before you install

Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
Try it in a test project or a copy of your files before pointing it at real work.
Pin the version you tested, and review changes before updating.
Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.

FAQ

What is Deep Research?

Deep Research is a skill for Claude Code and Claude Cowork from the sanjay3290/ai-skills repository on GitHub. Execute autonomous multi-step research using Google Gemini Deep Research Agent. Use for: market analysis, competitive landscaping, literature reviews, technical research, due diligence. Takes 2-10 minutes but produces detailed, cited reports. Costs $2-5 per task.

How do I install Deep Research in Claude Code?

Download the deep-research folder from the repository. Save it as ~/.claude/skills/<skill-name>/SKILL.md for all projects, or .claude/skills/<skill-name>/SKILL.md for one project. Claude loads it automatically when a task matches; you can also run it with / and its name.

Can I use Deep Research in Claude Cowork?

Zip the skill folder so SKILL.md sits at the top level of the folder. Open Customize → Skills, click +, then upload the ZIP. Start a task that matches the description, or call it by name with /.

Is Deep Research safe to install?

It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.

Similar resources

Browse all skills, subagents, and plugins →

Listing data comes from the public GitHub repository and was last checked in September 2026. Excerpts are © their authors and shared under Apache-2.0. This directory is independent and not affiliated with Anthropic or the resource's authors.