deep-dive

Researches topics using DAG-based query planning and parallel web-search subagents.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill deep-dive-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-dive
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/deep-dive
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill deep-dive-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Answering complex research questions with a single search often yields shallow or incomplete results. This Skill decomposes a big question into a dependency graph of sub-questions, researches them in parallel, and synthesizes a cited report. ## Core Features & Use Cases - DAG-Based Planning: Breaks a research question into 4-12 sub-questions with explicit dependencies, printed as a plan table before execution. - Parallel Subagent Research: Runs independent sub-questions concurrently as web-search subagents, each returning findings, gaps, and cited sources. - Gap-Driven Iteration: Reviews collected gaps and runs one targeted follow-up wave when missing information would change the conclusion. - Persistent Reports: Saves the synthesized markdown report with deduplicated sources into the project's docs/deep-dive/ directory. - Use Case: Ask "How do microservices generate Jira documentation?" and receive a structured report with an executive summary, themed findings, open questions, and a full source list. ## Quick Start Ask Claude to run a deep dive on the research question or topic you want investigated thoroughly.

Frequently Asked Questions about deep-dive

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

FAQPage Schema
How do I run deep research on a topic with Claude Code?

Invoke the deep-dive skill with your research question as the argument. It prints a DAG plan of sub-questions, launches parallel web-search subagents, and delivers a synthesized markdown report with sources.

How does DAG-based research planning work?

The question is split into 4-12 sub-questions, each with dependency links. Independent questions run in parallel first, then dependent questions receive prior findings as context, ensuring answers build on verified foundations.

Does deep-dive require external APIs or paid services?

No external API is needed. It runs entirely within Claude Code using built-in web search and Agent subagents, so there are no extra dependencies, keys, or third-party research services to configure.

Where are deep-dive research reports saved?

Final reports are saved as markdown files in the project's docs/deep-dive/ directory with a date-prefixed slug filename. Sources from each wave are also persisted to a JSON file in /tmp to survive context compaction.

What are the limitations of automated deep research?

Each sub-question is limited to 1-3 web searches, and only one gap-iteration round runs, so very niche topics may remain partially answered. The report honestly lists unresolved items under Open Questions rather than speculating.