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.
Best AI Skills for ChatGPT
Find the best AI skills to adapt into ChatGPT workflows for research, writing, summarization, planning, and repeatable assistant tasks.
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
autoresearch-pro
Automatically improve OpenClaw skills, prompts, or articles through iterative mutation-testing loops. Inspired by Karpathy's autoresearch. Use when user says 'optimize [skill]', 'autoresearch [skill]', 'improve my skill', 'optimize this prompt', 'improve my prompt', 'polish this article', 'improve this article', or explicitly requests quality improvement for any text-based content. Supports three modes: skill (SKILL.md files), prompt (any prompt text), and article (any document).
X/Twitter Research Skill
Research trending topics, ideas, and conversations on X (Twitter) using twitterapi.io.
token-research
Comprehensive token research for EVM chains (Base, ETH, Arbitrum) and Solana. Use this skill when you want to research crypto tokens, deep-dive projects or monitor tokens.
local-researcher
完全本地的深度研究助手 Skill。使用 Ollama 或 LMStudio 本地 LLM 进行迭代式网络研究，生成带引用来源的 Markdown 报告。当用户需要进行隐私优先的研究、本地文档分析或生成结构化研究报告时触发。
DeepSeek Agent Skill
Integrates DeepSeek API with OpenClaw agents.
auto-researcher
自主研究助手 - 深度调研、交叉验证、生成引用报告
MONK-EYE 👁️ - Deep Intelligence & Human Experience Oracle
MONK-EYE is a specialized OpenClaw skill designed for deep infiltration and synthesis of forum-based human intelligence. While most search tools focus on surface-level web pages, MONK-EYE dives into the "tacit knowledge" buried in the world's most active and niche forums (R10, BlackHatWorld, Reddit, Habr, etc.).
project-deep-analyzer
深度分析项目的系统边界、核心概念、模块架构、关键算法、技术选型以及错误排查。当用户需要深入理解代码库或定位疑难问题时调用。
Amazon Listing Optimizer — Free Listing Analysis & Keyword Research
**Free alternative to Helium 10 ($97/mo) and Jungle Scout ($49/mo).**
x-research
General-purpose X/Twitter research agent. Searches X for real-time perspectives, dev discussions, product feedback, cultural takes, breaking news, and expert opinions. Works like a web research agent but uses X as the source. Use when: (1) user says "x research", "search x for", "search twitter for", "what are people saying about", "what's twitter saying", "check x for", "x search", "/x-research", (2) user is working on something where recent X discourse would provide useful context (new library releases, API changes, product launches, cultural events, industry drama), (3) user wants to find what devs/experts/community thinks about a topic. NOT for: posting tweets, account management, or historical archive searches beyond 7 days.
deepwiki-ask
通过 DeepWiki MCP 查询仓库信息。支持提问、获取结构、获取文档内容。Query a repository via DeepWiki MCP: ask questions, get structure, get documentation. 用户提供 owner/repo 时触发。
competitive-research
Use when the user asks to research a competitor, map a market, analyze a category, or produce a competitive brief. Trigger phrases: 'research competitors of X', 'who competes with Y', 'market analysis for Z', 'competitive intelligence on [brand/space]', 'analyze this market', 'who are the main players in [category]', 'build a brief before my call', 'I need to understand this space'. Also triggers when preparing a proposal, positioning exercise, content strategy, or client pitch that requires knowing the competitive landscape.