# Gemini Deep Research

> Run a single Gemini deep research query from the CLI and store the report locally. Use when a user wants a one-off deep research result.

- Skill: `jeffchen006/gemini-deep-research` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jeffchen006/gemini-deep-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jeffchen006/gemini-deep-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: jeffchen006 (https://skillmd.com/u/jeffchen006)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jeffchen006/gemini-deep-research

---


# Gemini Deep Research

Use `scripts/deep_research.py` to run one deep research query and save the report to local storage.

## Quick start

- Put `GOOGLE_API_KEY=...` in the project `.env`.
- Run: `python scripts/deep_research.py "your topic"`

## Storage

Reports are saved under `storage/` (relative to this skill directory). Each run gets:

- `report.md` (human-readable output)
- `run.json` (metadata)

## Expected wait time

Deep research typically takes a few minutes (often 2-10 minutes), longer for complex topics.