Documentation Seeker

Intelligent documentation discovery and research for technical implementation.

When to Use

This skill auto-activates when:

User asks: "find documentation", "API docs", "how to use", "integration guide"
Running /ccpm:plan (needs library docs)
Running /ccpm:plan (technical research phase)
Implementing features requiring framework knowledge
Researching best practices or design patterns

What It Does

Documentation Discovery

Finds relevant documentation for:

Libraries and frameworks (React, Next.js, Express, etc.)
APIs and SDKs (Stripe, AWS, Google Cloud, etc.)
Design patterns and best practices
Integration guides
Technical specifications

Search strategies:

Official documentation first
Framework-specific guides
API references
Community resources (if official docs insufficient)
Code examples and tutorials

Integration with Context7 MCP

Works seamlessly with Context7 to fetch latest documentation:

User: "Find React 19 documentation for Server Components"

Claude: [docs-seeker activates]

Searching for React 19 Server Components documentation...

Using Context7 to fetch latest docs:
1. Official React docs (react.dev)
2. Server Components RFC
3. Next.js App Router integration guide

Found:
- React 19 Server Components: https://react.dev/reference/rsc/server-components
- Key features: Async components, data fetching, streaming
- Best practices: Use for data-heavy components, avoid client-side state
- Integration: Works with Next.js 15 App Router

Summary available for /ccpm:plan architecture section.

Integration with CCPM

Planning Phase Research

Use with /ccpm:plan:

When planning a task, docs-seeker helps gather technical context:

User: "/ccpm:plan AUTH-123 JIRA-456"

Claude: [docs-seeker activates during research phase]

Researching technical requirements for AUTH-123...

Finding relevant documentation:
1. JWT authentication best practices
2. OAuth 2.0 specification
3. Passport.js integration guide
4. Express.js security middleware

Key findings:
- JWT: Use RS256 for production (not HS256)
- Refresh tokens: Store in httpOnly cookies
- OAuth: Implement PKCE flow for SPAs
- Rate limiting: 5 login attempts per 15 minutes

Documentation links saved to Linear task for implementation reference.

Spec Writing Research

Use with /ccpm:plan:

When writing specs, docs-seeker finds authoritative sources:

User: "/ccpm:plan DOC-789 api-design"

Claude: [docs-seeker activates]

Researching API design best practices...

Finding documentation:
1. RESTful API design guide (Microsoft)
2. GraphQL schema design (Apollo)
3. OpenAPI 3.1 specification
4. API versioning strategies

Recommendations based on docs:
- Endpoints: Use nouns, not verbs (/users not /getUsers)
- Versioning: URL path (/v1/) or Accept header
- Pagination: Cursor-based for scalability
- Error handling: RFC 7807 Problem Details
- Documentation: OpenAPI spec + Swagger UI

Writing API design section with these guidelines...

Implementation Guidance

During feature implementation:

User: "How do I implement file uploads with NextJS 15?"

Claude: [docs-seeker activates]

Searching Next.js 15 file upload documentation...

Found official guides:
1. Next.js App Router: Route Handlers
2. FormData API usage
3. File upload best practices
4. Streaming uploads for large files

Implementation approach:
```typescript
// app/api/upload/route.ts
export async function POST(request: Request) {
  const formData = await request.formData();
  const file = formData.get('file') as File;

  // Process file
  const bytes = await file.arrayBuffer();
  const buffer = Buffer.from(bytes);

  // Save to storage
  await saveFile(buffer, file.name);

  return Response.json({ success: true });
}

Documentation: https://nextjs.org/docs/app/building-your-application/routing/route-handlers

Would you like me to add this to the implementation plan?


## Documentation Sources

### Official Sources (Highest Priority)

**Always check official docs first**:
- Framework documentation (React, Next.js, Vue, Angular)
- Library docs (Lodash, Axios, Moment.js)
- Cloud provider docs (AWS, GCP, Azure)
- API specifications (Stripe, Twilio, SendGrid)

### Technical Specifications

**For standards and protocols**:
- W3C specifications
- IETF RFCs
- ECMA standards
- OpenAPI/Swagger specs

### Community Resources

**When official docs are insufficient**:
- MDN Web Docs (JavaScript, CSS, HTML)
- Stack Overflow discussions
- GitHub repositories and READMEs
- Technical blogs (reputable sources only)

## Search Strategies

### Strategy 1: Version-Specific Search

Always search for the specific version in use:

❌ Generic: "React hooks documentation" ✅ Specific: "React 19 hooks documentation"

❌ Generic: "Node.js async/await" ✅ Specific: "Node.js 20 async/await best practices"


### Strategy 2: Context-Aware Search

Include the context of what you're building:

❌ Vague: "authentication docs" ✅ Context: "JWT authentication with Express.js and Passport"

❌ Vague: "database queries" ✅ Context: "PostgreSQL complex joins with Prisma ORM"


### Strategy 3: Progressive Discovery

Start broad, then narrow down:

1. **Overview**: "What is Server Components in React?"
2. **API Reference**: "Server Component API methods"
3. **Integration**: "Server Components with Next.js App Router"
4. **Best Practices**: "Server Components performance optimization"

## Examples

### Example 1: Research for Spec Writing

User: "/ccpm:plan DOC-456 architecture"

Claude: [docs-seeker activates]

Researching architecture patterns for payment processing...

Finding documentation:

Stripe API documentation
- Payment Intents API
- Webhook handling
- Idempotency keys
PCI compliance requirements
- Never store full card numbers
- Use tokenization
- Secure data transmission
Architecture patterns
- Adapter pattern for multiple providers
- Event-driven webhooks
- Retry mechanisms with exponential backoff
Error handling
- Stripe error types
- Declined payments flow
- Network timeout handling

Documentation summary:

Use Payment Intents (not legacy Charges API)
Implement webhook signature verification
Store payment status in database
Handle idempotency for retries
Support multiple payment providers via adapters

Writing architecture section with these patterns...


### Example 2: Quick Implementation Help

User: "How do I use React useEffect with async functions?"

Claude: [docs-seeker activates]

Searching React useEffect async documentation...

Found: React 19 documentation on useEffect

Official recommendation:

javascript

// ✅ Correct approach
useEffect(() => {
  async function fetchData() {
    const response = await fetch('/api/data');
    const data = await response.json();
    setData(data);
  }
  fetchData();
}, []);

// ❌ Wrong - useEffect cannot be async directly
useEffect(async () => {
  // This won't work!
}, []);

Key points from docs:

useEffect callback cannot be async
Create async function inside useEffect
Handle cleanup with AbortController
Avoid race conditions with cleanup

Documentation: https://react.dev/reference/react/useEffect#fetching-data-with-effects

Would you like me to show the full pattern with cleanup?


### Example 3: API Integration Research

User: "Find Stripe webhook documentation"

Claude: [docs-seeker activates]

Searching Stripe webhook documentation...

Found official Stripe docs:

Webhook Events
- payment_intent.succeeded
- payment_intent.payment_failed
- customer.subscription.updated
- Full event reference: https://stripe.com/docs/api/events/types

Webhook Security

Signature verification required
Use Stripe-Signature header
Verify with webhook secret
Code example:

javascript

const sig = request.headers['stripe-signature'];
const event = stripe.webhooks.constructEvent(
  request.body,
  sig,
  process.env.STRIPE_WEBHOOK_SECRET
);

Best Practices
- Return 200 immediately
- Process events asynchronously
- Handle duplicate events (idempotency)
- Log all webhook events
- Monitor webhook failures in Stripe dashboard
Testing
- Use Stripe CLI for local testing
- Test with Stripe's test events
- Verify all event types your app handles

Documentation: https://stripe.com/docs/webhooks

This should be added to the implementation plan under "Webhook Handler" section.


## Integration with CCPM Workflows

### Workflow 1: Spec Writing

User runs: /ccpm:plan DOC-123 architecture
docs-seeker activates automatically
Finds relevant documentation
Summarizes key patterns and best practices
Claude writes spec section using authoritative sources
Documentation links added to spec for reference


### Workflow 2: Planning Phase

User runs: /ccpm:plan TASK-456
Task description: "Implement real-time notifications"
docs-seeker activates for research
Finds WebSocket, Server-Sent Events, and polling docs
Compares approaches based on documentation
Recommends approach with rationale
Plan includes documentation links


### Workflow 3: Implementation Support

Developer starts implementing feature
Asks: "How do I handle file uploads?"
docs-seeker finds Next.js/Express/Multer docs
Provides implementation example from docs
Highlights important caveats (file size limits, validation)
Links to official documentation


## Works With Context7 MCP

**Context7 integration provides**:
- Latest documentation (always up-to-date)
- Version-specific information
- Framework changelog and migration guides
- API reference with examples

**Example Context7 usage**:

docs-seeker: "Find Next.js 15 App Router documentation" ↓ Context7 MCP: Fetches latest from nextjs.org ↓ Returns: App Router architecture, routing, data fetching, caching ↓ docs-seeker: Summarizes key points relevant to task


## Tips for Better Results

### Be Specific

**Good requests**:
- "Find Prisma migration documentation for PostgreSQL"
- "Get Tailwind CSS v4 documentation for dark mode"
- "Show GraphQL schema stitching with Apollo Federation"

**Vague requests** (harder to help):
- "Find docs"
- "How does this work?"
- "Give me information about React"

### Include Version Information

Always mention versions when known:
- "Next.js 15" not just "Next.js"
- "React 19" not just "React"
- "Node.js 20 LTS" not just "Node.js"

### Specify Your Stack

Help docs-seeker find the right integration docs:
- "React with TypeScript"
- "Express.js with Prisma ORM"
- "Next.js with Auth.js (NextAuth v5)"

## Common Use Cases

### Use Case 1: Starting New Feature

Before implementation:

Ask docs-seeker for library documentation
Review API reference
Check best practices
See code examples
Then start coding with solid foundation


### Use Case 2: Troubleshooting

When stuck:

Ask docs-seeker for specific API documentation
Check if using correct method/approach
Review error handling documentation
Find related examples
Apply documented solution


### Use Case 3: Architecture Decisions

When designing:

Ask docs-seeker for pattern documentation
Compare multiple approaches
Review trade-offs from official sources
Choose approach backed by documentation
Document decision with references


## Integration with Other Skills

**Works alongside**:

- **sequential-thinking**: Use docs-seeker to research each step
- **pm-workflow-guide**: Suggests when documentation research needed
- **ccpm-debugging**: Find debugging guides when issues arise
- **Context7 MCP**: Fetches actual documentation content

**Example combined activation**:

User: "Break down this complex GraphQL federation task" ↓ sequential-thinking: Structure the problem breakdown ↓ docs-seeker: Find Apollo Federation documentation ↓ Together: Create informed, well-researched plan


## Summary

This skill provides:

- ✅ Intelligent documentation discovery
- ✅ Version-specific search results
- ✅ Integration with Context7 MCP
- ✅ Support for CCPM planning and spec writing
- ✅ Implementation guidance from authoritative sources

**Philosophy**: Research first, implement with confidence. Use authoritative sources, always check official documentation, and stay current with latest versions.

---

**Source**: From [claudekit-skills/docs-seeker](https://github.com/mrgoonie/claudekit-skills)
**License**: MIT
**CCPM Integration**: `/ccpm:plan`, `/ccpm:plan`, Context7 MCP

Search AI Tools

docs-seeker

Install this agent skill to your Project

SKILL.md

Documentation Seeker

When to Use

What It Does

Documentation Discovery

Integration with Context7 MCP

Integration with CCPM

Planning Phase Research

Spec Writing Research

Implementation Guidance