---
name: web-research
description: Conduct deep web research to gather insights, determine best practices, and discover new developments. Produces structured reports.
---

# Web Research

Conduct deep, comprehensive web research on a topic. This skill acts as a "Lead Researcher," synthesizing information from multiple sources to provide insights, best practices, and trend analysis.

## When to Use

- "Research [topic]"
- "What are the best practices for [technology]?"
- "Gather insights on [subject]"
- "What's new in [field]?"
- "Compare [option A] and [option B]"

## Process

1.  Identify the research topic from the user's request.
2.  Run the helper script with the topic.

## Helper Scripts

### research.sh

**Usage**:
```bash
./scripts/research.sh "your research topic"
```

**Backends**:
You can choose the synthesis backend using the `RESEARCH_BACKEND` environment variable.
- `claude` (default): Uses Claude for both search and synthesis.
- `llm`: Uses Claude for search, but pipes results to the `llm` CLI for synthesis.
- `kagi`: Uses Kagi's FastGPT API (requires `KAGI_API_KEY` or `/run/secrets/api_keys/kagi`).

**Example**:
```bash
# Default (Claude)
./scripts/research.sh "current best practices for React state management in 2025"

# Use LLM backend
RESEARCH_BACKEND=llm ./scripts/research.sh "current best practices for React state management in 2025"
```

## Requirements

- `claude` CLI tool must be installed and in the PATH.
- `llm` CLI tool (optional) for using the `llm` backend.
- `KAGI_API_KEY` environment variable OR `/run/secrets/api_keys/kagi` (for `kagi` backend).
