Skip to content

Search Experience Optimization (SXO)

Diagnose why a page fails to rank due to intent or page-type mismatch versus search results

Stars
25,798
Licence
MIT
Files
5 files

What it does

When installed, the agent can analyze a web page against what Google currently shows for a keyword. It classifies the page type (blog post, product page, comparison, tool, and so on), checks the top search results for the dominant type, and points out mismatches. It also derives simulated user stories and persona scores, and can draft a concrete wireframe of how the page could be restructured. It is aimed at explaining ranking problems that come from layout or intent rather than technical SEO issues.

Great for

  • SEO specialists diagnosing pages that are technically sound but do not rank
  • Content marketers deciding whether to turn a blog post into a comparison or product page
  • Website owners who want concrete layout changes tied to search results

Skip it if

  • Pure technical SEO audits such as crawl errors or site speed, which this skill does not cover (the reason: its scope is intent and page type)
  • Guaranteed ranking predictions, since the scores are heuristic judgments drawn from SERP snapshots (the reason: results change over time and by location)
  • Sites where the user lacks permission to fetch or analyze the target URL (the reason: the skill fetches the page and search results)

Try asking

  • “/seo sxo https://example.com/blog/best-crm-tools”
  • “/seo sxo https://example.com/pricing project management software”
  • “/seo sxo wireframe https://example.com/landing-page”
  • “/seo sxo personas https://example.com/guide”
Step-by-step guide: how to use Search Experience Optimization (SXO)Install, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 5 original files, the MIT licence and an attribution note.

    seo-sxo.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip seo-sxo.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip seo-sxo.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Give a specific keyword as the second argument; auto-detection from the title and H1 is less reliable
  • Run the wireframe command only after reviewing the gap analysis, since it builds on those findings
  • Treat persona scores as prompts for discussion, not as measured user data

What's inside

  • references/page-type-taxonomy.md
  • references/persona-scoring.md
  • references/user-story-framework.md
  • references/wireframe-templates.md
  • SKILL.md

Redistributed unmodified from AgriciDaniel/claude-seo under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.