deep-research

Orchestrates multi-round web research with parallel synthesis and dual-reviewer claim verification.

Updated Sep 14, 2026
One-click install
npx skills add https://github.com/pandejesal/drone-nav-sar --skill deep-research-pandejesal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/pandejesal/drone-nav-sar/tree/main/.swarm/bundled-skills/deep-research
Command: npx skills add https://github.com/pandejesal/drone-nav-sar --skill deep-research-pandejesal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering complex questions from memory alone risks hallucinated facts and missing sources. This Skill runs a structured, evidence-grounded research workflow that decomposes a question, retrieves real web sources, verifies every claim against its citation, and produces a cited report. ## Core Features & Use Cases - Iterative Retrieval Loop: Decomposes the question into subtopics and runs up to 4 rounds of web_search and web_fetch, maintaining an evidence ledger keyed by subtopic. - Parallel Synthesis & Verification: Dispatches parallel sme workers to synthesize findings, then two reviewer agents verify each claim as SUPPORTED, UNSUPPORTED, OVERSTATED, or CONTRADICTED, with a critic challenging high-stakes claims. - Cited Report Output: Produces a report or brief where every load-bearing claim carries a source citation, disagreements between sources are surfaced, and ungrounded subtopics are marked UNVERIFIED. - Use Case: Ask "What are the current best practices for PPO training stability in 2025?" and receive a structured report with verified claims, confidence levels, and a full source list. ## Quick Start Ask the agent to run deep research on a question, for example: run deep research on the current state of indoor drone navigation benchmarks with standard depth and a full report.

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, researchers, and output format in the header. The orchestrator decomposes the question, retrieves web sources, verifies claims with reviewers, and returns a cited report.

What search APIs does deep research support?

Deep research supports Tavily and Brave Search. Configure a key via council.general.searchApiKey or the TAVILY_API_KEY or BRAVE_SEARCH_API_KEY environment variables, and set council.general.enabled to true in the opencode-swarm config.

Why does deep research stop before searching?

It stops when council.general.enabled is not true or no search API key is configured. This pre-flight check prevents ungrounded answers generated from training memory instead of real sources.

How are research claims verified for accuracy?

Each claim must cite an evidence ref from fetched sources. Two parallel reviewer agents grade every claim as SUPPORTED, UNSUPPORTED, OVERSTATED, or CONTRADICTED, and a critic challenges high-stakes or contested claims before publication.

What happens when sources cannot be found for a subtopic?

The subtopic is explicitly marked UNVERIFIED in the final report rather than answered from memory. The protocol forbids fabricating sources, URLs, or evidence references.

Can deep research modify code or write project files?

No. The mode is read-only: it does not mutate source code, delegate to coder agents, or write files outside the .swarm/evidence-cache directory, which tools populate automatically.