deep-research
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.
Install / Use
npx skills add sanjay3290/ai-skills --skill deep-researchInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Education & ResearchSupported Platforms
Our assessment of deep-research
deep-research scores 87/100 on our quality scale, 250th of 423 Education & Research skills we index.
Its SKILL.md is 2.7 KB long, well organised into 17 sections with 8 code examples: a solid amount of guidance for an agent.
It has 426 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so deep-research is actively maintained.
- Our last check on 2026-11-02 found the source still online.
- It is released under the Apache-2.0 license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-05. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
deep-research compared with similar skills
All 4 of these similar skills score higher than deep-research; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| deep-research (this skill)by sanjay3290 | 87 | 426 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 113.0k | 10d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.1k | today | CLAUDE.md |
| last30days-skillby mvanhorn | 100 | 69.8k | 1d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 104.2k | 1d ago | MCP Server |
Frequently asked questions
- How do I install deep-research?
- Run
npx skills add sanjay3290/ai-skills --skill deep-research. The install tabs above show the steps for each supported agent. - Which AI agents does deep-research work with?
- It is written for Gemini CLI, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is deep-research safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is Apache-2.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is deep-research still maintained?
- The repository was last updated about 2 months ago, so deep-research is actively maintained.
Skill content
View source on GitHubname: 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 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
- Get a Gemini API key from Google AI Studio
- Set the environment variable:
Or create aexport GEMINI_API_KEY=your-api-key-here.envfile in the skill directory.
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
--streamor poll with--status - Return formatted results
- Use
--continuefor follow-up questions
Exit Codes
- 0: Success
- 1: Error (API error, config issue, timeout)
- 130: Cancelled by user (Ctrl+C)
Related Skills
Agent-Reach
113.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
80.1kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
last30days-skill
69.8kAI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
Scrapling
104.2k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
