gemini-deep-research

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

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

With structured output format

python3 scripts/research.py --query "Com