deep-research

Orchestrates multi-round web research with parallel synthesis, claim verification, and cited reports.

Updated May 31, 2026
One-click install
npx skills add https://github.com/AlexanderNarbaev/agi --skill deep-research-alexandernarbaev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/AlexanderNarbaev/agi/tree/main/.opencode/skills/deep-research
Command: npx skills add https://github.com/AlexanderNarbaev/agi --skill deep-research-alexandernarbaev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering complex questions from memory alone produces ungrounded, unverifiable claims. This Skill runs a structured deep-research protocol that decomposes a question, gathers evidence via web search and fetch, verifies every claim against its source, and delivers a cited report. ## Core Features & Use Cases - Iterative Retrieval Loop: Decomposes the question into subtopics and runs up to 4 rounds of targeted web_search and web_fetch, maintaining an evidence ledger keyed by subtopic. - Parallel Synthesis & Verification: Dispatches parallel sme workers to synthesize evidence-grounded findings, then runs dual-reviewer claim verification and a critic challenge for high-stakes claims. - Honest Reporting: Leads with the answer, cites every load-bearing claim, surfaces source disagreements, and explicitly marks unverifiable subtopics as UNVERIFIED. - Use Case: Ask "Compare current approaches to post-quantum TLS deployment" and receive a structured report where each claim traces to a fetched primary source, with conflicts between sources presented openly. ## Quick Start Ask the agent to run deep research on your question, for example: "Run deep research on the current state of WiSARD versus Tsetlin machine accuracy benchmarks."

Frequently Asked Questions about deep-research

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

FAQPage Schema
How do I run deep research with cited sources?

Trigger the DEEP_RESEARCH mode with your question, optionally setting depth, rounds, and max_researchers parameters. The orchestrator decomposes the question, gathers evidence via web_search and web_fetch, verifies claims with reviewers, and returns a cited report.

What search API keys does deep research support?

Deep research supports Tavily and Brave search APIs. Set council.general.enabled to true and configure council.general.searchApiKey, TAVILY_API_KEY, or BRAVE_SEARCH_API_KEY in the global or project opencode-swarm.json config.

Why does deep research stop before searching?

The pre-flight check stops execution when council.general.enabled is not true or no search API key is configured. This prevents the agent from producing ungrounded research from training memory instead of real sources.

How are research claims verified before reporting?

Candidate findings are split into shards and checked by two parallel reviewers that mark each claim SUPPORTED, UNSUPPORTED, OVERSTATED, or CONTRADICTED against its cited evidence. High-stakes claims also face a critic challenge with SURVIVES, DOWNGRADE, or REJECT verdicts.

Can deep research modify my code or files?

No. The protocol is read-only: it does not mutate source code, delegate to coder, or call declare_scope. Evidence is written only under .swarm/evidence-cache/ by the tools, and the final report is presented directly in chat.

What happens when sources cannot answer a subtopic?

If a subtopic cannot be grounded through web search or fetch, it is explicitly marked UNVERIFIED in the report rather than answered from memory. Conflicting sources are presented honestly with the strongest version of each side.