About

Imported from sickn33/agentic-awesome-skills (skills/gemini-deep-research/SKILL.md). Install upstream with npx skills add sickn33/agentic-awesome-skills --skill gemini-deep-research. Copyright stays with the author (Apache-2.0).

Gemini Deep Research Skill

Name: gemini-deep-research
Author: sickn33

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

Get a Gemini API key from Google AI Studio
Set the environment variable:
```
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

python3 scripts/research.py --query "Research the history of Kubernetes"

With structured output format

python3 scripts/research.py --query "Compare Python web frameworks" \
  --format "1. Executive Summary\n2. Comparison Table\n3. Recommendations"

Stream progress in real-time

python3 scripts/research.py --query "Analyze EV battery market" --stream

Start without waiting

python3 scripts/research.py --query "Research topic" --no-wait

Check status of running research

python3 scripts/research.py --status <interaction_id>

Wait for completion

python3 scripts/research.py --wait <interaction_id>

Continue from previous research

python3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id>

List recent research

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

Metric	Value
Time	2-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

User requests research → Run --query "..."
Inform user of estimated time (2-10 minutes)
Monitor with --stream or poll with --status
Return formatted results
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.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/sickn33-agentic-awesome-skills-gemini-deep-research/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

sickn33-agentic-awesome-skills-gemini-deep-research.ocm.jsonjson

{
  "ocm": "1",
  "id": "sickn33-agentic-awesome-skills-gemini-deep-research",
  "kind": "skill",
  "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.",
  "publisher": "sickn33",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "data_analysis"
    ],
    "tags": [
      "skill-md",
      "research",
      "gemini",
      "google",
      "reports",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/sickn33/agentic-awesome-skills",
      "path": "skills/gemini-deep-research/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/skills/gemini-deep-research/SKILL.md",
      "key": "sickn33/agentic-awesome-skills/skills/gemini-deep-research/SKILL.md"
    },
    "license": "Apache-2.0"
  },
  "instructions": "# Gemini Deep Research Skill\n\n## When to Use\n\n- Use when a question needs autonomous multi-step research with cited sources (market analysis, literature reviews, competitive scans)\n- Use when you want to start a Gemini Deep Research run, poll its progress, and collect the final report\n- Use when a quick web search is not enough and a structured, source-grounded report is required\n\nRun autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.\n\n## Requirements\n\n- Python 3.8+\n- httpx: `pip install -r requirements.txt`\n- GEMINI_API_KEY environment va",
  "cost": {
    "context_tokens": 894
  }
}

Fetch it by URL: GET /api/v1/registry/sickn33-agentic-awesome-skills-gemini-deep-research/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.