[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EDGHV5GZA8TMB43FAPASZ2":3,"skill-same:01M7EDGHV5GZA8TMB43FAPASZ2":49},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":13,"repositoryHtmlUrl":25,"repositoryHomepageUrl":6,"ownerHtmlUrl":26,"ownerBlogUrl":6,"ownerDescription":27,"updatedAt":28,"install":29,"resources":42},"01M7EDGHV5GZA8TMB43FAPASZ2","seo-sxo",null,"jonahthan433\u002FCortexOS","jonahthan433","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F211465495?v=4","01M7ECH9HPHGA89DCXHHJBTS3C","jonah.ai","01M7ECH9JCEM45DZMWPT7148S1",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fseo-sxo\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# seo-sxo\n\n# Search Experience Optimization (SXO)\n\nSXO bridges the gap between SEO (what Google rewards) and UX (what users need).\nTraditional SEO audits check technical health. SXO asks: \"Does this page deserve\nto rank for this keyword based on what Google is actually rewarding in the SERP?\"\n\n## Core Insight\n\nA page can score 95\u002F100 on technical SEO and still fail to rank because it is the\n**wrong page type** for the keyword. If Google shows 8 product pages and 2 comparison\npages for your keyword, your blog post will never break through -- no matter how\nwell-optimized it is.\n\n## Commands\n\n| Command | Purpose |\n|---------|---------|\n| `\u002Fseo sxo \u003Curl>` | Full SXO analysis (auto-detect keyword from page) |\n| `\u002Fseo sxo \u003Curl> \u003Ckeyword>` | Full SXO analysis for a specific keyword |\n| `\u002Fseo sxo wireframe \u003Curl>` | Generate IST\u002FSOLL wireframe with concrete placeholders |\n| `\u002Fseo sxo personas \u003Curl>` | Persona-only scoring (skip SERP analysis) |\n\n## Execution Pipeline\n\n### Step 1: Target Acquisition\n\n1. Fetch the target URL via `scripts\u002Ffetch_page.py` (SSRF-safe)\n2. Parse with `scripts\u002Fparse_html.py` to extract: title, H1, meta description,\n   headings hierarchy, word count, schema markup, CTAs, media elements\n3. If no keyword provided, extract primary keyword from title tag + H1 overlap\n4. Validate keyword is non-empty before proceeding\n\n### Step 2: SERP Backwards Analysis\n\nRead `references\u002Fpage-type-taxonomy.md` for classification rules.\n\n1. Search Google for the target keyword (WebSearch)\n2. For each of the top 10 organic results, record:\n   - URL and domain authority tier (brand \u002F niche authority \u002F unknown)\n   - Page type (classify using taxonomy)\n   - Content format (long-form, listicle, how-to, comparison, tool, video)\n   - Word count estimate (from snippet length and page structure)\n   - Schema types present (from SERP features: ratings, FAQ, HowTo)\n   - Media signals (video carousel, image pack, thumbnail presence)\n3. Record SERP features present:\n   - Featured snippet (paragraph \u002F list \u002F table \u002F video)\n   - People Also Ask (extract all visible questions)\n   - Ads (top and bottom -- count and analyze ad copy themes)\n   - Related searches (extract all)\n   - Knowledge panel \u002F local pack \u002F shopping results\n   - AI Overview presence and source types\n4. Calculate SERP consensus:\n   - Dominant page type (>60% = strong consensus, 40-60% = mixed, \u003C40% = fragmented)\n   - Content depth expectations (average word count tier)\n   - Schema expectation (most common structured data types)\n   - Media expectations (video required? images critical?)\n\n### Step 3: Page-Type Mismatch Detection\n\nThis is the core SXO insight. Compare target page type against SERP consensus.\n\n**Mismatch severity levels:**\n\n| Target Type | SERP Expects | Severity | Recommendation |\n|-------------|-------------|----------|----------------|\n| Blog Post | Product Pages | CRITICAL | Create dedicated product page |\n| Blog Post | Comparison | HIGH | Restructure as comparison with matrix |\n| Product | Informational | HIGH | Add educational content layer |\n| Landing Page | Tool\u002FCalculator | HIGH | Build interactive tool component |\n| Service Page | Local Results | MEDIUM | Add location signals + local schema |\n| Any type match | - | ALIGNED | Focus on content depth and UX |\n\n**Classification rules:**\n- Classify target page using `references\u002Fpage-type-taxonomy.md`\n- Classify each SERP result using the same taxonomy\n- Flag mismatch if target type differs from SERP dominant type\n- If SERP is fragmented (no dominant type), note opportunity for differentiation\n\n### Step 4: User Story Derivation\n\nRead `references\u002Fuser-story-framework.md` for the full framework.\n\nFrom SERP signals, derive user stories:\n\n1. **PAA questions** reveal knowledge gaps and concerns\n2. **Ad copy themes** reveal commercial triggers and value propositions\n3. **Related searches** reveal the search journey (what comes before\u002Fafter)\n4. **Featured snippet format** reveals the expected answer structure\n5. **AI Overview** reveals what Google considers the definitive answer\n\nFor each signal cluster, generate a user story:\n```\nAs a [persona derived from signal],\nI want to [goal derived from query intent],\nbecause [emotional driver from ad copy \u002F PAA tone],\nbut I'm blocked by [barrier derived from PAA questions \u002F related searches].\n```\n\nGenerate 3-5 user stories covering the primary intent angles.\n\n### Step 5: Gap Analysis\n\nCompare the target page against SERP expectations across 7 dimensions:\n\n| Dimension | What to Compare | Score |\n|-----------|----------------|-------|\n| Page Type | Target type vs SERP dominant type | 0-15 |\n| Content Depth | Word count, heading depth, topic coverage | 0-15 |\n| UX Signals | CTA clarity, above-fold content, mobile layout | 0-15 |\n| Schema Markup | Present vs expected structured data types | 0-15 |\n| Media Richness | Images, video, interactive elements vs SERP norm | 0-15 |\n| Authority Signals | E-E-A-T markers, social proof, credentials | 0-15 |\n| Freshness | Last updated, date signals, content recency | 0-10 |\n\n**Total: 0-100 SXO Gap Score** (lower = larger gap, higher = better alignment)\n\n### Step 6: Persona-Based Scoring\n\nRead `references\u002Fpersona-scoring.md` for methodology.\n\n1. Derive 4-7 personas from SERP intent signals:\n   - Cluster PAA questions by theme\n   - Segment ad copy by target audience\n   - Map related searches to journey stages\n2. For each persona, score the target page on 4 dimensions (25 pts each):\n   - **Relevance**: Does the page address this persona's need?\n   - **Clarity**: Can this persona find their answer within 10 seconds?\n   - **Trust**: Are there adequate trust signals for this persona?\n   - **Action**: Is there a clear next step for this persona?\n3. Output persona cards with scores and specific improvement recommendations\n4. Sort recommendations by weakest persona first (biggest opportunity)\n\n### Step 7: Wireframe Generation (Optional)\n\nOnly execute when `\u002Fseo sxo wireframe` is invoked.\n\nRead `references\u002Fwireframe-templates.md` for templates.\n\n1. Generate IST (current state) wireframe from parsed page structure\n2. Generate SOLL (target state) wireframe based on:\n   - SERP consensus page type\n   - Gap analysis findings\n   - Persona scoring weaknesses\n3. Use ultra-concrete placeholders:\n   - NOT: \"Add a CTA here\"\n   - YES: \"Add pricing CTA with annual savings badge below hero, linking to \u002Fpricing#enterprise\"\n4. Output as semantic HTML section outline with annotations\n\n## DataForSEO Integration\n\nIf DataForSEO MCP tools are available:\n\n1. **Before any API call**, run cost estimate and confirm with user\n2. Use `google_organic_serp` for precise SERP data (positions, features, snippets)\n3. Use `keyword_data` for search volume and competition metrics\n4. Fall back to WebSearch if DataForSEO unavailable -- note reduced precision in output\n\n## SXO Score vs SEO Health Score\n\nThe SXO score is **separate** from the main SEO Health Score.\n\n- SEO Health Score = technical compliance (crawlability, speed, schema, etc.)\n- SXO Gap Score = alignment between page and SERP expectations\n- A page can score 95 SEO + 30 SXO = technically perfect but strategically misaligned\n- Both scores should be reported together when both are available\n\n## Cross-Skill References\n\n| Finding | Hand Off To |\n|---------|-------------|\n| E-E-A-T gaps in persona scoring | `\u002Fseo content` for deep E-E-A-T audit |\n| Missing schema types | `\u002Fseo schema` for generation |\n| Local intent detected in SERP | `\u002Fseo local` for GBP analysis |\n| Content depth gaps | `\u002Fseo page` for deep page analysis |\n| Technical issues found during fetch | `\u002Fseo technical` for full audit |\n| Image\u002Fmedia gaps | `\u002Fseo images` for optimization |\n\n## Output Format\n\n### Full SXO Analysis\n\n```\n## SXO Analysis: [URL]\n### Target Keyword: [keyword]\n\n### 1. SERP Landscape\n- Dominant page type: [type] ([confidence]% consensus)\n- SERP features: [list]\n- Content depth norm: [word count range]\n- Schema expectation: [types]\n\n### 2. Page-Type Alignment\n- Your page type: [type]\n- SERP expects: [type]\n- Verdict: [ALIGNED | MISMATCH (severity)]\n- Impact: [explanation]\n\n### 3. User Stories (derived from SERP signals)\n[3-5 user stories with source signals]\n\n### 4. Gap Analysis (SXO Score: XX\u002F100)\n[7-dimension breakdown table]\n\n### 5. Persona Scores\n[4-7 persona cards with 4-dimension scores]\n\n### 6. Priority Actions\n[Ranked list: fix mismatch first, then weakest persona gaps]\n\n### 7. Limitations\n[What could not be assessed, data source notes]\n```\n\n## Error Handling\n\n| Error | Action |\n|-------|--------|\n| URL fetch fails | Report error, suggest checking URL accessibility |\n| No keyword provided or detected | Ask user to provide target keyword |\n| WebSearch returns \u003C5 results | Proceed with available data, note limited sample |\n| SERP has no organic results (all ads) | Note highly commercial SERP, analyze ad copy only |\n| Target page is JavaScript-rendered | Note limitation, use available HTML content |\n| DataForSEO cost exceeds threshold | Fall back to WebSearch, notify user |\n\n## Quality Checklist\n\nBefore delivering results, verify:\n- [ ] Target URL was fetched via `scripts\u002Ffetch_page.py` (not raw curl\u002Ffetch)\n- [ ] Page type classification uses taxonomy from references\n- [ ] At least 5 SERP results were analyzed\n- [ ] User stories cite specific SERP signals as evidence\n- [ ] Persona scores include concrete improvement suggestions\n- [ ] SXO score is clearly labeled as separate from SEO Health Score\n- [ ] Limitations section is present and honest\n- [ ] Cross-skill recommendations are included where relevant\n",{},"main","38b32c99e7ed0b8e215d638e92cfa452c1ec3079","skills\u002Fimported\u002Fproductivity\u002Fseo-sxo","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS","https:\u002F\u002Fgithub.com\u002Fjonahthan433","AI Consultant","2026-10-24 05:13:39",{"source":7,"skillName":5,"commands":30,"prompt":40,"zipAvailable":41},[31,34,37],{"tool":32,"command":33},"npx","npx skills add jonahthan433\u002FCortexOS --skill seo-sxo",{"tool":35,"command":36},"bunx","bunx skills add jonahthan433\u002FCortexOS --skill seo-sxo",{"tool":38,"command":39},"pnpm","pnpm dlx skills add jonahthan433\u002FCortexOS --skill seo-sxo","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fseo-sxo\u002FSKILL.md",true,[43],{"path":44,"resourceType":45,"resourceTypeDesc":46,"sizeBytes":47,"sourceHtmlUrl":48},"skill.json","REFERENCE","参考文档",267,"https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fimported\u002Fproductivity\u002Fseo-sxo\u002Fskill.json",[50,56,62,68,74,80],{"skillNo":51,"name":52,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":53,"categories":54,"keywords":55,"publishedAt":18},"01M7EDQZDQX3Q8Y7GCQX6KN9V7","opportunity-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fsales\u002Fopportunity-brief\u002FSKILL.md",[],[],{"skillNo":57,"name":58,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":18},"01M7EDQYA0V9Y99VKBREJJ3MRT","morning-intel","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fmorning-intel\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":18},"01M7EDQVX1JVY0B6PDHKKGM19G","decision-brief","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fresearch\u002Fdecision-brief\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M7EDQV1GENZAC2SZSD8KZ3GM","weekly-review","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fweekly-review\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":18},"01M7EDQT2KETJ1Y3CGVN9EKW2J","system-health","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fsystem-health\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M7EDQQN2JK3XPWMS1M4T0F3K","backup-restore","https:\u002F\u002Fgithub.com\u002Fjonahthan433\u002FCortexOS\u002Fblob\u002Fmain\u002Fskills\u002Fops\u002Fbackup-restore\u002FSKILL.md",[],[]]