New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Gemini Deep Research

by LigphiDonk in LigphiDonk/Oh-my--paper

Perform complex, long-running research tasks using Gemini Deep Research Agent.

MITAuto-check passedResearch & Science

Install Gemini Deep Research

skills CLI
$ npx skills add LigphiDonk/Oh-my--paper --skill gemini-deep-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install LigphiDonk/Oh-my--paper gemini-deep-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/LigphiDonk/Oh-my--paper.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gemini-deep-research .claude/skills/gemini-deep-research && rm -rf skills-src

Use ~/.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/

Facts

Skill name
gemini-deep-research
GitHub stars
739
Token cost
~1.2k tokens
SKILL.md length
381 words
Files
2 (incl. scripts)
Skills in repo
27
Repo updated
First seen
Licence
MIT

At a glance

Perform complex, long-running research tasks using Gemini Deep Research Agent.

  • Works in 4 steps: Breaks down complex queries into… → Searches the web systematically for each… → Synthesizes findings into a… → …
  • Tasks that involve Deep research
  • SKILL.md covers Canonical Summary, Trigger Rules, Resource Use Rules and Execution Contract, plus 8 more sections
  • Runs Python scripts from its folder; reaches generativelanguage.googleapis.com; needs GEMINI_API_KEY

What it does

Gemini Deep Research is an agent skill from LigphiDonk/Oh-my--paper. Perform complex, long-running research tasks using Gemini Deep Research Agent.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/deep_research.py`).

It sits in Research & Science, covering Deep research. It works with Google Gemini. The repository describes itself as: A Claude Code plugin that turns your terminal into an autonomous research lab — literature survey, experiment execution, paper writing, all in one pipeline. The licence is MIT.

When your agent uses it

  • Tasks that involve Deep research

Example prompts

  • “/gemini-deep-research”

Requirements

  • Python 3
  • A credential in GEMINI_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Breaks down complex queries into sub-questions
  2. Searches the web systematically for each sub-question
  3. Synthesizes findings into a comprehensive markdown report
  4. Provides streaming progress updates during execution

What it can do on your machine

Read from SKILL.md and the folder at commit 6baece9. 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.

    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 1.2k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 381 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

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 LigphiDonk/Oh-my--paper at commit 6baece9, republished under its MIT licence (© LigphiDonk). 381 words, ~1,195 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 complex, long-running research tasks using Gemini Deep Research Agent.
id
gemini-deep-research
version
1.0.0
stages
survey
tools
read_file, search_project, write_file, run_terminal
summary
Perform complex, long-running research tasks using Gemini Deep Research Agent. Use when: asked to research topics requiring multi-source synthesis…
primaryIntent
research
intents
research
capabilities
search-retrieval, agent-workflow
domains
general
keywords
gemini-deep-research, survey, search-retrieval, agent-workflow, gemini, deep, research, perform, complex, long, running, tasks

gemini-deep-research

Canonical Summary

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, literature review, or comprehensive technical invest...

Trigger Rules

Use this skill when the user request matches its research workflow scope. Prefer the bundled resources instead of recreating templates or reference material. Keep outputs traceable to project files, citations, scripts, or upstream evidence.

Resource Use Rules

  • Treat scripts/ as optional helpers. Run them only when their dependencies are available, keep outputs in the project workspace, and explain a manual fallback if execution is blocked.

Execution Contract

  • Resolve every relative path from this skill directory first.
  • Prefer inspection before mutation when invoking bundled scripts.
  • If a required runtime, CLI, credential, or API is unavailable, explain the blocker and continue with the best manual fallback instead of silently skipping the step.
  • Do not write generated artifacts back into the skill directory; save them inside the active project workspace.

Upstream Instructions

Gemini Deep Research

Use Google Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks. The agent autonomously breaks down your query, searches the web, and synthesizes findings into a comprehensive report.

Prerequisites

  • GEMINI_API_KEY environment variable (obtain from Google AI Studio)
  • Python 3.8+ with requests library
  • Note: Requires a direct Gemini API key — OAuth tokens are not supported.
Show full SKILL.md (157 more words)Show less

When to Use

  • Comprehensive literature or market research
  • Competitive landscape analysis
  • Technical deep dives requiring multi-source synthesis
  • Any research task that benefits from systematic web search
  • When you need a structured report with evidence from multiple sources

How It Works

The Deep Research agent:

  1. Breaks down complex queries into sub-questions
  2. Searches the web systematically for each sub-question
  3. Synthesizes findings into a comprehensive markdown report
  4. Provides streaming progress updates during execution

Usage

Basic Research
bash
scripts/deep_research.py --query "Research the current state of quantum error correction" --stream
Custom Output Format
bash
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"
With File Search (optional)
bash
scripts/deep_research.py --query "Compare our fiscal year report against current public web news" \
  --file-search-store "fileSearchStores/my-store-name"
Specify Output Directory
bash
scripts/deep_research.py --query "Your research topic" --output-dir ./reports --stream

Output

Results are saved as timestamped files in the output directory:

  • 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

The report is also printed to stdout for immediate use.

API Details

  • Endpoint: https://generativelanguage.googleapis.com/v1beta/interactions
  • Agent model: deep-research-pro-preview-12-2025
  • Auth: x-goog-api-key header

Limitations

  • Long-running tasks (minutes to tens of minutes depending on complexity)
  • May incur API costs depending on your Google AI quota
  • Results depend on web content available at query time

© LigphiDonk, 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 LigphiDonk/Oh-my--paper.

  • SKILL.md
  • scripts/deep_research.py

Open the folder on GitHubat commit 6baece9

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.

Gemini Deep Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gemini Deep Research this skillLigphiDonk/Oh-my--paper739—~1.2kAutomated safety check: PassMIT
Deep Researchsanjay3290/ai-skills4329 repos~683Automated safety check: NotesApache-2.0
Librariumjkudish/librarium134—~1.9kAutomated safety check: PassMIT
Deep Research MCP Guidepminervini/deep-research-mcp114—~5.8kAutomated safety check: PassMIT
Gemini Deep ResearchOpenLAIR/dr-claw1.2k—~996Automated safety check: PassMIT
Gemini Deep Researchsickn33/agentic-awesome-skills47k1 repos~1kAutomated safety check: NotesApache-2.0

Similar skills

  • Deep Research

    sanjay3290/ai-skills

    Execute autonomous multi-step research using Google Gemini Deep Research Agent.

    432 GitHub starsUsed in 9 repos~683 tokens
    Research & ScienceAuto-check: notes

  • Librarium

    jkudish/librarium

    Runs evidence-aware, multi-provider research with the Librarium v2 CLI.

    134 GitHub stars~1.9k tokensUpdated 2 days ago
    Research & ScienceAuto-check passed

  • 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.

    114 GitHub stars~5.8k tokensUpdated 13 days ago
    Research & ScienceAuto-check passed

  • Gemini Deep Research

    OpenLAIR/dr-claw

    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.

    1.2k GitHub stars~996 tokensUpdated 23 days ago
    Research & ScienceAuto-check passed

  • 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.

    47k GitHub starsUsed in 1 repo~1k tokens
    Research & ScienceAuto-check: notes

  • Gemini Deep Research

    sundial-org/awesome-openclaw-skills

    Perform complex, long-running research tasks using Gemini Deep Research Agent.

    663 GitHub stars~572 tokensUpdated 7 mo ago
    Research & ScienceAuto-check passed

More from LigphiDonk/Oh-my--paper

All 27 skills in this repo

  • Preprint Search on bioRxiv

    LigphiDonk/Oh-my--paper

    Searches bioRxiv life sciences preprints by keyword, author, date range or category with a Python script, returning JSON metadata and optional PDF downloads.

    739 GitHub starsUsed in 12 repos~3.7k tokens
    Auto-check passed

  • Literature PDF OCR Library Builder

    LigphiDonk/Oh-my--paper

    Searches and downloads legally accessible academic PDFs, OCRs them to Markdown, and organizes the results into a traceable, AI-readable literature library.

    739 GitHub stars~1.1k tokensUpdated 5 mo ago
    Auto-check passed

  • Inno Code Survey

    LigphiDonk/Oh-my--paper

    Finds and clones missing code repositories for a chosen research idea, then writes a survey that maps academic concepts to their implementations.

    739 GitHub stars~3.6k tokensUpdated 5 mo ago
    Auto-check passed

  • Experiment Results Analysis for Papers

    LigphiDonk/Oh-my--paper

    Turns experimental data such as CSV, JSON or TensorBoard logs into statistical significance tests, visualizations and a drafted Results section.

    739 GitHub stars~3k tokensUpdated 5 mo ago
    Auto-check passed

  • Citation Verification Guide

    LigphiDonk/Oh-my--paper

    Lays out principles for catching fake, mismatched, or inconsistently formatted citations in academic writing, checked through live web search.

    739 GitHub stars~2.2k tokensUpdated 5 mo ago
    Auto-check passed

  • Single-Cell Initial Analysis

    LigphiDonk/Oh-my--paper

    Runs a seven-step quality-control and exploration pipeline on scRNA-seq, CyTOF or flow cytometry data and writes a plain-language report of what it found.

    739 GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

Works with

Categories

Questions about Gemini Deep Research

What does Gemini Deep Research do?

Perform complex, long-running research tasks using Gemini Deep Research Agent. Gemini Deep Research is an agent skill from LigphiDonk/Oh-my--paper. Perform complex, long-running research tasks using Gemini Deep Research Agent.

When should I use Gemini Deep Research?

Gemini Deep Research fits situations like: tasks that involve Deep research.

How do I install Gemini Deep Research in Claude Code?

Run `npx skills add LigphiDonk/Oh-my--paper --skill gemini-deep-research -a claude-code`. Or copy the skill folder (skills/gemini-deep-research in LigphiDonk/Oh-my--paper) 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 LigphiDonk/Oh-my--paper --skill gemini-deep-research -a codex`. Or copy the skill folder (skills/gemini-deep-research in LigphiDonk/Oh-my--paper) 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 LigphiDonk/Oh-my--paper --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 and credentials named GEMINI_API_KEY. Our summary lists: Python 3; A credential in GEMINI_API_KEY.

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 (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gemini Deep Research use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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), Librarium (jkudish/librarium, 134 stars), Deep Research MCP Guide (pminervini/deep-research-mcp, 114 stars) and Gemini Deep Research (OpenLAIR/dr-claw, 1.2k 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?

LigphiDonk (a GitHub user) maintains it in LigphiDonk/Oh-my--paper, which has 739 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on April 15, 2026.

Source: LigphiDonk/Oh-my--paper on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.