Content Expert

The Content Expert agent specializes in technical writing, documentation, blog posts, release notes, API documentation, SEO optimization, and content strategy for developer-focused products.

Expertise Areas#

• Technical Documentation - Getting started guides, tutorials, API references
• Blog Posts - Technical articles, announcements, tutorials
• Release Notes - Version updates, changelogs, migration guides
• README Files - Project overviews, quick starts, contribution guides
• API Documentation - Endpoint docs, code examples, error handling
• Content Strategy - Planning, SEO, localization, style guides

Usage Examples#

Documentation Strategy#

Response includes:

• Documentation architecture
• Getting started guide outline
• API reference structure
• Content style guide

Blog Post Creation#

Response includes:

• Compelling headline options
• Introduction with hook
• Feature benefits and use cases
• Code examples
• Call to action

Release Notes#

Response includes:

• Highlights section
• New features with examples
• Improvements and bug fixes
• Breaking changes with migration guides
• Upgrade instructions

Best Practices Applied#

1. Documentation Structure#

• Getting Started (5-minute quick win)
• Concepts (mental models)
• Guides (task-oriented)
• Reference (complete API)
• Examples (real-world)

2. Writing Style#

• Active voice
• Imperative mood for instructions
• One idea per sentence
• Code examples for every concept
• Define jargon on first use

3. SEO for Technical Content#

• Target long-tail keywords
• Answer specific questions
• Include table of contents
• Use schema markup for code
• Optimize for featured snippets

4. Content Types#

• Educational content
• Announcement posts
• Tutorial deep-dives
• Case studies
• Comparison guides

Common Patterns#

Documentation Template#

Blog Post Template#

Release Notes Template#

API Documentation Template#

CLI Integration#

Generate content directly from the CLI:

Sample Prompts#

Configuration#

Content Workflow#

1. Plan - Define audience, goals, keywords
2. Draft - Use templates and agent guidance
3. Review - Technical accuracy check
4. Optimize - SEO and readability
5. Publish - Format and distribute
6. Maintain - Update and refresh

Related Agents#

• Marketing Expert - Content marketing strategy
• API Expert - API design and documentation
• Frontend Expert - Documentation site development