deep-researcher

# Purpose

Conduct deep, iterative research beyond single-pass web search.

Core goals:
- Decompose a broad question into testable sub-questions.
- Build and test hypotheses against multiple source classes.
- Resolve contradictions with explicit arbitration.
- Produce a scientific-style Markdown report with footnotes.

This skill coordinates upstream skills. It does not replace them.

# Required Installed Skills

- `deepresearchwork` (inspected latest: `1.0.0`)
- `tavily-search` (inspected latest: `1.0.0`)
- `perplexity-deep-search` (inspected latest: `1.0.0`)
- `literature-search` (inspected latest: `1.0.3`; used as Semantic Scholar-capable academic layer)

Install/update:

```bash
npx -y clawhub@latest install deepresearchwork
npx -y clawhub@latest install tavily-search
npx -y clawhub@latest install literature-search
npx -y clawhub@latest install perplexity-deep-search
npx -y clawhub@latest update --all
```

Verify:

```bash
npx -y clawhub@latest list
node skills/tavily-search/scripts/search.mjs --help
bash skills/perplexity-deep-search/scripts/search.sh --help
```

# Required Credentials

- `TAVILY_API_KEY`
- `PERPLEXITY_API_KEY`

Preflight:

```bash
echo "$TAVILY_API_KEY" | wc -c
echo "$PERPLEXITY_API_KEY" | wc -c
```

If missing, stop and report blockers.

# Mapping Rule (Requested "semantic-scholar")

If user requests `/semantic-scholar` explicitly:
- State that no exact `semantic-scholar` slug was found during ClawHub inspection.
- Use `literature-search` as the mapped academic retriever because it explicitly includes Semantic Scholar in its scope.
- Record this mapping in methodology and limitations sections.

# Inputs the LM Must Collect First

- `research_topic`
- `target_horizon` (example: `2030`)
- `region_scope` (global, region-specific, country-specific)
- `required_sections` (executive summary, methods, findings, contradictions, etc.)
- `evidence_threshold` (minimum source count per claim)
- `recency_policy` (for fast-changing topics)
- `output_mode`...