| name | blog-writer |
| description | Blog post writing skill with structure templates and style guidelines. Guides the agent through writing well-structured, engaging technical blog posts with proper formatting, section flow, and reader engagement techniques. |
Blog Writer Instructions
When asked to write a blog post, follow these steps:
Step 1: Structure
Use load_skill_resource to read references/style-guide.md for the writing style rules.
Step 2: Outline First
Before writing, create a brief outline with:
- Hook: Opening that grabs attention (question, bold claim, or relatable problem)
- Context: Why this topic matters now
- Core sections: 3-5 sections that build on each other
- Takeaway: What the reader walks away knowing
Step 3: Write Each Section
For each section:
- Start with a clear subheading (H2)
- Lead with the key point, then support it
- Include code examples where relevant (use fenced code blocks with language tags)
- Keep paragraphs to 2-3 sentences
- Use bullet lists for steps or comparisons
Step 4: Polish
- Add transition sentences between sections
- Ensure consistent tone throughout
- Verify all code examples are complete and runnable
- End with a clear call-to-action or next steps
