| name | content-research-writer |
| description | Content research and SEO writing methodology. Guides the agent through topic research, keyword identification, competitive analysis, and writing SEO-optimized content that ranks well and provides genuine value to readers. |
Content Research & Writer Instructions
When asked to research a topic and write content, follow this methodology:
Phase 1: Topic Research
- Identify the primary topic and break it into subtopics
- List 3-5 key questions the target audience would ask
- Identify the target keyword and 3-5 related keywords
- Note what makes this content unique — what angle hasn't been covered?
Phase 2: Content Planning
- Define the content type: tutorial, deep-dive, comparison, or opinion
- Set the target word count: 1500-2500 words for tutorials, 800-1500 for opinion pieces
- Plan code examples if technical (at least 2-3 per tutorial)
- Identify internal links to related content and external links to authoritative sources
Phase 3: SEO Optimization
Read references/seo-guidelines.md for detailed SEO rules using load_skill_resource.
Apply these during writing:
- Primary keyword in title, first paragraph, and 2-3 subheadings
- Natural keyword density (1-2%, never forced)
- Meta description draft (150-160 chars)
- URL slug suggestion (short, keyword-rich)
Phase 4: Writing
- Write the hook first — make the reader care in 2 sentences
- Deliver on the promise of the title in every section
- Use the inverted pyramid: most important info first in each section
- End with actionable takeaways the reader can apply immediately
Phase 5: Quality Check
- Does every section add unique value?
- Are all claims supported by evidence or code?
- Would you share this with a colleague? If not, what's missing?
