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

Deep Research

by cnemri in cnemri/google-genai-skills

Perform autonomous, multi-step research using the Gemini Deep Research Agent (Interactions API).

MITAuto-check passedResearch & Science

Install Deep Research

skills CLI
$ npx skills add cnemri/google-genai-skills --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install cnemri/google-genai-skills 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/cnemri/google-genai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/deep-research .claude/skills/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
deep-research
GitHub stars
127
Token cost
~613 tokens
SKILL.md length
199 words
Files
3 (incl. scripts, references)
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Perform autonomous, multi-step research using the Gemini Deep Research Agent (Interactions API).

  • Works in 4 steps: Planning: The agent breaks down your… → Execution: It autonomously searches the… → Resilience: The script automatically… → …
  • Tasks that involve Deep research
  • SKILL.md covers Prerequisites, Usage, References and How it Works
  • Runs Python scripts from its folder; calls uv; needs GOOGLE_API_KEY

What it does

Deep Research is an agent skill from cnemri/google-genai-skills. Perform autonomous, multi-step research using the Gemini Deep Research Agent (Interactions API). Supports web search, file/directory context, and resilient streaming.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/online_docs.md` and `scripts/research.py`).

It sits in Research & Science, covering Deep research. The licence is MIT.

When your agent uses it

  • Tasks that involve Deep research

Example prompts

  • “/deep-research”

Requirements

  • Python 3
  • A credential in GOOGLE_API_KEY

Workflow steps

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

  1. Planning: The agent breaks down your prompt into steps.
  2. Execution: It autonomously searches the web and reads your provided files.
  3. Resilience: The script automatically reconnects if the long-running stream drops.
  4. Synthesis: It produces a comprehensive, cited report.

What it can do on your machine

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

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOGLE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Deep Research loads about 613 tokens when it runs, and up to ~678 if it reads all its reference files. Until then it costs about 45 tokens; SKILL.md has 199 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~613
With references · SKILL.md plus every file in references/, read only if the agent opens them
~678

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 cnemri/google-genai-skills at commit 7277476, republished under its MIT licence (© cnemri). 199 words, ~613 tokens.

Download SKILL.mdSave it as .claude/skills/deep-research/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
deep-research
description
Perform autonomous, multi-step research using the Gemini Deep Research Agent (Interactions API). Supports web search, file/directory context, and resilient streaming.

Deep Research

Use this skill to conduct deep, autonomous research tasks that require planning, searching, reading, and synthesizing information.

This skill uses the Gemini Deep Research Agent (deep-research-pro-preview-12-2025) via the Interactions API.

Prerequisites

  • GOOGLE_API_KEY: Required for accessing the Interactions API (currently in Preview via AI Studio).
  • google-genai SDK v0.3.0+

Usage

Basic Research

Start a research task and stream the results to the console.

bash
uv run skills/deep-research/scripts/research.py "Research the history of RISC-V architecture."
Research with Context (Files or Directories)

Provide local files (PDFs, text) or entire directories for the agent to read and incorporate into its research.

Direct Upload (Best for specific docs):

bash
# Single file
uv run skills/deep-research/scripts/research.py "Analyze this report" --file report.pdf

# Entire directory
uv run skills/deep-research/scripts/research.py "Summarize these meeting notes" --file ./notes/

File Search Store (Best for large corpora): Use --use-file-store to index files into a searchable store (RAG) instead of uploading them into the context window.

bash
uv run skills/deep-research/scripts/research.py "Find trends in these 1000 PDFs" --file ./large_corpus/ --use-file-store
Saving the Report

Save the final Markdown report to a file.

bash
uv run skills/deep-research/scripts/research.py "Competitive landscape of EV batteries" --output report.md
Continuing Research (Follow-up)

Ask follow-up questions to an existing research session using the Interaction ID (displayed at the start of the previous run).

bash
uv run skills/deep-research/scripts/research.py "Elaborate on the second point about lithium supply." --follow-up "INTERACTION_ID_HERE"

References

How it Works

  1. Planning: The agent breaks down your prompt into steps.
  2. Execution: It autonomously searches the web and reads your provided files.
  3. Resilience: The script automatically reconnects if the long-running stream drops.
  4. Synthesis: It produces a comprehensive, cited report.

© cnemri, 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 2 other files (scripts, references) in skills/deep-research of cnemri/google-genai-skills.

  • SKILL.md
  • references/online_docs.md
  • scripts/research.py

Open the folder on GitHubat commit 7277476

Compare with similar skills

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.

Deep Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Deep Research this skillcnemri/google-genai-skills127—~613Automated safety check: PassMIT
GitHub Deep Researchbytedance/deer-flow84k4 repos~1.3kAutomated safety check: PassMIT
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0
Deep Researchsanjay3290/ai-skills4319 repos~683Automated safety check: NotesApache-2.0
Horizontal-Vertical Deep ResearchKKKKhazix/khazix-skills21k—~2.1kAutomated safety check: PassMIT
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence

Similar skills

  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Research & ScienceAuto-check passed

  • Deep Research Workflow

    TokenRhythm/opensquilla

    Runs multi-round research in three stages with a persisted state file, evidence tracking and a long-form report with per-claim citations.

    7.1k GitHub stars~1.3k tokensUpdated today
    Research & ScienceAuto-check passed

  • Deep Research

    sanjay3290/ai-skills

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

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

  • Horizontal-Vertical Deep Research

    KKKKhazix/khazix-skills

    Runs a two-axis deep research method on a product, company, concept or person: its full history over time, compared with peers today, delivered as a typeset PDF report.

    21k GitHub stars~2.1k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed

  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated today
    Research & ScienceAuto-check passed

  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 5 days ago
    Research & ScienceAuto-check passed

More from cnemri/google-genai-skills

All 10 skills in this repo

  • Speech Use

    cnemri/google-genai-skills

    Generate (TTS), Transcribe (STT), and Clone voices using Google's GenAI and Cloud Speech SDKs.

    127 GitHub stars~616 tokensUpdated 8 mo ago
    Auto-check passed

  • Veo Use

    cnemri/google-genai-skills

    Create and edit videos using Google's Veo 2 and Veo 3 models.

    127 GitHub stars~625 tokensUpdated 8 mo ago
    Auto-check passed

  • Google Developer Knowledge

    cnemri/google-genai-skills

    Search and retrieve Google's developer documentation using the Developer Knowledge API.

    127 GitHub stars~709 tokensUpdated 8 mo ago
    Auto-check passed

  • Nano Banana Use

    cnemri/google-genai-skills

    Generate, edit, and compose images using Gemini Nano Banana models via portable Python scripts.

    127 GitHub stars~587 tokensUpdated 8 mo ago
    Auto-check passed

  • Google Adk Python

    cnemri/google-genai-skills

    Expert guidance on the Google Agent Development Kit (ADK) for Python.

    127 GitHub stars~769 tokensUpdated 8 mo ago
    Auto-check passed

  • Nano Banana Build

    cnemri/google-genai-skills

    Generate and edit high-quality images using Gemini 2.5 Flash Image and Gemini 3 Pro Image (Nano Banana).

    127 GitHub stars~534 tokensUpdated 8 mo ago
    Auto-check passed

Categories

Questions about Deep Research

What does Deep Research do?

Perform autonomous, multi-step research using the Gemini Deep Research Agent (Interactions API). Deep Research is an agent skill from cnemri/google-genai-skills. Perform autonomous, multi-step research using the Gemini Deep Research Agent (Interactions API).

When should I use Deep Research?

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

How do I install Deep Research in Claude Code?

Run `npx skills add cnemri/google-genai-skills --skill deep-research -a claude-code`. Or copy the skill folder (skills/deep-research in cnemri/google-genai-skills) into .claude/skills/deep-research in your project. Claude Code loads it when a task matches its description.

How do I install Deep Research in Codex?

Run `npx skills add cnemri/google-genai-skills --skill deep-research -a codex`. Or copy the skill folder (skills/deep-research in cnemri/google-genai-skills) into .agents/skills/deep-research in your project. Codex loads it when a task matches its description.

Can I use 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 cnemri/google-genai-skills --skill 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/deep-research, .gemini/skills/deep-research, .github/skills/deep-research and .opencode/skills/deep-research in your project.

What does Deep Research need to run?

Going by SKILL.md and its folder, Deep Research needs Python for the scripts in its folder, the command-line tools its instructions call (uv) and credentials named GOOGLE_API_KEY. Our summary lists: Python 3; A credential in GOOGLE_API_KEY.

Does Deep Research access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is 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 Deep Research use?

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 Deep Research use?

About 613 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 65 tokens, read only when the agent opens those files.

What are the alternatives to Deep Research?

Skills that share tags, products or a category with Deep Research: GitHub Deep Research (bytedance/deer-flow, 84k stars), Deep Research Workflow (TokenRhythm/opensquilla, 7.1k stars), Deep Research (sanjay3290/ai-skills, 431 stars) and Horizontal-Vertical Deep Research (KKKKhazix/khazix-skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research?

cnemri (a GitHub user) maintains it in cnemri/google-genai-skills, which has 127 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on February 6, 2026.

Source: cnemri/google-genai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.