# blog-writer

- type: skill
- industry: software-engineering
- roles: general
- source: https://github.com/google/adk-recipes/blob/main/contrib/python/agent-skills-tutorial/app/skills/blog-writer/SKILL.md
- license: Apache-2.0 (mirror-with-attribution)
- install: npx skills add google/adk-recipes --skill blog-writer
- needs_credentials: false
- writes_external: false
- updated_at: 2026-10-15T10:15:30Z

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.

---

Mirrored from https://github.com/google/adk-recipes/blob/main/contrib/python/agent-skills-tutorial/app/skills/blog-writer/SKILL.md under Apache-2.0. The original is authoritative.

---
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:
1. Start with a clear subheading (H2)
2. Lead with the key point, then support it
3. Include code examples where relevant (use fenced code blocks with language tags)
4. Keep paragraphs to 2-3 sentences
5. 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
