AgentSkillsCN

gemini-deep-research

使用 Gemini 深度研究代理执行复杂、长时间的研究任务。当要求研究需要多源综合、竞争分析、市场研究或全面技术调查的主题时使用，这些主题受益于系统的网络搜索和分析。

SKILL.md
--- frontmatter
name: gemini-deep-research
description: Perform complex, long-running research tasks using Gemini Deep Research Agent. Use when asked to research topics requiring multi-source synthesis, competitive analysis, market research, or comprehensive technical investigations that benefit from systematic web search and analysis.
metadata: {"clawdbot":{"emoji":"🔬","requires":{"env":["GEMINI_API_KEY"]},"primaryEnv":"GEMINI_API_KEY"}}

Gemini Deep Research

Use Gemini's Deep Research Agent to perform complex, long-running context gathering and synthesis tasks.

Prerequisites

  • •GEMINI_API_KEY environment variable (from Google AI Studio)
  • •Note: This does NOT work with Antigravity OAuth tokens. Requires a direct Gemini API key.

How It Works

Deep Research is an agent that:

  1. •Breaks down complex queries into sub-questions
  2. •Searches the web systematically
  3. •Synthesizes findings into comprehensive reports
  4. •Provides streaming progress updates

Usage

Basic Research

bash
scripts/deep_research.py --query "Research the history of Google TPUs"

Custom Output Format

bash
scripts/deep_research.py --query "Research the competitive landscape of EV batteries" \
  --format "1. Executive Summary\n2. Key Players (include data table)\n3. Supply Chain Risks"

With File Search (optional)

bash
scripts/deep_research.py --query "Compare our 2025 fiscal year report against current public web news" \
  --file-search-store "fileSearchStores/my-store-name"

Stream Progress

bash
scripts/deep_research.py --query "Your research topic" --stream

Output

The script saves results to timestamped files:

  • •deep-research-YYYY-MM-DD-HH-MM-SS.md - Final report in markdown
  • •deep-research-YYYY-MM-DD-HH-MM-SS.json - Full interaction metadata

API Details

  • •Endpoint: https://generativelanguage.googleapis.com/v1beta/interactions
  • •Agent: deep-research-pro-preview-12-2025
  • •Auth: x-goog-api-key header (NOT OAuth Bearer token)

Limitations

  • •Requires Gemini API key (get from Google AI Studio)
  • •Does NOT work with Antigravity OAuth authentication
  • •Long-running tasks (minutes to hours depending on complexity)
  • •May incur API costs depending on your quota