Agent skill · research science · sickn33
gemini-deep-research
Run autonomous multi-step research with Google's Gemini Deep Research Agent: kick off a query, poll progress, and collect a cited report for market analysis or literature reviews.
Why this skill is useful
Adds executable scripts for autonomous multi-step research with Google's Gemini API, enabling structured reports and real-time progress tracking.
What it needs
Requires httpx, python installed locally. Requires google account access. About 2k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Gemini Deep Research Skill When to Use Use when a question needs autonomous multi-step research with cited sources (market analysis, literature reviews, competitive scans) Use when you want to start a Gemini Deep Research run, poll its progress, and collect the final report Use when a quick web search is not enough and a structured, source-grounded report is required Run autonomous research tasks that plan, search, read, and synthesize information into comprehensive reports. Requirements Python 3.8+ httpx: pip install -r requirements.txt GEMINIAPIKEY environment variable Setup 1. Get a Gemini API key from Google AI Studio 2. Set the environment variable: Or create a .env file in the skill directory. Safety Gate Before starting a research job, show the user the exact query, the fact that it will be sent to Google's Gemini service, the expected cost range, and the output destination. Start a job only after explicit approval. Do not include private workspace material, credentials, personal data, or confidential customer information in a query. Usage Start a research task With structured output format Stream progress in real-time Start without waiting Check status of running research Wait for completion Continue from previous research List recent research 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 1. User requests research → Run --query "..." 2. Inform user of estimated time (2-10 minutes) 3. Monitor with --stream or poll with --status 4. Return formatted results 5. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/gemini-deep-research