Skill Listing
Review the skill and install it into your account in one click.
Deep Research
Comprehensive research using multi-source evidence, synthesis, and citation structure.
AI review
Quality 78Trust 65Discovery 49Well-built researcher orchestration script that streams progress and produces citation-backed reports; useful and fairly polished but depends on external Google Gemini APIs and the accuracy of the underlying model.
Deep Research is a practical, well-documented script for orchestrating multi-source research with streaming progress updates and configurable output options. The listing includes usage examples, argument flags, and a runnable script, making it launch-ready for developers with access to the required API. Note that it requires a Google Gemini (GEMINI_API_KEY) and network access, and the trustworthiness of citations ultimately depends on the model’s behavior — users should verify sources in final reports.
Strengths
- Streams progress and thinking summaries for real-time visibility
- Clear usage examples and configurable output/timeout options
Considerations
- Requires a Google Gemini API key and external network access; verify credentials handling
- Citation and synthesis quality depend on the underlying model; users should validate sources
Why this ranks
Agent List ranks listings using quality, trust, traction, and freshness instead of follower count alone. Paid Computer Agents badges are identity signals only and do not raise discovery score.
- It is surfacing as a hidden-gem candidate: high quality with less existing traction.
- The quality review is solid enough to support discovery.
- The listing is under additional review, which can affect discoverability.
Trust signals
AI review
Review pending.
Badge guide
Paid account badge
Automatic for active Computer Agents Individual, Team, and Enterprise subscriptions. It confirms account status only and does not increase discovery ranking.
Agent List review
Granted after Agent List reviews the creator profile and marketplace presence. This is separate from the blue paid account badge.
Deep Research
Conduct comprehensive deep research on complex topics using Google's Deep Research agent with streaming progress updates.
When to Use
Use this skill when you need to:
- Research complex topics requiring multiple sources
- Generate comprehensive reports with citations
- Analyze and synthesize information from various angles
- Investigate technical concepts, industry trends, or detailed questions
Usage
Run the deep research script with your topic:
Optional: Save to a specific output file:
IMPORTANT: Wait for Completion
Deep research takes 3-10 minutes to complete. The script will:
- Stream thinking/progress updates in real-time
- Automatically retry and poll for results if needed
- Save the final report to a file when complete
DO NOT interrupt or check on the research while it's running. The script handles all retries and status checking internally.
Examples
Options
| Option | Short | Default | Description |
|---|---|---|---|
--output | -o | auto-generated | Output file path |
--timeout | -t | 600 | Maximum time in seconds (default: 10 min) |
--verbose | -v | false | Enable verbose debug logging |
--system | none | Custom system instruction |
Research Process
The script uses Google's Deep Research agent which:
- Starts an interaction: Creates a research session with the topic
- Streams thinking summaries: Real-time progress as the agent researches
- Delivers results: Final report with sources and citations
- Auto-recovers: Handles network issues and retries automatically
Output
The script generates a markdown report containing:
- Comprehensive research findings
- Source URLs for verification (in Sources section)
By default, reports are saved to /workspace/deep_research/ with auto-generated filenames.
IMPORTANT: Enhance Reports with Images
After the research completes, you MUST enhance the report with generated images:
- Generate a title image for the report header
- Generate 1-2 concept visualizations for key findings
- Insert the images into the report using sed
Example workflow after research completes:
Images should be saved to /workspace/generated_images/ and referenced with relative paths from the report.
Streaming Events
The script outputs JSON events for real-time UI updates:
{"event": "start", "topic": "..."}- Research started{"event": "thinking", "summary": "..."}- Progress update{"event": "content", "text": "..."}- Report content{"event": "complete", "report_file": "...", "sources_count": N}- Done
Requirements
GEMINI_API_KEYenvironment variable must be set- Python 3.10+ with
requestspackage installed
Notes
- Research typically takes 3-10 minutes depending on topic complexity
- The script blocks until completion - do not interrupt
- Results include sources for verification
- If research fails, the script will clearly indicate this