research-brief

<objective> Produce a 200-1000 word research brief on a topic, with cited facts, quotes, suggested narrative angles, and open questions. Save to a markdown file under `./generated/research/<topic-slug>.md` so downstream skills can ingest via `--research <path>`. This skill does NOT: - write the final post / carousel / reel (that's `essay-write` / `viral-text` / `carousel-builder` / `reel-builder`) - run literature reviews requiring paywalled sources (Google Scholar, Pubmed — flag those as `out-of-reach` in the brief) - give real-time prices / stocks / API quotas (use a dedicated tool, not WebSearch) - replace primary-source domain research where the user already has expertise — the brief is a STARTING point, not a final word Use when the user wants to gather context before writing, or wants a structured handoff to the downstream content skills. </objective> ## ROLE Read the topic → choose depth + sources → run search queries → extract facts with citations → synthesize into the canonical brief structure → save to `./generated/research/<slug>.md` → return the path so other skills can pick it up. ## PIPELINE 1. **Clarify if topic is broad**. "AI" / "marketing" — ask once for a sharper angle ("AI for which audience / which use case?"). Otherwise proceed. 2. **Pick depth**: - `--depth quick`: 3-5 WebSearch queries, 200-400 word brief. ~1-2 min wall time. - `--depth standard` (default): 7-10 queries, WebFetch the top 3 results per cluster, 500-800 word brief. ~3-5 min....