deep-research
Perform autonomous, multi-step research using the Gemini Deep Research Agent (Interactions API). Supports web search, file/directory context, and resilient streaming.
How do I install this agent skill?
npx skills add https://github.com/cnemri/google-genai-skills --skill deep-researchIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides a research tool using the Gemini Deep Research API. It handles file uploads and API keys securely, with no malicious patterns detected.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerwarn
3/3 files flagged
What does this agent skill do?
Deep Research
Use this skill to conduct deep, autonomous research tasks that require planning, searching, reading, and synthesizing information.
This skill uses the Gemini Deep Research Agent (deep-research-pro-preview-12-2025) via the Interactions API.
Prerequisites
GOOGLE_API_KEY: Required for accessing the Interactions API (currently in Preview via AI Studio).google-genaiSDK v0.3.0+
Usage
Basic Research
Start a research task and stream the results to the console.
uv run skills/deep-research/scripts/research.py "Research the history of RISC-V architecture."
Research with Context (Files or Directories)
Provide local files (PDFs, text) or entire directories for the agent to read and incorporate into its research.
Direct Upload (Best for specific docs):
# Single file
uv run skills/deep-research/scripts/research.py "Analyze this report" --file report.pdf
# Entire directory
uv run skills/deep-research/scripts/research.py "Summarize these meeting notes" --file ./notes/
File Search Store (Best for large corpora):
Use --use-file-store to index files into a searchable store (RAG) instead of uploading them into the context window.
uv run skills/deep-research/scripts/research.py "Find trends in these 1000 PDFs" --file ./large_corpus/ --use-file-store
Saving the Report
Save the final Markdown report to a file.
uv run skills/deep-research/scripts/research.py "Competitive landscape of EV batteries" --output report.md
Continuing Research (Follow-up)
Ask follow-up questions to an existing research session using the Interaction ID (displayed at the start of the previous run).
uv run skills/deep-research/scripts/research.py "Elaborate on the second point about lithium supply." --follow-up "INTERACTION_ID_HERE"
References
How it Works
- Planning: The agent breaks down your prompt into steps.
- Execution: It autonomously searches the web and reads your provided files.
- Resilience: The script automatically reconnects if the long-running stream drops.
- Synthesis: It produces a comprehensive, cited report.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/cnemri/google-genai-skills/deep-research">View deep-research on skillZs</a>