Create high-quality, SEO-optimized content that ranks AND reads like a human wrote it. Performs live SERP gap analysis, writes with anti-AI detection techniques, and adds schema markup. Use when someone needs a blog post, article, SEO page, or wants content that drives search traffic. Triggers on 'SEO content', 'blog post', 'article', 'SERP', 'programmatic SEO', 'content at scale', 'template pages at scale', 'write a post about', 'rank for', or 'search-optimized content'. Two modes: single article or programmatic SEO at scale. Owns programmatic SEO and content-at-scale generation. For a single alternatives or vs/comparison page, see /competitor-alternatives; for a multi-phase page roadmap with a persistent tracker, see /seo-machine.
Create high-quality, SEO-optimized content that ranks AND reads like a human wrote it. Performs live SERP gap analysis, writes with anti-AI detection techniques, and adds schema markup. Use when someone needs a blog post, article, SEO page, or wants content that drives search traffic. Triggers on 'SEO content', 'blog post', 'article', 'SERP', 'programmatic SEO', 'content at scale', 'template pages at scale', 'write a post about', 'rank for', or 'search-optimized content'. Two modes: single article or programmatic SEO at scale. Owns programmatic SEO and content-at-scale generation. For a single alternatives or vs/comparison page, see /competitor-alternatives; for a multi-phase page roadmap with a persistent tracker, see /seo-machine.
["blog post","SEO article","long-form content","rankable content","programmatic SEO","pages at scale","write SEO content for X","create article for keyword","refresh article","update blog post"]
/seo-content -- Publication-Ready SEO Content
SEO content has a reputation problem. Most of it is low-value -- keyword-stuffed,
AI-sounding, says nothing new. It ranks for a month, then dies.
This skill creates content that ranks AND builds trust. Content that sounds like
an expert sharing what they know, not a content mill churning out filler.
The goal: Would someone bookmark this? Would they share it? Would they come back?
If yes, Google will reward it. If no, no amount of optimization saves it.
If files missing, note suggestions at the end (e.g., run /brand-voice).
Check for existing content file at ./campaigns/content/{keyword-slug}.md.
If exists --> Content Refresh Mode (see below).
If not --> Full Creation Mode.
Determine mode: Single article or Scale mode (programmatic SEO).
Read brand/landscape.md if it exists — check the Claims Blacklist before making ecosystem or competitive claims. If stale (>14 days) or missing, warn that market claims may be outdated.
Prioritization (defer to seo-machine's publishing order)
When the user asks "what should I write next?" — the answer follows seo-machine's conversion-intent-first publishing order, not "whatever has highest volume":
Order
Pattern
Why
1
/alternatives/[competitor]
Highest conversion intent — reader is already in market
2
/compare/[a]-vs-[b]
Be the third option in any two-vendor comparison
3
/for/[use-case] and /for/[audience]
JTBD without competitor name — high TP/volume ratio
4
Long-form playbooks (this skill's wheelhouse)
Authority + AI-citation + inbound link draw
5
Generic blog posts
Lowest conversion — defer until ~10 indexed pages exist
If docs/seo-machine.md exists at the project root, route the user to that skill's Resume mode instead of writing standalone articles — the roadmap there already encodes the priority order. seo-content is the right tool for single articles and playbook-pattern long-form; alternatives/compare/use-case pages belong in seo-machine's programmatic sprint.
Brand Memory
Reads (if they exist)
File
What it provides
How it shapes output
voice-profile.md
Tone, personality, vocabulary, rhythm
Directly shapes writing style
keyword-plan.md
Prioritized keywords, content briefs, SERP data
Target keyword, cluster, intent, content type
audience.md
Buyer profiles, sophistication level, pain points
How technical to write, what examples to use
positioning.md
Market angles, differentiators
Unique angle for the piece
competitors.md
Named competitors, their positioning
What angle competitors take
learnings.md
Past performance data
What content approaches worked before
Writes
File
What it contains
./campaigns/content/{keyword-slug}.md
Publication-ready article with frontmatter
./brand/assets.md
Appends entry for the created content piece
./brand/learnings.md
Appends findings after feedback collection
Required Inputs
Target keyword -- Primary keyword to rank for
Keyword cluster -- Related keywords to include naturally
/content-atomizer -- distribute across social (3-5 LinkedIn, 8-12 Twitter, 2-3 IG carousels)
/newsletter -- feature article in next edition
/email-sequences -- nurture readers into subscribers
/seo-content -- write next article from keyword plan
"Refresh" to update this article later
Error States
No web search: Skip Phase 1, note limitation, proceed with brand context
No target keyword: Ask user or suggest /keyword-research
No voice profile: Use defaults (direct, conversational), suggest /brand-voice
Can't save: Display content for manual copy, suggest checking permissions
Anti-Patterns
Anti-pattern
Instead
Why
Skipping Phase 5 (Humanize) to save time
Cut research depth before cutting humanization
Unhumanized content reads like AI slop — readers bounce, Google devalues it, and the brand takes a credibility hit. Content that sounds like a committee wrote it doesn't earn trust, links, or shares.
Skipping schema markup
Always add Article + FAQ JSON-LD — it takes minutes
Schema compounds over time: rich results, AI citations, and structured search features for the life of the content. Skipping it leaves free visibility on the table.
Keyword-stuffing headings
One keyword in H1, natural secondary keywords in H2s
Google detects keyword stuffing and users find it off-putting. If every heading reads like an SEO template, it's over-optimized.
Starting with a generic intro
Answer the search query in sentence one
"In today's digital world..." tells the reader nothing. The search query brought them here — if the value prop isn't instant, they bounce.
Implementation Notes
Never skip SERP analysis when web search is available -- it's the differentiator
Always check for existing content first -- refresh mode is high value
