What is a deep research skill?

It is an agent skill that runs autonomous research tasks. The agent plans, searches, reads sources, and synthesizes what it finds into a comprehensive report.

What does the deep research agent skill do?

It lets an agent carry a research question through to a written report: planning the inquiry, searching for sources, reading them, and synthesizing the findings.

Does it write the report itself?

Yes. Synthesizing information into a comprehensive report is part of the task, so the agent produces the written result.

Do I need to guide each search step?

No. The task is autonomous, so the agent plans and carries out the search and reading steps on its own.

What do I need before using it?

An AI agent that can load and use skills, with the deep research skill added to it.

Gemini Deep Research Skill

SkillSearch

The deep research skill is an agent skill that lets an AI agent run autonomous research tasks. It plans a line of inquiry, searches for sources, reads them, and synthesizes what it finds into a comprehensive report. You give the agent a research question and it carries the task through to a written result.

Use Gemini Deep Research Skill in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Gemini Deep Research Skill and connect your AI. About a minute.

Claude ChatGPT Ahel Desktop

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Gemini Deep Research Skill skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

No other account needed.

Have an AI agent that can load and use skills.

Gemini Deep Research SkillStart free

What your AI can do with it

Plan an approach to a research question before searching
Search for sources relevant to the question
Read the sources it finds
Synthesize findings into a comprehensive report
Run the research task autonomously from question to report

Getting started

Have an AI agent that can load and use skills.
Add the deep research skill to that agent.
Give the agent a research question to work on.
Let the agent plan, search, read, and synthesize the report.

What this skill tells your AI

The instructions your AI receives, as published by davila7/claude-code-templates in cli-tool/components/skills/ai-research/deep-research/SKILL.md and read by ahel’s review.

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)

Signals

GitHub stars: 32k
Forks: 4k
Last commit: Oct 2026
Hacker News mentions: 1

ahel review

K1binfo
installs-packages

Automated review, not a security audit. Ruleset v1+k2.

Questions

What is a deep research skill?: It is an agent skill that runs autonomous research tasks. The agent plans, searches, reads sources, and synthesizes what it finds into a comprehensive report.
What does the deep research agent skill do?: It lets an agent carry a research question through to a written report: planning the inquiry, searching for sources, reading them, and synthesizing the findings.
Does it write the report itself?: Yes. Synthesizing information into a comprehensive report is part of the task, so the agent produces the written result.
Do I need to guide each search step?: No. The task is autonomous, so the agent plans and carries out the search and reading steps on its own.
What do I need before using it?: An AI agent that can load and use skills, with the deep research skill added to it.

Advanced

Item type: skill
Key: deep-research-davila7
Source: github.com/davila7/claude-code-templates

github.com/davila7/claude-code-templates