From claude-superskills
Runs structured multi-step web research with source synthesis, citations, skeptical evaluation, and confidence/gap analysis. Supports native and dense/frontier modes.
How this skill is triggered — by the user, by Claude, or both
Slash command
/claude-superskills:deep-researchThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Run structured, multi-step web research with evidence-first synthesis, source traceability, skeptical evaluation, and explicit confidence/gap analysis.
Run structured, multi-step web research with evidence-first synthesis, source traceability, skeptical evaluation, and explicit confidence/gap analysis.
This skill works in native mode with built-in web research tools and does not require Google/Gemini, OpenAI, Anthropic, OpenRouter, or any other paid provider setup. When the user explicitly wants maximum depth, use dense/frontier mode to recommend the strongest available model and run a wider parallel research topology where the host platform supports subagents.
Use this skill when:
WebSearch, WebFetch)No external API key is required for native mode.
Display a progress gauge at each research phase:
[████░░░░░░░░░░░░░░░░] 20% — Phase 1/5: Objective, Scope & Decomposition
[████████░░░░░░░░░░░░] 40% — Phase 2/5: Parallel Source Collection
[████████████░░░░░░░░] 60% — Phase 3/5: Evidence Ledger & Triangulation
[████████████████░░░░] 80% — Phase 4/5: Synthesis & Confidence/Gaps
[████████████████████] 100% — Phase 5/5: Citation Audit & Final Review
Use native mode by default.
WebSearch and WebFetch.ResearchScout agents where subagents are available.Confidence & Gaps.Use dense/frontier mode when the user asks for maximum depth, exhaustive research, "frontier model", "Perplexity-like" research, "turbinado", adversarial review, high-confidence evidence, or says cost is secondary to research quality.
If dense/frontier mode is requested but frontier tooling is unavailable, continue with native mode and disclose the limitation.
For dense/frontier research, recommend the strongest available model before execution:
State the recommendation in this form:
Recommended research model: <model or model class>.
Reason: <why this model fits the research task>.
Fallback: <native mode or next best model>.
Do not hard-code one model as universally best. Use the strongest available model/tooling path and disclose limitations.
Before starting, present the user with three modes:
Which research mode do you want?
[1] Standard — 12–15 sources · 1.500–3.000 words · findings by sub-question · single Confidence & Gaps block
[2] Verbose — 20–30 sources · 4.000–6.000 words · per-source deep-dives · per-sub-question confidence · Devil's Advocate section · Appendices
[3] Exhaustive — 40–60+ sources · 8.000+ words · full dense/frontier agent topology · block quotes allowed · stakeholder map · chronology · multiple critique rounds
If the user does not specify, default to Standard.
| Parameter | Standard | Verbose | Exhaustive |
|---|---|---|---|
| Minimum sources | 12–15 | 20–30 | 40–60+ |
| Word target | 1.500–3.000 | 4.000–6.000 | 8.000+ |
| Per-source deep-dive | No | Yes (material sources) | Yes (all major sources) |
| Per-sub-question confidence | No | Yes | Yes |
| Block quotes | Short only | Allowed when exact wording matters | Allowed |
| Devil's Advocate / Steelman | No | Yes | Yes |
| Background / Context section | Brief | Full (2–4 paragraphs) | Full + chronology |
| Stakeholder / Actor map | No | When applicable | Always |
| Methodology section | No | Yes | Yes |
| Appendices (query log, rejected sources, paywalls) | No | Yes | Yes |
| Executive Summary | No | Yes (200–300 words at top) | Yes (300–500 words at top) |
| Agent topology | Native | Native + ContrarianScout | Full dense/frontier topology |
| Critique rounds | 1 | 1–2 | 2–3 adversarial rounds |
0.5. Create and present a Research Plan
Before launching any agents, produce a structured research plan and show it to the user. Proceed unless they want changes.
## Research Plan: [Topic]
**Core Question:** [one sentence — what exactly needs answering]
**Decision Context:** [how results will be used: strategy, due diligence, comparison, etc.]
**Scope:** [geography, time horizon, industry, technology boundaries]
### Research Dimensions
1. [Dimension] — [what to find and why it matters]
2. [Dimension] — [what to find and why it matters]
3. [Dimension] — [what to find and why it matters]
...
### Source Strategy
- Primary: [official docs, filings, government data, company pages]
- Secondary: [analyst reports, established media, expert orgs]
- Validation: [how conflicting claims will be resolved]
### Known Unknowns
- [What we know we don't know yet — data that may be hard to find]
Show the plan and wait for user confirmation before proceeding.
Example decomposition:
Reject or down-rank sources that:
For every agent, emit three status lines in this exact format:
⟳ <Agent Name> — <what it is doing>
✅ <Agent Name> — Done · <N> sources collected · <key finding in one sentence>
Example:
⟳ 🔍 Scout Alpha — Scanning primary sources for sub-question 1...
✅ 🔍 Scout Alpha — Done · 8 sources collected · Three vendors dominate with >60% market share combined.
⟳ ⚔️ Devil's Advocate — Searching for contradictions and critical evidence...
✅ ⚔️ Devil's Advocate — Done · 4 sources collected · Two analyst reports dispute the market share figures.
Emit the ⟳ line immediately before launching each agent. Emit the ✅ line immediately after the agent returns results.
Do NOT run searches sequentially. Launch one agent per sub-question or major query type simultaneously in a single block where the host platform supports subagents.
| Agent | Role | Assignment |
|---|---|---|
| 🔍 Scout Alpha | Primary researcher | Sub-question 1 with primary-source preference |
| 🔍 Scout Beta | Primary researcher | Sub-question 2 with primary-source preference |
| 🔍 Scout Gamma | Primary researcher | Sub-question 3 with primary-source preference |
| ⚔️ Devil's Advocate | Contrarian researcher | Find credible conflicting or critical evidence |
| 📡 Trend Watcher | Recency researcher | Date-filtered search for recent developments when time-sensitive |
Each agent prompt begins with:
# <Agent Name> — Deep Research Agent
Role: Execute assigned web research using WebSearch/WebFetch. Collect authoritative sources, extract claim-level evidence, identify contradictions, and return structured results.
Required output:
- Sub-question or query assignment
- Queries attempted
- Source inventory with URL, title, publisher, date, and relevance
- Key claims and data points with source attribution
- Quote directly when the exact wording is material — definitions, methodologies, thresholds, or claims where paraphrasing would change the meaning. Avoid decorative quotes that add length without adding precision. (block quotes allowed in Verbose/Exhaustive mode)
- Evidence quality notes
- Conflicts, gaps, and inaccessible/paywalled sources
Wait for all agents to complete. Emit a summary banner before deduplication:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
All agents finished · Deduplicating results...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Then deduplicate results by canonical URL and run a Gap Analysis before proceeding to the evidence ledger.
After each agent batch, reason explicitly about findings vs needs before moving to synthesis:
### Gap Analysis — Iteration [N]
**Coverage so far:** [summary of dimensions addressed and confidence level per dimension]
**Gaps identified:**
- [ ] [Missing data point] — needed because [reason]
- [ ] [Conflicting claims unresolved] — need [source type] to adjudicate
- [ ] [Shallow coverage] — [dimension] needs deeper investigation
**Decision:** [Stop — all dimensions sufficient] / [Continue — targeted follow-up on gaps above]
Stop iterating when any of these conditions are met:
If continuing, launch a targeted follow-up agent batch scoped only to the identified gaps. Emit status notifications for each follow-up agent using the same format.
When the user requests maximum-depth research, run a wider parallel topology where the host platform supports subagents:
| Agent | Role | Purpose |
|---|---|---|
| 🧭 Research Lead | Coordinator | Normalize scope, define sub-questions, assign agents, and maintain evidence standards |
| 🔍 Scout Alpha–Epsilon | Primary researchers | Research one sub-question each with source traceability |
| 🏛️ Source Hunter | Primary-source specialist | Find official docs, filings, papers, regulatory pages, datasets, and primary evidence |
| ⚔️ Devil's Advocate | Contrarian researcher | Find credible disagreement, failures, criticism, and negative evidence |
| 📡 Trend Watcher | Recency researcher | Search for recent developments and date-sensitive updates |
| 🔬 Citation Auditor | Fact-checker | Check whether claims are properly supported and sources are credible |
| ⚖️ Synthesis Judge | Synthesizer | Consolidate findings, resolve conflicts, and write the final report |
Launch independent scout agents in one parallel batch whenever the host platform supports subagents. If subagents are unavailable, simulate the topology sequentially while preserving the same roles and output contracts.
After all dense/frontier agents complete, emit:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
All agents finished
🔍 Scouts Alpha–Epsilon ✅
🏛️ Source Hunter ✅
⚔️ Devil's Advocate ✅
📡 Trend Watcher ✅
🔬 Citation Auditor ✅
⚖️ Synthesis Judge ✅
Proceeding to final synthesis...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
confirmed: supported by strong evidence or multiple credible independent sourcescontested: credible sources disagreeweak: only one weak or indirect source supports itinferred: reasoned conclusion based on evidence, not directly stated by sourcesEvidence ledger fields:
For every source that directly supports a main conclusion, produce a deep-dive paragraph after the evidence ledger. Only cover material sources — those whose removal would weaken or change a key finding.
### Source Deep-Dive: "<Title>" — <Publisher>
- **Type:** <primary | scholarly | analyst report | news | blog>
- **Date:** <publication or last-update date>
- **Methodology:** <how data was collected — survey, benchmark, interview, literature review, etc.>
- **Sample size:** <N respondents / data points / cases, if applicable>
- **Geographic scope:** <regions covered — flag gaps>
- **Potential conflict of interest:** <funding, ownership, vendor affiliation, or "none identified">
- **Independence:** <peer-reviewed, externally validated, or self-published>
- **Key contribution:** <what this source adds that no other source provides>
- **Limitations:** <gaps, recency issues, methodology weaknesses, self-reported data, etc.>
In Exhaustive mode, apply deep-dives to all sources with high or medium source quality, not only the material ones.
4.5. Self-critique (three passes before synthesis)
Run all three passes before generating any output. Do not skip passes even under time pressure.
Pass 1 — Factual Accuracy
[UNVERIFIED] — do not include them in final conclusions.Pass 2 — Completeness
Pass 3 — Coherence & Bias
For each sub-question, use this four-layer structure before stating the conclusion:
### Sub-question N: <question text>
**Evidence supporting the main claim:**
- <claim> [source]
- <claim> [source, source]
**Counter-evidence:**
- <conflicting claim or data point> [source] — methodology: <brief description>
**Methodology critique:**
- <weakness or gap in the supporting evidence>
- <independence issue, sample size concern, recency problem, etc.>
**Conflicting interpretations:**
- <interpretation A> — supported by sources X, Y
- <interpretation B> — supported by source Z; contested / weak evidence
**Sub-question conclusion:**
<1–3 sentence conclusion with explicit confidence level>
Confidence: <high | medium | low> — <one-line reason>
In Standard mode, state the conclusion directly without the four-layer breakdown. In Exhaustive mode, expand each layer with additional quotes and source references.
Choose one based on request:
Default structure for non-trivial research:
Standard mode:
Verbose and Exhaustive modes — additional sections:
Include a Methodology section before any findings. It must document:
## Methodology
**Research period:** <month and year>
**Mode:** <Standard | Verbose | Exhaustive>
**Queries used:**
- <exact query string>
- <exact query string>
**Queries discarded:** <query> (<reason: too broad, SEO-heavy, off-scope, etc.>)
**Sources attempted but inaccessible:**
- <Source name> (<reason: paywall | login required | timeout | 404>) — <what was used instead, if anything>
**Filters applied:**
- <e.g. Sources older than N years excluded unless foundational>
- <e.g. Marketing pages used only for vendor positioning claims>
**Known limitations before synthesis:**
- <e.g. No access to paid analyst reports>
- <e.g. Limited peer-reviewed literature on this topic>
Omit any field that does not apply. Never fabricate inaccessible sources — only list ones actually attempted.
Every substantive report must close with Confidence & Gaps:
Executive Summary — 200–300 words at the very top of the report, before Methodology. Must cover: research question, top 3–5 findings, overall confidence level, and biggest gap or risk. Written so the reader can stop here and still understand the core answer.
Background / Context — 2–4 paragraphs before findings. Covers: why this topic matters, relevant history, key definitions, and the current state of the field. Gives the reader enough context to evaluate the findings without prior domain knowledge.
Stakeholder / Actor map — when the topic involves multiple parties (competitors, regulators, buyers, vendors). List each actor, their role, their interests, and their relevance to the research question. Include in Verbose and Exhaustive when applicable.
Timeline / Chronology — for time-sensitive topics (regulatory changes, product evolution, market shifts). A dated list of key events relevant to the research question, ordered chronologically. Include in Verbose and Exhaustive when the time dimension affects interpretation.
Devil's Advocate — a steelman section arguing the strongest case against the main conclusions. Written as a self-contained argument, not a list of caveats. Forces the report to confront its weakest points directly. Include in Verbose and Exhaustive always.
Appendices — at the end of the report, after Sources:
## Appendices
### A — Full Query Log
| Query | Agent | Results | Outcome |
|-------|-------|---------|---------|
| <query string> | 🔍 Scout Alpha | 12 results | 4 sources used |
| <query string> | ⚔️ Devil's Advocate | 8 results | 2 sources used |
### B — Rejected Sources
| Source | URL | Reason for rejection |
|--------|-----|----------------------|
| <title> | <url> | Promotional content, no methodology |
### C — Paywalled / Inaccessible Sources
| Source | URL | What was available |
|--------|-----|--------------------|
| <title> | <url> | Abstract only / login required |
| Error | Likely Cause | Action |
|---|---|---|
| WebSearch returns no results | Query too specific, misspelled, or topic very niche | Broaden query, try alternate phrasing, report low-coverage finding |
| WebFetch times out or blocked | Site is down, bot-blocking, or paywalled | Skip that source, note it as inaccessible, continue with other sources |
| Insufficient sources found | Topic has limited public information | Report coverage gaps; recommend user provide domain-specific sources |
| Conflicting information across sources | Different sources cite different facts | Flag the conflict explicitly; present both sides with sources |
| Query too broad | Research question covers too many sub-topics | Ask user to narrow the scope or prioritize specific dimensions |
| Paywalled content | Article requires subscription | Note the source as paywalled; use abstract/preview if available |
| Source lacks author/date/methodology | Source quality is unclear | Use only as weak/supporting context or discard for critical claims |
| Sources cite each other circularly | Apparent agreement is not independent confirmation | Mark evidence as weak and search for primary source |
| Strong sources disagree | Different methods, dates, jurisdictions, or definitions | Present both claims, explain credibility factors, and lower confidence if unresolved |
| Too many low-quality sources | Query is attracting SEO/marketing content | Add primary-source, filetype, site, institution, or regulatory terms to query |
| Frontier model unavailable | Host platform lacks requested model/tooling | Use native mode or strongest available model and disclose limitation |
npx claudepluginhub ericgandrade/claude-superskills --plugin claude-superskillsConducts deep web research with parallel agents, multi-wave exploration for gaps, and structured synthesis. Activates for investigating topics, comparing options, best practices, or comprehensive web info.
Conducts deep research on any topic with multi-agent source verification, interactive focus selection, and structured report generation. Supports multiple languages and session management.
Executes multi-agent research pipeline on any topic with Scout, Investigators, Deep Diver, Verifier, Synthesizer, and Critic reviews to produce verified, sourced reports.