Blog Post Writing

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."