SEO Blog Writing Claude Skill

The SEO Blog Writing Claude skill drafts a full blog post from a topic or brief for content marketers and founders. It picks a template, researches sources, writes the article and runs it through delivery checks before you see it. It is free and open source (MIT), part of the claude-blog plugin by Agrici Daniel.

SEO Advanced MIT license 2.6k GitHub stars
Install
Claude Code plugin
/plugin marketplace add AgriciDaniel/claude-blog
Claude Code plugin
/plugin install claude-blog@agricidaniel-blog
Skills CLI
npx skills add AgriciDaniel/claude-blog --skill blog-write
View on GitHub Checked

What the SEO Blog Writing skill does

Most AI writing prompts give you a draft and leave the checking to you. This skill treats the draft as the middle of the job. It decides which surfaces the post should win, picks one of 12 templates, researches current sources, and only then writes.

The writing rules favor evidence over padding. Statistics need a named source, unverifiable numbers get dropped, and every section states its point early so a search engine or an AI assistant can lift it. The skill warns against forcing quotas for images, charts or questions.

After the draft, a delivery sequence renders the post, runs a reviewer and applies gates. Failed gates trigger a repair loop, capped at three failed runs, so you get a diagnostic instead of a weak draft. It is heavy machinery, built for people who publish often.

  • Chooses from 12 templates such as how-to, listicle, comparison, case study and pillar page, and checks the evidence each needs
  • Researches current sources and records the publisher, date and link for each statistic used
  • Writes an answer-first article with a Key Takeaways box and clean heading hierarchy
  • Adds an optional FAQ only when real reader questions justify it
  • Builds inline SVG charts when the data has comparable metrics worth plotting
  • Sources a hero image from stock APIs, a generated SVG, or an AI image after a cost check
  • Outputs MDX, markdown or HTML, with frontmatter ready for your platform
  • Renders the post, runs a review pass and blocks delivery until the quality gates pass

How it works

  1. Pick target surfaces

    Decides whether the post aims at Google rankings, AI Overviews, AI assistant citations, or community echoes, which shapes structure and length.

  2. Select a template

    Matches the topic to one of 12 templates and refuses ones that need evidence you lack, like first-hand testing for a product review.

  3. Research and outline

    Finds current, credible sources, plans visuals and charts, and shows you an outline to approve before any writing starts.

  4. Write the article

    Drafts with frontmatter, a Key Takeaways box, answer-first sections, sourced claims, internal link markers and an optional FAQ.

  5. Resolve visuals

    Turns chart markers into inline SVG, replaces link markers with real links, and adds or generates a hero image.

  6. Render and gate

    Renders the post, runs a reviewer agent and delivery checks, repairs failures up to three times, then reports any fallbacks it used.

Example prompts

Once the SEO Blog Writing skill is installed, ask Claude in plain language. These prompts trigger it:

  • Write a blog post on how to run a LinkedIn outbound campaign for a B2B SaaS audience
  • Draft a comparison post: Instantly vs Smartlead for cold email, with the keyword best cold email tools
  • Write a how-to guide on setting up DMARC, aimed at marketing managers
  • Create a pillar page on account-based marketing
  • Write a listicle of the best SEO tools for agencies and show me the outline first

What you get

  • A finished article in MDX, markdown or HTML with complete frontmatter
  • A hero image and any inline SVG charts, saved in a draft folder
  • A rendered preview of the post as HTML and PDF
  • A completion summary that lists sources, gate results and any fallbacks

Who it is for

  • Content teams that publish regularly and want a consistent, checked process
  • Founders who write for search and want sourced, not padded, posts
  • Agencies producing blog content for several clients
  • Teams already using claude-blog who want its writing step

How to install the SEO Blog Writing skill

What you need: Claude Code with the claude-blog plugin. It runs Python scripts for rendering and checks, so you need Python and the plugin's requirements. Paid image generation is opt-in. The skill reads files from sibling folders in the same plugin.

  1. Claude Code plugin
    /plugin marketplace add AgriciDaniel/claude-blog
  2. Claude Code plugin
    /plugin install claude-blog@agricidaniel-blog
  3. Skills CLI
    npx skills add AgriciDaniel/claude-blog --skill blog-write
  4. Manual
    git clone https://github.com/AgriciDaniel/claude-blog.git && cd claude-blog && ./install.sh

After installing, restart Claude Code or start a new session. Claude loads the SEO Blog Writing skill automatically when your request matches it, or you can ask for it by name.

Tips for better results

  • Give a target audience and primary keyword up front. The skill asks for them anyway, and clear answers save a round.
  • Approve or edit the outline before writing starts. It is the cheapest point to change direction.
  • Add a project-root BRAND.md for voice and site URL so canonical links and tone are not guessed.

Limitations

  • It writes new posts only. Editing an existing post is a separate skill in the same plugin.
  • It needs the wider claude-blog install: templates and references live in sibling folders, so the Skills CLI single-folder install is incomplete.
  • Gate runs and rendering add time, and templates like case study or data research refuse to run without real evidence.

SEO Blog Writing Claude skill FAQ

Yes. It is open source under the MIT license, published by Agrici Daniel on GitHub. You can read, copy and modify it at no cost. Any paid data tools it can connect to are optional and billed separately by those vendors.

Run /plugin marketplace add AgriciDaniel/claude-blog, then /plugin install claude-blog@agricidaniel-blog. Install the Python requirements the README lists, then run /blog write with your topic. The standalone installer script is the alternative if you do not use plugins.

Claude Code is the safer choice. The rendering step, the review gates and file output need Python and a terminal, and the skill reads sibling reference folders. You can still zip the SKILL.md and upload it under Settings, Capabilities, Skills on a paid plan, but expect reduced results.

Claude can draft well-structured posts, but ranking depends on your site, competition and sources. This skill improves the odds by matching search intent, requiring sourced claims and running checks. It makes no ranking promise, and a human should review before publishing.

Yes. It targets Google rankings, AI Overviews and AI assistant citations together. Posts open sections with the point, use standalone answer passages and include sourced facts, which helps both classic search and AI tools pick out clear passages.