deep-research

Runs Gemini, ChatGPT, or Perplexity Deep Research in a browser and retrieves the cited report.

1|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill deep-research-zhiyuan-zhang0206
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/zhiyuan-zhang0206/Ava/tree/main/ava_builtins/skills/web-ai/deep-research
Command: npx skills add https://github.com/zhiyuan-zhang0206/Ava --skill deep-research-zhiyuan-zhang0206

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deep Research features in Gemini, ChatGPT, and Perplexity run for many minutes and may pause for plan approval or clarifying questions, so they cannot be completed in a single agent turn. This Skill splits the job into deterministic start, check, and reply commands that drive a logged-in browser, letting an agent kick off long multi-source research, poll it later, and retrieve the finished cited report as a saved Markdown file. ## Core Features & Use Cases - Multi-site Deep Research automation: Starts Deep Research on Gemini, ChatGPT, or Perplexity by enabling the mode in the composer UI, submitting the prompt, and auto-approving the research plan. - Polling-based completion detection: The check command judges completion via report-text stability and streaming state, then saves report.md plus meta.json to a timestamped downloads directory. - Clarifying-question handling: Reads the conversation's last message when a site asks questions before starting, and answers it with the reply command. - Use Case: Ask "How have small modular reactors progressed since 2023?" — the agent starts Gemini Deep Research, schedules a reminder to poll every 6-8 minutes, and delivers the synthesized, citation-backed report when it finishes. ## Quick Start Ask the agent to run a deep research on your question, for example: start a Gemini deep research on how small modular reactors have progressed since 2023 and bring me the cited report when it finishes.

Frequently Asked Questions about deep-research

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Gemini Deep Research from an AI agent?▼

Run the research.py start command with --site gemini and your prompt; it enables Deep Research mode in the browser, submits the prompt, and approves the plan. Then poll with the check command using the returned conversation URL until the state is done.

How do I get a cited report from ChatGPT or Perplexity deep research?▼

Start the job with --site chatgpt or --site perplexity, then poll with check. ChatGPT reports are fetched through the widget's Export to Markdown control, while Perplexity reports are read from the page once the text stops growing.

Why does deep research polling stay in the running state forever?▼

Check only marks a report done when it exceeds the minimum character count, stays unchanged across a stability gap, and no stop button is visible. If a UI change broke the report selectors, the report reads as empty and never settles, so the selectors in research.py need updating.

What happens when ChatGPT asks clarifying questions before starting research?▼

A running check with zero chars returns the conversation's last message in last_message. Answer it with the reply command and keep polling, or avoid the gate by ending your prompt with an instruction to make reasonable assumptions and start without asking.

What if the script cannot find the Deep Research toggle or plan button?▼

Enable Deep Research mode manually in the browser and re-run start with --assume-mode, or click the plan approval button yourself and continue polling with check. Button labels drift with UI updates, which is the known fragility of this approach.