| name | writing-blog-posts |
| description | Creates blog posts for company and product blogs. Use when writing thought leadership, tutorials, announcements, or educational content for publication on a blog. |
Writing blog posts
Quick start
Collect or infer:
- Post type (thought leadership, tutorial, announcement, listicle, opinion)
- Target audience
- Primary keyword or topic
- Key takeaway or goal
- Desired length (short: 500-800, standard: 1000-1500, long: 2000+)
- Internal linking opportunities
Then produce output using TEMPLATES.md. Validate with RUBRIC.md.
Workflow
- Identify post type and match structure from reference/blog-structure.md.
- Research keyword and competitive posts for angle.
- Write headline using proven patterns (and 2-3 variants).
- Draft introduction with hook, context, and promise.
- Structure body with scannable headers.
- Write conclusion with key takeaway and CTA.
- Add internal and external links per reference/linking-policy.md.
- Run readability check with scripts/readability_score.py.
- Run the rubric check. Revise until it passes.
Degrees of freedom
- Low: Must have scannable structure, clear takeaway, and CTA.
- Medium: Tone, headline style, section ordering, example depth.
- Allowed variation: Voice, opening style, listicle vs. narrative—as long as rubric passes.
References