gemini-deep-research
Perform complex, long-running research tasks using Gemini Deep Research Agent. Use when asked to research topics requiring multi-source synthesis, competitive analysis, market research, or comprehensive technical investigations that benefit from systematic web search and analysis.
Best use case
gemini-deep-research is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Perform complex, long-running research tasks using Gemini Deep Research Agent. Use when asked to research topics requiring multi-source synthesis, competitive analysis, market research, or comprehensive technical investigations that benefit from systematic web search and analysis.
Teams using gemini-deep-research should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/gemini-deep-research/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How gemini-deep-research Compares
| Feature / Agent | gemini-deep-research | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Perform complex, long-running research tasks using Gemini Deep Research Agent. Use when asked to research topics requiring multi-source synthesis, competitive analysis, market research, or comprehensive technical investigations that benefit from systematic web search and analysis.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
AI Agent for SaaS Idea Validation
Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.
SKILL.md Source
# Gemini Deep Research Use Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks. ## Prerequisites - `GEMINI_API_KEY` environment variable (from Google AI Studio) - **Note**: This does NOT work with Antigravity OAuth tokens. Requires a direct Gemini API key. ## How It Works Deep Research is an agent that: 1. Breaks down complex queries into sub-questions 2. Searches the web systematically 3. Synthesizes findings into comprehensive reports 4. Provides streaming progress updates ## Usage ### Basic Research ```bash scripts/deep_research.py --query "Research the history of Google TPUs" ``` ### Custom Output Format ```bash scripts/deep_research.py --query "Research the competitive landscape of EV batteries" \ --format "1. Executive Summary\n2. Key Players (include data table)\n3. Supply Chain Risks" ``` ### With File Search (optional) ```bash scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \ --file-search-store "fileSearchStores/my-store-name" ``` ### Stream Progress ```bash scripts/deep_research.py --query "Your research topic" --stream ``` ## Output The script saves results to timestamped files: - `deep-research-YYYY-MM-DD-HH-MM-SS.md` - Final report in markdown - `deep-research-YYYY-MM-DD-HH-MM-SS.json` - Full interaction metadata ## API Details - **Endpoint**: `https://generativelanguage.googleapis.com/v1beta/interactions` - **Agent**: `deep-research-pro-preview-12-2025` - **Auth**: `x-goog-api-key` header (NOT OAuth Bearer token) ## Limitations - Requires Gemini API key (get from [Google AI Studio](https://aistudio.google.com/apikey)) - Does NOT work with Antigravity OAuth authentication - Long-running tasks (minutes to hours depending on complexity) - May incur API costs depending on your quota
Related Skills
academic-deep-research
Transparent, rigorous research with full methodology — not a black-box API wrapper. Conducts exhaustive investigation through mandated 2-cycle research per theme, APA 7th citations, evidence hierarchy, and 3 user checkpoints. Self-contained using native OpenClaw tools (web_search, web_fetch, sessions_spawn). Use for literature reviews, competitive intelligence, or any research requiring academic rigor and reproducibility.
research-tracker
Manage autonomous AI research agents with SQLite-based state tracking. Use when spawning long-running research sub-agents, tracking multi-step investigations, coordinating agent handoffs, or monitoring background work. Triggers on: research projects, sub-agent coordination, autonomous investigation, progress tracking, agent oversight.
yutori-web-research
Use Yutori’s Research API and Browsing API (cloud browser) to research topics, collect sources, and extract structured facts from the web. Use when the user asks to “research X”, “monitor/find papers”, or “navigate to a site and extract info” and you have access to YUTORI dev/prod endpoints via YUTORI_API_BASE and an API key in env (YUTORI_API_KEY or ~/.openclaw/openclaw.json env.YUTORI_API_KEY).
research-library
Local-first multimedia research library for hardware projects.
research-assistant
Organized research and knowledge management for agents.
market-research-2
Conduct structured market research for a solopreneur business.
deep-research
Comprehensive research framework that combines web search, content analysis, source verification, and iterative investigation to conduct in-depth research on any topic. Use when you need to perform thorough research with multiple sources, cross-validation, and structured findings.
focus-deep-work
Maximize deep work with focus sessions, distraction logging, and productivity tracking
research-paper-kb
Persistent cross-session knowledge base for research papers.
gemini-image-gen
Generate and edit images via Google Gemini API. Supports Gemini native generation, Imagen 3, style presets, and batch generation with HTML gallery. Zero dependencies — pure Python stdlib.
perplexity-research
Conduct deep research using Perplexity Agent API with web search, reasoning, and multi-model analysis.
research-report
Research technical projects/papers and generate comprehensive reports with PDF export.