SEO Skill (Antigravity / Claude / Codex / Cursor)

An LLM-first SEO analysis skill for agent IDEs and AI coding assistants, with 16 specialized sub-skills, 10 specialist agents, and 89 scripts used as evidence collectors and workflow automation.

For detailed installation guidance, example prompts, report generation, troubleshooting, and the full script inventory, see the Agentic SEO Skill Wiki.

IDE Compatibility

The installer ships native formats for each tool — not just a generic copy:

Tool	Install location	Native format
Claude Code	~/.claude/skills/seo	Skill directory
Codex CLI	~/.codex/skills/seo	Skill directory
Antigravity IDE	/.agent/skills/seo	Skill directory
Claude Cowork	/.claude/skills/seo	Project-scoped skill (commit to git)
Cursor	/.cursor/rules/seo.mdc + .cursor/skills/seo/	MDC rule
Windsurf	/.windsurf/rules/seo.md + .windsurf/skills/seo/	Windsurf rule
Continue.dev	/.continue/prompts/seo.prompt + .continue/skills/seo/	Slash command
GitHub Copilot	/.github/copilot-instructions.md + .github/skills/seo/	Repo instructions
Cline	/.clinerules + .cline/skills/seo/	Project rules

📦 Current Inventory

• Specialized sub-skills: 16
• Specialist agents: 10
• Scripts in scripts/: 89 (88 Python + 1 shell validation helper)

Inventory drift is checked by CI with:

python3 scripts/validate_skill_inventory.py
python3 scripts/reference_freshness.py resources/references --max-age-days 90

Key Script Inventory

The README only highlights the scripts most users reach for first. See the full 89-script list with purpose notes in the Script Inventory wiki.

Script	Best for
audit_runner.py	One-command full audit that writes JSON, HTML, FULL-AUDIT-REPORT.md, and ACTION-PLAN.md.
generate_report.py	Self-contained browser dashboard for sharing SEO findings.
fetch_page.py	Reliable page fetch with SEO crawler headers and local HTML output.
parse_html.py	Extract titles, metadata, headings, links, images, schema, and canonical signals.
pagespeed.py	Core Web Vitals and PageSpeed Insights evidence.
crawl_audit.py	Multi-page crawl evidence for status, metadata, depth, and duplicate signals.
indexability_matrix.py	Per-URL indexability verdicts from robots, meta robots, canonicals, status, and sitemaps.
robots_checker.py	Search and AI crawler policy checks from robots.txt.
sitemap_checker.py	XML sitemap discovery, parsing, limits, status checks, and lastmod quality.
image_inventory.py	Image alt text, dimensions, loading behavior, responsive image, and LCP-candidate evidence.
validate_schema.py	JSON-LD syntax, required fields, placeholders, and deprecated schema checks.
github_seo_report.py	GitHub repository SEO report and action plan generation.
finding_verifier.py	Deduplicate, prioritize, and validate findings before final reporting.

🐙 GitHub SEO Metadata

Recommended GitHub repository description (About field):

LLM-first SEO skill for Claude Code, Codex, Antigravity, Cursor, Windsurf, Continue, Copilot, and Cline — 16 sub-skills, 10 specialist agents, and GitHub SEO workflows that output GITHUB-SEO-REPORT.md and GITHUB-ACTION-PLAN.md.

Suggested GitHub topics:

seo, llm, github-seo, ai-search, geo, aeo, technical-seo, schema, core-web-vitals, codex, claude-code, antigravity, cursor, windsurf, copilot

✨ Features

Sub-Skill	Description
seo audit	Full website audit with evidence-backed scoring
seo article	Article data extraction & LLM-driven content optimization
seo page	Deep single-page analysis
seo technical	Crawlability, indexability, security, Core Web Vitals, AI crawlers
seo content	Content quality & E-E-A-T assessment (Sept 2025 QRG)
seo schema	Schema.org detection, validation & JSON-LD generation
seo sitemap	XML sitemap analysis & generation
seo images	Image optimization audit (alt text, formats, lazy loading, CLS)
seo geo	Generative Engine Optimization — AI Overviews, ChatGPT, Perplexity
seo aeo	Answer Engine Optimization — Featured Snippets, PAA, Knowledge Panel
seo links	Link profile analysis — internal links, backlinks, anchor text, orphan pages
seo programmatic	Programmatic SEO safeguards & quality gates
seo competitors	Comparison & alternatives page generation
seo hreflang	International SEO / hreflang validation
seo plan	Strategic SEO planning with topical clusters & industry templates
seo github	GitHub repository SEO: metadata/topics, README quality, community profile, query benchmarking, traffic archiving

🧠 LLM-First Workflow

This skill is designed for reasoning-first SEO analysis:

1. Collect page evidence (read_url_content first, scripts optional).
2. Analyze with LLM using explicit proof for each finding.
3. Apply confidence labels (Confirmed, Likely, Hypothesis).
4. Prioritize by impact and effort.
5. Produce a structured action plan.

Required Rubric

All audits should apply:

• resources/references/llm-audit-rubric.md

The rubric standardizes:

• e