[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77TCBKHE7GRNSHA6X8ZGAFA":3,"skill-same:01M77TCBKHE7GRNSHA6X8ZGAFA":107},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":13,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":34,"install":35,"resources":47},"01M77TCBKHE7GRNSHA6X8ZGAFA","seo",null,"Comprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews\u002FChatGPT\u002FPerplexity. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed, structured data.","ConcertoNotes\u002Fcodex-plugins","ConcertoNotes","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F249301288?v=4","01M77NJ0BK2KN5YW0D8RHD99TB","01M77NJ0CCEDPATAY3JTXEWNK5",0,"MIT","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: seo\ndescription: \"Comprehensive SEO analysis for any website or business type. Full site audits, single-page analysis, technical SEO (crawlability, indexability, Core Web Vitals with INP), schema markup, content quality (E-E-A-T), image optimization, sitemap analysis, and GEO for AI Overviews\u002FChatGPT\u002FPerplexity. Industry detection for SaaS, e-commerce, local, publishers, agencies. Triggers on: SEO, audit, schema, Core Web Vitals, sitemap, E-E-A-T, AI Overviews, GEO, technical SEO, content quality, page speed, structured data.\"\nuser-invocable: true\nargument-hint: \"[command] [url]\"\nlicense: MIT\nmetadata:\n  author: AgriciDaniel\n  version: \"2.2.16\"\n  category: seo\n---\n\n# SEO: Universal SEO Analysis Skill\n\n**Invocation:** `\u002Fseo $1 $2` where `$1` is the command and `$2` is the URL or argument.\n\n**Scripts:** Located at the plugin root `scripts\u002F` directory.\n\nComprehensive SEO analysis across all industries (SaaS, local services,\ne-commerce, publishers, agencies). Orchestrates 24 sub-skills (21 core + 1 framework\nintegration + 2 extension mirrors) and 18 sub-agents. A separate optional Firecrawl\nextension is also installable (see \"Optional Extensions\" below).\n\n## Quick Reference\n\n| Command | What it does |\n|---------|-------------|\n| `\u002Fseo audit \u003Curl>` | Full website audit with parallel subagent delegation |\n| `\u002Fseo page \u003Curl>` | Deep single-page analysis |\n| `\u002Fseo sitemap \u003Curl or generate>` | Analyze or generate XML sitemaps |\n| `\u002Fseo schema \u003Curl>` | Detect, validate, and generate Schema.org markup |\n| `\u002Fseo images \u003Curl or optimize>` | Image SEO: on-page audit, SERP analysis, file optimization |\n| `\u002Fseo technical \u003Curl>` | Technical SEO audit (9 categories) |\n| `\u002Fseo content \u003Curl>` | E-E-A-T and content quality analysis |\n| `\u002Fseo content-brief \u003Ctopic or url>` | Generate detailed SEO content brief with target keywords, outline, internal links |\n| `\u002Fseo geo \u003Curl>` | AI Overviews \u002F Generative Engine Optimization |\n| `\u002Fseo plan \u003Cbusiness-type>` | Strategic SEO planning |\n| `\u002Fseo programmatic [url\\|plan]` | Programmatic SEO analysis and planning |\n| `\u002Fseo competitor-pages [url\\|generate]` | Competitor comparison page generation |\n| `\u002Fseo local \u003Curl>` | Local SEO analysis (GBP, citations, reviews, map pack) |\n| `\u002Fseo maps [command] [args]` | Maps intelligence (geo-grid, GBP audit, reviews, competitors) |\n| `\u002Fseo hreflang [url]` | Hreflang\u002Fi18n SEO audit and generation |\n| `\u002Fseo google [command] [url]` | Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) |\n| `\u002Fseo backlinks \u003Curl>` | Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) |\n| `\u002Fseo cluster \u003Cseed-keyword>` | SERP-based semantic clustering and content architecture |\n| `\u002Fseo sxo \u003Curl>` | Search Experience Optimization: page-type analysis, user stories, personas |\n| `\u002Fseo drift baseline \u003Curl>` | Capture SEO baseline for change monitoring |\n| `\u002Fseo drift compare \u003Curl>` | Compare current state to stored baseline |\n| `\u002Fseo drift history \u003Curl>` | Show drift history over time |\n| `\u002Fseo ecommerce \u003Curl>` | E-commerce SEO: product schema, marketplace intelligence |\n| `\u002Fseo firecrawl [command] \u003Curl>` | Full-site crawling and site mapping (extension) |\n| `\u002Fseo dataforseo [command]` | Live SEO data via DataForSEO (extension) |\n| `\u002Fseo image-gen [use-case] \u003Cdescription>` | AI image generation for SEO assets (extension) |\n| `\u002Fseo flow [stage] [url\\|topic]` | FLOW framework: evidence-led prompts for Find, Leverage, Optimize, Win, or Local stages |\n\n## Orchestration Logic\n\n### Delegation policy\n\nFull audits are speed-first, multi-agent workflows. Launch available specialist\nagents concurrently whenever the runtime supports delegation; use inline\nsequential work only as a last-resort compatibility fallback. In SEO Dungeon,\ndelegated agents should inherit the selected strength profile: Warrior\u002Fdeep\nuses extra-high or the highest available effort, Samurai\u002Fbalanced uses high,\nand Knight\u002Ffast uses medium. Do not silently downshift delegated work below the\nselected profile.\n\nWhen the user invokes `\u002Fseo audit`, delegate to subagents in parallel:\n1. Detect business type (SaaS, local, ecommerce, publisher, agency, other)\n2. Spawn always-on subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo, seo-sxo\n3. If Google API credentials detected (`python3 scripts\u002Fgoogle_auth.py --check`), also spawn seo-google agent\n4. If local business detected, also spawn seo-local agent\n5. If local business detected AND DataForSEO credentials or optional tools are available, also spawn seo-maps agent\n6. If backlink APIs detected (`python3 scripts\u002Fbacklinks_auth.py --check`), also spawn seo-backlinks agent\n7. If `FIRECRAWL_API_KEY` or an optional Firecrawl adapter is available, use Firecrawl to discover site URLs before analysis; otherwise fall back to sitemap and page-discovery scripts\n8. If content strategy signals detected (blog, pillar pages, topic clusters), also spawn seo-cluster agent\n9. If e-commerce detected, also spawn seo-ecommerce agent\n10. If drift baseline exists for this URL (`python3 scripts\u002Fdrift_history.py \u003Curl>`), also spawn seo-drift agent\n11. Collect results and generate unified report with SEO Health Score (0-100)\n12. **Synthesize via the 10-principle framework** (see \"Synthesis Methodology\" below): walk PERCEIVE -> ANALYZE -> VALIDATE -> ACT before bucketing findings into Critical \u002F High \u002F Medium \u002F Low\n13. Create prioritized action plan with dependency sequencing + falsifiability per recommendation\n14. **Offer PDF report**: \"Generate a professional PDF report? Use `\u002Fseo google report full`\"\n\nFor individual commands, load the relevant sub-skill directly.\nAfter any analysis command completes, offer to generate a PDF report via `scripts\u002Fgoogle_report.py`.\n\n## Synthesis Methodology\n\nAudits are not just findings — they are findings synthesized into a coherent\nstrategy. claude-seo uses a 10-principle thinking framework grouped into four\nphases: **PERCEIVE** (observe-external · observe-internal · listen),\n**ANALYZE** (think · connect-lateral · connect-system), **VALIDATE** (feel ·\naccept), **ACT** (create · grow).\n\nFull audits (`\u002Fseo audit`, `\u002Fseo page`) walk every phase before emitting the\naction plan. Narrower commands (`\u002Fseo schema`, `\u002Fseo images`, etc.) pass at\nleast THINK + ACCEPT before emitting (sound first principle, surfaced\nfalsifiability). The Critical \u002F High \u002F Medium \u002F Low priority buckets are the\n**output** of validation, not a substitute for it.\n\nFull methodology + per-principle SEO mapping: `references\u002Fthinking-framework.md`.\n\nEach emitted recommendation should carry:\n- The first-principle observation it rests on (THINK)\n- The dependency on \u002F unblock relationship to other recommendations (CONNECT-system)\n- An explicit \"how would we know this failed?\" check (ACCEPT)\n- A leading indicator the user can monitor without re-running the audit (GROW)\n\n## Industry Detection\n\nDetect business type from homepage signals:\n- **SaaS**: pricing page, \u002Ffeatures, \u002Fintegrations, \u002Fdocs, \"free trial\", \"sign up\"\n- **Local Service**: phone number, address, service area, \"serving [city]\", Google Maps embed --> auto-suggest `\u002Fseo local` for deeper analysis\n- **E-commerce**: \u002Fproducts, \u002Fcollections, \u002Fcart, \"add to cart\", product schema\n- **Publisher**: \u002Fblog, \u002Farticles, \u002Ftopics, article schema, author pages, publication dates\n- **Agency**: \u002Fcase-studies, \u002Fportfolio, \u002Findustries, \"our work\", client logos\n\n## Quality Gates\n\nRead `references\u002Fquality-gates.md` for thin content thresholds per page type.\nHard rules:\n- WARNING at 30+ location pages (enforce 60%+ unique content)\n- HARD STOP at 50+ location pages (require user justification)\n- Never recommend HowTo schema (deprecated Sept 2023)\n- FAQ schema: Google retired FAQ rich results for ALL sites on May 7, 2026 (no SERP feature anymore; supersedes the Aug 2023 gov\u002Fhealth restriction). Flag existing FAQPage at Info (not Critical) for its AI\u002FLLM citation benefit; do not recommend removal; do not recommend new FAQPage for Google SERP benefit; use QAPage for genuine user Q&A\n- All Core Web Vitals references use INP, never FID\n\n## Reference Files\n\nLoad these on-demand as needed (do NOT load all at startup):\n- `references\u002Fcwv-thresholds.md`: Current Core Web Vitals thresholds and measurement details\n- `references\u002Fschema-types.md`: All supported schema types with deprecation status\n- `references\u002Feeat-framework.md`: E-E-A-T evaluation criteria (Sept 2025 QRG update)\n- `references\u002Fquality-gates.md`: Content length minimums, uniqueness thresholds\n- `references\u002Flocal-seo-signals.md`: Local ranking factors, review benchmarks, citation tiers, GBP status\n- `references\u002Flocal-schema-types.md`: LocalBusiness subtypes, industry-specific schema and citation sources\n\nMaps-specific references (loaded by seo-maps skill, not at startup):\n- `references\u002Fmaps-geo-grid.md`, `references\u002Fmaps-gbp-checklist.md`, `references\u002Fmaps-api-endpoints.md`, `references\u002Fmaps-free-apis.md`\n\n## Scoring Methodology\n\n### SEO Health Score (0-100)\nWeighted aggregate of all categories:\n\n| Category | Weight |\n|----------|--------|\n| Technical SEO | 22% |\n| Content Quality | 23% |\n| On-Page SEO | 20% |\n| Schema \u002F Structured Data | 10% |\n| Performance (CWV) | 10% |\n| AI Search Readiness | 10% |\n| Images | 5% |\n\n### Priority Levels\n- **Critical**: Blocks indexing or causes penalties (immediate fix required)\n- **High**: Significantly impacts rankings (fix within 1 week)\n- **Medium**: Optimization opportunity (fix within 1 month)\n- **Low**: Nice to have (backlog)\n\n## Sub-Skills\n\nThis skill orchestrates 24 sub-skills (21 core + 1 framework integration + 2 extension\nmirrors). The orchestrator itself (`seo`) is the 25th in `skills\u002F`, but does not\norchestrate itself, so it is not enumerated below.\n\n1. **seo-audit** -- Full website audit with parallel delegation\n2. **seo-page** -- Deep single-page analysis\n3. **seo-technical** -- Technical SEO (9 categories)\n4. **seo-content** -- E-E-A-T and content quality\n5. **seo-content-brief** -- Detailed SEO content brief generation (contributed by puneetindersingh)\n6. **seo-schema** -- Schema markup detection and generation\n7. **seo-images** -- Image optimization, SERP analysis, file optimization\n8. **seo-sitemap** -- Sitemap analysis and generation\n9. **seo-geo** -- AI Overviews \u002F GEO optimization\n10. **seo-plan** -- Strategic planning with templates\n11. **seo-programmatic** -- Programmatic SEO analysis and planning\n12. **seo-competitor-pages** -- Competitor comparison page generation\n13. **seo-hreflang** -- Hreflang\u002Fi18n SEO audit, cultural profiles, content parity\n14. **seo-local** -- Local SEO (GBP, NAP, citations, reviews, local schema, multi-location)\n15. **seo-maps** -- Maps intelligence (geo-grid, GBP audit, reviews, competitor radius)\n16. **seo-google** -- Google SEO APIs (GSC, PageSpeed, CrUX, Indexing API, GA4)\n17. **seo-backlinks** -- Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO)\n18. **seo-cluster** -- SERP-based semantic clustering (contributed by Lutfiya Miller)\n19. **seo-sxo** -- Search Experience Optimization (contributed by Florian Schmitz)\n20. **seo-drift** -- SEO drift monitoring (contributed by Dan Colta)\n21. **seo-ecommerce** -- E-commerce SEO intelligence (contributed by Matej Marjanovic)\n22. **seo-dataforseo** -- Live SEO data via DataForSEO credentials (extension mirror)\n23. **seo-image-gen** -- AI image generation for SEO assets via Gemini (extension mirror)\n24. **seo-flow** -- FLOW framework integration (Find -> Leverage -> Optimize -> Win, 41 AI prompts, CC BY 4.0)\n\n### Optional Extensions\n\nThe following ship in `extensions\u002F` rather than `skills\u002F`. DataForSEO and\nFirecrawl should use selected-project `.env` credentials by default; their\ninstallers are optional for users who want adapter setup:\n\nOf the optional extensions, firecrawl, dataforseo, and image-gen are reachable\nthrough `\u002Fseo` subcommands. Ahrefs, Bing, Profound, SE Ranking, and Unlighthouse\ninstall as standalone skills invoked by their own descriptions. The model\nauto-routes to those triggers, not through `\u002Fseo \u003Cname>`.\n\n- **seo-firecrawl** -- Full-site crawling and site mapping via Firecrawl\n  credentials. Add `FIRECRAWL_API_KEY` to the selected project `.env`; install\n  the optional adapter only if desired. Invoke via `\u002Fseo firecrawl \u003Ccommand>`.\n\n## Subagents\n\nFor parallel analysis during audits:\n- `seo-technical` -- Crawlability, indexability, security, CWV\n- `seo-content` -- E-E-A-T, readability, thin content\n- `seo-schema` -- Detection, validation, generation\n- `seo-sitemap` -- Structure, coverage, quality gates\n- `seo-performance` -- Core Web Vitals measurement\n- `seo-visual` -- Screenshots, mobile testing, above-fold\n- `seo-geo` -- AI crawler access, llms.txt, citability, brand mention signals\n- `seo-local` -- GBP signals, NAP consistency, reviews, local schema, industry-specific local factors (conditional: spawned when Local Service detected)\n- `seo-maps` -- Geo-grid rank tracking, GBP audit, review intelligence, competitor radius mapping (conditional: spawned when Local Service detected AND DataForSEO credentials\u002Ftools are available)\n- `seo-google` -- CWV field data, URL indexation status, organic traffic trends (conditional: spawned when Google API credentials detected)\n- `seo-backlinks` -- Backlink profile data: DA\u002FPA, referring domains, anchor text, toxic links (conditional: spawned when Moz\u002FBing API keys detected or always for CC domain-level metrics)\n- `seo-cluster` -- Semantic clustering analysis (conditional: content strategy detected)\n- `seo-sxo` -- Page-type mismatch, user stories, persona scoring (always in full audits)\n- `seo-drift` -- Baseline comparison (conditional: drift baseline exists for URL)\n- `seo-ecommerce` -- Product schema, marketplace intel (conditional: e-commerce detected)\n- `seo-flow` -- FLOW framework prompts (conditional: spawned for content strategy workflows)\n- `seo-dataforseo` -- Live SERP, keyword, backlink, local SEO data (extension, optional)\n- `seo-image-gen` -- SEO image audit and generation plan (extension, optional)\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| Unrecognized command | List available commands from the Quick Reference table. Suggest the closest matching command. |\n| URL unreachable | Report the error and suggest the user verify the URL. Do not attempt to guess site content. |\n| Sub-skill fails during audit | Report partial results from successful sub-skills. Clearly note which sub-skill failed and why. Suggest re-running the failed sub-skill individually. |\n| Ambiguous business type detection | Present the top two detected types with supporting signals. Ask the user to confirm before proceeding with industry-specific recommendations. |\n","# SEO: Universal SEO Analysis Skill\n\n**Invocation:** `\u002Fseo $1 $2` where `$1` is the command and `$2` is the URL or argument.\n\n**Scripts:** Located at the plugin root `scripts\u002F` directory.\n\nComprehensive SEO analysis across all industries (SaaS, local services,\ne-commerce, publishers, agencies). Orchestrates 24 sub-skills (21 core + 1 framework\nintegration + 2 extension mirrors) and 18 sub-agents. A separate optional Firecrawl\nextension is also installable (see \"Optional Extensions\" below).\n\n## Quick Reference\n\n| Command | What it does |\n|---------|-------------|\n| `\u002Fseo audit \u003Curl>` | Full website audit with parallel subagent delegation |\n| `\u002Fseo page \u003Curl>` | Deep single-page analysis |\n| `\u002Fseo sitemap \u003Curl or generate>` | Analyze or generate XML sitemaps |\n| `\u002Fseo schema \u003Curl>` | Detect, validate, and generate Schema.org markup |\n| `\u002Fseo images \u003Curl or optimize>` | Image SEO: on-page audit, SERP analysis, file optimization |\n| `\u002Fseo technical \u003Curl>` | Technical SEO audit (9 categories) |\n| `\u002Fseo content \u003Curl>` | E-E-A-T and content quality analysis |\n| `\u002Fseo content-brief \u003Ctopic or url>` | Generate detailed SEO content brief with target keywords, outline, internal links |\n| `\u002Fseo geo \u003Curl>` | AI Overviews \u002F Generative Engine Optimization |\n| `\u002Fseo plan \u003Cbusiness-type>` | Strategic SEO planning |\n| `\u002Fseo programmatic [url\\|plan]` | Programmatic SEO analysis and planning |\n| `\u002Fseo competitor-pages [url\\|generate]` | Competitor comparison page generation |\n| `\u002Fseo local \u003Curl>` | Local SEO analysis (GBP, citations, reviews, map pack) |\n| `\u002Fseo maps [command] [args]` | Maps intelligence (geo-grid, GBP audit, reviews, competitors) |\n| `\u002Fseo hreflang [url]` | Hreflang\u002Fi18n SEO audit and generation |\n| `\u002Fseo google [command] [url]` | Google SEO APIs (GSC, PageSpeed, CrUX, Indexing, GA4) |\n| `\u002Fseo backlinks \u003Curl>` | Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO) |\n| `\u002Fseo cluster \u003Cseed-keyword>` | SERP-based semantic clustering and content architecture |\n| `\u002Fseo sxo \u003Curl>` | Search Experience Optimization: page-type analysis, user stories, personas |\n| `\u002Fseo drift baseline \u003Curl>` | Capture SEO baseline for change monitoring |\n| `\u002Fseo drift compare \u003Curl>` | Compare current state to stored baseline |\n| `\u002Fseo drift history \u003Curl>` | Show drift history over time |\n| `\u002Fseo ecommerce \u003Curl>` | E-commerce SEO: product schema, marketplace intelligence |\n| `\u002Fseo firecrawl [command] \u003Curl>` | Full-site crawling and site mapping (extension) |\n| `\u002Fseo dataforseo [command]` | Live SEO data via DataForSEO (extension) |\n| `\u002Fseo image-gen [use-case] \u003Cdescription>` | AI image generation for SEO assets (extension) |\n| `\u002Fseo flow [stage] [url\\|topic]` | FLOW framework: evidence-led prompts for Find, Leverage, Optimize, Win, or Local stages |\n\n## Orchestration Logic\n\n### Delegation policy\n\nFull audits are speed-first, multi-agent workflows. Launch available specialist\nagents concurrently whenever the runtime supports delegation; use inline\nsequential work only as a last-resort compatibility fallback. In SEO Dungeon,\ndelegated agents should inherit the selected strength profile: Warrior\u002Fdeep\nuses extra-high or the highest available effort, Samurai\u002Fbalanced uses high,\nand Knight\u002Ffast uses medium. Do not silently downshift delegated work below the\nselected profile.\n\nWhen the user invokes `\u002Fseo audit`, delegate to subagents in parallel:\n1. Detect business type (SaaS, local, ecommerce, publisher, agency, other)\n2. Spawn always-on subagents: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual, seo-geo, seo-sxo\n3. If Google API credentials detected (`python3 scripts\u002Fgoogle_auth.py --check`), also spawn seo-google agent\n4. If local business detected, also spawn seo-local agent\n5. If local business detected AND DataForSEO credentials or optional tools are available, also spawn seo-maps agent\n6. If backlink APIs detected (`python3 scripts\u002Fbacklinks_auth.py --check`), also spawn seo-backlinks agent\n7. If `FIRECRAWL_API_KEY` or an optional Firecrawl adapter is available, use Firecrawl to discover site URLs before analysis; otherwise fall back to sitemap and page-discovery scripts\n8. If content strategy signals detected (blog, pillar pages, topic clusters), also spawn seo-cluster agent\n9. If e-commerce detected, also spawn seo-ecommerce agent\n10. If drift baseline exists for this URL (`python3 scripts\u002Fdrift_history.py \u003Curl>`), also spawn seo-drift agent\n11. Collect results and generate unified report with SEO Health Score (0-100)\n12. **Synthesize via the 10-principle framework** (see \"Synthesis Methodology\" below): walk PERCEIVE -> ANALYZE -> VALIDATE -> ACT before bucketing findings into Critical \u002F High \u002F Medium \u002F Low\n13. Create prioritized action plan with dependency sequencing + falsifiability per recommendation\n14. **Offer PDF report**: \"Generate a professional PDF report? Use `\u002Fseo google report full`\"\n\nFor individual commands, load the relevant sub-skill directly.\nAfter any analysis command completes, offer to generate a PDF report via `scripts\u002Fgoogle_report.py`.\n\n## Synthesis Methodology\n\nAudits are not just findings — they are findings synthesized into a coherent\nstrategy. claude-seo uses a 10-principle thinking framework grouped into four\nphases: **PERCEIVE** (observe-external · observe-internal · listen),\n**ANALYZE** (think · connect-lateral · connect-system), **VALIDATE** (feel ·\naccept), **ACT** (create · grow).\n\nFull audits (`\u002Fseo audit`, `\u002Fseo page`) walk every phase before emitting the\naction plan. Narrower commands (`\u002Fseo schema`, `\u002Fseo images`, etc.) pass at\nleast THINK + ACCEPT before emitting (sound first principle, surfaced\nfalsifiability). The Critical \u002F High \u002F Medium \u002F Low priority buckets are the\n**output** of validation, not a substitute for it.\n\nFull methodology + per-principle SEO mapping: `references\u002Fthinking-framework.md`.\n\nEach emitted recommendation should carry:\n- The first-principle observation it rests on (THINK)\n- The dependency on \u002F unblock relationship to other recommendations (CONNECT-system)\n- An explicit \"how would we know this failed?\" check (ACCEPT)\n- A leading indicator the user can monitor without re-running the audit (GROW)\n\n## Industry Detection\n\nDetect business type from homepage signals:\n- **SaaS**: pricing page, \u002Ffeatures, \u002Fintegrations, \u002Fdocs, \"free trial\", \"sign up\"\n- **Local Service**: phone number, address, service area, \"serving [city]\", Google Maps embed --> auto-suggest `\u002Fseo local` for deeper analysis\n- **E-commerce**: \u002Fproducts, \u002Fcollections, \u002Fcart, \"add to cart\", product schema\n- **Publisher**: \u002Fblog, \u002Farticles, \u002Ftopics, article schema, author pages, publication dates\n- **Agency**: \u002Fcase-studies, \u002Fportfolio, \u002Findustries, \"our work\", client logos\n\n## Quality Gates\n\nRead `references\u002Fquality-gates.md` for thin content thresholds per page type.\nHard rules:\n- WARNING at 30+ location pages (enforce 60%+ unique content)\n- HARD STOP at 50+ location pages (require user justification)\n- Never recommend HowTo schema (deprecated Sept 2023)\n- FAQ schema: Google retired FAQ rich results for ALL sites on May 7, 2026 (no SERP feature anymore; supersedes the Aug 2023 gov\u002Fhealth restriction). Flag existing FAQPage at Info (not Critical) for its AI\u002FLLM citation benefit; do not recommend removal; do not recommend new FAQPage for Google SERP benefit; use QAPage for genuine user Q&A\n- All Core Web Vitals references use INP, never FID\n\n## Reference Files\n\nLoad these on-demand as needed (do NOT load all at startup):\n- `references\u002Fcwv-thresholds.md`: Current Core Web Vitals thresholds and measurement details\n- `references\u002Fschema-types.md`: All supported schema types with deprecation status\n- `references\u002Feeat-framework.md`: E-E-A-T evaluation criteria (Sept 2025 QRG update)\n- `references\u002Fquality-gates.md`: Content length minimums, uniqueness thresholds\n- `references\u002Flocal-seo-signals.md`: Local ranking factors, review benchmarks, citation tiers, GBP status\n- `references\u002Flocal-schema-types.md`: LocalBusiness subtypes, industry-specific schema and citation sources\n\nMaps-specific references (loaded by seo-maps skill, not at startup):\n- `references\u002Fmaps-geo-grid.md`, `references\u002Fmaps-gbp-checklist.md`, `references\u002Fmaps-api-endpoints.md`, `references\u002Fmaps-free-apis.md`\n\n## Scoring Methodology\n\n### SEO Health Score (0-100)\nWeighted aggregate of all categories:\n\n| Category | Weight |\n|----------|--------|\n| Technical SEO | 22% |\n| Content Quality | 23% |\n| On-Page SEO | 20% |\n| Schema \u002F Structured Data | 10% |\n| Performance (CWV) | 10% |\n| AI Search Readiness | 10% |\n| Images | 5% |\n\n### Priority Levels\n- **Critical**: Blocks indexing or causes penalties (immediate fix required)\n- **High**: Significantly impacts rankings (fix within 1 week)\n- **Medium**: Optimization opportunity (fix within 1 month)\n- **Low**: Nice to have (backlog)\n\n## Sub-Skills\n\nThis skill orchestrates 24 sub-skills (21 core + 1 framework integration + 2 extension\nmirrors). The orchestrator itself (`seo`) is the 25th in `skills\u002F`, but does not\norchestrate itself, so it is not enumerated below.\n\n1. **seo-audit** -- Full website audit with parallel delegation\n2. **seo-page** -- Deep single-page analysis\n3. **seo-technical** -- Technical SEO (9 categories)\n4. **seo-content** -- E-E-A-T and content quality\n5. **seo-content-brief** -- Detailed SEO content brief generation (contributed by puneetindersingh)\n6. **seo-schema** -- Schema markup detection and generation\n7. **seo-images** -- Image optimization, SERP analysis, file optimization\n8. **seo-sitemap** -- Sitemap analysis and generation\n9. **seo-geo** -- AI Overviews \u002F GEO optimization\n10. **seo-plan** -- Strategic planning with templates\n11. **seo-programmatic** -- Programmatic SEO analysis and planning\n12. **seo-competitor-pages** -- Competitor comparison page generation\n13. **seo-hreflang** -- Hreflang\u002Fi18n SEO audit, cultural profiles, content parity\n14. **seo-local** -- Local SEO (GBP, NAP, citations, reviews, local schema, multi-location)\n15. **seo-maps** -- Maps intelligence (geo-grid, GBP audit, reviews, competitor radius)\n16. **seo-google** -- Google SEO APIs (GSC, PageSpeed, CrUX, Indexing API, GA4)\n17. **seo-backlinks** -- Backlink profile analysis (free: Moz, Bing, CC; premium: DataForSEO)\n18. **seo-cluster** -- SERP-based semantic clustering (contributed by Lutfiya Miller)\n19. **seo-sxo** -- Search Experience Optimization (contributed by Florian Schmitz)\n20. **seo-drift** -- SEO drift monitoring (contributed by Dan Colta)\n21. **seo-ecommerce** -- E-commerce SEO intelligence (contributed by Matej Marjanovic)\n22. **seo-dataforseo** -- Live SEO data via DataForSEO credentials (extension mirror)\n23. **seo-image-gen** -- AI image generation for SEO assets via Gemini (extension mirror)\n24. **seo-flow** -- FLOW framework integration (Find -> Leverage -> Optimize -> Win, 41 AI prompts, CC BY 4.0)\n\n### Optional Extensions\n\nThe following ship in `extensions\u002F` rather than `skills\u002F`. DataForSEO and\nFirecrawl should use selected-project `.env` credentials by default; their\ninstallers are optional for users who want adapter setup:\n\nOf the optional extensions, firecrawl, dataforseo, and image-gen are reachable\nthrough `\u002Fseo` subcommands. Ahrefs, Bing, Profound, SE Ranking, and Unlighthouse\ninstall as standalone skills invoked by their own descriptions. The model\nauto-routes to those triggers, not through `\u002Fseo \u003Cname>`.\n\n- **seo-firecrawl** -- Full-site crawling and site mapping via Firecrawl\n  credentials. Add `FIRECRAWL_API_KEY` to the selected project `.env`; install\n  the optional adapter only if desired. Invoke via `\u002Fseo firecrawl \u003Ccommand>`.\n\n## Subagents\n\nFor parallel analysis during audits:\n- `seo-technical` -- Crawlability, indexability, security, CWV\n- `seo-content` -- E-E-A-T, readability, thin content\n- `seo-schema` -- Detection, validation, generation\n- `seo-sitemap` -- Structure, coverage, quality gates\n- `seo-performance` -- Core Web Vitals measurement\n- `seo-visual` -- Screenshots, mobile testing, above-fold\n- `seo-geo` -- AI crawler access, llms.txt, citability, brand mention signals\n- `seo-local` -- GBP signals, NAP consistency, reviews, local schema, industry-specific local factors (conditional: spawned when Local Service detected)\n- `seo-maps` -- Geo-grid rank tracking, GBP audit, review intelligence, competitor radius mapping (conditional: spawned when Local Service detected AND DataForSEO credentials\u002Ftools are available)\n- `seo-google` -- CWV field data, URL indexation status, organic traffic trends (conditional: spawned when Google API credentials detected)\n- `seo-backlinks` -- Backlink profile data: DA\u002FPA, referring domains, anchor text, toxic links (conditional: spawned when Moz\u002FBing API keys detected or always for CC domain-level metrics)\n- `seo-cluster` -- Semantic clustering analysis (conditional: content strategy detected)\n- `seo-sxo` -- Page-type mismatch, user stories, persona scoring (always in full audits)\n- `seo-drift` -- Baseline comparison (conditional: drift baseline exists for URL)\n- `seo-ecommerce` -- Product schema, marketplace intel (conditional: e-commerce detected)\n- `seo-flow` -- FLOW framework prompts (conditional: spawned for content strategy workflows)\n- `seo-dataforseo` -- Live SERP, keyword, backlink, local SEO data (extension, optional)\n- `seo-image-gen` -- SEO image audit and generation plan (extension, optional)\n\n## Error Handling\n\n| Scenario | Action |\n|----------|--------|\n| Unrecognized command | List available commands from the Quick Reference table. Suggest the closest matching command. |\n| URL unreachable | Report the error and suggest the user verify the URL. Do not attempt to guess site content. |\n| Sub-skill fails during audit | Report partial results from successful sub-skills. Clearly note which sub-skill failed and why. Suggest re-running the failed sub-skill individually. |\n| Ambiguous business type detection | Present the top two detected types with supporting signals. Ask the user to confirm before proceeding with industry-specific recommendations. |\n",{"name":5,"license":14,"metadata":24,"description":7,"argument-hint":27,"user-invocable":28},{"author":25,"version":26,"category":5},"AgriciDaniel","2.2.16","[command] [url]",true,"main","9ba3c9fadff1092395837bf1502e1b8a7f98b1e1","plugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins","https:\u002F\u002Fgithub.com\u002FConcertoNotes","2026-06-26 10:13:54",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":28},[37,40,43],{"tool":38,"command":39},"npx","npx skills add ConcertoNotes\u002Fcodex-plugins --skill seo",{"tool":41,"command":42},"bunx","bunx skills add ConcertoNotes\u002Fcodex-plugins --skill seo",{"tool":44,"command":45},"pnpm","pnpm dlx skills add ConcertoNotes\u002Fcodex-plugins --skill seo","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002FSKILL.md",[48,53,59,63,67,71,75,79,83,87,91,95,99,103],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":15},"LICENSE.txt","LICENSE","许可证",143,{"path":54,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fbacklink-quality.md","REFERENCE","参考文档",3491,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fbacklink-quality.md",{"path":60,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fcwv-thresholds.md",5188,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fcwv-thresholds.md",{"path":64,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Feeat-framework.md",7452,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Feeat-framework.md",{"path":68,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Ffree-backlink-sources.md",5451,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Ffree-backlink-sources.md",{"path":72,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Flocal-schema-types.md",9269,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Flocal-schema-types.md",{"path":76,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Flocal-seo-signals.md",8607,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Flocal-seo-signals.md",{"path":80,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fmaps-api-endpoints.md",6009,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fmaps-api-endpoints.md",{"path":84,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fmaps-free-apis.md",6191,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fmaps-free-apis.md",{"path":88,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":89,"sourceHtmlUrl":90},"references\u002Fmaps-gbp-checklist.md",6003,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fmaps-gbp-checklist.md",{"path":92,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":93,"sourceHtmlUrl":94},"references\u002Fmaps-geo-grid.md",4375,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fmaps-geo-grid.md",{"path":96,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":97,"sourceHtmlUrl":98},"references\u002Fquality-gates.md",5210,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fquality-gates.md",{"path":100,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":101,"sourceHtmlUrl":102},"references\u002Fschema-types.md",6812,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fschema-types.md",{"path":104,"resourceType":55,"resourceTypeDesc":56,"sizeBytes":105,"sourceHtmlUrl":106},"references\u002Fthinking-framework.md",9512,"https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fseo-dungeon\u002Fskills\u002Fseo\u002Freferences\u002Fthinking-framework.md",[108,117,124,132,139,146],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":112,"licenseFileUrl":113,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M77YB7WW36DS9AERTWP673E0","android-emulator-qa","Use when validating Android feature flows in an emulator with adb-driven launch, input, UI-tree inspection, screenshots, and logcat capture.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Ftest-android-apps\u002Fskills\u002Fandroid-emulator-qa\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Ftest-android-apps\u002Fskills\u002Fandroid-emulator-qa\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":19},"01M77Y7AA8N45G6NM0WJSS2W9C","supabase-postgres-best-practices","Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Fsupabase\u002Fskills\u002Fsupabase-postgres-best-practices\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":112,"licenseFileUrl":128,"sourceHtmlUrl":129,"categories":130,"keywords":131,"publishedAt":19},"01M77Y2W5H5YGSW7MYWEJ8HYXD","sentry","Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Fsentry\u002Fskills\u002Fsentry\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Fsentry\u002Fskills\u002Fsentry\u002FSKILL.md",[],[],{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":138,"publishedAt":19},"01M77Y06GV1DAME7PN9KBFHWRX","render-workflows","Sets up, develops, tests, and deploys Render Workflows. Covers first-time scaffolding (via CLI or manual), SDK installation (Python or TypeScript), task patterns (retries, subtasks, fan-out), local development, Dashboard deployment, and troubleshooting. Use when a user wants to set up Render Workflows for the first time, scaffold a workflow service, add or modify workflow tasks, test workflows locally, or deploy workflows to Render.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Frender\u002Fskills\u002Frender-workflows\u002FSKILL.md",[],[],{"skillNo":140,"name":141,"nameZh":6,"description":142,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":143,"categories":144,"keywords":145,"publishedAt":19},"01M77Y01A6RJA8VYT7CZ2TVETF","render-web-services","Configures Render web services—port binding, TLS, health checks, custom domains, auto-deploy, PR previews, persistent disks, and deploy lifecycle. Use when the user needs to set up a web service, fix health check failures, add a custom domain, configure zero-downtime deploys, or troubleshoot port binding issues.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Frender\u002Fskills\u002Frender-web-services\u002FSKILL.md",[],[],{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":152,"publishedAt":19},"01M77XZW1AZ6B6NZTWWFVY72T3","render-static-sites","Deploys and configures static sites on Render's global CDN—build commands, publish paths, SPA routing, redirects, custom headers, and PR previews. Use when the user needs to deploy a static site, set up a React\u002FVue\u002FHugo\u002FGatsby frontend, configure SPA fallback routing, add redirect rules, customize response headers, or choose between a static site and a web service for their frontend. Trigger terms: static site, CDN, SPA, single-page app, React deploy, Vue deploy, Hugo, Gatsby, Docusaurus, Jekyll, staticPublishPath.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Frender\u002Fskills\u002Frender-static-sites\u002FSKILL.md",[],[]]