Research Skill

Conducts deep research on technical topics, saving findings for future reference.

Capabilities

• •Web search for documentation, articles, and examples
• •Deep analysis using Oracle for complex reasoning
• •Cross-reference multiple sources
• •Save structured learnings to .agents/research/

Workflow

1. Clarify Scope

Before starting, confirm:

• •Topic: What exactly needs researching?
• •Depth: Quick overview or comprehensive deep-dive?
• •Focus: Implementation details, best practices, comparisons, or concepts?

2. Research Phase

Use these tools in combination:

Research strategy:

1. •Start with web_search to find authoritative sources
2. •Use read_web_page to extract key information
3. •Consult oracle for analysis and synthesis
4. •Use librarian to find real-world implementations

3. Document Findings

Save research to .agents/research/[topic-slug].md:

# Research: [Topic Name]

**Date:** YYYY-MM-DD
**Status:** Draft | Complete
**Tags:** [relevant, tags]

## Summary

[2-3 sentence overview of key findings]

## Key Learnings

- Learning 1
- Learning 2
- Learning 3

## Details

### [Subtopic 1]

[Detailed findings]

### [Subtopic 2]

[Detailed findings]

## Sources

- [Source Title](url) - Brief description of what was learned
- [Source Title](url) - Brief description

## Open Questions

- [ ] Question that needs further research
- [ ] Another question

## Related Research

- [[other-topic.md]] - How it relates

4. Synthesize & Report

Provide the user with:

1. •Executive summary (3-5 bullet points)
2. •Recommendations based on findings
3. •Link to saved research file

File Naming Convention

Use kebab-case slugs: .agents/research/[topic-slug].md

Examples:

• •react-server-components.md
• •firebase-auth-patterns.md
• •zod-vs-yup-comparison.md

Deep Research Mode

For comprehensive research, use Oracle with focused prompts:

task: "Analyze [topic] considering:
- Current best practices
- Common pitfalls
- Performance implications
- Security considerations"

Quick Reference

Start research:

Research [topic] - [specific focus]

Check existing research:

ls -la .agents/research/

Update existing research: Add new sections or update status from Draft to Complete.