mcpField
S
seo

seo

github.com/norahe0304-artMarketing & growth5780 installsUpdated 33w ago
Repository

About seo

A command-routed SEO skill for marketers, site owners, and agencies, combining audits, content and technical analysis, planning, and monitoring across specialized sub-skills.

Key features

  1. 01Site and page audits
  2. 02Technical and content SEO analysis
  3. 03Keyword and competitor research
  4. 04Search and AI visibility monitoring
  5. 05Local SEO analysis

Use cases

  1. 01Auditing a site's technical and content health
  2. 02Planning keywords and content calendars
  3. 03Tracking rankings and AI search mentions
  4. 04Reviewing local business search presence

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/norahe0304-art/30x-seo --skill seo

After installing, type/seoin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
cwv-thresholds.md
eeat-framework.md
quality-gates.md
schema-types.md

Details

From the project README

SEO — Master Orchestrator (24 Sub-Skills)

[PROTOCOL]: Update this header on changes

Comprehensive SEO analysis across all industries (SaaS, local services, e-commerce, publishers, agencies). Orchestrates 24 specialized sub-skills organized in 9 categories, plus 6 parallel subagents for audits.

Quick Reference

1. Audit
CommandWhat it does
/seo audit <url>Full-site audit — first run squirrelscan audit <url> --format llm (if installed), then spawn subagents for deep analysis
/seo page <url>Deep single-page analysis: title, meta, headings, links, images, Schema, E-E-A-T
squirrelscan audit <url>Full-site 230+ rules audit via CLI (npm i -g squirrelscan)
2. Technical SEO
CommandWhat it does
/seo technical <url>8-category audit: crawl, index, security, URLs, mobile, CWV, structured data, JS
/seo sitemap <url>Validate XML sitemaps, detect issues, generate new ones
/seo hreflang <url>Multi-language SEO: self-refs, return tags, x-default, ISO codes
/seo schema <url>Detect, validate, generate JSON-LD structured data
/seo geo-technical <url>AI crawler management: GPTBot, ClaudeBot, llms.txt, SSR check
3. Links
CommandWhat it does
/seo internal-links <url>Orphan pages, click depth, anchor text, link equity
/seo backlinks profile <domain>Backlink profile analysis (DataForSEO)
/seo backlinks gap <domain> <competitor>Find link gap opportunities (DataForSEO)
/seo redirects <url>Chains, loops, 301/302 mix, protocol issues, trailing slashes
4. Content
CommandWhat it does
/seo content-audit <url>E-E-A-T scoring + AI citability analysis
/seo images <url>Alt text, file sizes, formats (WebP/AVIF), lazy loading, CLS
/seo content-decay <url>Detect declining content, recommend refresh priorities
/seo cannibalization <domain>Find keyword conflicts between pages
/seo content-brief <keyword>Analyze SERP top 10, generate content briefs
/seo content-writerSEO + AI optimized writing guidelines
5. Planning
CommandWhat it does
/seo plan <business-type>Competitor analysis, keyword strategy, content calendar, 4-phase roadmap
/seo architecture <url>URL structure, navigation design, internal linking strategy
6. Programmatic SEO
CommandWhat it does
/seo programmatic planScale content: data sources, templates, quality gates, index control
/seo competitor-pages generateX vs Y comparisons, alternatives pages, feature matrices
7. Monitoring
CommandWhat it does
/seo monitor overviewMonitor your site: rankings, clicks, CTR, position changes (GSC)
/seo serp check <keyword>Live SERP check for any keyword (DataForSEO)
/seo ai-visibility domain <domain>Track mentions in ChatGPT, Claude, Perplexity, AI Overview (DataForSEO)
8. Local SEO
CommandWhat it does
/seo local <business> <url>GBP audit, NAP consistency, reviews, local schema, competitor benchmarking, Ask Maps optimization
9. Data
CommandWhat it does
/seo keywords research <seed>Ideas, volume, difficulty, intent, trends (DataForSEO)
/seo keywords site <domain>Keywords a site ranks for (DataForSEO)
/seo keywords gap <domain> <competitor>Find keyword opportunities (DataForSEO)

Command → Skill Routing

CommandLoads Skill
page30x-seo-page
technical30x-seo-technical
sitemap30x-seo-sitemap
hreflang30x-seo-hreflang
schema30x-seo-schema
geo-technical30x-seo-geo-technical
internal-links30x-seo-internal-links
backlinks30x-seo-backlinks
redirects30x-seo-redirects
content-audit30x-seo-content-audit
images30x-seo-images
content-decay30x-seo-content-decay
cannibalization30x-seo-cannibalization
content-brief30x-seo-content-brief
content-writer30x-seo-content-writer
plan30x-seo-plan
architecture30x-seo-architecture
programmatic30x-seo-programmatic
competitor-pages30x-seo-competitor-pages
monitor30x-seo-monitor
serp30x-seo-serp
ai-visibility30x-seo-ai-visibility
keywords30x-seo-keywords
local30x-seo-local
auditsquirrelscan (CLI) + subagents

Orchestration Logic

MANDATORY: /seo audit Execution Order

CRITICAL: When user says "audit", "full audit", "SEO audit", or /seo audit, you MUST follow this exact sequence. Do NOT skip Step 1. Do NOT jump directly to sub-skills.

Step 1 — Squirrelscan (BLOCKING — run this BEFORE anything else):

which squirrelscan && squirrelscan audit <url> --format llm
  • If installed: run it FIRST, wait for results, then proceed to Step 2
  • If NOT installed: tell user npm i -g squirrelscan to get 230+ rule full-site scan, then proceed to Step 2
  • This step provides the global health score (0-100) that frames the entire audit

Step 2 — Industry Detection: Detect business type from homepage (SaaS, local, ecommerce, publisher, agency, other)

Step 3 — Local Business Check: If local business detected → also trigger 30x-seo-local for GBP/Maps/Ask Maps audit

Step 4 — Spawn Sub-Skill Agents (parallel): technical, content, schema, sitemap, performance, visual

Step 5 — Unified Report: Combine squirrelscan score + sub-skill results into SEO Health Score (0-100)

Step 6 — Action Plan: Prioritized: Critical → High → Medium → Low

Industry Detection

Detect business type from homepage signals:

  • SaaS: pricing page, /features, /integrations, /docs, "free trial", "sign up"
  • Local Service: phone number, address, service area, "serving [city]", Google Maps embed
  • E-commerce: /products, /collections, /cart, "add to cart", product schema
  • Publisher: /blog, /articles, /topics, article schema, author pages, publication dates
  • Agency: /case-studies, /portfolio, /industries, "our work", client logos

Quality Gates

Hard rules:

  • WARNING at 30+ location pages (enforce 60%+ unique content)
  • HARD STOP at 50+ location pages (require user justification)
  • Never recommend HowTo schema (deprecated Sept 2023)
  • FAQ schema only for government and healthcare sites
  • All Core Web Vitals references use INP, never FID

Scoring Methodology

SEO Health Score (0-100)
CategoryWeight
Technical SEO25%
Content Quality25%
On-Page SEO20%
Schema / Structured Data10%
Performance (CWV)10%
Images5%
AI Search Readiness5%
Priority Levels
  • Critical: Blocks indexing or causes penalties (immediate fix)
  • High: Significantly impacts rankings (fix within 1 week)
  • Medium: Optimization opportunity (fix within 1 month)
  • Low: Nice to have (backlog)

Sub-Skills (24 Total, 9 Categories)

1. Audit (1 skill + CLI)
SkillWhat it does
30x-seo-pageDeep single-page analysis
squirrelscan (CLI)Full-site 230+ rules audit
2. Technical SEO (5 skills)
SkillWhat it does
30x-seo-technical8-category technical audit
30x-seo-sitemapSitemap validation and generation
30x-seo-hreflangInternational SEO / hreflang
30x-seo-schemaSchema.org JSON-LD
30x-seo-geo-technicalAI crawler management
3. Links (3 skills)
SkillWhat it does
30x-seo-internal-linksInternal link analysis
30x-seo-backlinksBacklink profile (DataForSEO)
30x-seo-redirectsRedirect chain analysis
4. Content (6 skills)
SkillWhat it does
30x-seo-content-auditE-E-A-T + AI citability
30x-seo-imagesImage optimization
30x-seo-content-decayContent freshness analysis
30x-seo-cannibalizationKeyword conflict detection
30x-seo-content-briefSERP-based content briefs
30x-seo-content-writerSEO writing guidelines
5. Planning (2 skills)
SkillWhat it does
30x-seo-planStrategic SEO planning
30x-seo-architectureSite structure planning
6. Programmatic SEO (2 skills)
SkillWhat it does
30x-seo-programmaticScale content with templates
30x-seo-competitor-pagesX vs Y comparison pages
7. Monitoring (3 skills)
SkillWhat it does
30x-seo-monitorYour site via GSC
30x-seo-serpAny site via DataForSEO
30x-seo-ai-visibilityAI search visibility
8. Local SEO (1 skill)
SkillWhat it does
30x-seo-localGBP audit, NAP, reviews, local schema, competitors, Ask Maps, AI Local Pack
9. Data (1 skill)
SkillWhat it does
30x-seo-keywordsKeyword research (DataForSEO)

Dependencies

CategorySkillsDependency
Audit1WebFetch
Technical SEO5WebFetch
Links3WebFetch + DataForSEO (backlinks)
Content6WebFetch
Planning2WebFetch
Programmatic SEO2WebFetch
Local SEO1WebFetch
Monitoring3GSC + DataForSEO
Data1DataForSEO

19 skills work without any API. 4 skills require DataForSEO. 1 skill requires Google Search Console.

Subagents

For parallel analysis during audits:

  • seo-technical — Crawlability, indexability, security, CWV
  • seo-content — E-E-A-T, readability, thin content
  • seo-schema — Detection, validation, generation
  • seo-sitemap — Structure, coverage, quality gates
  • seo-performance — Core Web Vitals measurement
  • seo-visual — Screenshots, mobile testing, above-fold

Comments

Markdown supported