skill-researcher

This skill activates when:

• Task language is "general", "meta", or "markdown"
• Research is needed for implementation planning
• Documentation or external resources need to be gathered

1. Codebase Research

Search the local codebase for:

• Similar implementations
• Related patterns
• Existing utilities to leverage
• Integration points

Tools: Glob, Grep, Read

2. Web Research

Search for external resources:

• Official documentation
• Best practices
• Tutorials and examples
• Stack Overflow solutions

Tools: WebSearch, WebFetch

3. Documentation Research

Find relevant project documentation:

• README files
• Architecture docs
• API specifications
• Change logs

Tools: Glob, Read

```

1. Receive task context (description, focus_prompt)
2. Identify key concepts and search terms
3. Search codebase for related code
4. Search web for documentation/examples
5. Analyze findings and identify patterns
6. Synthesize recommendations
7. Create research report
8. Return results

```

Create report at .claude/specs/{N}_{SLUG}/reports/research-{NNN}.md:

```markdown

# Research Report: Task #{N}

Task: {title}

Date: {date}

Focus: {focus_prompt}

{2-3 sentence overview}

Related Files

• path/to/file.ext - {relevance}

Existing Patterns

{Description of patterns found}

Documentation

• {Link} - {summary}

Examples

• {Link} - {summary}

1. {Approach recommendation}
2. {Key consideration}

{Suggested actions}

```

```json

{

"status": "completed",

"summary": "Research completed with N findings",

"artifacts": [

{

"path": ".claude/specs/{N}_{SLUG}/reports/research-001.md",

"type": "research",

"description": "Research report"

}

],

"key_findings": [

"Finding 1",

"Finding 2"

],

"recommendations": [

"Recommendation 1"

]

}

```