---
name: blog-post-writing
description: Write high-quality, SEO-optimized blog posts in multiple formats including how-to guides, listicles, opinion pieces, and case studies, with structured outlines, hooks, and calls-to-action.
license: MIT
metadata:
  author: awesome-ai-agent-skills
  version: 1.0.0
---

# Blog Post Writing

This skill enables an AI agent to write well-structured, engaging, and SEO-optimized blog posts across multiple content types — how-to guides, listicles, opinion pieces, case studies, and thought leadership articles. The agent handles the full lifecycle from topic research and outlining through drafting, SEO optimization, and final review, producing publish-ready content tailored to the target audience and brand voice.

## Workflow

1. **Research the Topic and Keywords**
   Investigate the topic to understand its scope, current discourse, and search intent. Identify a primary keyword and 3-5 secondary keywords to target. Analyze the top-ranking content for the primary keyword to understand what angle, depth, and format performs well. Determine whether the search intent is informational ("how to set up CI/CD"), navigational ("GitHub Actions docs"), or transactional ("best CI/CD tools 2025").

2. **Choose the Content Format**
   Select the blog post format that best matches the topic and search intent. Use a **how-to guide** for process-oriented queries. Use a **listicle** for comparison or round-up queries. Use an **opinion piece** for thought leadership and brand positioning. Use a **case study** for showcasing results and building credibility. The format determines the structural template for the outline.

3. **Build the Outline**
   Create a detailed outline with the title (including the primary keyword), a hook for the introduction, H2 and H3 subheadings for the body, and a conclusion with a call-to-action. Ensure headings are descriptive and incorporate secondary keywords naturally. Plan where to place supporting elements — code blocks, images, blockquotes, statistics, and internal/external links.

4. **Write the Draft**
   Expand the outline into full prose. Open with a hook that creates curiosity, states a surprising fact, or directly addresses the reader's pain point. Follow with a clear thesis sentence that tells the reader what they will gain from the post. Write body sections in a logical progression, using transitions between sections. Close with a summary of key takeaways and a specific CTA — subscribe, download, try the product, or read a related post.

5. **Optimize for SEO**
   Place the primary keyword in the title, first paragraph, at least one H2, and the meta description. Use secondary keywords in subheadings and body text where they fit naturally — never force them. Write a meta description (150-160 characters) that summarizes the post and includes the primary keyword. Add alt text descriptions for any images. Ensure the URL slug is short and keyword-rich.

6. **Review and Polish**
   Proofread for grammar, spelling, and punctuation. Verify all statistics and claims have credible sources. Check that all links work and point to the correct destinations. Read the post aloud (or simulate doing so) to catch awkward phrasing. Ensure the post meets the target word count and that no section feels thin or padded.

## Usage

Provide the agent with:

- **Topic** — the subject or working title for the blog post
- **Target keyword** — the primary SEO keyword (optional; agent can research)
- **Content format** — how-to, listicle, opinion, case study, or let the agent recommend
- **Audience** — who will read this (developers, marketers, executives, general public)
- **Tone** — professional, casual, conversational, authoritative, witty
- **Word count** — target length (e.g., 800, 1500, 2500 words)
- **CTA** — what action readers should take after reading

Example prompt: "Write a 1,500-word how-to blog post about setting up a CI/CD pipeline with GitHub Actions. Target keyword: 'GitHub Actions CI/CD tutorial.' Audience: junior developers. Tone: friendly and encouraging."

## Examples

### Example 1: Complete Blog Post Outline with Filled-In Sections

**Input:** "Write an outline for a listicle: '7 VS Code Extensions Every Python Developer Needs in 2025.' Audience: intermediate Python developers. Fill in the intro and one list item as examples."

**Output:**

> **Title:** 7 VS Code Extensions Every Python Developer Needs in 2025
>
> **Meta description:** Boost your Python workflow with these 7 essential VS Code extensions for linting, testing, debugging, and more. Updated for 2025.
>
> **Target keyword:** VS Code extensions Python
>
> ---
>
> **Introduction (filled in):**
>
> Visual Studio Code became the most popular code editor among Python developers for good reason — it is fast, free, and infinitely customizable. But a stock VS Code install only scratches the surface. The right extensions can turn it into a full-featured Python IDE with intelligent autocomplete, real-time linting, one-click debugging, and seamless virtual environment management. Here are seven extensions that will save you real time every single day in 2025.
>
> **1. Pylance — Supercharged IntelliSense (filled in):**
>
> Pylance replaces the default Python language server with a blazing-fast type checker and autocomplete engine built on Pyright. It catches type errors before you run your code, surfaces inline documentation as you type, and handles complex type annotations that the default extension misses entirely. If you write any amount of typed Python — and you should — Pylance is non-negotiable. Install it once and you will wonder how you ever coded without it.
>
> **2. Ruff — Lightning-Fast Linting and Formatting** [to be filled]
>
> **3. Python Test Explorer — Visual Test Runner** [to be filled]
>
> **4. GitLens — Git History in Your Editor** [to be filled]
>
> **5. Docker — Container Management** [to be filled]
>
> **6. Jupyter — Interactive Notebooks Inside VS Code** [to be filled]
>
> **7. autoDocstring — One-Click Docstrings** [to be filled]
>
> **Conclusion:** Recap the extensions, emphasize that a well-configured editor is a productivity multiplier, and CTA: "Share your favorite Python extension in the comments."

### Example 2: Writing an Intro Paragraph with a Hook

**Input:** "Write an intro paragraph for a blog post titled 'Why Your Startup Should Adopt Infrastructure as Code on Day One.' Audience: non-technical startup founders. Hook style: surprising statistic."

**Output:**

> Sixty-eight percent of startups that experience a major infrastructure outage in their first year never fully recover the lost customers. That is not a scare tactic — it is a finding from a 2024 Datadog reliability survey. The irony is that most of these outages trace back to manual server configuration: someone fat-fingered a setting, forgot to open a port, or could not reproduce the production environment when it mattered most. Infrastructure as Code (IaC) eliminates this entire category of risk by treating your servers, networks, and deployments as version-controlled code — code that can be reviewed, tested, and rolled back just like the software it runs. You do not need a dedicated DevOps team to get started, and the earlier you adopt it, the less technical debt you accumulate. In this post, we will break down what IaC actually is, why it matters even at the five-person stage, and how to set it up in a single afternoon.

## Best Practices

- **Start with the hook, not the backstory.** Readers decide in the first two sentences whether to keep reading. Open with a surprising fact, a provocative question, or a direct statement of the reader's problem. Save the context for the second paragraph.
- **Use descriptive, keyword-rich headings.** "Step 3: Configure the Database Connection" is better than "Step 3: Configuration." Headings should be useful on their own when someone skims.
- **Break up long sections.** No paragraph should exceed 4-5 sentences in a blog post. Use subheadings, bullet points, code blocks, and pull quotes to create visual rhythm and let readers scan.
- **Link internally and externally.** Internal links keep readers on your site and improve SEO. External links to credible sources build trust. Aim for 2-3 internal links and 1-2 external links per 1,000 words.
- **End with a clear CTA.** Every blog post should ask the reader to do something: subscribe, try the product, leave a comment, read the next post. A post without a CTA is a missed opportunity.
- **Write for the featured snippet.** Structure one section as a concise, direct answer to the primary keyword query. Use a definition paragraph, a numbered list, or a table that Google can pull into a featured snippet.

## Edge Cases

- **Topics with no search volume:** For thought leadership or opinion pieces targeting niche audiences, SEO optimization is secondary to originality and depth. Focus on unique insights rather than keyword density.
- **Highly competitive keywords:** When the top results are all from high-authority domains, target a long-tail variant of the keyword (e.g., "GitHub Actions CI/CD tutorial for monorepos" instead of "CI/CD tutorial") to find a rankable niche.
- **Time-sensitive content:** Posts referencing specific tool versions, pricing, or events should include a "Last updated" date and a note that details may have changed. Plan for periodic content refreshes.
- **Multi-author blogs:** When writing for a blog with an established voice, review 2-3 recent published posts to match the existing tone, sentence style, and formatting conventions.
- **Very long posts (3,000+ words):** Include a table of contents with anchor links at the top. Consider whether the post should be split into a series for better readability and sustained engagement.