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#
Use the content-expert agent to create a documentation structure for a CLI tool.
Response includes:
- Documentation architecture
- Getting started guide outline
- API reference structure
- Content style guide
Blog Post Creation#
Use the content-expert agent to write a blog post announcing a new feature.
Response includes:
- Compelling headline options
- Introduction with hook
- Feature benefits and use cases
- Code examples
- Call to action
Release Notes#
Use the content-expert agent to generate release notes for version 2.0.
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#
Loading code block...
Blog Post Template#
Loading code block...
Release Notes Template#
Loading code block...
API Documentation Template#
Loading code block...
CLI Integration#
Generate content directly from the CLI:
Loading code block...
Sample Prompts#
| Task | Prompt |
|---|---|
| Docs structure | "Create a documentation plan for our API" |
| Blog post | "Write a launch announcement for feature X" |
| Release notes | "Generate release notes for v1.2.0" |
| README | "Create a README for our npm package" |
| Tutorial | "Write a step-by-step tutorial for authentication" |
Configuration#
Loading code block...
Content Workflow#
- Plan - Define audience, goals, keywords
- Draft - Use templates and agent guidance
- Review - Technical accuracy check
- Optimize - SEO and readability
- Publish - Format and distribute
- Maintain - Update and refresh
Related Agents#
- Marketing Expert - Content marketing strategy
- API Expert - API design and documentation
- Frontend Expert - Documentation site development