Agent skill

Gemini Deep Research

by sickn33 in 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.

Apache-2.0Auto-check: notesResearch & Science

Install Gemini Deep Research

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill gemini-deep-research -a claude-code

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

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills 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/sickn33/agentic-awesome-skills.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
47k
Used in
1 other repo
Token cost
~1k tokens
SKILL.md length
382 words
Files
4 (incl. scripts)
Skills in repo
1,493
Repo updated
First seen
Licence
Apache-2.0

At a glance

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.

  • Works in 2 steps: Get a Gemini API key from Google AI Studio → Set the environment variable
  • Tasks that involve Deep research
  • SKILL.md covers When to Use, Requirements, Setup and Safety Gate, plus 7 more sections
  • Runs Python scripts from its folder; calls python3 and pip; needs GEMINI_API_KEY

What it does

Gemini Deep Research is an agent skill from 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.

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

It sits in Research & Science, covering Deep research, Market research and Literature review. It works with Google Gemini. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Deep research
  • Tasks that involve Market research
  • Tasks that involve Literature review

Example prompts

  • “/gemini-deep-research”

Requirements

  • Python 3
  • A credential in GEMINI_API_KEY

Workflow steps

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

  1. Get a Gemini API key from Google AI Studio
  2. Set the environment variable

What it can do on your machine

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

    • python3
    • pip

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

  • Network

    Links to these hosts (documentation or services it may open):

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

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:40
    Or create a `.env` file in the skill directory.

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 sickn33/agentic-awesome-skills at commit 680176d, republished under its Apache-2.0 licence (© sickn33). 382 words, ~1,049 tokens.

Download SKILL.mdSave it as .claude/skills/gemini-deep-research/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
gemini-deep-research
description
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.
category
research
risk
critical
source
https://github.com/sanjay3290/ai-skills/tree/main/skills/deep-research
source_repo
sanjay3290/ai-skills
source_type
community
date_added
2026-07-09
author
sanjay3290
tags
research, gemini, google, reports
tools
claude, cursor, gemini
license
Apache-2.0

Gemini Deep Research Skill

When to Use

  • Use when a question needs autonomous multi-step research with cited sources (market analysis, literature reviews, competitive scans)
  • Use when you want to start a Gemini Deep Research run, poll its progress, and collect the final report
  • Use when a quick web search is not enough and a structured, source-grounded report is required

Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.

Requirements

  • Python 3.8+
  • httpx: pip install -r requirements.txt
  • GEMINI_API_KEY environment variable

Setup

  1. Get a Gemini API key from Google AI Studio
  2. Set the environment variable:
    bash
    export GEMINI_API_KEY=your-api-key-here
    Or create a .env file in the skill directory.

Safety Gate

Before starting a research job, show the user the exact query, the fact that it will be sent to Google's Gemini service, the expected cost range, and the output destination. Start a job only after explicit approval. Do not include private workspace material, credentials, personal data, or confidential customer information in a query.

Usage

Start a research task
bash
python3 scripts/research.py --query "Research the history of Kubernetes"
With structured output format
bash
python3 scripts/research.py --query "Compare Python web frameworks" \
  --format "1. Executive Summary\n2. Comparison Table\n3. Recommendations"
Stream progress in real-time
bash
python3 scripts/research.py --query "Analyze EV battery market" --stream
Start without waiting
bash
python3 scripts/research.py --query "Research topic" --no-wait
Check status of running research
bash
python3 scripts/research.py --status <interaction_id>
Wait for completion
bash
python3 scripts/research.py --wait <interaction_id>
Continue from previous research
bash
python3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id>
List recent research
bash
python3 scripts/research.py --list

Output Formats

  • Default: Human-readable markdown report
  • JSON (--json): Structured data for programmatic use
  • Raw (--raw): Unprocessed API response

Cost & Time

MetricValue
Time2-10 minutes per task
Cost$2-5 per task (varies by complexity)
Token usage~250k-900k input, ~60k-80k output
Show full SKILL.md (147 more words)Show less

Best Use Cases

  • Market analysis and competitive landscaping
  • Technical literature reviews
  • Due diligence research
  • Historical research and timelines
  • Comparative analysis (frameworks, products, technologies)

Workflow

  1. User requests research → Run --query "..."
  2. Inform user of estimated time (2-10 minutes)
  3. Monitor with --stream or poll with --status
  4. Return formatted results
  5. Use --continue for follow-up questions

Exit Codes

  • 0: Success
  • 1: Error (API error, config issue, timeout)
  • 130: Cancelled by user (Ctrl+C)

Limitations

  • Each research job is a paid, third-party API request; costs and availability can change, and the listed estimate is not a spending authorization.
  • Reports may contain incomplete, stale, or incorrect citations. Verify consequential claims against primary sources.
  • This skill cannot guarantee that a prompt is safe to disclose; redact proprietary or personal material before requesting user approval.
  • An API key must remain local and must never be committed, printed, or sent in a query.

© sickn33, Apache-2.0. 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 3 other files (scripts) in skills/gemini-deep-research of sickn33/agentic-awesome-skills.

  • SKILL.md
  • README.md
  • requirements.txt
  • scripts/research.py

Open the folder on GitHubat commit 680176d

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

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 skillsickn33/agentic-awesome-skills47k1 repos~1kAutomated safety check: NotesApache-2.0
Deep Researchsanjay3290/ai-skills4319 repos~683Automated safety check: NotesApache-2.0
Gemini Deep ResearchOpenLAIR/dr-claw1.2k—~996Automated safety check: PassMIT
Bmad Deep Recondelorenj/mcp-server-trello445—~2.3kAutomated safety check: PassMIT
Gemini Deep Researchsundial-org/awesome-openclaw-skills663—~572Automated safety check: PassNone
Deep Research WorkflowTokenRhythm/opensquilla7.1k—~1.3kAutomated safety check: PassApache-2.0

Similar skills

  • 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
  • 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 22 days ago
    Research & ScienceAuto-check passed
  • 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…

    445 GitHub stars~2.3k tokensUpdated 16 days ago
    Research & ScienceAuto-check passed
  • 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
  • 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
  • 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 yesterday
    Research & ScienceAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,493 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Works with

Questions about Gemini Deep Research

What does Gemini Deep Research do?

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. Gemini Deep Research is an agent skill from 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.

When should I use Gemini Deep Research?

Gemini Deep Research fits situations like: tasks that involve Deep research; tasks that involve Market research; tasks that involve Literature review.

How do I install Gemini Deep Research in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill gemini-deep-research -a claude-code`. Or copy the skill folder (skills/gemini-deep-research in sickn33/agentic-awesome-skills) 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 sickn33/agentic-awesome-skills --skill gemini-deep-research -a codex`. Or copy the skill folder (skills/gemini-deep-research in sickn33/agentic-awesome-skills) 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 sickn33/agentic-awesome-skills --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 pip) 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 1 domain. 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 notes only (mentions a .env file), nothing it rates as a warning. 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 Apache-2.0 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 1k tokens (SKILL.md is roughly 4.2k 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, 431 stars), Gemini Deep Research (OpenLAIR/dr-claw, 1.2k stars), Bmad Deep Recon (delorenj/mcp-server-trello, 445 stars) and Gemini Deep Research (sundial-org/awesome-openclaw-skills, 663 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?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,379 GitHub stars. The repository holds 1,493 skills in this directory. The repository was last updated on October 9, 2026.

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