gemini-deep-research
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.
npx skills add sickn33/agentic-awesome-skills --skill gemini-deep-research --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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](https://aistudio.google.com/) 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 resear
- When to Use
- Requirements
- Setup
- Safety Gate
- Usage
- Start a research task
- With structured output format
- Stream progress in real-time
- Start without waiting
- Check status of running research
- Wait for completion
- Continue from previous research
- List recent research
- Output Formats
export GEMINI_API_KEY=your-api-key-here python3 scripts/research.py --query "Research the history of Kubernetes" python3 scripts/research.py --query "Compare Python web frameworks" \ python3 scripts/research.py --query "Analyze EV battery market" --stream python3 scripts/research.py --query "Research topic" --no-wait python3 scripts/research.py --status <interaction_id> python3 scripts/research.py --wait <interaction_id> python3 scripts/research.py --query "Elaborate on point 2" --continue <interaction_id> python3 scripts/research.py --list
What does the gemini-deep-research skill 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.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill gemini-deep-research --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.