Skip to content
seo-sxo logo

Search Experience Optimization (SXO)

seo-sxo

Search Experience Optimization: reads Google SERPs backwards to detect page-type mismatches, derives user stories from search intent signals, and scores pages from multiple persona perspectives. Identifies why well-optimized pages fail to rank by analyzing what Google rewards for each keyword. Us...

SKILL.md

Full skill instructions

Search Experience Optimization (SXO)

SXO bridges the gap between SEO (what Google rewards) and UX (what users need). Traditional SEO audits check technical health. SXO asks: "Does this page deserve to rank for this keyword based on what Google is actually rewarding in the SERP?"

Core Insight

A page can score 95/​100 on technical SEO and still fail to rank because it is the wrong page type for the keyword. If Google shows 8 product pages and 2 comparison pages for your keyword, your blog post will never break through -- no matter how well-optimized it is.

Commands

CommandPurpose
/​seo sxo <url>Full SXO analysis (auto-detect keyword from page)
/​seo sxo <url> <keyword>Full SXO analysis for a specific keyword
/​seo sxo wireframe <url>Generate IST/​SOLL wireframe with concrete placeholders
/​seo sxo personas <url>Persona-only scoring (skip SERP analysis)

Execution Pipeline

Step 1: Target Acquisition

  1. Fetch the target URL via scripts/​render_page.py --mode auto (SPA-aware and SSRF-safe)
  2. Parse with scripts/​parse_html.py to extract: title, H1, meta description, headings hierarchy, word count, schema markup, CTAs, media elements
  3. If no keyword provided, extract primary keyword from title tag + H1 overlap
  4. Validate keyword is non-empty before proceeding

Step 2: SERP Backwards Analysis

Read references/​page-type-taxonomy.md for classification rules.

  1. Search Google for the target keyword (WebSearch)
  2. For each of the top 10 organic results, record:
    • URL and domain authority tier (brand / niche authority / unknown)
    • Page type (classify using taxonomy)
    • Content format (long-form, listicle, how-to, comparison, tool, video)
    • Word count estimate (from snippet length and page structure)
    • Schema types present (from SERP features: ratings, FAQ, HowTo)
    • Media signals (video carousel, image pack, thumbnail presence)
  3. Record SERP features present:
    • Featured snippet (paragraph / list / table / video)
    • People Also Ask (extract all visible questions)
    • Ads (top and bottom -- count and analyze ad copy themes)
    • Related searches (extract all)
    • Knowledge panel / local pack / shopping results
    • AI Overview presence and source types
  4. Calculate SERP consensus:
    • Dominant page type (>60% = strong consensus, 40-60% = mixed, <40% = fragmented)
    • Content depth expectations (average word count tier)
    • Schema expectation (most common structured data types)
    • Media expectations (video required? images critical?)

Step 3: Page-Type Mismatch Detection

This is the core SXO insight. Compare target page type against SERP consensus.

Mismatch severity levels:

Target TypeSERP ExpectsSeverityRecommendation
Blog PostProduct PagesCRITICALCreate dedicated product page
Blog PostComparisonHIGHRestructure as comparison with matrix
ProductInformationalHIGHAdd educational content layer
Landing PageTool/​CalculatorHIGHBuild interactive tool component
Service PageLocal ResultsMEDIUMAdd location signals + local schema
Any type match-ALIGNEDFocus on content depth and UX

Classification rules:

  • Classify target page using references/​page-type-taxonomy.md
  • Classify each SERP result using the same taxonomy
  • Flag mismatch if target type differs from SERP dominant type
  • If SERP is fragmented (no dominant type), note opportunity for differentiation

Step 4: User Story Derivation

Read references/​user-story-framework.md for the full framework.

From SERP signals, derive user stories:

  1. PAA questions reveal knowledge gaps and concerns
  2. Ad copy themes reveal commercial triggers and value propositions
  3. Related searches reveal the search journey (what comes before/​after)
  4. Featured snippet format reveals the expected answer structure
  5. AI Overview reveals what Google considers the definitive answer

For each signal cluster, generate a user story:

As a [persona derived from signal],
I want to [goal derived from query intent],
because [emotional driver from ad copy / PAA tone],
but I'm blocked by [barrier derived from PAA questions / related searches].

Generate 3-5 user stories covering the primary intent angles.

Step 5: Gap Analysis

Compare the target page against SERP expectations across 7 dimensions:

DimensionWhat to CompareScore
Page TypeTarget type vs SERP dominant type0-15
Content DepthWord count, heading depth, topic coverage0-15
UX SignalsCTA clarity, above-fold content, mobile layout0-15
Schema MarkupPresent vs expected structured data types0-15
Media RichnessImages, video, interactive elements vs SERP norm0-15
Authority SignalsE-E-A-T markers, social proof, credentials0-15
FreshnessLast updated, date signals, content recency0-10

Total: 0-100 SXO Gap Score (lower = larger gap, higher = better alignment)

Step 6: Persona-Based Scoring

Read references/​persona-scoring.md for methodology.

  1. Derive 4-7 personas from SERP intent signals:
    • Cluster PAA questions by theme
    • Segment ad copy by target audience
    • Map related searches to journey stages
  2. For each persona, score the target page on 4 dimensions (25 pts each):
    • Relevance: Does the page address this persona's need?
    • Clarity: Can this persona find their answer within 10 seconds?
    • Trust: Are there adequate trust signals for this persona?
    • Action: Is there a clear next step for this persona?
  3. Output persona cards with scores and specific improvement recommendations
  4. Sort recommendations by weakest persona first (biggest opportunity)

Step 7: Wireframe Generation (Optional)

Only execute when /​seo sxo wireframe is invoked.

Read references/​wireframe-templates.md for templates.

  1. Generate IST (current state) wireframe from parsed page structure
  2. Generate SOLL (target state) wireframe based on:
    • SERP consensus page type
    • Gap analysis findings
    • Persona scoring weaknesses
  3. Use ultra-concrete placeholders:
    • NOT: "Add a CTA here"
    • YES: "Add pricing CTA with annual savings badge below hero, linking to /​pricing#enterprise"
  4. Output as semantic HTML section outline with annotations

DataForSEO Integration

If DataForSEO MCP tools are available:

  1. Before any API call, run cost estimate and confirm with user
  2. Use google_organic_serp for precise SERP data (positions, features, snippets)
  3. Use keyword_data for search volume and competition metrics
  4. Fall back to WebSearch if DataForSEO unavailable -- note reduced precision in output

SXO Score vs SEO Health Score

The SXO score is separate from the main SEO Health Score.

  • SEO Health Score = technical compliance (crawlability, speed, schema, etc.)
  • SXO Gap Score = alignment between page and SERP expectations
  • A page can score 95 SEO + 30 SXO = technically perfect but strategically misaligned
  • Both scores should be reported together when both are available

Cross-Skill References

FindingHand Off To
E-E-A-T gaps in persona scoring/​seo content for deep E-E-A-T audit
Missing schema types/​seo schema for generation
Local intent detected in SERP/​seo local for GBP analysis
Content depth gaps/​seo page for deep page analysis
Technical issues found during fetch/​seo technical for full audit
Image/​media gaps/​seo images for optimization

Output Format

Full SXO Analysis

## SXO Analysis: [URL]
### Target Keyword: [keyword]

### 1. SERP Landscape
- Dominant page type: [type] ([confidence]% consensus)
- SERP features: [list]
- Content depth norm: [word count range]
- Schema expectation: [types]

### 2. Page-Type Alignment
- Your page type: [type]
- SERP expects: [type]
- Verdict: [ALIGNED | MISMATCH (severity)]
- Impact: [explanation]

### 3. User Stories (derived from SERP signals)
[3-5 user stories with source signals]

### 4. Gap Analysis (SXO Score: XX/​100)
[7-dimension breakdown table]

### 5. Persona Scores
[4-7 persona cards with 4-dimension scores]

### 6. Priority Actions
[Ranked list: fix mismatch first, then weakest persona gaps]

### 7. Limitations
[What could not be assessed, data source notes]

Error Handling

ErrorAction
URL fetch failsReport error, suggest checking URL accessibility
No keyword provided or detectedAsk user to provide target keyword
WebSearch returns <5 resultsProceed with available data, note limited sample
SERP has no organic results (all ads)Note highly commercial SERP, analyze ad copy only
Target page is JavaScript-renderedNote limitation, use available HTML content
DataForSEO cost exceeds thresholdFall back to WebSearch, notify user

Quality Checklist

Before delivering results, verify:

  • Target URL was fetched via scripts/​render_page.py --mode auto (not raw curl/​fetch)
  • Page type classification uses taxonomy from references
  • At least 5 SERP results were analyzed
  • User stories cite specific SERP signals as evidence
  • Persona scores include concrete improvement suggestions
  • SXO score is clearly labeled as separate from SEO Health Score
  • Limitations section is present and honest
  • Cross-skill recommendations are included where relevant

More skills from gabrielmoreira

workflow-router logo
gabrielmoreira/agent-skills-mirror

workflow-router

研发工作流入口 - 帮助用户快速进入正确的工作流阶段。 触发关键词: 工作流, 流程, 从哪开始, 帮我, 我该怎么做, 下一步, workflow, 不知道用什么, 新手引导, 怎么用

19 0
View
平台架构知识 logo
gabrielmoreira/agent-skills-mirror

平台架构知识

Periodically refreshed mirror of agents, skills, prompts and instruction files from public repositories.

19 0
View
unity-profiler logo
gabrielmoreira/agent-skills-mirror

unity-profiler

Read-only Unity runtime performance snapshots — FPS, frame time, batches/draw calls, triangles/vertices, memory (total/mono/per-asset), object counts, AssetBundle stats. Exact signatures via GET /skills/schema.

19 0
View
ads-audit logo
gabrielmoreira/agent-skills-mirror

ads-audit

Full multi-platform paid advertising audit with parallel subagent delegation. Analyzes Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, and Apple Ads accounts via 6 parallel audit agents. Amazon Ads, cross-platform attribution, and server-side tracking are covered by their standalon...

19 0
View
unity-skills logo
gabrielmoreira/agent-skills-mirror

unity-skills

Unity Editor automation via REST API — create scripts, analyze scenes, manage assets, control editor, orchestrate workflows, run batch jobs, and route by Unity version. Triggers: Unity, Unity Skills, in Unity, automate Unity, Unity editor automation, create Unity script, scene summary, analyze Un...

19 0
View
purple-cow-audit logo
gabrielmoreira/agent-skills-mirror

purple-cow-audit

Score product remarkability 1-10 to decide if it's worth promoting. Seth Godin's Purple Cow test. Triggers on: "is this product worth promoting", "should I promote", "product audit", "purple cow", "remarkable product", "is it remarkable", "rate this product", "product quality check", "worth my re...

19 0
View
unity-cleaner logo
gabrielmoreira/agent-skills-mirror

unity-cleaner

Project cleanup and audit — find unused assets, content-hash duplicates, missing references, empty folders, large assets, dependency trees; two-step confirm-token delete. Exact signatures via GET /skills/schema.

19 0
View
skill-manager-guide logo
gabrielmoreira/agent-skills-mirror

skill-manager-guide

**GUIDE SKILL** — Guide to the Skill Manager for Copilot extension. USE FOR: adding/removing skill repos, syncing skills, pushing feedback, configuring sync intervals, troubleshooting sync issues, understanding skill format. DO NOT USE FOR: creating new skills (use skill-creator), creating agents...

19 0
View
configure-nightwatch logo
gabrielmoreira/agent-skills-mirror

configure-nightwatch

Configures Laravel Nightwatch data collection, sampling rates, filtering rules, and redaction policies. Use when setting up Nightwatch, managing data volume, protecting sensitive data (PII), or optimizing event collection for production workloads.

19 0
View
research-and-write logo
gabrielmoreira/agent-skills-mirror

research-and-write

End-to-end workflow: research a topic and then write a LinkedIn post about it. Use this skill whenever the user wants the full pipeline — from a topic idea to a finished LinkedIn post. Triggers on: 'research and write a post about', 'create a LinkedIn post about [topic]', 'I want to post about', ...

19 0
View
AI Tutor Persona logo
gabrielmoreira/agent-skills-mirror

AI Tutor Persona

Periodically refreshed mirror of agents, skills, prompts and instruction files from public repositories.

19 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View