Agent skill

Deep Research

by sanjay3290 in sanjay3290/ai-skills

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

Apache-2.0Auto-check: notesResearch & Science

Install Deep Research

skills CLI
$ npx skills add sanjay3290/ai-skills --skill deep-research -a claude-code

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

GitHub CLI
$ gh skill install sanjay3290/ai-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/sanjay3290/ai-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
431
Used in
9 other repos
Token cost
~683 tokens
SKILL.md length
197 words
Files
6 (incl. scripts)
Skills in repo
24
Repo updated
First seen
Licence
Apache-2.0

At a glance

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

  • Works in 2 steps: Get a Gemini API key from Google AI Studio → Set the environment variable
  • : market analysis
  • SKILL.md covers Requirements, Setup, Usage and Output Formats, plus 4 more sections
  • Runs Python scripts from its folder; calls python3 and pip; needs GEMINI_API_KEY

What it does

Deep Research is an agent skill from sanjay3290/ai-skills. Execute autonomous multi-step research using Google Gemini Deep Research Agent. Use for: market analysis, competitive landscaping, literature reviews, technical research, due diligence. Takes 2-10 minutes but produces detailed, cited reports. Costs $2-5 per task.

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 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: 24 cross-platform agent skills for Claude Code, Cursor, Codex & Gemini CLI — databases, messaging, research, TTS, DevOps, and Google Workspace. The licence is Apache-2.0.

When your agent uses it

  • : market analysis
  • Competitive landscaping
  • Literature reviews
  • Technical research

Example prompts

  • “/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 281d88d. 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

Deep Research loads about 683 tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 197 words of instructions outside code blocks.

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

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:27
    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 sanjay3290/ai-skills at commit 281d88d, republished under its Apache-2.0 licence (© sanjay3290). 197 words, ~683 tokens.

Download SKILL.mdSave it as .claude/skills/deep-research/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
deep-research
description
Execute autonomous multi-step research using Google Gemini Deep Research Agent. Use for: market analysis, competitive landscaping, literature reviews, technical research, due diligence. Takes 2-10 minutes but produces detailed, cited reports. Costs $2-5 per task.
license
Apache-2.0
metadata.author
sanjay3290
metadata.version
1.0

Gemini Deep Research Skill

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.

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

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)

© sanjay3290, 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 5 other files (scripts) in skills/deep-research of sanjay3290/ai-skills.

  • SKILL.md
  • .env.example
  • .gitignore
  • README.md
  • requirements.txt
  • scripts/research.py

Open the folder on GitHubat commit 281d88d

Used in 9 other repositories

We found 19 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 9 other GitHub owners. This page covers the copy in sanjay3290/ai-skills, which our catalogue first saw on October 7, 2026.

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 skillsanjay3290/ai-skills4319 repos~683Automated safety check: NotesApache-2.0
Gemini Deep ResearchOpenLAIR/dr-claw1.2k—~996Automated safety check: PassMIT
Gemini Deep Researchsickn33/agentic-awesome-skills47k1 repos~1kAutomated safety check: NotesApache-2.0
Bmad Deep Recondelorenj/mcp-server-trello445—~2.3kAutomated safety check: PassMIT
Interceptor ResearchHacker-Valley-Media/Interceptor519—~3.8kAutomated safety check: PassCustom licence
Deep Scrapedavidondrej/skills4.1k—~2.3kAutomated safety check: PassMIT

Similar skills

  • 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 21 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
  • 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 15 days ago
    Research & ScienceAuto-check passed
  • Interceptor Research

    Hacker-Valley-Media/Interceptor

    Deep web-research methodology for the interceptor browser surface — investigate a topic the way researchers, intelligence analysts, investigative journalists, private investigators, and OSINT…

    519 GitHub stars~3.8k tokensUpdated 6 days ago
    Research & ScienceAuto-check passed
  • Deep Scrape

    davidondrej/skills

    Build sourced JSON dossiers on people, companies, or topics with DeepAPI.

    4.1k GitHub stars~2.3k tokensUpdated yesterday
    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

More from sanjay3290/ai-skills

All 24 skills in this repo
  • Imagen

    sanjay3290/ai-skills

    Generate images using Google Gemini's image generation capabilities.

    431 GitHub starsUsed in 6 repos~657 tokens
    Auto-check passed
  • Notebooklm

    sanjay3290/ai-skills

    Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports.

    431 GitHub stars~655 tokensUpdated 28 days ago
    Auto-check passed
  • Whatsapp

    sanjay3290/ai-skills

    Send and receive WhatsApp messages via the unofficial linked-device client pywhats (pip install pywhats) — pair with QR, send text/images, group chat, read receipts, presence/typing, and a…

    431 GitHub stars~1.1k tokensUpdated 28 days ago
    Auto-check passed
  • Postgres

    sanjay3290/ai-skills

    Execute read-only SQL queries against multiple PostgreSQL databases.

    431 GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed
  • Atlassian

    sanjay3290/ai-skills

    Manage Jira issues and Confluence wiki pages in Atlassian Cloud.

    431 GitHub stars~1.6k tokensUpdated 28 days ago
    Auto-check passed
  • Azure Devops

    sanjay3290/ai-skills

    Manage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, and attachments.

    431 GitHub stars~4.2k tokensUpdated 28 days ago
    Auto-check passed

Works with

Questions about Deep Research

What does Deep Research do?

Execute autonomous multi-step research using Google Gemini Deep Research Agent. Deep Research is an agent skill from sanjay3290/ai-skills. Execute autonomous multi-step research using Google Gemini Deep Research Agent.

When should I use Deep Research?

Deep Research fits situations like: : market analysis; competitive landscaping; literature reviews; technical research.

How do I install Deep Research in Claude Code?

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

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

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

About 683 tokens (SKILL.md is roughly 2.7k 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 Deep Research?

Skills that share tags, products or a category with Deep Research: Gemini Deep Research (OpenLAIR/dr-claw, 1.2k stars), Gemini Deep Research (sickn33/agentic-awesome-skills, 47k stars), Bmad Deep Recon (delorenj/mcp-server-trello, 445 stars) and Interceptor Research (Hacker-Valley-Media/Interceptor, 519 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Deep Research?

sanjay3290 (a GitHub user) maintains it in sanjay3290/ai-skills, which has 431 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 10, 2026.

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