Skills

SEO Sxo

Diagnose search-experience and intent mismatches using SERP page types, user stories...

Install

npx skills add AgriciDaniel/claude-seo --skill seo-sxo -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
MIT
Context cost
Mediumabout 2,532 tokens
Runs scripts
No, instructions only

What it does

Diagnose search-experience and intent mismatches using SERP page types, user stories, and persona scoring. Use when ranking problems appear intent- or layout-driven.

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 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py <URL> --mode auto (SPA-aware and SSRF-safe)
  2. Parse with "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py <URL> 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.

Read the whole SKILL.md on GitHub

More in Engineering