deep-research

Generates citation-tracked research reports through a multi-phase pipeline with evidence persistence and claim verification.

3|3|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/joaoguirunas/team-os --skill deep-research-joaoguirunas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-research
Source: https://github.com/joaoguirunas/team-os/tree/main/.claude/skills/deep-research
Command: npx skills add https://github.com/joaoguirunas/team-os --skill deep-research-joaoguirunas

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires weasyprint, and includes scripts (resource) and references (resource) components.

What problem does it solve? Conducting rigorous multi-source research manually means juggling dozens of searches, tracking which claims came from which sources, and verifying citations — a process prone to hallucinated references and lost evidence. This Skill automates the entire pipeline, producing citation-backed reports with an auditable evidence trail persisted to disk. ## Core Features & Use Cases - 8-Phase Research Pipeline: Scope, plan, retrieve (parallel searches plus sub-agents), triangulate, synthesize, critique with loop-back, refine, and package — with four depth modes (quick, standard, deep, ultradeep) from 2 to 45 minutes. - Evidence & Claim Persistence: Sources, evidence quotes, and atomic claims are stored in append-only JSONL files (sources.jsonl, evidence.jsonl, claims.jsonl) with stable SHA-256 identities, surviving context compaction and continuation agents. - Multi-Format Output: Generates Markdown, McKinsey-style HTML, and PDF reports with automated validation (structure checks, citation verification, hallucination detection) and auto-continuation for reports over 18,000 words. - Use Case: Ask for a deep comparison of PostgreSQL vs Supabase for your stack, and receive a verified report with 10+ sources, 3+ citations per major claim, and a complete bibliography. ## Quick Start Ask the agent to do deep research on the current state of quantum computing in standard mode and save the report to the project docs folder.

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 report with citations?▼

Invoke the skill with a research question and optionally a mode, such as "deep research on quantum computing" or "ultradeep mode: compare PostgreSQL vs Supabase". The pipeline runs scoping, parallel retrieval, triangulation, synthesis, critique, and packaging automatically.

What research modes are available and how long do they take?▼

Four modes exist: quick (3 phases, 2-5 minutes), standard (6 phases, 5-10 minutes, the default), deep (8 phases, 10-20 minutes), and ultradeep (8+ phases, 20-45 minutes). Deeper modes add critique, refinement, and multi-persona red teaming.

When should I use this skill instead of the native /deep-research workflow?▼

Use the native workflow for fast factual web questions. Use this skill when you need disk-persisted evidence (evidence.jsonl, claims.jsonl), atomic claim-level verification with an auditable ledger, or McKinsey-style HTML/PDF reports.

Does the deep research skill require API keys or external tools?▼

Core functionality works with built-in WebSearch and Python standard library only. The optional search-cli tool (installed via Homebrew) enables multi-provider search across Brave, Serper, Exa, Jina, and Firecrawl, and weasyprint enables PDF output.

How are citations verified and hallucinations prevented?▼

Every source gets a stable SHA-256 identity in sources.jsonl, evidence quotes are persisted in evidence.jsonl, and claims are extracted into claims.jsonl with support status. Validation scripts check structure, DOI/URL validity, and flag unsupported factual claims before delivery.

What happens when a research report exceeds 18,000 words?▼

An auto-continuation protocol saves a state file with research context, quality metrics, and remaining sections, then spawns continuation agents that read the state and append subsequent sections while matching style, citation density, and prose ratio.