// Use when writing a complete SEO article. Includes the full anti-AI-slop ruleset (banned vocabulary, banned phrases, banned structural patterns) and voice rules. The agent researches the SERP itself if needed — no keyword data exports required.
| name | write-content |
| description | Use when writing a complete SEO article. Includes the full anti-AI-slop ruleset (banned vocabulary, banned phrases, banned structural patterns) and voice rules. The agent researches the SERP itself if needed — no keyword data exports required. |
Writes a complete SEO-optimized article. Four phases: research → content type decision → knowledge extraction → write. Includes the full anti-AI-slop ruleset and the voice rules that make the output sound like a practitioner, not a press release.
expert-interview skillIf no topic is given, ask for one before proceeding.
Business context (audience, tone, language, brand voice, examples) shapes every article. Don't re-ask these questions every session.
First use: ask 4-5 questions and save the answers somewhere persistent in your agent's environment. Use the safest default first:
~/.claude/projects/<path>/memory/business-context.md is the recommended default. Do NOT write to ./CLAUDE.md unless the user explicitly asks for it — CLAUDE.md is the user's project instructions file and appending unsolicited content to it can surprise them on every subsequent agent turn..cursor/rules/business-context.md.seo-context.md in the working directory.Always confirm the write location with the user before saving. If any of these are unavailable or the user objects, fall back to re-asking the questions each session.
Every use after that: load that file first. If missing, ask where the user saved it or re-ask the questions.
Questions on first use:
If a content brief wasn't provided, Google the topic and read the top 5 results. Note: what formats are ranking, what angles exist, what gaps you see. 3-5 bullet points, not a full brief.
Skip this phase entirely if a brief or prior conversation context already contains SERP analysis.
Based on what's ranking, pick a content type: how-to, definition/explainer, comparison (X vs Y), listicle/roundup, product review, case study, pillar/ultimate guide, FAQ, landing page, service page, news/trend analysis.
State it plainly: "The top results for [keyword] are all [format]. I'll write a [content type] with [key structural element]. Sound good, or did you have something else in mind?"
Wait for confirmation.
Load references/content-types-overview.md for the decision table covering all 23 content types. Then load the specific template from references/content-types/<type>.md (e.g., references/content-types/how-to.md) for H1/H2 structure, schema, featured snippet format, CTA placement, word count targets. The 19 content types bundled as full templates: how-to, definition, comparison, listicle, pillar-page, faq-page, landing-page, service-page, case-study, statistics-page, news-article, glossary-page, alternatives-page, buying-guide, product-page, category-page, integration-page, location-page, programmatic-page. For the 4 types covered only by the overview table (thought-leadership, product-reviews, pricing-pages, about-pages), those live under eeat-audit/references/content-types/ because the E-E-A-T bar for them is the load-bearing factor.
Ask 2-3 quick questions to extract unique knowledge the user has. Pick from:
Ask one at a time. Keep it quick.
Adapt style:
Length: Do not target a specific word count. Match the depth of top-ranking content from Phase 1. Length follows intent and competition — never pad to hit a number.
Produce the complete article in clean markdown. Follow ALL of these rules:
NEVER use these words — highest-signal AI tells: delve, landscape (metaphorical), testament, leverage, utilize, robust, seamless, furthermore, moreover, additionally, pivotal, multifaceted, harness, embark, navigate (metaphorical), showcase, streamline, paramount, culminate, spearhead, commence, endeavor, vibrant, innovative, comprehensive (as adjective).
NEVER use these phrases: "It's worth noting", "In today's [anything]", "Let's dive in", "In conclusion", "plays a crucial/vital/pivotal role", "It goes without saying", "In the realm of".
Avoid these structural patterns:
Clean markdown. Title + article content. Nothing else.
Write in the language from the business context. If not specified, match the language of the user's messages.
Load from references/ only when the step or rule calls for them. Don't preload — each file is heavy enough to blow context if stacked.
Content type templates (references/content-types/) — load one after Phase 2:
how-to.md, definition.md, comparison.md, listicle.md, pillar-page.md, faq-page.md, landing-page.md, service-page.md, case-study.mdstatistics-page.md, news-article.md, glossary-page.mdalternatives-page.md, buying-guide.md, product-page.md, category-page.md, integration-page.md, location-page.md, programmatic-page.mdreferences/content-types-overview.md for the decision table across all 23 content types (load this FIRST if unsure which type to pick)Writing technique modules (references/) — load when the matching Phase 4 rule needs more depth:
anti-slop-ruleset.md — full tiered banned vocab + structural tell list (when the inline anti-slop block isn't catching something)voice-injection-playbook.md — voice and register techniques (when the draft reads flat)information-gain-writing.md — the 30% rule and how to satisfy it (for the "So What" test)serp-driven-writing.md — how Phase 1 research shapes the article (if the draft drifts from the SERP intent)intent-matching.md — length and format decisions from intent (when the SERP is mixed)eeat-signal-embedding.md — how to surface experience without a bio sectionstructured-data-snippets.md — JSON-LD and featured snippet formatting per content typegeo-optimization.md — optimizing for AI Overview / generative engine citationnavboost-engagement.md — engagement signal writing (dwell time, scroll depth)quality-scoring.md — self-scoring rubric to run before deliverywriting-pipeline.md — the research → draft → edit loopseo-optimization-layer.md — keyword placement, internal linking, metadata passfact-checking.md — how to verify every specific number and claimhuman-input-framework.md — the knowledge-extraction questions (reinforces Phase 3)Use when planning a new article. The agent Googles the keyword, reads the top 10 results, classifies intent, maps the content gap, and produces a writer-ready brief with structure, outline, and on-page artifacts. No keyword tool required.
Use when you want to win a featured snippet for a keyword you already rank for. The agent checks the current snippet format, analyzes your content, and rewrites the relevant section to match what Google wants.
Use when rewriting or refreshing an existing page that's underperforming. The agent fetches the URL, analyzes the current content, researches the SERP, and rewrites using the full anti-AI-slop ruleset — no data exports needed.
Use when a page ranks for a keyword but isn't in the top 3 and you want to know exactly what's missing. The agent compares the page to the top-ranking competitors and produces a specific list of entities, subtopics, and relationships to add.
Use when auditing a page for E-E-A-T signals. The agent reads the page and scores Experience, Expertise, Authoritativeness, and Trustworthiness — then tells you exactly what to add to each dimension.
Use when extracting first-party expertise from a subject-matter expert before writing content. Produces a knowledge document of contrarian takes, specific examples, and surprising outcomes that AI can't fabricate.