By name: web-researcher description: Research topics on the internet and compile findings into a structured markdown document. Use when asked to research, investigate, find information about, look up, or learn about any topic. Triggers include "Research X", "Find information about Y", "What are the latest developments in Z", "Look up details on W", or any request requiring gathering and synthesizing web information.
Web Researcher
Research topics using WebSearch and WebFetch, then compile findings into a well-structured markdown document saved to ~/research/.
Workflow
- Clarify scope (if ambiguous): Confirm what aspects of the topic to focus on
- Search: Use WebSearch to find 4-6 relevant, authoritative sources
- Extract: Use WebFetch on the most promising sources to gather detailed information
- Synthesize: Compile findings into structured markdown
- Save: Write to
~/research/(create directory if needed) with auto-generated filename - Report: Always end by stating the exact file path created
Output Format
Save as ~/research/{topic-slug}-research.md.
# {Topic Title}
**Researched:** {YYYY-MM-DD}
## Summary
{3-5 bullet points of key findings}
## {Subtopic 1}
{Detailed findings with inline source references}
## {Subtopic 2}
{Continue for each major subtopic discovered}
## Sources
| Source | URL | Description |
|--------|-----|-------------|
| {Name} | {URL} | {What this source contributed} |
## Follow-up Questions
- {Suggested areas for deeper research}
- {Related topics worth exploring}
Guidelines
- Source quality: Prefer official documentation, reputable news, academic sources over blogs or forums
- Recency: Note when information may be outdated; prefer recent sources for fast-moving topics
- Attribution: Always link claims to specific sources
- Gaps: Explicitly note when authoritative information wasn't found on a subtopic
- Balanced depth: Cover breadth first, then depth on the most important subtopics
Completion
Always end with a clear statement of where the research was saved:
Research saved to: ~/research/example-topic-research.md
This ensures the file location is known for future reference.