| 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 |
| license_source | https://github.com/sanjay3290/ai-skills/blob/main/LICENSE |
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
- 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
