Verified Agent Skill record

SEO-blog-writer

Turn a single long-tail query into a publish-ready blog post optimized for search ranking and AI assistant citation. The skill runs a complete pipeline that classifies the topic, researches it against real sources, drafts clean HTML, scrubs LLM-tell vocabulary and typography, audits for AI-SEO elements including TL;DR blocks and query-phrased H2s with FAQ and JSON-LD schema, then publishes through a platform adapter for Ghost, WordPress, or static-site file output.

Tasks

Run the pipeline end-to-end from a single long-tail query to a publish-ready HTML post by executing the topic-to-publish workflow with all default platform-agnostic steps
Draft a post using a specific format template like troubleshooting or comparison and apply the corresponding length band and structured-spec labels to prepare the content for publishing

Inputs

A single long-tail topic provided as a required argument
Optional flags including --target to specify ghost, wordpress, or static output, --publish or --publish-at for publishing state, and --angle to narrow the topic angle
People Also Ask questions and search intent extracted from web search results

Outputs

A publish-ready bundle containing clean HTML restricted to an allowed tag list, a slug, metadata, JSON-LD schema blocks for FAQPage, BreadcrumbList, and HowTo, and feature-image alt text
Research artifact files stored in tmp/blog-drafts including research notes, interlink targets, draft HTML, schema HTML, metadata JSON, and refresh JSON
A self-contained HTML file and a metadata.json file written to a specified static-site directory when the default static target is used

Limitations and checks

The skill cannot invent a topic and requires one to be provided as an argument
If the honest answer to what makes the post worth writing beyond existing docs is nothing the skill aborts and informs the user rather than producing a doc paraphrase
Inbound link splicing into prior historical posts is not handled by this skill due to platform-specific constraints and must be run separately as a cron job against a platform API
Supported publish adapters out of the box are limited to Ghost Admin API, WordPress REST, and static-site file output with other CMS platforms requiring a custom adapter
Verify the opening TL;DR block is a single sentence of 8-40 words answering the query directly with specific nouns and is the first child of the body
Confirm every H2 heading either ends with a question mark or matches the allowlist of operational labels such as Install, Prerequisites, FAQ, or Summary
Ensure no ul or ol elements contain fewer than 3 items or more than 9 items without sub-grouping and that every li carries a data point ending with a period
Check that every outbound interlink URL recorded in the interlinks JSON appears at least once as an href in the final draft HTML