Deep Research
Deep Research is an code AI skill with a core value of Execute autonomous multi-step research using Google Gemini Deep Research Agent. It
helps developers solve real-world problems in the code domain, boosting
efficiency, automating repetitive tasks, and optimizing workflows.
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 ...
Quick Facts
mkdir -p ./skills/deep-research && curl -sfL https://raw.githubusercontent.com/sickn33/antigravity-awesome-skills/main/skills/deep-research/SKILL.md -o ./skills/deep-research/SKILL.mdRun in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).
Skill Content
# Gemini Deep Research Skill
Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports.
When to Use This Skill
Use this skill when:
- Performing market analysis
- Conducting competitive landscaping
- Creating literature reviews
- Doing technical research
- Performing due diligence
- Need detailed, cited research 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.
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" --streamStart without waiting
python3 scripts/research.py --query "Research topic" --no-waitCheck 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 --listOutput 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
1. User requests research → Run `--query "..."`
2. Inform user of estimated time (2-10 minutes)
3. Monitor with `--stream` or poll with `--status`
4. Return formatted results
5. Use `--continue` for follow-up questions
Exit Codes
- **0**: Success
- **1**: Error (API error, config issue, timeout)
- **130**: Cancelled by user (Ctrl+C)
🎯 Best For
- Engineering teams doing code reviews
- Open source maintainers
- Claude users
- Gemini users
- Software engineers
💡 Use Cases
- Reviewing pull requests for security vulnerabilities
- Checking code style consistency
- Code quality improvement
- Best practice enforcement
📖 How to Use This Skill
- 1
Install the Skill
Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.
- 2
Load into Your AI Assistant
Open Claude or Gemini and reference the skill. Paste the SKILL.md content or use the system prompt tab.
- 3
Apply Deep Research to Your Work
Open your project in the AI assistant and ask it to apply the skill. Start with a small module to verify the output quality.
- 4
Review and Refine
Review AI suggestions before committing. Run tests, check for regressions, and iterate on the skill output.
❓ Frequently Asked Questions
Does this skill check for OWASP Top 10?
Security-focused review skills often include OWASP checks. Check the skill content for specific vulnerability categories covered.
Is Deep Research compatible with Cursor and VS Code?
Yes — this skill works with any AI coding assistant including Cursor, VS Code with Copilot, and JetBrains IDEs.
Do I need specific dependencies for Deep Research?
Check the install command and Works With section. Most code skills only require the AI assistant and your codebase.
How do I install Deep Research?
Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/deep-research/SKILL.md, ready to use.
Can I customize this skill for my team?
Absolutely. Edit the SKILL.md file to add team-specific instructions, examples, or workflows.
⚠️ Common Mistakes to Avoid
Blindly accepting AI suggestions
Always verify AI-generated review comments. Some suggestions may not apply to your specific codebase conventions.
Skipping validation
Always test AI-generated code changes, even for simple refactors.
Missing dependency updates
Check if the skill requires updated dependencies or new packages.