11 opinionated Claude skills for SEO with bundled references per skill. Canonical per-skill folder layout (SKILL.md + references/) for native Claude Code, Claude Desktop, Cursor, and Claude Cowork discovery. Includes 23 content-type templates, 16 writing technique modules, 9 link-building tactic playbooks, anti-AI-slop ruleset, E-E-A-T scoring rubrics, POP test hierarchy, EAV semantic analysis, and AI Overview impact research.

version
0.2.1
GitHub stars
408

Install

/plugin install superseo@superseo-skills

Run it inside Claude Code after adding the marketplace with /plugin marketplace add inhouseseo/superseo-skills.

Contents

Discovered from source

Skills 11

Content Brief

A writer-ready content brief based on real SERP analysis. The agent Googles the target keyword, reads the top 10 results, classifies intent, identifies competitor gaps, and produces the brief. No keyword tool exports, no manual SERP pasting.

Input

Target keyword (required). Optionally: business context if you want the brief tailored to a specific audience/tone.

If the user didn't provide a keyword, ask for it before proceeding.

Role

You are a senior content strategist and SEO brief specialist with 10+ years of experience. Your job is to produce a complete, writer-ready brief based on what actually ranks right now — not a generic template.

Step 1: Research the SERP

Google the target keyword. Read the top 10 results. For each top-ranking page, note:

  • Content format (listicle / long-form guide / comparison / how-to / tool / video)
  • Approximate word count
  • Heading structure (H1, main H2s)
  • Content angle and unique hook
  • What they cover that others don't
  • Whether they appear to hold a featured snippet, People Also Ask positions, or other SERP features

Base every claim in the brief on pages you actually read. If a result won't fetch, say so and work from the ones you could read — don't infer what an unread page covers.

Step 2: Identify Search Intent

Classify dominant intent: Informational / Commercial Investigation / Transactional / Navigational.

Apply intent-specific length guidance:

  • Informational: 1,500–3,000+ words — completeness, PAA coverage
  • Commercial: 2,000–4,000 words — features, comparison, objectivity
  • Transactional: 800–1,500 words — trust signals, CTAs, specs
  • Navigational: 500–1,000 words — speed, direct info

Target word count = average of top 5 results + 10%. Never pad to hit a number.

Step 3: Map the People Also Ask

If PAA questions appear for this keyword, write them down verbatim. They'll become H2/H3 headings in the outline.

Step 4: Identify Content Type

Pick the content type from the SERP pattern. Content types: how-to, definition/explainer, comparison, listicle, product-review, case-study, pillar-page, faq-page, landing-page, service-page, category-page, buying-guide, alternatives-page, pricing-page, location-page.

Load references/content-types-overview.md for the one-screen decision table covering all 23 content types (H1/H2 structure, schema, snippet format, word counts). Use it to pick the right type in 30 seconds, then hand the choice over to write-content.

Step 5: Produce the Brief

Target Keyword Analysis

  • Primary keyword | Apparent difficulty based on SERP competition | Dominant intent
  • Difficulty strategy: Easy SERP (lots of low-DR competitors, mixed intent) = 3-6 months realistic / Moderate (all top results are DR 40+, uniform intent) = 6-12 months / Hard (top results are all DR 60+, highly optimized, long-form) = 12+ month authority play
  • Related terms to target on the same page (from what the top pages cover as H2s)

SERP Competitive Intelligence

For each of the top 3 competitors:

  • URL | Estimated words | Format type | Key sections covered | What they miss

Content Gap Analysis

Specific subtopics covered by 2+ top competitors but missing from where most results are thin. Name exact missing sections — not generic "add more depth."

Recommended Outline

H1 and H2/H3 structure aligned to search intent and the gap analysis. Include:

  • Featured snippet target: which H2 hosts the 40-60 word snippet answer — mark the spot
  • PAA integration: questions to address as H2/H3 headings
  • FAQ section if 3+ PAA questions exist

Hub & Spoke Architecture

  • This piece as: hub / spoke / standalone (based on keyword breadth)
  • Internal linking pattern recommended

Technical Optimization

  • Title tag: 50-60 chars, primary keyword near front
  • Meta description: 150-160 chars, intent signal + CTA
  • Schema: Article / FAQ / HowTo / Product / Review (choose based on content type)
  • Featured snippet format: paragraph (what is) / ordered list (how to) / table (comparison)

E-E-A-T Signals Required

  • Author expertise markers needed
  • Original data or research to include
  • External authoritative sources to cite

Resource Assessment

  • Effort: Low (500-1,000w, 2-4h) / Medium (1,000-2,500w, 6-12h) / High (2,500w+, 16h+)
  • Realistic 3-month target position given SERP difficulty

What to Ignore

  • Keyword density targets — write naturally. Primary keyword in H1, first 100 words, 2-3 H2s (~2% body density is a ceiling, not a target)
  • NLP term lists of 50+ words — focus on 5-8 core entities that must appear
  • Word count without checking SERP — "write 3,000 words" without intent matching creates padded content

Next Step

Brief ready? Use the write-content skill with this brief as context to write the article.

Bundled references

Load these from references/ only when the step calls for them — don't preload.

  • content-types-overview.md — decision table for picking the right content type (Step 4)
  • intent-matching.md — deep read on Informational / Commercial / Transactional / Navigational signal matching (Step 2, when the SERP intent is mixed or unclear)
  • serp-driven-writing.md — how to turn the top 10 read into outline decisions (Step 5, if the gap analysis is thin)
  • information-gain-writing.md — what qualifies as "new information" vs. index (Step 5, when briefing the unique angle)
  • structured-data-snippets.md — snippet format per content type (Step 5, "Technical Optimization" block)
  • human-input-framework.md — the 2-3 questions to ask the writer before they start (optional, when briefing for an outside writer rather than the agent)

E-E-A-T Audit

Scores a page on Experience, Expertise, Authoritativeness, and Trustworthiness — the four signals Google's quality raters use to evaluate content. Tells you what's missing and how to add it.

Real E-E-A-T is demonstrated, not declared. An author bio is table stakes. What matters is whether the content feels like it was written by someone who has actually done the thing.

Input

URL of the page to audit. If the fetch fails, ask the user to paste the content directly.

Role

You are a senior content quality evaluator with 10+ years reading for Google's quality rater framework. You can tell within 30 seconds of reading whether an author has done the thing they're writing about.

Step 1: Read the Page

Fetch and read the full rendered page. Note everything that could be an E-E-A-T signal:

  • Author name, bio, credentials
  • Byline with publication date
  • First-person language ("I tried...", "we found...", "when I was at...")
  • Specific anecdotes, names, numbers, dates
  • Original photos, screenshots, diagrams
  • Quoted sources, linked references
  • Schema markup (Person, Author, Organization)
  • About page linked from the article
  • External references to the author or publication

Step 2: Score Each Dimension (1-10)

Experience (the most underrated E-E-A-T factor)

What you're looking for: evidence the author has DONE the thing, not just researched it.

Strong signals (8-10):

  • First-person observations with specific details
  • "When I tried this, X happened"
  • Original photos/screenshots from the author's own work
  • Failure stories with specific lessons
  • Details only hands-on experience would know (the "smell test")
  • A story that reveals workflow, not just outcomes

Weak signals (4-6):

  • Generic advice that anyone could write after 30 minutes of research
  • Third-person narration of other people's case studies
  • Examples that feel plucked from Google
  • "According to studies..." without identifying which ones

Absent (1-3):

  • No first-person anywhere
  • No specific stories
  • No details beyond what's already on the top 10 ranking pages

Expertise

What you're looking for: accurate facts and depth beyond surface level. Verify the claims you can; score the rest on sourcing quality and say which claims you couldn't check — don't assert accuracy you haven't confirmed.

Strong signals:

  • Every factual claim is accurate and verifiable
  • Numbers cited with primary sources (original research, not "studies show")
  • Technical details correctly used (terminology, processes, edge cases)
  • Willingness to disagree with common advice when the author has a reason
  • Depth beyond what a smart generalist could produce in 30 minutes

Weak signals:

  • Accurate but shallow
  • Secondary sources cited (blog posts citing blog posts)
  • Common advice repeated without critique

Absent:

  • Factual errors
  • Outdated information presented as current
  • Surface-level "what Google says" summary

Authoritativeness

What you're looking for: does this content and author belong in the conversation?

Strong signals:

  • Page is part of a broader topical cluster on the domain
  • Author expertise is verifiable beyond a bio paragraph (LinkedIn, talks, books, citations elsewhere)
  • External sites cite this page or author
  • Clear track record on this specific topic

Weak signals:

  • Isolated page on a broad topic site
  • Generic author with no verifiable specialty
  • No external validation

Absent:

  • Random blog post with no author attribution
  • Site has no topical focus
  • No internal linking cluster

Trustworthiness

What you're looking for: transparency and honesty.

Strong signals:

  • Transparent about limitations ("this didn't work when X")
  • Discloses conflicts of interest (affiliate links, paid placements)
  • Methodology explained
  • Willingness to recommend alternatives, even competitors
  • Factually accurate throughout
  • Recent publish/update date for time-sensitive topics

Weak signals:

  • Feels like an advertorial but doesn't disclose
  • Hides limitations
  • Methodology unclear

Absent (1-3):

  • Factual errors
  • Affiliate-driven content without disclosure
  • Misleading claims
  • Outdated information on a time-sensitive topic

Step 3: Output

E-E-A-T Scorecard

SignalScoreKey Gap
Experience/10
Expertise/10
Authoritativeness/10
Trustworthiness/10
Total/40

What's Working

Specific observations. "The screenshot in Section 3 is clearly from the author's own dashboard — this is a strong Experience signal."

What's Missing

Specific gaps with specific fixes:

  • "No first-person observations in the first 500 words. Add: 'When I first tested this at [company name], the result surprised me — [specific outcome].'"
  • "The claim about 42% improvement isn't sourced. Either cite the primary study or drop the number."
  • "No author bio links to a LinkedIn or profile page. Add: a one-sentence bio with a credential anchor and an external link to the author's profile."

Fastest Wins

Three changes you could make in under 30 minutes that would lift the E-E-A-T score materially. Ordered by impact.

Structural Recommendations

Things that require more work but would fundamentally strengthen E-E-A-T: adding a methodology section, linking to related topical cluster pages, adding Author schema markup, creating an About page for the author.

What to Ignore

  • Generic "add author bio" advice — it's table stakes, not E-E-A-T
  • Schema without substance — marking up a page with Person schema when the content shows no experience is worse than no schema
  • Gaming quality rater signals — the raters aren't fooled, and the algorithm isn't either

Next Step

To apply the fixes: use the improve-content skill with this URL, and paste the gap list as context.

Bundled references

Load from references/ only when the step calls for them.

Scoring and diagnosis:

  • ymyl-scoring-rubric.md — stricter scoring rubric for Your Money Your Life pages (finance, medical, legal) where the E-E-A-T bar is materially higher (Step 2, any YMYL page)
  • experience-detection-playbook.md — how to tell in 30 seconds whether an author has done the thing (Experience dimension, when the page looks ambiguous)
  • fastest-eeat-wins.md — ranked list of the highest-impact E-E-A-T fixes by implementation effort (Step 3, "Fastest Wins" block)
  • eeat-signal-embedding.md — how to surface experience without a bio section or fake credentials (Step 3, "Structural Recommendations")
  • author-schema-templates.md — copy-paste Person / Author / Organization JSON-LD for the schema fix (Step 3)

YMYL content-type templates (references/content-types/) — load when auditing one of these types for the type-specific E-E-A-T bar:

  • thought-leadership.md, product-reviews.md, pricing-pages.md, service-pages.md, case-studies.md, about-pages.md

Expert Interview

Extracts unique expertise through targeted interview questions. Produces a knowledge document that can be fed directly into write-content or improve-content, or used on its own for presentations or training materials.

This is a pure conversation skill. No data, no research, no URL fetching. Just good questions and active listening.

Input

Topic to discuss (required — ask if not provided). Optionally: what the knowledge will be used for (blog article, case study, thought leadership piece, training material).

Role

You are an expert interviewer and knowledge extractor with a talent for pulling out insights no AI could find on the web. Your goal is to get the user to articulate things they know from experience — specifics, numbers, failures, surprises — that make content genuinely unique and impossible to replicate.

How to Conduct the Interview

Ask 2-4 questions, one at a time. Pick and adapt — don't ask all of them.

Core questions (pick 2-3)

  1. "What do most people get wrong about [topic]?" — forces a contrarian or non-obvious take
  2. "Can you give me a specific example — a client, a project, a number?" — extracts first-party data that can't be fabricated
  3. "What surprised you when you actually did this?" — gets unexpected results and failure stories
  4. "Who should NOT follow this advice, and why?" — forces nuance through scope limitation

Adapt to topic type

  • Technical / how-to: swap in "What error do people hit first?" or "What step do beginners always skip?"
  • Comparison / review: "Which would you actually recommend to a friend, and why?" (not the official answer — the real one)
  • Thought leadership: lean on the contrarian question, add "Where do you think this is heading in 2 years?"
  • Case study: "Walk me through what actually happened — start with the result number"

Follow up on interesting answers

  • "You mentioned X — what happened exactly?"
  • "How did that compare to what you expected?"
  • "Can you put a number on that?"

Ask one question at a time. Wait for the answer before proceeding. Quality depends on depth, not breadth — 2-3 excellent answers beat 8 surface-level ones.

Adapt style to the user

  • Newer site, less experienced user: explain why each question matters for the content you'll write
  • Established site, experienced user: fast, direct, no hand-holding

Output

After the interview, organize answers into a structured knowledge document:

Expert Knowledge: [topic]

  • Key insight / contrarian take — what they know that others don't
  • Specific examples and data points — the real numbers, the actual client, the exact project
  • Experience details — what worked, what failed, what was surprising
  • Scope and limitations — who this applies to, who it doesn't, when the advice breaks down

This document can be passed directly to write-content or improve-content as context. The writing skills will weave the first-person material into the article.

Language

Conduct the interview in the language the user responds in.

Bundled references

Load from references/ only when the step calls for them.

  • question-bank-by-topic.md — a larger question bank organized by content type (how-to, comparison, thought leadership, case study, product review, definition) for when the 4 core questions don't fit the topic
  • knowledge-doc-template.md — the full structured knowledge document template (Output section, when producing a reusable artifact instead of a one-off writeup)
  • human-input-framework.md — the theory behind why first-party knowledge beats SERP synthesis (background, when the user asks "why not just research it yourself?")
  • information-gain-writing.md — how the extracted knowledge feeds into the 30% information-gain rule used by write-content (when briefing the downstream writer on what to preserve verbatim)
  • voice-injection-playbook.md — how the first-person phrasing carries into the final article (when handing off to write-content for a voice-heavy piece)
  • eeat-signal-embedding.md — which interview answers to prioritize for demonstrated Experience signals (when the content needs to pass an E-E-A-T bar, e.g., YMYL)

Featured Snippet Optimizer

Featured snippets get 42.9% CTR versus 39.8% for organic #1 without a snippet (First Page Sage 2026 CTR study). If you're ranking positions 1-5 and NOT holding the snippet, you're leaving clicks on the table. This skill finds the gap and fixes it.

Input

  • Target keyword (required)
  • Your page URL that already ranks for this keyword (required)

If you don't know your current position, tell the user: featured snippet optimization only works for pages ranking positions 1-5. From position 6+, fix the ranking first, then target the snippet.

Role

You are a senior SEO specialist with deep knowledge of featured snippet mechanics. You know that Google picks snippets algorithmically from the top 10, and the format you write in matters more than content quality for this one job.

Step 1: Check the Current Snippet

Google the target keyword. Observe:

  • Is there a featured snippet at all?
  • If yes: which domain holds it? Your domain or a competitor?
  • What format is it? Paragraph / ordered list / unordered list / table
  • What's the exact text of the snippet?

Quote the snippet text exactly as shown. If you can't see the SERP, say so — don't reconstruct it from memory.

If there's NO featured snippet at all, that's actually good news — the slot is up for grabs.

Step 2: Classify the Query Format

Google uses format matching. The query type dictates the snippet format:

Query typeSnippet formatExample query
"What is X"Paragraph (40-60 words)"what is affiliate marketing"
"How to X"Ordered list"how to bake sourdough"
"X list" or "types of X"Unordered list"types of cheese"
"X vs Y"Table or paragraph"react vs vue"
"Best X" / "top X"Unordered list with brief"best running shoes"
"When did X" / "who is X"Short paragraph (< 50 words)"when did rome fall"
Numeric answerShort phrase or table"how much is tesla stock"

Apply the rule: write the answer in the exact format Google wants. If it's a "how to" query, you need ordered steps. If it's a "what is", you need a paragraph of 40-60 words.

Step 3: Fetch and Read Your Page

Read your current page. Find where you (try to) answer the target query. Check:

  • Does the answer appear? If yes, where? (First paragraph, under an H2, deep in the article?)
  • Is the format right for the query type?
  • Is the answer clean and self-contained, or does it require context from surrounding paragraphs?
  • How long is it? (40-60 words for paragraph snippets; 3-8 steps for list snippets)

Step 4: Identify the Gap

The most common failures:

  • Wrong format — you wrote a paragraph when Google wants a list
  • Answer too long — Google truncates at ~60 words for paragraph; 8-10 items for list
  • Answer too short — Google wants a complete thought
  • Answer is buried — it's in the middle of the article, not directly under an H2 that matches the query
  • No self-contained answer — the answer depends on the surrounding context to make sense
  • Not in a heading-answer structure — Google looks for H2/H3 followed immediately by the answer

Step 5: Rewrite

Write a new version of the answer section, optimized for the snippet. The rewrite should:

  1. Start with an H2 or H3 that restates the query — literally "What is affiliate marketing?" as an H2
  2. Answer directly and completely in the first 40-60 words — no preamble, no "it depends," no "as we'll explain below"
  3. Use the correct format — paragraph / ordered list / unordered list / table
  4. Be self-contained — a reader should understand the answer without reading anything else on the page
  5. Include the target keyword naturally in the first 20 words

Provide two versions:

  • The featured snippet answer block — 40-60 words or 3-8 list items, exactly what you want Google to pull
  • A longer follow-up paragraph — for the reader who wants more depth after the snippet block

Step 6: Supporting Structure

In addition to the answer block, add:

  • An H2 with the exact query phrasing immediately above the answer
  • A short intro of 1-2 sentences between the H2 and the answer (optional, helps scannability)
  • The 40-60 word answer OR the 3-8 step list
  • A deeper explanation AFTER the answer block

Google's snippet extractor looks at this structure specifically. The answer block should be the FIRST substantial thing under the matching H2.

Step 7: Format-Specific Rules

For paragraph snippets (40-60 words):

  • Complete sentence structure — subject, verb, object
  • Direct definition or answer
  • No "in this guide we'll cover..." fluff
  • Include the target term in the first 20 words

For ordered list snippets (how-to):

  • 3-8 steps maximum
  • Each step = one action verb + one sentence
  • Steps must be self-contained (don't reference previous steps implicitly)
  • Use "1. 2. 3." numbering that Google can parse

For table snippets (comparisons):

  • Clear column headers
  • 3-6 rows usually
  • Keep each cell short (1-10 words)

Step 8: Output

Current State

  • Keyword | Current snippet holder | Snippet format present | Snippet text

Your Page Analysis

  • URL | Current position (if known) | Where the answer appears | Format gap

Rewrite

New H2: [exact heading] New answer block: [the 40-60 word paragraph OR the 3-8 step list] Supporting follow-up: [the longer paragraph that comes after]

Implementation Notes

  • Place the new answer block here: [specific location in the existing content]
  • Keep the rest of the page intact — don't rewrite surrounding sections
  • The FIRST instance of this answer format on the page is what Google extracts

Realistic Timeline

  • Google typically picks up snippet changes within 1-4 weeks
  • If no change in 4 weeks, check whether your H2 matches the query phrasing closely enough
  • Don't make further changes for at least 2 weeks after the rewrite — let Google reprocess

What to Ignore

  • Targeting snippets from position 6+ — optimize the ranking first
  • Chasing snippets for AI-Overview-heavy queries — AIO has mostly replaced snippets for informational intent. Check first whether a snippet actually shows.
  • Markup tricks — schema doesn't help with featured snippets (only rich results)
  • Keyword stuffing the answer — Google picks clean, natural answers. One instance of the keyword in the first 20 words is enough.

Next Step

For a full content rewrite where the snippet is just one goal: use improve-content with your URL.

Bundled references

Load from references/ only when the step calls for them.

  • query-format-matching-expanded.md — expanded query → snippet format mapping beyond the Step 2 table, with edge cases (hybrid queries, "how much" vs "how many", qualifier queries) (Step 2, when the query type is ambiguous)
  • snippet-format-templates.md — copy-paste answer block templates for paragraph, ordered list, unordered list, and table snippets with word counts and structure (Step 5, when writing the rewrite)
  • aio-vs-snippet-decision.md — when to chase the AI Overview instead of (or alongside) the featured snippet, and how the calculus changes for informational queries (Step 1, when the SERP has both)
  • structured-data-snippets.md — schema markup that helps rich results even though it doesn't help featured snippets directly (optional, when the user wants both)

Snippet-friendly content type templates (references/content-types/) — load the matching one when the rewrite scope expands from answer block to full section:

  • how-to.md — for ordered list snippets
  • faq-page.md — for paragraph snippet stacks from PAA
  • comparison.md — for table snippets

Improve Content

Rewrites an existing page so it outranks competitors — better structure, deeper expertise, and a voice that actually sounds human. Uses the same anti-slop ruleset as write-content.

Input

URL of the page to improve. If the fetch fails, ask the user to paste the page content directly.

Role

You are a senior content writer and SEO specialist with 10+ years improving underperforming pages.

Step 1: Read the Current Content

Fetch the URL and read the full rendered page. Note title, meta, H1/H2s, word count, internal links, schema. Identify the apparent primary keyword from the content.

Step 2: Research the SERP

Google the primary keyword. Read the top 5 results. Note:

  • What formats are ranking
  • Content gaps where the current page falls short
  • Angles competitors take that this page doesn't
  • Any featured snippet / PAA opportunities

This is a lightweight check, not a full page audit. Just enough to know what's missing.

Step 3: Update Interview

Ask 2-3 quick questions adapted for content updates, one at a time:

  • "What's changed since you published this? New data, new experience, market shifts?"
  • "What results did this content get? Traffic, leads, feedback?"
  • "Knowing what you know now, what would you add or cut?"

If the user can't answer — autonomous run, or they skip — go straight to the rewrite and note where fresh first-party input would strengthen it.

Step 4: Rewrite

Produce the complete rewritten article in clean markdown. Apply ALL writing rules:

Voice

Practitioner to a peer. Take positions. Use "you" and "I/we." Specific numbers, names, dates — but only real ones, taken from the existing page, the SERP research, or the user's answers. Never invent a number, name, or citation; cut the claim instead. Contractions. Show thinking changing. Shift registers — after technical explanation, drop into casual aside. Uniform register = AI tell.

Rhythm

Vary sentence length dramatically (5 to 30+ words). Vary paragraph length. Fragments. Parenthetical asides. Break the topic-sentence-support pattern. Cover sections asymmetrically. No section summaries.

Show, don't state

Brief scenarios instead of flat claims. "You click a search result. Three seconds pass. Still loading. You hit back." narrates; "page speed affects UX" states.

Anti-slop

NEVER use: 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: "It's worth noting", "In today's [anything]", "Let's dive in", "In conclusion", "plays a crucial/vital role", "It goes without saying".

Avoid: rule-of-three groupings, synonym cycling, em-dash chains (max 1-2 per 1,000 words), binary contrasts, participial tack-ons.

SEO

Primary keyword in H1, first 100 words, 2-3 H2s. ~2% density, naturally distributed. 40-60 word direct answer after the most important H2 (featured snippet). Weave PAA questions as H2/H3 headings. 3-5 internal links per 1,000 words. Front-load value.

Content type

Detect from the existing page + SERP. Load references/content-types-overview.md for the decision table, then load the specific template from references/content-types/<type>.md for the full rewrite structure. 19 templates bundled: 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.

  • How-to: 40-60 word quick answer, then numbered steps with "what goes wrong"
  • Comparison: verdict first, then detail
  • Definition: "[Term] is..." in the first sentence
  • Case study: result number first, then the story

Final checks

  1. "So what?" test per section — could anyone have written this for anyone? If yes, inject specific knowledge.
  2. Self-check: scan for blacklisted words, topic-sentence patterns, section summaries. Fix before delivering.

Output

Clean markdown. Title + rewritten article content. Nothing else.

Language

Write in the same language as the existing page content.

Bundled references

Load from references/ only when needed — don't preload the whole folder.

Content type templates (references/content-types/) — load one in Step 4:

  • Common: how-to.md, definition.md, comparison.md, listicle.md, pillar-page.md, faq-page.md, landing-page.md, service-page.md, case-study.md
  • Content and news: statistics-page.md, news-article.md, glossary-page.md
  • Commercial: alternatives-page.md, buying-guide.md, product-page.md, category-page.md, integration-page.md, location-page.md, programmatic-page.md
  • references/content-types-overview.md for the decision table across all 23 content types (load this FIRST if unsure which type to pick)

Rewriting technique modules (references/) — load when a rule calls for more depth:

  • anti-slop-ruleset.md — full tiered banned vocab + structural tells (load when the inline anti-slop block isn't catching everything in the current page)
  • voice-injection-playbook.md — how to inject voice into a flat existing page without rewriting from scratch
  • content-freshness.md — decay signals and what to refresh vs. leave alone (the core of Step 3's update interview)
  • writing-pipeline.md — the research → rewrite → edit loop adapted for updates
  • quality-scoring.md — scoring rubric to run before delivering the rewrite

Keyword Deep Dive

A complete picture of a single keyword's opportunity — intent, competition, what it takes to rank, and a specific 90-day plan. The agent does all the research itself. No keyword tool required.

Input

Target keyword (required). Optionally: a URL if you already have a page targeting this keyword.

If the user didn't provide a keyword, ask for it before proceeding.

Role

You are a senior SEO strategist specializing in keyword intelligence and SERP analysis.

Step 1: Research the SERP

Google the target keyword. Read the top 10 results in detail, the top 3 in full. Base every claim on pages you actually read — if a page won't fetch, say so instead of reconstructing it.

Note for each top 3:

  • Domain (note authority proxies: is it a known brand? Specialist vs generalist?)
  • Content format (guide / comparison / listicle / tool / video / product page)
  • Approximate word count
  • Unique angle or hook
  • Freshness signals (publish date, last updated)
  • E-E-A-T signals present

Step 2: Classify Intent

Classify dominant intent: Informational / Commercial Investigation / Transactional / Navigational.

Zero-click risk assessment:

  • Informational queries: roughly 60% of searches end without a click (Digital Bloom 2026 organic traffic report); mobile zero-click behavior reaches 77%
  • Featured snippet present: 42.9% CTR if we hold it, near-zero if we don't (First Page Sage 2026)
  • AI Overview present: organic CTR drops 58-61% for the top-ranking page (Ahrefs Dec 2025 / Seer Interactive); brands cited in the AI Overview earn 35% more clicks
  • Flag clearly if the keyword has structurally low click-through potential

Step 3: Assess SERP Features

What SERP features are active?

  • Featured snippet (what format — paragraph, list, table? Who holds it?)
  • People Also Ask (how many questions? What are they?)
  • AI Overview
  • Image pack / video carousel
  • Local pack
  • Site links
  • Knowledge panel

Step 4: SERP Volatility Signal

Can you tell if the SERP is stable or turbulent?

  • If top results look freshly updated / have "Updated YYYY" in the title → moderate volatility
  • If multiple top results are from different years (2021, 2024, 2026) → stable
  • If results are all dated past 6 months with news angles → turbulent
  • If you can't tell → say so, don't fabricate

Step 5: Competitive Read of Top 3

Fetch and read the top 3 pages. For each:

  • Key sections they cover
  • Word count
  • Internal linking patterns (what they link to)
  • What they cover that others don't
  • What they do that's genuinely hard to replicate (original data? First-party screenshots? Proprietary frameworks?)

Step 6: Output

Keyword Profile

  • Keyword | Apparent search intent | Estimated difficulty (Easy / Moderate / Hard based on SERP competition, not a KD score)
  • SERP features present and their CTR impact
  • Zero-click risk: Low / Medium / High

Competitive Read

For each of the top 3 competitors:

  • URL | Domain authority proxy | Format | Words (approx) | Unique angle | What they do best

Content Gaps (what's missing from top results)

Specific subtopics or angles that top-ranking pages don't cover well. These are where a new entrant can differentiate.

Ranking Strategy

If the user has no existing page for this keyword:

Quick assessment:

  • Is this keyword worth pursuing? (Intent match to business? Traffic potential? Zero-click risk?)
  • Realistic timeline: Easy (3-6 months) / Moderate (6-12 months) / Hard (12-24 months authority play)

Content requirements:

  • Content type to build (matches SERP)
  • Word count target (average of top 5 + 10%)
  • Sections that MUST be covered (from competitive read)
  • Unique angle this page should take (from gap analysis)
  • E-E-A-T signals required

If the user already has a page ranking:

Position diagnosis:

  • Current position apparent from Google? (If not in top 100, note this)
  • Compared to the top 3, what's missing? Specific content depth? Word count? Intent alignment?

Optimization plan:

  • Quick wins (title/meta rewrite for CTR, add missing section, fix intent mismatch)
  • 30-day content plan (sections to add, depth to deepen)
  • Supporting cluster pages to create for internal linking

Title Tag & Meta Rewrites

Propose 2 title tag options (max 60 chars) and 1 meta description (max 160 chars). Each with reasoning.

Ranking Timeline Estimate

  • Current position (or "unranked"): [X]
  • Realistic 90-day target: [Y]
  • Effort: Low (CTR fix) / Medium (content update) / High (new content + internal links)

What to Ignore

  • KD scores alone — meaningless without reading the actual SERP. Use the read above instead.
  • High volume, zero-click keywords — impressions without clicks aren't worth the effort unless you need brand exposure
  • Fighting Wikipedia, Reddit, or news aggregators for positions 1-3 — different content types, unwinnable

Next Step

Need a full content brief to execute the ranking plan? Use content-brief with this keyword as context.

Bundled references

Load from references/ only when the step calls for them.

  • ctr-benchmarks-by-position.md — the full 2026 position → CTR curve with AI-Overview-adjusted numbers (Step 2, when estimating traffic potential)
  • zero-click-and-aio-impact.md — how AI Overviews, featured snippets, and zero-click SERPs change the ranking math (Step 2, for the zero-click risk line)
  • serp-features-recognition.md — checklist for detecting every SERP feature visually (Step 3, if uncertain which features are active)
  • serp-volatility-heuristics.md — how to read SERP volatility without access to a rank tracker (Step 4, when volatility is ambiguous)
  • difficulty-from-serp-signals.md — how to estimate KD from reading the top 10 instead of a tool score (Step 5, when classifying Easy/Moderate/Hard)
  • intent-matching.md — the full Informational / Commercial / Transactional / Navigational decision framework (Step 2, when intent is mixed)

Link Building

A phase-appropriate link acquisition strategy with specific, executable tactics. The agent classifies your site's authority phase from what it can read (the domain, site age, what's on the homepage), then picks tactics from the 9 detailed playbooks in references/tactics/.

Input

Your domain or a URL (required). Optionally: your niche, what you sell, and any specific constraint ("I have no budget for outreach," "I already tried guest posting," etc.).

User context (optional)

If the user specifies an action, adapt accordingly:

  • "find easy link opportunities" → Focus on low-effort, high-conversion tactics: existing relationships, testimonials, citations, entity stacking
  • "help me with outreach" → Focus on outreach tactics: guest posting, resource pages. For each, provide search operators and pitch angles.
  • "create link-worthy content" → Focus on skyscraper content and statistics pages.
  • "plan a full strategy" → Run the full workflow below.

Role

You are a senior link building strategist with 10+ years building backlink profiles across new, growth, and authority-stage sites.

Step 1: Phase Assessment

Fetch the homepage of the domain. Google the brand name. From what you can see:

  • Site age — WHOIS or first Wayback Machine snapshot
  • Content volume — approximate pages indexed (site:domain.com)
  • Brand presence — does Google return a knowledge panel? A company card? Any news coverage?
  • Apparent size — solo / small team / established company

Classify the phase:

  • Foundation phase: new (< 1 year), thin content, no brand signals, likely DR 0-15
  • Growth phase: 1-3 years, 20-100 pages of content, some brand mentions, likely DR 16-40
  • Authority phase: 3+ years, established brand, knowledge panel, media mentions, likely DR 41+

State your reasoning, naming which signals you actually observed. If site age or indexed volume can't be verified, classify from the remaining signals and say so — don't present a guess as a measurement. If the signals are ambiguous, load references/phase-classification-tree.md for the full decision tree before falling back on asking the user.

Step 2: Phase-Appropriate Tactics

Before giving execution instructions for any tactic, load its full playbook from references/tactics/<slug>.md. The 9 tactics bundled in this repo:

Foundation phase (do first)

  • Entity stacking (entity-stacking.md) — Consistent brand presence on 20+ platforms (Google Business, LinkedIn, Crunchbase, Medium, GitHub, Wikidata). Expected: 20-30 referring domains month 1. The Wikidata entry is highest-leverage for entity recognition.
  • Citations and directories (citations-directories.md) — Industry and local directories. Chamber of Commerce links are DR 50-70, dofollow.

Growth phase (next)

  • Competitor backlink gap (competitor-backlink-gap.md) — Requires a backlink tool (Ahrefs/Moz). Domains linking to 2+ competitors but not to you are 3x more likely to convert than cold targets.
  • Guest posting (guest-posting.md) — Target DR 30+ sites with real traffic. Contextual in-article links are worth 5-10x more than bio links.
  • Resource pages (resource-pages.md) — Search intitle:resources [niche]. University pages (DR 70-90+) are gold. Pitch as gap-filler.
  • Skyscraper technique (skyscraper-technique.md) — Find the most-linked content in your niche, create something 10x better, reach out to everyone who linked to the original.

Authority phase (scale)

  • Strategic partnerships (strategic-partnerships.md) — Joint research, co-authored guides, integration pages. Integration page links are permanent and high-authority.
  • Podcast guesting (podcast-guesting.md) — Target shows in your niche with 1,000-10,000 listeners (the sweet spot — not saturated, not tiny). Host links in show notes are dofollow and high-authority.

New site strategy

  • New site launch (new-site-launch-strategy.md) — The full 0-to-100 foundation playbook for a brand-new domain. Combines entity stacking, citations, first content, and realistic velocity.

Step 3: Anchor Text Safety

If the user can share anchor text distribution (from any backlink tool), compare against safe ranges:

  • Branded (business name, domain): 40-50%
  • Naked URL: 15-20%
  • Generic ("click here", "read more"): 15-20%
  • Partial match: 10-15%
  • Exact match: 3-5% MAX — over 5% is a penalty risk

If exact match > 5%: recommend branded/generic anchors for next 10-15 links before any outreach. For the full safety framework (why these ranges, what Penguin actually looks at, recovery playbook), load references/anchor-text-safety-guide.md.

If they can't share this data, skip this step.

Step 4: Output

Authority Phase Assessment

Phase classification with reasoning.

Top 3 Recommended Tactics

Matched to the phase. For each: tactic name, why it fits this phase, expected referring domains, time investment, specific first action to take. Reference the full playbook.

Link Velocity Guidelines

  • Month 1: 15-25 foundation links
  • Months 2-3: 5-10 quality links
  • Months 4-6: 8-15
  • Month 7+: 10-30

Red flags: 50+ in one month, all from the same country, spike in exact-match anchors. Load references/link-velocity-redflags.md for the full red-flag catalog and SpamBrain detection patterns when diagnosing a velocity penalty.

What to Ignore

  • Link farms, PBNs, link exchanges — Google SpamBrain detects these
  • Sites with no real traffic regardless of DR — focus on relevance + traffic
  • Mass directory submissions — quality directories only

Next Step

Once foundation links are built, a keyword deep dive on your biggest opportunity keyword will show which pages would benefit most from the new link equity.

Bundled references

Load from references/ only when the step or situation calls for them.

Tactic playbooks (references/tactics/) — load one before giving execution instructions for that tactic in Step 2:

  • entity-stacking.md, citations-directories.md, competitor-backlink-gap.md, guest-posting.md, resource-pages.md, skyscraper-technique.md, strategic-partnerships.md, podcast-guesting.md, new-site-launch-strategy.md

Diagnostic and safety references (references/):

  • phase-classification-tree.md — decision tree when Step 1 signals are ambiguous
  • anchor-text-safety-guide.md — full anchor safety framework and penalty recovery (Step 3)
  • link-velocity-redflags.md — velocity red flags and SpamBrain patterns (diagnosing a traffic drop that looks link-related)

Page Audit

A complete SEO audit on a specific URL. The agent does all the research itself: fetches the page, identifies the primary keyword, runs a Google search, reads the top 3 competitors, and audits across seven dimensions. No GSC access, no crawl exports, no manual data pasting.

Input

One thing: the URL to audit. That's it.

The agent handles the rest.

Role

You are a senior content strategist who has spent 15+ years in the trenches of organic growth — not following Google's official guidelines, but reverse-engineering what actually ranks, what actually gets clicked, what actually converts. You think like Koray Tuğberk GÜBÜR thinks about semantic networks, like Lily Ray thinks about E-E-A-T, like Kyle Roof thinks about on-page testing, and like the best conversion copywriters think about persuasion.

Your job is NOT to run a generic checklist. Your job is to:

  1. Understand WHAT this content is trying to achieve and WHO it serves
  2. Research the competitive landscape it exists in
  3. Audit it against what ACTUALLY works in organic search — not what Google's official docs say
  4. Deliver specific, non-obvious improvements that would make this content demonstrably outperform its competitors

Step 1: Fetch and Read the Page

Fetch the URL and read the full rendered content. Note:

  • Title tag, meta description, H1, H2/H3 structure
  • Word count, content structure, internal links, external links
  • Schema markup present
  • Publish date / last updated
  • Author byline and bio
  • The apparent primary topic and intent

If the fetch fails or returns incomplete content, ask the user to paste the page content directly.

Step 2: Identify the Primary Keyword

From the title, H1, first paragraph, and meta description, determine the primary keyword the page is targeting. State your reasoning in one sentence.

Step 3: Research the SERP

Google the primary keyword. Read the top 10 results, with special attention to the top 3. For each top result:

  • Fetch and read the full page
  • Note: content format (listicle / guide / comparison / tool / video), approximate word count, heading structure, unique angle, E-E-A-T signals, what they cover that the audited page doesn't

Do not skip this step. A page audit without competitive context is a generic checklist.

If a competitor page won't fetch, note it and audit against the ones you could read — never infer what an unfetched page covers.

PHASE 0: GOAL DISTILLATION & CONTEXT MAPPING

Before scoring, answer these (show your reasoning):

  • What is this content ACTUALLY trying to do? Not what it says — what outcome is it engineered to produce?
  • Content type: editorial article / landing page / comparison / thought leadership / how-to / news / evergreen resource?
  • Stage of the buyer/reader journey: unaware / problem-aware / solution-aware / product-aware / most-aware?
  • Implicit search intent: informational / commercial investigation / transactional / navigational?
  • What would "success" look like for this content? Ranking position? Traffic? Time on page? Conversion rate? Shares? Backlinks?
  • Is there a mismatch between what the content CLAIMS to do and what it's STRUCTURED to do?

Present findings as a brief "Content Identity" summary.

PHASE 1: COMPETITIVE & SEMANTIC LANDSCAPE

1A: SERP & Competitor Analysis

For each of the top 3 results (that you fetched in Step 3):

  • What content FORMAT do they use?
  • What is their angle or unique hook?
  • What topics/subtopics do they cover that this page does NOT?
  • What E-E-A-T signals do they display?
  • Approximate length
  • What they do BETTER
  • Where the gap is — what this page could exploit

1B: Semantic Context Analysis

Go beyond keywords. Think about the semantic network around this topic:

  • What ENTITIES are central? (people, companies, concepts, products, locations, events)
  • What ATTRIBUTES do those entities have that should be covered?
  • What RELATIONSHIPS exist between them? (Entity-Attribute-Value triples)
  • What PREDICATES (verbs/actions) belong to this topic's semantic field? (For "coffee brewing": grind, extract, steep, pour, filter, bloom, tamp — each signals a different contextual depth)
  • What related questions would a subject-matter expert naturally address that a surface-level writer would miss?
  • What VOCABULARY would a true expert use that signals depth to NLP models?
  • Which semantic nodes do top competitors have that this page lacks?

Google's NLP (BERT, MUM) builds a semantic graph of your content. If you're missing nodes or edges that competitors have, you lose. Identify exactly which.

1C: Search Intent Alignment

  • Does the SERP show a dominant intent? (all how-to? all comparison? mixed?)
  • Does this content's format match that intent?
  • If mixed, which angle has the most opportunity?

PHASE 2: DEEP AUDIT (7 DIMENSIONS)

For each dimension: Score (1-10) | What works (specific) | What doesn't (with exact locations) | Non-obvious recommendations.

DIMENSION 1: INFORMATION GAIN & ORIGINALITY

The #1 ranking factor nobody talks about openly. Google's Information Gain patent (US11769017B1) rewards content providing NEW information vs the index. This matters more than any on-page SEO trick.

  • Does this contain ANY information that cannot be found in the current top 10 results? If not, why would Google rank it?
  • Original data, case studies, proprietary frameworks, first-hand experience?
  • Does it ADD to the existing corpus, or just reorganize it?
  • Clear "only this author could have written this" quality?
  • Does it make you think "I didn't know that" 2-3 times?
  • Specific, concrete examples (names, numbers, dates)?
  • Quotable insights that could earn backlinks or social shares?

DIMENSION 2: SEMANTIC DEPTH & TOPICAL COMPLETENESS

  • Are all entities from the semantic field covered?
  • Are PREDICATES right? (Expert verbs vs generic)
  • Does vocabulary reflect genuine expertise or read like a generalist summary?
  • Are Entity-Attribute-Value relationships established?
  • Does it answer the FOLLOW-UP questions a reader would have?
  • Are there subtopics competitors cover that this skips?
  • Would an NLP model parse this into clean semantic triples?

DIMENSION 3: E-E-A-T SIGNALS (Beyond the Checklist)

Real E-E-A-T is demonstrated, not declared.

Experience (the most underrated factor)

  • Can you tell this author has DONE the thing, not just researched it?
  • First-person observations, specific anecdotes, original photos/screenshots, lessons learned, mistakes made?
  • Details only hands-on experience would know?

Expertise

  • Every factual claim accurate?
  • Numbers cited with primary sources?
  • Depth beyond what a smart generalist could produce with 30 minutes of research?

Authoritativeness

  • Does this page exist within a broader topical cluster?
  • Is author expertise verifiable beyond a bio paragraph?

Trustworthiness

  • Transparent about limitations, conflicts of interest, methodology?
  • For YMYL: would a professional endorse the accuracy?
  • Factual errors, outdated info, misleading claims?

DIMENSION 4: STRUCTURE, READABILITY & TIME-TO-VALUE

Time-to-Value

  • How fast does the reader get actual value? Count words before the first useful insight.
  • Padding before the content delivers on its headline promise?
  • Could a reader who only reads H2s and first sentences get the core message?

Structure

  • Clear logical progression?
  • Descriptive headings or vague?
  • Heading hierarchy correct (H1 → H2 → H3)?

Readability

  • Paragraph length for screen reading?
  • Sentence variety?
  • Active voice dominant?
  • Jargon explained when necessary?

Language Quality

  • ALL spelling errors, grammar mistakes, punctuation issues with exact locations
  • Clichés, filler phrases, weak constructions

DIMENSION 5: TECHNICAL ON-PAGE SEO

Kyle Roof's PageOptimizer Pro (400+ controlled Google algorithm tests, US patent 10540263) shows on-page factors have a strict hierarchy. The grouping below is our synthesis of POP's published findings:

  • Group A (Critical): Meta title, body content, URL, H1
  • Group B (Important): H2, H3, H4, anchor text of internal links
  • Group C (Supporting): Bold, italic, image alt text
  • Group D (Minimal / none): Schema (SERP features only), meta description (CTR only)

Prioritize accordingly: a title tag fix is worth more than an alt text fix. Keyword position within the title (beginning / middle / end) does NOT matter per POP test data. Focus on inclusion and CTR appeal.

Title Tag

  • Primary keyword in first half?
  • Under 60 characters / 580px?
  • Creates a REASON TO CLICK?
  • How does it compare to the top 3 titles?

Meta Description

  • Written for CTR, not just keyword inclusion?
  • Under 140 characters?

Featured Snippets & AI Overviews

  • Paragraph definitions that could be pulled?
  • Numbered steps or comparison tables?
  • Structured so AI Overviews could cite specific sections?

Internal & External Links — HIGH IMPACT. SearchPilot split-tests consistently show 5-25% organic traffic uplifts from contextual internal link additions, with stronger effects for in-body contextual links than for footer or sidebar links.

  • Internal links with descriptive anchor text?
  • External links to authoritative primary sources?

Schema Markup

  • Appropriate structured data? (Article, FAQ, HowTo, Product)
  • Could nested schemas strengthen entity recognition?

DIMENSION 6: ENGAGEMENT, DISTRIBUTION & DISCOVERABILITY

Google Discover Readiness

  • Headline emotionally compelling for a non-search feed?
  • Hero image ≥1200px, original, visually striking?
  • Matches an active interest graph?

Social Shareability

  • Tweetable insights, stats, or quotes?
  • Open Graph tags configured?
  • Visual content for social?

Behavioral Signals

  • Will readers stay (dwell time) or pogo-stick back?
  • Does it encourage further engagement?
  • Mobile reading experience excellent?

DIMENSION 7: CONVERSION & BUSINESS IMPACT

Only score if the content has a conversion goal.

  • Value prop clear within 5 seconds?
  • Single, clear CTA?
  • Above the fold AND repeated logically?
  • Social proof near the conversion point?
  • Friction minimized?
  • Genuine urgency, not fabricated?

PHASE 3: OUTPUT

CONTENT IDENTITY (from Phase 0)

2-3 sentences on what this content is and whether its structure matches its goal.

COMPETITIVE POSITION (from Phase 1)

Where this content stands vs top results. The #1 thing competitors do better. The #1 gap this could exploit.

SCORECARD

DimensionScorePriority
1. Information Gain & Originality/10🔴🟡🟢
2. Semantic Depth & Topical Completeness/10🔴🟡🟢
3. E-E-A-T Signals/10🔴🟡🟢
4. Structure, Readability & Time-to-Value/10🔴🟡🟢
5. Technical On-Page SEO/10🔴🟡🟢
6. Engagement, Distribution & Discoverability/10🔴🟡🟢
7. Conversion & Business Impact/10🔴🟡🟢
TOTAL/70

DETAILED FINDINGS PER DIMENSION

For each: strengths (specific), problems (with exact locations), recommendations (actionable, non-obvious, with examples).

SEMANTIC GAP ANALYSIS

The specific entities, subtopics, predicates, and relationships missing from this content but present in top competitors. The content brief for what to add.

TOP 5 QUICK WINS

Five changes with highest impact-to-effort. Be specific — not "improve your meta description" but "change your title tag FROM '...' TO '...' because [reason]."

TOP 5 STRATEGIC IMPROVEMENTS

Five changes that require more work but create the biggest competitive advantage.

REWRITTEN ELEMENTS

  • Title tag (with character count)
  • Meta description (with character count)
  • H1 heading
  • Opening paragraph / hook (if it can be stronger)
  • Any section with factual errors

Quality Gate

  • Did I actually fetch and read the competitors, or just guess from SERP titles?
  • At least 3 specific semantic gaps from the competitive analysis?
  • Are recommendations things the author hasn't obviously considered?
  • Specific examples and rewrites, not abstract advice?
  • Would a senior content strategist find this valuable, or say "I already knew all this"?

Note on traffic weighting

Without GSC data, the audit can't say "this problem is urgent because this page gets 50k monthly impressions." If the user provides traffic context alongside the URL (impressions, position, CTR), weight the recommendations by actual impact. Otherwise, prioritize by apparent prominence (nav placement, depth from homepage, inbound links visible on the page) and by severity of the finding itself.

Bundled references

Load from references/ only when the step calls for them — don't preload the whole folder.

  • pop-test-hierarchy.md — the full POP test element hierarchy and how to weight fixes (Dimension 5, when prioritizing across title/H1/body/alt/schema)
  • eeat-scoring-rubric-compact.md — one-page scoring rubric for the 4 E-E-A-T dimensions (Dimension 3, for fast scoring during the audit)
  • semantic-entity-checklist.md — entity / predicate / EAV checklist for extracting what competitors have and this page doesn't (Phase 1B and Dimension 2)
  • content-types-audit-summary.md — content-type-specific audit criteria across all 23 types (Phase 0, after content identity is classified, for type-specific red flags)

Semantic Gap Analysis

Identifies the exact entities, subtopics, predicates, and relationships that are missing from your page but present in top-ranking competitors. This is the content brief for what to add — not a generic "write more depth" recommendation.

Google's NLP models (BERT, MUM, Gemini) build a semantic graph of your content. If you're missing nodes or edges that competitors have, your content reads as shallow to the algorithm. This skill finds the exact missing nodes.

Input

  • URL of your page (required)
  • Target keyword the page should rank for (required)

Role

You are a semantic SEO specialist in the tradition of Koray Tuğberk GÜBÜR. You think in entities, attributes, and relationships — not keywords.

Step 1: Read Your Page

Fetch the URL. Extract:

  • Main topic and sub-topics
  • All named entities (people, places, products, concepts, dates, organizations)
  • All predicates (verbs that signal the contextual depth — for "coffee brewing", verbs like grind, extract, bloom, tamp)
  • Internal structure: H2/H3 hierarchy
  • What the page explicitly covers and what it implicitly assumes

Step 2: Read the Top 3 Competitors

Google the target keyword. Fetch the top 3 results in full. If one won't fetch, take the next result down and say so — a gap list built on an inferred page is worthless. For each:

  • Extract entities, predicates, and structural elements the same way
  • Note what they cover that your page doesn't
  • Note the depth at which they discuss each entity (single mention vs. full section)

Step 3: Build the Semantic Inventory

Create three lists side by side:

Your page coversCompetitors cover but you don'tUnique to your page

Be specific. "Pricing models" is too generic. "Three-tier vs usage-based pricing with examples from Stripe and Twilio" is specific.

Step 4: Classify the Gaps

For each gap, classify its importance:

  • Core gap — all 3 competitors cover this, you don't. Critical to add.
  • Differentiator gap — 1-2 competitors cover this and it's working for them. Worth adding.
  • Commodity gap — everyone covers this superficially. Add briefly or skip.
  • Opportunity gap — competitors skip this, you could own it. Your angle.

Step 5: Map Entity Relationships

For the core gaps, identify the Entity-Attribute-Value (EAV) relationships that should exist:

  • Entity: what is it
  • Attribute: what properties does it have that matter
  • Value/Relation: how does it relate to other entities in this topic space

Example for "espresso machine reviews":

  • Entity: La Marzocco Linea Mini
  • Attribute: brew pressure, boiler type, price point
  • Relation: competes with Rocket Appartamento, used by third-wave cafes

This is what competitors are implicitly encoding when they write detailed sections — you need the same density.

Step 6: Output

Semantic Fingerprint

One sentence on what your page actually "talks about" to an NLP model, and what it should talk about.

Your Page

List of entities and predicates currently present.

Competitor Coverage

What each top 3 competitor covers that yours doesn't (specific sections, with brief notes on why they chose to include them).

Gap List

GapImportanceAdd to sectionDepth required

Importance: Core / Differentiator / Commodity / Opportunity. Section: where in your H2/H3 structure this belongs. Depth: Paragraph / subsection / full section.

Entity Relationships to Encode

The EAV triples that should appear in your page, even if just in passing. These are the signals that tell Google "this content understands the topic space."

Unique Angle to Preserve

What your page does well that competitors don't. Don't lose this when adding depth.

Content Addition Plan

Specific sections to add or expand, in order of priority. Each with: section heading, 2-3 sentence description of what goes in it, estimated word count.

What to Ignore

  • Keyword density for related terms — don't force. Semantic relevance is about covering the entities, not repeating the keyword variants.
  • Fluff additions — every section you add should carry actual information. Padding defeats the purpose.
  • Wikipedia-style completeness — you don't need to cover everything. You need to cover enough that an NLP model recognizes the topic depth.

Next Step

Turn the content addition plan into an actual rewrite: use the improve-content skill with your page URL as input, and paste the gap list as context.

Bundled references

Load from references/ only when the step calls for them.

  • eav-triple-worked-examples.md — full Entity-Attribute-Value examples across 6 niches for Step 5 (when the EAV framework feels abstract and you need concrete analogues)
  • predicate-verb-fields.md — domain-specific verb fields that signal contextual depth to NLP models (Step 3, when extracting predicates from competitor pages)
  • gap-classification-rubric.md — detailed scoring for Core / Differentiator / Commodity / Opportunity gaps (Step 4, when classification is ambiguous)
  • topic-cluster-strategy.md — how the gap list feeds into cluster architecture (optional, when the gaps reveal missing spokes rather than in-page sections)

Topic Cluster Planning

Builds a hub-and-spoke architecture for a new content area. Hub = a broad pillar page that owns the topic. Spokes = specific articles that target long-tail keywords and link up to the hub. Done right, this signals topical authority to Google and concentrates link equity on the pages that matter.

Input

Seed topic or broad keyword (required). Example: "email marketing", "keto diet", "small business accounting".

Optionally: your domain, so the agent can check what you've already published in this space.

Role

You are a senior SEO content strategist specializing in topical authority architecture. You think in clusters, not individual articles.

Step 1: Research the Topic Space

Google the seed topic. Read:

  • The top 10 results for the broad keyword
  • The People Also Ask questions
  • The "Searches related to" at the bottom of the SERP
  • 2-3 major publications in the space to see how they structure their content

Note:

  • Who dominates the broad keyword? (This tells you the difficulty level.)
  • What sub-topics emerge from PAA and related searches?
  • What specific questions do people ask?

Use only PAA questions and related searches you actually saw — don't pad the spoke list with invented queries. If the SERP shows few, say so and lean harder on competitor coverage.

Step 2: Identify the Hub

The hub is the one page that deserves to own the broad topic. It should:

  • Target the broad/seed keyword directly
  • Cover the topic comprehensively at a high level (don't go deep on every sub-topic)
  • Link out to all the spoke articles

Hub content type options:

  • Ultimate guide ("The Complete Guide to X") — best for broad informational topics
  • Pillar + chapters (pillar page with a TOC linking to deep-dive chapters) — best for very broad topics with clear sub-chapters
  • Category page with curated featured content — best for product/service topics

State your recommended hub format with reasoning.

Step 3: Map the Spokes

From the PAA questions, related searches, and competitor coverage, identify 8-15 specific spoke topics. Each spoke should:

  • Target a long-tail keyword or specific question
  • Go deeper on one narrow sub-topic than the hub can
  • Link back to the hub (primary)
  • Link to 2-3 related spokes

For each spoke, specify:

  • Target keyword / question it answers
  • Content type (how-to / definition / comparison / case study / listicle)
  • Approximate word count
  • Why it matters for the cluster (what sub-topic does it own?)

Rule of thumb: a spoke should answer a question the hub can only summarize.

Step 4: Map the Internal Linking

Draw the link graph:

  • Every spoke links to the hub with a keyword-rich anchor
  • Hub links to every spoke (usually in a "In this guide" TOC or a "Related deep dives" section)
  • Related spokes link to each other (but sparingly — don't over-link)
  • External links from the hub to 3-5 authoritative sources in the space

Critical: the first link from any spoke TO the hub is what Google's algorithm weights most heavily. Make sure it's contextual (within the article body), with a descriptive anchor text.

Step 5: Publishing Order

Don't publish the hub first. Publish 3-4 high-quality spokes first, then the hub with links to them. Then publish the remaining spokes, each linking back to the now-established hub.

This prevents the hub from launching as a link-less orphan that has nothing to point to.

Step 6: Output

Cluster Overview

  • Seed topic | Estimated difficulty (Easy / Moderate / Hard) based on SERP competition
  • Realistic timeline to build out (how many articles, how many months)

Hub

  • Recommended format (Ultimate guide / Pillar + chapters / Category)
  • Target keyword (the broad seed)
  • Main H2 sections (roughly 5-10)
  • Approximate word count
  • What the hub should NOT cover in depth (save that for spokes)

Spoke List

#Spoke TopicTarget KeywordContent TypeWordsHub Anchor Text

8-15 rows. Sorted by priority: highest-impact/easiest-to-rank first.

Publishing Sequence

  1. Month 1: 3-4 spokes (pick from rows 1-4)
  2. Month 2: Publish the hub, link it to the published spokes
  3. Month 3-4: Remaining spokes, each linking back to the hub

Internal Link Map

A simple list showing which spokes link to which other spokes. Not every spoke needs to link to every other — just the naturally related ones.

External Linking Strategy

3-5 authoritative external sources the hub should cite. (Not competitors — actual authoritative sources: research papers, industry standards, government/university resources, or the primary creators of the concepts you're discussing.)

Success Metrics

  • Month 3: Hub should rank somewhere in top 50 for the seed keyword
  • Month 6: At least 2-3 spokes ranking in top 20 for their long-tail keywords
  • Month 9: Hub ranking top 20, cluster driving consistent organic traffic
  • Month 12: Cluster becomes a topical authority signal for the whole domain

What to Ignore

  • Publishing everything at once — Google needs time to see the cluster form. Spread it over 3-4 months.
  • Over-linking between spokes — if it doesn't feel natural in the article, skip it
  • Keyword density in the hub — the hub is about breadth, not keyword stuffing

Next Step

For each spoke, use content-brief with the spoke's target keyword to produce a writer-ready brief. Then write-content to write the article.

Bundled references

Load from references/ only when the step calls for them.

  • first-link-weight-evidence.md — the evidence behind "the first link in the body is weighted most heavily" and why it matters for spoke → hub linking (Step 4, when briefing the writer on anchor placement)
  • publishing-sequence-decisions.md — the full decision framework for "don't publish the hub first" and the exceptions (Step 5, when the user pushes back on the staggered launch)
  • spoke-selection-worked-example.md — a full cluster worked end-to-end (seed → hub → 12 spokes → link map) for a sample niche, to anchor Step 3 when spoke selection feels arbitrary
  • topic-cluster-strategy.md — the theory behind hub-and-spoke architecture and topical authority signals (background, optional)
  • pillar-page-template.md — exact H1/H2 structure for the hub page (Step 2, after the hub format is chosen)

Write Content

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.

Input

  • Topic or target keyword (required)
  • (Optional) An existing content brief — skip the research phase if provided
  • (Optional) Expert interview output from the expert-interview skill

If no topic is given, ask for one before proceeding.

Business context persistence

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 Code: ~/.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.
  • Claude Desktop / Claude.ai: save to a Project's context or a pinned note.
  • Cursor: .cursor/rules/business-context.md.
  • Any other agent: 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:

  • What does the business do, and who is it for?
  • What's the brand's tone of voice? (Professional / Casual / Technical / Authoritative / Conversational)
  • What language should content be written in?
  • What topics should NEVER appear? (compliance, competitor mentions, etc.)
  • Who are the 2-3 main competitors?

Phase 1: Research

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.

Phase 2: Content Type Decision

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. If the user already asked for the article in one go, or there's nobody to respond (autonomous run), state your choice with a one-line reason and keep going.

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.

Phase 3: Knowledge Extraction

Ask 2-3 quick questions to extract unique knowledge the user has. Pick from:

  • "What do most people get wrong about [topic]?"
  • "Can you give me a specific example — a client, a project, a number?"
  • "What surprised you when you actually did this?"
  • "Who should NOT follow this advice, and why?"

Ask one at a time. Keep it quick.

If the user can't or won't answer — autonomous run, or they skip the questions — write from Phase 1 research alone and note in the delivery where first-party input would lift the article.

Adapt style:

  • Newer/smaller site, less SEO-savvy user: conversational, explain why each question matters
  • Established site, experienced user: fast, direct, no hand-holding

Phase 4: Write the Article

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:

Voice and Stance

  • Write like a practitioner talking to a peer. Not a textbook, not a press release.
  • Take clear positions. "We tested this and X works better than Y" beats "both X and Y have merits."
  • Use "you" and "I/we" — write to one person, not an audience.
  • Include specific numbers, names, dates. Never "many companies" — always "[Company] in [year]."
  • Specifics must be real: pulled from the Phase 1 research, the interview answers, or the business context. Never invent a number, name, study, or citation — an invented specific is worse than a generic sentence. No real one available? Ask, or cut the claim.
  • Weave in interview answers as first-person experience. Preserve phrasing where it sounds natural.
  • Use contractions: "doesn't" not "does not."
  • Show thinking changing: "At first I thought this was a branding problem — turns out it was pricing all along." Self-correction is a human signal.
  • Anchor in real context — reference current events, industry shifts, or cultural touchstones where relevant.

Rhythm and Structure

  • Vary sentence length dramatically. Mix 5-word punches with 30-word complexes. Never 3+ consecutive sentences of similar length.
  • Vary paragraph length. One-sentence paragraphs are fine. So are 6-sentence ones.
  • Use fragments for emphasis. Start sentences with "And" or "But" when natural.
  • Include parenthetical asides and brief tangents — humans do this, AI doesn't.
  • Shift registers. After a technical explanation, drop into a casual aside. Uniform register = AI tell.
  • Break the topic-sentence-support pattern. Start some paragraphs with an example, a question, or a statement that only makes sense after reading on.
  • Cover sections asymmetrically. Spend 500 words on the interesting part and 50 on the boring-but-necessary one.
  • Don't summarize at the end of sections unless genuinely complex (3+ subsections).

Show, Don't Just State

  • Don't state facts. Show them through brief scenarios. Instead of "page speed affects rankings" — "You click a search result. Three seconds pass. Still loading. You hit back. Google tracked every millisecond."
  • For claims backed by experience, narrate the moment: what was tried, what happened, what surprised you.

Anti-Slop 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:

  • Rule-of-three groupings (use 2 or 4 items instead)
  • Synonym cycling (repeat the right word rather than finding alternatives)
  • Copula avoidance ("serves as" — just say "is")
  • Em-dash chains (max 1-2 per 1000 words)
  • Binary contrasts ("it's not X, it's Y" — just make the argument)
  • Participial tack-ons ("...highlighting the importance of X" — delete or make a separate sentence)
  • Clustering of: however, notably, essentially, that said, arguably — fine individually, but 3+ in one article flags AI

Content Type Structure

  • How-to: 40-60 word quick answer first (featured snippet target), then numbered steps, each step = one action with "what goes wrong"
  • Comparison: Verdict first ("Choose A if... Choose B if..."), then detailed analysis
  • Listicle: Summary table above fold, consistent evaluation framework per item
  • Definition: "[Term] is..." in the first sentence, no preamble
  • Case study: Lead with the result number, then the story (PAS framework)
  • Pillar page: Table of contents, overview, then link to deep-dive articles
  • Service/landing page: PAS framework. Pain point first, agitate consequences, then solution

SEO Structure

  • Primary keyword in meta title, H1, first 100 words, 2-3 H2s. ~2% body density, naturally distributed.
  • Place a 40-60 word direct answer immediately after the most important H2 — targets featured snippets. "How" queries get ordered lists, "what is" gets paragraphs, comparisons get tables.
  • Weave 2-3 PAA questions into the article as H2/H3 headings with direct answers.
  • Include 3-5 internal links per 1,000 words. Use descriptive anchor text — never "click here."
  • Front-load value. The first screen is the highest-value real estate. No preamble paragraphs.

Long Article Strategy (1,500+ words)

  • Write section by section. Track what you've covered to prevent repetition and voice drift.
  • At least 30% of the article must contain details no generic AI could produce: the user's data, examples, opinions, experience.

Final Checks

  1. "So What?" test: For each major section — could anyone have written this, for anyone, about anything? If yes, inject specific knowledge.
  2. Self-check: Scan for blacklisted words, sections where every paragraph starts with a topic sentence, unnecessary section summaries, participial tack-ons. Fix before delivering.

Output

Clean markdown. Title + article content. Nothing else.

Language

Write in the language from the business context. If not specified, match the language of the user's messages.

Bundled references

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:

  • Common: how-to.md, definition.md, comparison.md, listicle.md, pillar-page.md, faq-page.md, landing-page.md, service-page.md, case-study.md
  • Content and news: statistics-page.md, news-article.md, glossary-page.md
  • Commercial: alternatives-page.md, buying-guide.md, product-page.md, category-page.md, integration-page.md, location-page.md, programmatic-page.md
  • references/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 section
  • structured-data-snippets.md — JSON-LD and featured snippet formatting per content type
  • geo-optimization.md — optimizing for AI Overview / generative engine citation
  • navboost-engagement.md — engagement signal writing (dwell time, scroll depth)
  • quality-scoring.md — self-scoring rubric to run before delivery
  • writing-pipeline.md — the research → draft → edit loop
  • seo-optimization-layer.md — keyword placement, internal linking, metadata pass
  • fact-checking.md — how to verify every specific number and claim
  • human-input-framework.md — the knowledge-extraction questions (reinforces Phase 3)

Sponsors

Details

Marketplace
inhouseseo/superseo-skills
Category
Seo