Deep research
Skill w95/awesome-claude-corporate-skills/01-executive-leadership/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.From its SKILL.md
npx -y skills add w95/awesome-claude-corporate-skills --skill deep-researchAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- reads credentialsReads from 2 credential sources: `GEMINI_API_KEY` and 1 more.
- runs commandsInstructs the agent to run 8 commands, including `pip install -r requirements.txt` and 7 more.
What its file declares
Copied from the file, not written here
The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.7 KB, 592 tokens by cl100k_base, as published. Nobody here has run it
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)
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.
Gives 0 of the 12 instructions most web research skills give in 592 tokens
Counted across 292 of the 300 authors here whose files we hold, read 2026-09-06
- Use web_search_exa for current information and broad discoveryin 22 of 292, across 8 files
- Cite every claim with a sourcein 21 of 292, across 18 files
- Configure the Exa MCP server with an API keyin 18 of 292, across 5 files
- Use get_code_context_exa for code examples and API docsin 16 of 292, across 6 files
- Verify exact tool names before depending on themin 13 of 292, across 4 files
- Narrow results with site:, quoted phrase, and intitle: operatorsin 13 of 292, across 4 files
- Adjust tokensNum lower for snippets, higher for full contextin 13 of 292, across 4 files
- Break the topic into 3-5 research sub-questionsin 13 of 292
- Confirm current Exa docs and exposed tool surface before usein 11 of 292, across 2 files
- Get user confirmation after Phase 1in 10 of 292, across 9 files
- Prefer primary sources when availablein 10 of 292
- Verify extracted metadata against original sourcesin 9 of 292, across 5 files
Said here and by no other author read
- Install dependencies with pip
- Start a research task with --query
- Specify report structure with --format
- Stream progress in real time with --stream
- Start without waiting using --no-wait
- Check status with --status
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.