Writing & Content

SXO Search Experience Optimization

Reverse-engineer Google SERPs to find page-type and search-intent mismatches behind weak rankings, then turn the findings into actionable UX improvements.

51/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Claude Code
Stars
★ 19k
Last updated
23d ago
License
MIT
search-experience-optimizationserp-analysissearch-intentpersona-scoring
+3wireframe-generationpage-type-mismatchtechnical-seo

What does this skill do, and when should you use it?

This is the individual SXO skill inside the claude-seo repository, focused on Search Experience Optimization rather than a complete technical SEO audit. It fetches and parses a target page, analyzes Google results for a keyword, checks whether the page type matches the SERP consensus, and evaluates the page through user-story and persona lenses. Its output covers the SERP landscape, page-type alignment, derived user stories, a seven-dimension gap score, persona scores, and prioritized actions. It is a good fit for teams whose pages are technically sound but still fail to rank.

It fetches the target URL with scripts/render_page.py in automatic mode and uses scripts/parse_html.py to extract the title, H1, meta description, heading hierarchy, word count, structured data, CTAs, and media elements. If no keyword is supplied, it derives a primary keyword from title/H1 overlap. It then uses WebSearch to analyze up to 10 organic results and SERP features, including page type, content format, authority tier, schema, media signals, People Also Ask, ads, related searches, local packs, shopping results, and AI Overviews. Using page-type classification rules, it detects mismatches, derives 3-5 user stories from SERP signals, and calculates a 0-100 SXO Gap Score across page type, content depth, UX, schema, media richness, authority signals, and freshness. It also derives 4-7 personas and scores relevance, clarity, trust, and action; the wireframe mode produces IST/SOLL semantic HTML outlines with concrete placeholders.

Good fit
  • An SEO consultant investigates a page with strong technical metrics but persistently weak rankings and tests whether the page type conflicts with the SERP.
  • A content team is restructuring a page for a target keyword and uses PAA, ad copy, and related searches to define user stories and content requirements.
  • A product or growth team is improving a landing page and uses persona scoring to identify concrete clarity, trust, or CTA gaps.
  • An SEO and UX team needs an implementation-oriented redesign brief and uses wireframe mode to produce current-state and target-state page outlines.

How do you install this skill?

Before you use it
  • Core analysis depends on Google/WebSearch, target-URL fetching, and optionally DataForSEO; network reachability, anti-bot controls, and regional differences may produce incomplete results.
  • The skill requires at least five SERP results but does not define result snapshots, locale, language, device, or timestamp, limiting reproducibility.
  • The skill does not clearly specify retention, redaction, or lifecycle handling for sensitive page content, queries, or third-party API data.
  • README-level testing and security claims are repository context and do not establish that seo-sxo key outputs were tested.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
  • MCP Server
Install first
  • Python 3.10+
  • Playwright Chromium

The skill is located at skills/seo-sxo/SKILL.md in the repository. The README documents collection-level installation in Claude Code: run /plugin marketplace add AgriciDaniel/claude-seo, then /plugin install claude-seo@agricidaniel-claude-seo; alternatively, run git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git followed by bash claude-seo/install.sh. The README does not document a separate installation procedure for only the seo-sxo directory. The repository states Python 3.10+ is required, and Playwright Chromium can be used for SPA rendering.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/seo-sxo" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

In Claude Code, run /seo sxo <url> for a full SXO analysis, or /seo sxo <url> <keyword> with a specific keyword. Use /seo sxo wireframe <url> for an IST/SOLL wireframe, or /seo sxo personas <url> for persona-only scoring. If no keyword is supplied and none can be extracted, the skill asks for a target keyword. DataForSEO is optional: when its MCP tools are available, the skill requires a cost estimate and user confirmation before API calls; otherwise it uses WebSearch and notes the reduced precision.

What are this skill's strengths and limitations?

Pros
  • Targets page-type and search-intent alignment issues that ordinary technical SEO checks can miss.
  • Turns PAA questions, ad themes, related searches, and AI Overview signals into user stories and recommendations.
  • Provides a distinct SXO Gap Score and explicitly separates it from an SEO Health Score.
  • Offers persona-level relevance, clarity, trust, and action scoring with concrete improvement suggestions.
Limitations
  • It depends on an accessible target URL, page fetching, and WebSearch; failed fetching or a small SERP sample limits the analysis.
  • Pages with scroll-triggered hydration, interaction-loaded content, or race-prone third-party widgets may produce noisy findings.
  • DataForSEO, Firecrawl, and Banana are optional extensions of the broader repository and should not be attributed to this skill as default capabilities.
  • The SKILL.md uses Claude Code-style /seo commands, so its trigger and tool integration require adaptation in other clients.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
SXO Search Experience Optimization this page 51 · Use with care ★ 19k 23d ago MIT
SERP Analysis 56 · Use with care ★ 3k 14d ago Apache-2.0
Blog Keyword Conflict Detector 43 · Not recommended ★ 2.4k 14d ago MIT
SEO Content Brief Generator 52 · Use with care ★ 19k 23d ago MIT
SEOBuild Onpage (SEO-AGI) 50 · Use with care ★ 257 12d ago —

Unlike a technical SEO audit that primarily checks crawlability, performance, and structured data, this skill focuses on whether a page matches the dominant SERP page type, content format, and user needs for a keyword. It is also narrower than tools such as Screaming Frog or Ahrefs Site Audit: its scope is single-page SERP reverse analysis, user-story derivation, persona scoring, and wireframe guidance.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
51/ 100 5-point scale 2.6 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust14 / 25 · 2.8/5

The skill requires SSRF-safe rendering, user confirmation before DataForSEO calls, and explicit limitation reporting, showing some awareness of permissions and external effects. It does not fully disclose page-data flows, third-party search-data handling, credential isolation, rollback, or source attribution within the skill itself, so points are deducted.

2Reliability8 / 20 · 2.0/5

The pipeline, classification rules, error handling, and quality checklist are fairly detailed, and the skill references supporting scripts and documents. However, this is a static review with no execution of key paths; script parameters, WebSearch availability, and revision-level reproducibility of all referenced files cannot be confirmed, so the score stays below the static ceiling.

3Adaptability10 / 15 · 3.3/5

Trigger phrases, required URL/keyword inputs, command variants, and output structure are clear across SERP analysis, user stories, personas, and wireframes. Non-fit boundaries, Chinese-language support, and reachability of the Google/WebSearch-dependent core for mainland-China users are not adequately specified, so points are deducted.

4Convention10 / 15 · 3.3/5

The skill has front matter, MIT licensing, a version, layered reference documents, command documentation, output examples, error handling, and limitations guidance. It lacks skill-specific installation notes, FAQs, changelog details, explicit maintenance responsibility, and an update path; some governance evidence exists only at repository level, so points are deducted.

5Effectiveness6 / 15 · 2.0/5

The intended output converts live SERP signals into page-type judgments, gap analysis, persona scoring, and concrete wireframes, which could directly support SEO decisions. The core results depend on live fetching and search, while the supplied materials provide no verifiable key-path output evidence for this skill, so the static ceiling requires a conservative deduction.

6Verifiability3 / 10 · 1.5/5

The taxonomy, scoring method, and signal sources are documented and auditable, and the README claims tests and primary-source alignment. The supplied evidence does not show seo-sxo-specific test results, independent review, or reproducible key-path examples; SERP observations also cannot be independently verified from static files, so points are deducted.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 6cf1ea9fe4c2 Review evidence[1][2][3][4][5][6][7][8][9][10][11][12][13][14][15]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does it automatically change the website?
No. The SKILL.md specifies analysis, scoring, prioritized actions, and optional wireframes; it does not promise direct website edits.
Do I have to provide a keyword?
Not always. The skill first attempts to extract one from title/H1 overlap. If the result is empty or cannot be validated, it asks for a target keyword.
Is a DataForSEO account required?
No. DataForSEO is an optional enrichment. Without it, the skill uses WebSearch and reports the lower precision of that data source.
What problem is it best suited for?
It is best suited to pages that are technically optimized but fail to rank, pages that may target the wrong page type, or redesign projects driven by SERP evidence.

More skills from this repository

All from AgriciDaniel/claude-seo

Writing & Content

SEO Content Brief Generator

Builds actionable SEO content briefs from competitor results and the target website’s real structure.

★ 19k FS 52 Use with care 23d ago
Writing & Content

DataForSEO Live SEO Intelligence

Query live search, keyword, backlink, page, listing, and AI-visibility data through the DataForSEO MCP server.

★ 19k FS 47 Use with care 23d ago
Writing & Content

FLOW Evidence-Led SEO

Apply structured FLOW prompts to guide evidence-led SEO research, optimization, conversion, and local analysis.

★ 19k FS 47 Use with care 23d ago
Writing & Content

AI Search & GEO Optimizer

Audits a page’s citability and visibility readiness across Google AI Overviews, ChatGPT, Perplexity, and related AI search surfaces.

★ 19k FS 52 Use with care 23d ago
Writing & Content

Single-Page SEO Inspector

Audits one URL across on-page SEO, content quality, technical metadata, schema, images, and performance signals.

★ 19k FS 51 Use with care 23d ago
Writing & Content

Bing Visibility & IndexNow

Bring Bing indexing, link intelligence, and IndexNow URL submission into a first-class SEO workflow.

★ 19k FS 48 Use with care 23d ago
Writing & Content

Backlink Profile Analyzer

Audit link profiles, anchor text, toxic links, and competitor gaps with source-aware SEO reporting.

★ 19k FS 47 Use with care 23d ago
Writing & Content

Claude SEO Site Analysis

Run parallel, testable audits of a website’s technical, content, and AI-search performance.

★ 19k FS 46 Use with care 23d ago
Writing & Content

SE Ranking AI Visibility Analyst

Track brand visibility across five AI search platforms from one query.

★ 19k FS 40 Not recommended 23d ago
Writing & Content

Full-Site SEO Audit

Crawl a website and turn SEO signals into a scored, prioritized action plan.

★ 19k FS 53 Use with care 23d ago
Writing & Content

Schema Markup Assistant

Detect, validate, and generate SEO-ready Schema.org structured data.

★ 19k FS 52 Use with care 23d ago
Writing & Content

International SEO Hreflang Auditor

Audit and generate correct hreflang implementations for multilingual and multi-region websites.

★ 19k FS 51 Use with care 23d ago
Writing & Content

Unlighthouse Site Audit

Run local Lighthouse audits across many site URLs and aggregate performance, accessibility, best-practices, and SEO results.

★ 19k FS 51 Use with care 23d ago
Writing & Content

Sitemap Inspector & Builder

Analyze or generate valid XML sitemaps and uncover URL, structure, and indexing risks.

★ 19k FS 50 Use with care 23d ago
Writing & Content

SERP Semantic Topic Clustering

Turns Google SERP overlap into actionable keyword clusters, content architecture, and internal-link plans.

★ 19k FS 49 Use with care 23d ago
Writing & Content

Technical SEO Auditor

Audit a website’s technical SEO foundations and produce a prioritized, actionable remediation report.

★ 19k FS 49 Use with care 23d ago
Writing & Content

Programmatic SEO Planner

Plan and audit data-driven pages at scale while controlling thin content, duplication, and index bloat.

★ 19k FS 47 Use with care 23d ago
Writing & Content

Competitor Comparison Page Builder

Create search-focused competitor comparison and alternatives pages with verifiable data and conversion-ready structure.

★ 19k FS 47 Use with care 23d ago
Writing & Content

Maps Intelligence for Local SEO

Diagnose local visibility through map rankings, business profiles, reviews, competitors, and cross-platform listing consistency.

★ 19k FS 54 Use with care 23d ago
Writing & Content

SEO Content Quality Audit

Audits content quality, E-E-A-T, and readiness for AI citation.

★ 19k FS 52 Use with care 23d ago

Related skills