deep-research

Conducts multi-agent web research with tiered source classification and structured report synthesis.

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/Yvesdefaria/GymLab --skill deep-research-yvesdefaria
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/Yvesdefaria/GymLab/tree/main/.opencode/skills/deep-research/skills/deep-research
Command: npx skills add https://github.com/Yvesdefaria/GymLab --skill deep-research-yvesdefaria

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Answering complex questions with a single web search often yields shallow, unsourced, or unreliable results. This Skill orchestrates parallel research agents that classify sources by credibility tier, cross-reference findings, and enforce hard quality gates so every claim in the final report is grounded in verifiable evidence. ## Core Features & Use Cases - Parallel Multi-Agent Research: Launches breadth, depth, and fact-checking agents that investigate distinct angles of a question simultaneously. - Source Tier Classification: Labels every source from Tier 1 (primary/official) to Tier 4 (unverifiable) and assigns confidence labels (Established, Likely, Emerging, Contested, Speculative) to each finding. - Hard Quality Gates: Enforces citation requirements, blocks fabricated URLs, discloses failed research angles, and flags reports relying too heavily on low-tier sources. - Use Case: Ask "Should we migrate from Redis to Valkey?" with thorough scope — the Skill dispatches agents to compare licensing, performance, and ecosystem, verifies single-source claims, and writes a dated report to ~/Documents/deep-research/ with an executive summary and research gaps. ## Quick Start Ask the assistant to research a topic thoroughly, for example: "Do a thorough deep research on the tradeoffs between SQLite and PostgreSQL for new web apps."

Frequently Asked Questions about deep-research

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

FAQPage Schema
How do I run a deep research query with multiple sources?

Invoke the deep-research skill with a scope modifier (quick, standard, thorough, or angles) followed by your research question. The skill launches parallel agents that search the web, classify sources by tier, and synthesize a cited report saved to ~/Documents/deep-research/.

What is the difference between quick, standard, and thorough research scope?

Quick uses 2 breadth agents with no depth or verification phase. Standard uses 3 breadth agents plus 1-2 depth agents. Thorough uses 5 breadth agents, 2-3 depth agents, and a dedicated fact-checking phase that verifies single-source claims against their original URLs.

How are sources evaluated for credibility in research reports?

Sources are classified into four tiers: Tier 1 primary sources like official docs and peer-reviewed papers, Tier 2 curated secondary sources like major publications, Tier 3 community content like blogs and forums, and Tier 4 unverifiable content. Findings receive confidence labels based on tier corroboration.

What is angles mode in deep research used for?

Angles mode surfaces candidate angles for content pieces like video essays or blog posts rather than answering a question. It explores four fixed facets — surprising facts, counterintuitive claims, unresolved debates, and real-world anchors — and returns 3-5 grounded candidate angles.

What happens when a research agent finds no useful sources?

The agent returns NO_USEFUL_FINDINGS with all attempted queries listed. The skill reformulates the angle and dispatches one replacement agent; if that also fails, the gap is disclosed in the report's Research Gaps section rather than being silently dropped.

Where are deep research reports saved?

Reports are written to ~/Documents/deep-research/ with filenames in the format YYYY-MM-DD-slug.md, where the slug is a short kebab-case topic identifier. Each file includes frontmatter with the original question, scope, and date, and duplicate slugs get numeric suffixes.