Deep Research
sanjay3290/ai-skills
Execute autonomous multi-step research using Google Gemini Deep Research Agent.
Runs multi-source web research through Google's Gemini Deep Research Agent with a bundled Python script and saves a structured, cited report as files.
Install Gemini Deep Research
$ npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install OpenLAIR/dr-claw gemini-deep-research --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/OpenLAIR/dr-claw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gemini-deep-research .claude/skills/gemini-deep-research && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "gemini-deep-research" agent skill from https://github.com/OpenLAIR/dr-claw/tree/main/skills/gemini-deep-research into .claude/skills/gemini-deep-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gemini-deep-research", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/OpenLAIR/dr-claw/tree/main/skills/gemini-deep-researchType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install OpenLAIR/dr-claw gemini-deep-research --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenLAIR/dr-claw.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/gemini-deep-research .agents/skills/gemini-deep-research && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "gemini-deep-research" agent skill from https://github.com/OpenLAIR/dr-claw/tree/main/skills/gemini-deep-research into .agents/skills/gemini-deep-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gemini-deep-research", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install OpenLAIR/dr-claw gemini-deep-research --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenLAIR/dr-claw.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/gemini-deep-research .cursor/skills/gemini-deep-research && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "gemini-deep-research" agent skill from https://github.com/OpenLAIR/dr-claw/tree/main/skills/gemini-deep-research into .cursor/skills/gemini-deep-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gemini-deep-research", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/OpenLAIR/dr-claw.git --path skills/gemini-deep-research--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install OpenLAIR/dr-claw gemini-deep-research --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenLAIR/dr-claw.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/gemini-deep-research .gemini/skills/gemini-deep-research && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "gemini-deep-research" agent skill from https://github.com/OpenLAIR/dr-claw/tree/main/skills/gemini-deep-research into .gemini/skills/gemini-deep-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gemini-deep-research", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install OpenLAIR/dr-claw gemini-deep-researchInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/OpenLAIR/dr-claw.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/gemini-deep-research .github/skills/gemini-deep-research && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "gemini-deep-research" agent skill from https://github.com/OpenLAIR/dr-claw/tree/main/skills/gemini-deep-research into .github/skills/gemini-deep-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gemini-deep-research", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install OpenLAIR/dr-claw gemini-deep-research --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/OpenLAIR/dr-claw.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/gemini-deep-research .opencode/skills/gemini-deep-research && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "gemini-deep-research" agent skill from https://github.com/OpenLAIR/dr-claw/tree/main/skills/gemini-deep-research into .opencode/skills/gemini-deep-research/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gemini-deep-research", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
gemini-deep-research- GitHub stars
- 1.2k
- Token cost
- ~996 tokens
- SKILL.md length
- 342 words
- Files
- 2 (incl. scripts)
- Skills in repo
- 36
- Repo updated
- First seen
- Licence
- MIT
At a glance
Runs multi-source web research through Google's Gemini Deep Research Agent with a bundled Python script and saves a structured, cited report as files.
- Works in 2 steps: Check for GEMINI_API_KEY: Run echo… → Ensure requests is installed: python3 -c…
- Needing a cited report synthesized from many web sources
- SKILL.md covers Prerequisites, How to Run the Script, Output and Execution Notes, plus 1 more section
- Runs Python scripts from its folder; calls python3 and pip3; reaches generativelanguage.googleapis.com; needs GEMINI_API_KEY
What it does
The agent calls scripts/deep_research.py, which hands a research question to Gemini's Deep Research Agent; that agent splits the question, searches the web and returns a markdown report with citations. Flags set the query, optional progress streaming, the output folder, a custom report structure, a Gemini file-search store and an API key override. Each run writes two timestamped files into the output directory.
A direct Gemini API key in GEMINI_API_KEY is required, since OAuth tokens are not supported, along with Python 3.8 or later and the requests library. If the variable is empty, the agent asks whether you want to supply a key, and if you decline it does not use the skill and falls back to other research methods. The examples cover a quantum error correction survey and an EV battery landscape with a custom section outline.
When your agent uses it
- Needing a cited report synthesized from many web sources
- Running a literature review or technology survey
- Doing competitive or market research with a fixed report outline
Example prompts
- “Do deep research on the current state of quantum error correction and save the report to ./reports.”
- “Research the competitive landscape of EV batteries with sections for key players and supply chain risks.”
Requirements
- A Gemini API key in GEMINI_API_KEY
- Python 3.8 or later with the requests library
- Network access to the Gemini API
Workflow steps
2 steps, taken from the first numbered list in SKILL.md.
- Check for GEMINI_API_KEY: Run echo $GEMINI_API_KEY to see if it's set. If empty, ask the user whether they'd like to provide a Gemini API…
- Ensure requests is installed: python3 -c "import requests". If missing, install it: pip3 install requests.
What it can do on your machine
Read from SKILL.md and the folder at commit d51b64e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3pip3
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
generativelanguage.googleapis.com
Also links to:
aistudio.google.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
GEMINI_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Gemini Deep Research loads about 996 tokens when it runs. Until then it costs about 138 tokens; SKILL.md has 342 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from OpenLAIR/dr-claw at commit d51b64e, republished under its MIT licence (© OpenLAIR). 342 words, ~996 tokens.
Download SKILL.mdSave it as
.claude/skills/gemini-deep-research/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.- name
- gemini-deep-research
- description
- Perform deep, multi-source research using Google Gemini's Deep Research Agent. Use this skill whenever the user asks for comprehensive research, literature reviews, competitive analysis, market research, technology surveys, or any investigation that requires synthesizing information from many web sources. Also trigger when the user says "deep research", "research this thoroughly", "do a comprehensive study on", or wants a structured report with evidence gathered from across the web — even if they don't mention Gemini by name.
- license
- MIT
- metadata.author
- clawdbot
- metadata.version
- 1.1.0
Gemini Deep Research
Google Gemini's Deep Research Agent autonomously breaks down complex queries, searches the web systematically, and produces structured markdown reports with citations. It handles the kind of multi-source synthesis that would take a human hours of browsing.
Prerequisites
GEMINI_API_KEYenvironment variable must be set (obtain from Google AI Studio)- Python 3.8+ with the
requestslibrary installed - Requires a direct Gemini API key — OAuth tokens are not supported
How to Run the Script
The script is at scripts/deep_research.py relative to this skill's directory (i.e., the directory containing this SKILL.md). Resolve the full path from the skill's location before running.
python3 <this-skill-directory>/scripts/deep_research.py \
--query "<research query>" \
--stream \
--output-dir ./reportsKey flags
| Flag | Purpose | Default |
|---|---|---|
--query | (required) The research question | — |
--stream | Print progress updates while waiting | off |
--output-dir | Where to save the report files | current dir |
--format | Custom output structure (see example below) | free-form |
--file-search-store | Gemini file-search store name | none |
--api-key | Override GEMINI_API_KEY env var | env var |
Before running
- Check for
GEMINI_API_KEY: Runecho $GEMINI_API_KEYto see if it's set. If empty, ask the user whether they'd like to provide a Gemini API key (they can get one from https://aistudio.google.com/apikey). If the user provides one, pass it via--api-key. If the user declines, do not use this skill — fall back to other research approaches and let the user know why. - Ensure
requestsis installed:python3 -c "import requests". If missing, install it:pip3 install requests.
Example commands
Basic research:
python3 <this-skill-directory>/scripts/deep_research.py \
--query "Current state of quantum error correction techniques" \
--stream --output-dir ./reportsCustom output format:
python3 <this-skill-directory>/scripts/deep_research.py \
--query "Competitive landscape of EV batteries" \
--format "1. Executive Summary\n2. Key Players (data table)\n3. Technology Comparison\n4. Supply Chain Risks" \
--stream --output-dir ./reportsOutput
The script produces two timestamped files in the output directory:
deep-research-YYYY-MM-DD-HH-MM-SS.md— the final markdown reportdeep-research-YYYY-MM-DD-HH-MM-SS.json— full interaction metadata
The report is also printed to stdout so you can capture it directly.
Execution Notes
- This is a long-running task — it typically takes 2–10 minutes depending on query complexity. Use
--streamso the user can see progress. - Always run with a reasonable timeout (at least 600000ms / 10 minutes) when using the Bash tool.
- After the script finishes, read and present the generated
.mdreport to the user. Summarize key findings and point them to the full report file.
API Details
- Endpoint:
https://generativelanguage.googleapis.com/v1beta/interactions - Agent model:
deep-research-pro-preview-12-2025 - Auth:
x-goog-api-keyheader
© OpenLAIR, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 1 other file (scripts) in skills/gemini-deep-research of OpenLAIR/dr-claw.
- SKILL.md
- scripts/deep_research.py
Open the folder on GitHubat commit d51b64e
Compare with similar skills
Gemini Deep Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Gemini Deep Research this skillOpenLAIR/dr-claw | 1.2k | — | ~996 | Automated safety check: Pass | MIT | |
| Deep Researchsanjay3290/ai-skills | 432 | 9 repos | ~683 | Automated safety check: Notes | Apache-2.0 | |
| Gemini Deep Researchsickn33/agentic-awesome-skills | 47k | 1 repos | ~1k | Automated safety check: Notes | Apache-2.0 | |
| Bmad Deep Recondelorenj/mcp-server-trello | 445 | — | ~2.3k | Automated safety check: Pass | MIT | |
| Deep Research MCP Guidepminervini/deep-research-mcp | 114 | — | ~5.8k | Automated safety check: Pass | MIT | |
| ResearchClaw Research Pipelineaiming-lab/AutoResearchClaw | 15k | — | ~1k | Automated safety check: Pass | MIT |
Similar skills
Gemini Deep Research
sickn33/agentic-awesome-skills
Run autonomous multi-step research with Google's Gemini Deep Research Agent: kick off a query, poll progress, and collect a cited report for market analysis or literature reviews.
Bmad Deep Recon
delorenj/mcp-server-trello
Decision-grade research, three ways: draft a deep-research prompt for the user to run in their own tool (ChatGPT, Gemini, Grok, Perplexity, …), process a finished research report — file it, distill…
Deep Research MCP Guide
pminervini/deep-research-mcp
Explains how to run, integrate and debug the deep-research-mcp project through its CLI, Python API or MCP server, with OpenAI, Gemini and DR-Tulu backends.
ResearchClaw Research Pipeline
aiming-lab/AutoResearchClaw
Runs the ResearchClaw 23-stage autonomous pipeline from a topic, config file and output directory, from literature review through experiments to a written and reviewed paper.
Gemini Deep Research
sundial-org/awesome-openclaw-skills
Perform complex, long-running research tasks using Gemini Deep Research Agent.
More from OpenLAIR/dr-claw
All 36 skills in this repoAcademic Rebuttal Drafting
OpenLAIR/dr-claw
Analyzes reviewer comments and drafts venue-specific rebuttals for AI and computer science conferences, with an issue board, task list and paper edit plan.
Academic Presentation Maker
OpenLAIR/dr-claw
Turns a research paper into a slide deck and, optionally, a narrated demo video, through script, slide generation, text-to-speech and video assembly stages you control.
News to Research Idea Briefing
OpenLAIR/dr-claw
Clusters the latest news-feed results by topic and writes a briefing of research idea seeds with citations, plus a structured seeds file, without crawling new sources.
ML Dataset Discovery
OpenLAIR/dr-claw
Searches Hugging Face Hub, OpenML, GitHub and paper references for datasets that fit a research task and returns a ranked, de-duplicated table.
Grant Proposal Writing Workflow
OpenLAIR/dr-claw
Six-phase workflow for writing, revising and adapting grant proposals for NSF, NIH, DOE, DARPA, NASA and China's NSFC, from profiling through simulated peer review.
Inno Rclone To Overleaf
OpenLAIR/dr-claw
Access Overleaf projects via CLI. An agent skill from OpenLAIR/dr-claw.
Related
Works with
Categories
Questions about Gemini Deep Research
What does Gemini Deep Research do?
Runs multi-source web research through Google's Gemini Deep Research Agent with a bundled Python script and saves a structured, cited report as files. py, which hands a research question to Gemini's Deep Research Agent; that agent splits the question, searches the web and returns a markdown report with citations. Flags set the query, optional progress streaming, the output folder, a custom report structure, a Gemini file-search store and an API key override.
When should I use Gemini Deep Research?
Gemini Deep Research fits situations like: needing a cited report synthesized from many web sources; running a literature review or technology survey; doing competitive or market research with a fixed report outline.
How do I install Gemini Deep Research in Claude Code?
Run `npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a claude-code`. Or copy the skill folder (skills/gemini-deep-research in OpenLAIR/dr-claw) into .claude/skills/gemini-deep-research in your project. Claude Code loads it when a task matches its description.
How do I install Gemini Deep Research in Codex?
Run `npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a codex`. Or copy the skill folder (skills/gemini-deep-research in OpenLAIR/dr-claw) into .agents/skills/gemini-deep-research in your project. Codex loads it when a task matches its description.
Can I use Gemini Deep Research in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenLAIR/dr-claw --skill gemini-deep-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gemini-deep-research, .gemini/skills/gemini-deep-research, .github/skills/gemini-deep-research and .opencode/skills/gemini-deep-research in your project.
What does Gemini Deep Research need to run?
Going by SKILL.md and its folder, Gemini Deep Research needs Python for the scripts in its folder, the command-line tools its instructions call (python3 and pip3) and credentials named GEMINI_API_KEY. Our summary lists: A Gemini API key in GEMINI_API_KEY; Python 3.8 or later with the requests library; Network access to the Gemini API.
Does Gemini Deep Research access the network?
SKILL.md names 2 domains. In commands or code: generativelanguage.googleapis.com; the agent is likely to contact it when it follows the instructions. As links in the text: aistudio.google.com. This is read from the text; nothing was executed.
Is Gemini Deep Research safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Gemini Deep Research use?
Gemini Deep Research is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Gemini Deep Research use?
About 996 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Gemini Deep Research?
Skills that share tags, products or a category with Gemini Deep Research: Deep Research (sanjay3290/ai-skills, 432 stars), Gemini Deep Research (sickn33/agentic-awesome-skills, 47k stars), Bmad Deep Recon (delorenj/mcp-server-trello, 445 stars) and Deep Research MCP Guide (pminervini/deep-research-mcp, 114 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Gemini Deep Research?
OpenLAIR (a GitHub organization) maintains it in OpenLAIR/dr-claw, which has 1,155 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 17, 2026.
Source: OpenLAIR/dr-claw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.