A community-driven registry for the Claude Code ecosystem. Not affiliated with Anthropic.
Are you the author? Sign in to claim
An LLM-first SEO analysis skill for Antigravity, Codex, Claude with 16 specialized sub-skills, 10 specialist agents, and
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.
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 | <project>/.agent/skills/seo | Skill directory |
| Claude Cowork | <project>/.claude/skills/seo | Project-scoped skill (commit to git) |
| Cursor | <project>/.cursor/rules/seo.mdc + .cursor/skills/seo/ | MDC rule |
| Windsurf | <project>/.windsurf/rules/seo.md + .windsurf/skills/seo/ | Windsurf rule |
| Continue.dev | <project>/.continue/prompts/seo.prompt + .continue/skills/seo/ | Slash command |
| GitHub Copilot | <project>/.github/copilot-instructions.md + .github/skills/seo/ | Repo instructions |
| Cline | <project>/.clinerules + .cline/skills/seo/ | Project rules |
1610scripts/: 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
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. |
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
| 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 |
This skill is designed for reasoning-first SEO analysis:
read_url_content first, scripts optional).Confirmed, Likely, Hypothesis).All audits should apply:
resources/references/llm-audit-rubric.mdThe rubric standardizes:
Finding, Evidence, Impact, Fix)Critical, Warning, Pass, Info)Each reference file carries its own <!-- Updated: YYYY-MM-DD --> marker. CI checks those markers with scripts/reference_freshness.py and flags stale references for review.
Pre-built strategy templates for: SaaS, E-commerce, Local Business, Publisher/Media, Agency, and Generic businesses.
All --online commands below download the latest release package from GitHub automatically. With no --target, --online installs to every supported IDE.
Linux / macOS:
# Default: installs to every target at once
curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online
# Claude Code only
curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online --target claude
# User-wide (Claude + Codex)
curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online --target global
# Every target, scoped to a project
curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online --target all --project-dir /path/to/your/project
Windows (PowerShell 7+):
# Download installer, then run with --online
irm https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.ps1 -OutFile install.ps1
# Default: installs to every target at once
powershell -ExecutionPolicy Bypass -File .\install.ps1 --online
# Claude Code only
powershell -ExecutionPolicy Bypass -File .\install.ps1 --online --target claude
# Every target, scoped to a project
powershell -ExecutionPolicy Bypass -File .\install.ps1 --online --target all --project-dir C:\path\to\your\project
git clone https://github.com/Bhanunamikaze/Agentic-SEO-Skill.git
cd Agentic-SEO-Skill
# Claude Code (most common)
bash install.sh --target claude
# Codex
bash install.sh --target codex
# Claude Cowork / project-scoped (installs to .claude/skills/, commit to git to share with team)
bash install.sh --target cowork --project-dir /path/to/your/project
# GitHub Copilot Chat (writes .github/copilot-instructions.md)
bash install.sh --target copilot --project-dir /path/to/your/project
# Cursor AI (writes .cursor/rules/seo.mdc)
bash install.sh --target cursor --project-dir /path/to/your/project
# Windsurf (writes .windsurf/rules/seo.md)
bash install.sh --target windsurf --project-dir /path/to/your/project
# Cline (writes .clinerules)
bash install.sh --target cline --project-dir /path/to/your/project
# Continue.dev (writes .continue/prompts/seo.prompt)
bash install.sh --target continue --project-dir /path/to/your/project
# Antigravity (writes .agent/skills/seo)
bash install.sh --target antigravity --project-dir /path/to/your/project
# User-wide (Claude + Codex)
bash install.sh --target global
# All project-local IDEs at once
bash install.sh --target project --project-dir /path/to/your/project
# Every target at once
bash install.sh --target all --project-dir /path/to/your/project
# With Python deps + Playwright (for visual analysis scripts)
bash install.sh --target claude --install-deps --install-playwright
Windows (PowerShell) — from source:
powershell -ExecutionPolicy Bypass -File .\install.ps1 --target claude
powershell -ExecutionPolicy Bypass -File .\install.ps1 --target cursor --project-dir C:\path\to\project
powershell -ExecutionPolicy Bypass -File .\install.ps1 --target all --project-dir C:\path\to\project
Safer remote install (download, inspect, run):
curl -fsSLO https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh
less install.sh # review before running
bash install.sh --online
| Flag | Default | Purpose |
|---|---|---|
--target <name> | claude | Pick a target (see IDE Compatibility table). With --online and no flag, defaults to all. |
--project-dir <path> | cwd | Where to install project-local targets. |
--skill-name <name> | seo | Override the installed folder name for skills-dir targets. |
--online | off | Fetch the latest release/branch archive from GitHub instead of using the local tree. |
--ref <branch-or-tag> | main | Branch or tag to use in --online mode. |
--repo-url <url> | upstream | Override the source repo for remote clone. |
--source <auto|local|remote> | auto | Force the source resolution mode. |
--repo-path <path> | — | Use a specific local checkout as the install source. |
--install-deps | off | Also pip install --user requests beautifulsoup4. |
--install-playwright | off | Also install Playwright + Chromium (for visual analysis). |
--force | off | Overwrite an existing installed skill. (--online implies --force.) |
-h, --help | — | Show the full usage block. |
If you skipped --install-deps:
pip install requests beautifulsoup4
# Optional — for visual analysis (screenshots & layout checks):
pip install playwright && playwright install chromium
The skill will auto-trigger when you mention SEO-related keywords in your IDE. Try:
For expanded copy-paste prompt templates across full audits, technical SEO, schema, content, GEO/AEO, local SEO, ecommerce, and GitHub SEO, see the Example Prompts wiki.
The IDE uses an LLM orchestration layer to match your natural language intent to the correct underlying sub-skill (e.g., seo-hreflang.md, seo-schema.md). You do not need to use explicit flags or commands.
seo-audit.md, which acts as the master orchestrator calling all available scripts and analyzing the combined output.Here's how specific phrases map to the skill's capabilities:
| You type... | Scope | Agent(s) activated | Scripts used |
|---|---|---|---|
| "Run SEO audit" | 🌐 Full domain | All 6 core website agents (technical, content, schema, performance, sitemap, visual) | audit_runner.py, crawl_audit.py, parse_html.py, pagespeed.py, robots_checker.py, security_headers.py, broken_links.py, readability.py |
| "Analyze this article" / blog post URL | 📄 Single page | Content + Schema + Technical | article_seo.py, parse_html.py, readability.py |
| "Check technical SEO" | 🔧 Technical only | Technical | robots_checker.py, security_headers.py, redirect_checker.py, parse_html.py |
| "Review content quality" / "E-E-A-T" | 📝 Content only | Content | article_seo.py, readability.py, entity_checker.py |
| "Check schema markup" | 🏷️ Schema only | Schema | parse_html.py, validate_schema.py |
| "Audit sitemap" | 🗺️ Sitemap only | Sitemap | sitemap_checker.py, sitemap_generator.py |
| "Check page speed" / "Core Web Vitals" | ⚡ Performance only | Performance | pagespeed.py |
| "Take screenshots" / "mobile check" | 📱 Visual only | Visual | capture_screenshot.py, analyze_visual.py |
| "Check GEO readiness" / "AI search" | 🤖 GEO/AI only | Technical + Content | llms_txt_checker.py, robots_checker.py, parse_html.py |
| "Analyze links" / "backlink profile" | 🔗 Links only | Technical | link_profile.py, internal_links.py, broken_links.py |
| "Check hreflang" | 🌍 i18n only | Technical | hreflang_checker.py |
| "Create SEO plan" / "SEO strategy" | 📋 Strategy | None (LLM reasoning) | competitor_gap.py (optional) |
| "AEO analysis" / "Featured Snippets" | 🎯 AEO only | Content | article_seo.py, parse_html.py |
| "Entity SEO" / "Knowledge Graph" | 🏛️ Entity only | Content + Schema | entity_checker.py, parse_html.py |
| "Check IndexNow" | 📡 IndexNow only | Technical | indexnow_checker.py |
| "Find content gaps" / "competitor analysis" | 📊 Gap analysis | None (LLM reasoning) | competitor_gap.py |
| "Check for duplicates" / "thin content" | 📋 Dupe check | Content | duplicate_content.py |
| "GSC data" / "Search Console" | 📈 GSC only | None | gsc_checker.py |
| "GitHub SEO" / "optimize this repo" | 🐙 Repository | GitHub Analyst + Benchmark + Data + Verifier | github_repo_audit.py, github_readme_lint.py, github_community_health.py, github_search_benchmark.py, github_competitor_research.py, github_traffic_archiver.py, github_seo_report.py, finding_verifier.py (outputs GITHUB-SEO-REPORT.md + GITHUB-ACTION-PLAN.md) |
| Input type | What happens | Example |
|---|---|---|
Domain (hackingdream.net) | Crawls multiple pages, checks robots.txt, sitemap, site-wide patterns | Full audit, link profile, sitemap check |
URL (hackingdream.net/page) | Single page deep-dive: HTML, meta, schema, content, CWV | Page audit, schema check, technical check |
| Blog post URL | Article-specific: readability, keyword density, heading structure, JSON-LD Article/BlogPosting schema, publish date | Article analysis, AEO check |
Run a full SEO audit for https://hackingdream.net and prioritize fixes by impact.
Analyze this article: https://www.hackingdream.net/2026/02/cobalt-strike-beacon-commands-red-team-field-guide.html
Do a single-page SEO analysis of https://hackingdream.net and show critical issues first.
Analyze technical SEO for https://hackingdream.net (robots, crawlability, canonicals, redirects, headers).
Review content quality and E-E-A-T signals on https://hackingdream.net and suggest concrete rewrites.
Check schema markup on https://hackingdream.net, validate errors, and generate corrected JSON-LD.
Run Core Web Vitals analysis on https://hackingdream.net and break down LCP subparts.
Evaluate GEO readiness for https://hackingdream.net (AI crawler access, llms.txt, citation structure).
Analyze AEO signals for https://hackingdream.net — Featured Snippet targeting, PAA optimization, Knowledge Panel readiness.
Analyze internal link structure and backlink profile for https://hackingdream.net.
Check entity SEO for https://hackingdream.net — Wikidata presence, sameAs links, Knowledge Graph signals.
Find content gaps between https://hackingdream.net and competitors https://hackerone.com https://portswigger.net.
Validate hreflang implementation on https://hackingdream.net — BCP-47 tags, bidirectional links, x-default.
Check IndexNow implementation for https://hackingdream.net with key abc123def456.
Create a topical authority cluster plan for https://hackingdream.net covering cybersecurity topics.
Pull GSC performance data for https://hackingdream.net and identify striking-distance keywords.
Audit sitemap quality for https://hackingdream.net and flag missing, redirected, or noindex URLs.
Run image SEO checks for https://hackingdream.net (alt text, lazy loading, dimensions, format suggestions).
Create a 6-month SEO strategy for https://hackingdream.net with milestones and KPIs.
Take desktop and mobile screenshots of https://hackingdream.net and analyze above-the-fold content.
To run all analysis types on a single URL:
Run a complete SEO audit on https://hackingdream.net — include technical, content, schema, performance,
links, GEO, AEO, entity SEO, and sitemap analysis. Provide a prioritized action plan.
Example generated outputs:
FULL-AUDIT-REPORT.md — comprehensive findingsACTION-PLAN.md — prioritized fixes
You can generate reports in two ways:
Run a full SEO audit for https://hackingdream.net and produce a prioritized action plan with evidence for each finding.
python3 scripts/generate_report.py "https://hackingdream.net" --output seo-report-hackingdream.html
The HTML report includes:
Example generated dashboard:
Use scripts when you need additional verification or structured JSON outputs.
.env file)Some scripts use third-party APIs. Instead of pasting keys on the command line every time, copy .env.example to .env and fill in the keys you have:
cp .env.example .env
$EDITOR .env # add PAGESPEED_API_KEY, GITHUB_TOKEN, GSC_CREDENTIALS_PATH, etc.
.env is gitignored. The loader searches the current directory, the skill root, and ~/.agentic-seo/.env (in that order). Real shell-exported env vars and --flag overrides always win.
| Variable | Used by | How to get one |
|---|---|---|
PAGESPEED_API_KEY | pagespeed.py, generate_report.py | Google Cloud Console → enable "PageSpeed Insights API" |
GOOGLE_KG_API_KEY | entity_checker.py | Same console → enable "Knowledge Graph Search API" |
GITHUB_TOKEN (or GH_TOKEN) | All github_*.py scripts | A PAT with public_repo is enough; gh auth login works as a fallback |
GSC_CREDENTIALS_PATH | gsc_checker.py, link_profile.py | Path to a Google service-account JSON with Search Console access |
# GitHub auth setup for repository SEO scripts (choose one)
export GITHUB_TOKEN="ghp_xxx" # or: export GH_TOKEN="ghp_xxx"
# or authenticate gh CLI:
gh auth login -h github.com
gh auth status -h github.com
# Example target
URL="https://example.com"
# Fetch + parse HTML
python3 scripts/fetch_page.py "$URL" --output /tmp/page.html
python3 scripts/parse_html.py /tmp/page.html --url "$URL" --json
# Core checks
python3 scripts/robots_checker.py "$URL" --json
python3 scripts/llms_txt_checker.py "$URL" --json
python3 scripts/pagespeed.py "$URL" --strategy mobile --json
python3 scripts/security_headers.py "$URL" --json
python3 scripts/redirect_checker.py "$URL" --json
python3 scripts/social_meta.py "$URL" --json
python3 scripts/sitemap_checker.py "$URL" --json
python3 scripts/crawl_audit.py "$URL" --max-pages 50 --json
python3 scripts/indexability_matrix.py --site "$URL" --json
python3 scripts/canonical_checker.py "$URL" --json
python3 scripts/x_robots_header_checker.py "$URL" --json
# Content + structure checks
python3 scripts/readability.py /tmp/page.html --json
python3 scripts/internal_links.py "$URL" --depth 1 --max-pages 20 --json
python3 scripts/broken_links.py "$URL" --workers 5 --json
python3 scripts/article_seo.py "$URL" --json
python3 scripts/image_inventory.py /tmp/page.html --json
python3 scripts/a11y_seo_checker.py /tmp/page.html --json
python3 scripts/url_quality.py "$URL" --json
# New analysis scripts
python3 scripts/hreflang_checker.py "$URL" --json
python3 scripts/entity_checker.py "$URL" --json
python3 scripts/duplicate_content.py "$URL" --json
python3 scripts/link_profile.py "$URL" --json
python3 scripts/competitor_gap.py "$URL" --competitor https://competitor.com --json
python3 scripts/faceted_nav_audit.py "$URL" --json
python3 scripts/ai_crawler_policy_matrix.py "$URL" --json
python3 scripts/llms_txt_generator.py "$URL" "$URL" --title "Example Site" --description "Example site summary." --json
# python3 scripts/gsc_checker.py "$URL" --credentials creds.json --json # requires GSC credentials
# python3 scripts/indexnow_checker.py "$URL" --key YOUR_KEY --json # requires IndexNow key
# GitHub repository SEO scripts (provider fallback: auto|api|gh)
python3 scripts/github_repo_audit.py --repo owner/repo --provider auto --json
python3 scripts/github_readme_lint.py README.md --json
python3 scripts/github_community_health.py --repo owner/repo --provider auto --json
# Provide query/competitor inputs from LLM/web-search discovery when possible:
python3 scripts/github_search_benchmark.py --repo owner/repo --query "<llm_or_web_query>" --provider auto --json
python3 scripts/github_competitor_research.py --repo owner/repo --query "<llm_or_web_query>" --provider auto --top-n 6 --json
python3 scripts/github_competitor_research.py --repo owner/repo --competitor owner/repo --competitor owner/repo --provider auto --json
python3 scripts/github_traffic_archiver.py --repo owner/repo --provider auto --archive-dir .github-seo-data --json
# github_seo_report.py auto-derives repo-specific benchmark queries if none are provided
python3 scripts/github_seo_report.py --repo owner/repo --provider auto --markdown GITHUB-SEO-REPORT.md --action-plan GITHUB-ACTION-PLAN.md --json
# Optional: tune auto-derived query count (default: 6)
# python3 scripts/github_seo_report.py --repo owner/repo --provider auto --auto-query-max 8 --markdown GITHUB-SEO-REPORT.md --action-plan GITHUB-ACTION-PLAN.md --json
# Generic verifier stage (can be used by any workflow before final reporting)
python3 scripts/finding_verifier.py --findings-json raw-findings.json --json
Generate a single HTML dashboard if needed:
python3 scripts/generate_report.py "$URL"
| Rule | Detail |
|---|---|
| INP not FID | FID removed Sept 2024. INP is the sole interactivity metric. |
| FAQ schema restricted | FAQPage only for government/healthcare authority sites (Aug 2023) |
| HowTo deprecated | Rich results removed Sept 2023 |
| JSON-LD only | Never recommend Microdata or RDFa |
| E-E-A-T everywhere | Applies to ALL competitive queries since Dec 2025 |
| Mobile-first complete | 100% mobile-first indexing since July 2024 |
| Location page limits | ⚠️ Warning at 30+ pages, 🛑 Hard stop at 50+ |
| Requirement | Version |
|---|---|
| Python | 3.8+ |
requests | Any |
beautifulsoup4 | Any |
| Playwright | Optional (for visual analysis) |
This project was originally inspired by claude-seo by AgriciDaniel.
Agentic SEO Skill has since evolved into a broader, independently maintained skill package with expanded agent workflows, release packaging, GitHub SEO automation, reporting, validation, and many additional scripts. The project keeps the same practical goal: make SEO analysis usable inside agent IDEs and AI coding assistants through a clear skill layout (SKILL.md + scripts/ + resources/).
Licensed under the MIT License. See LICENSE.
Earlier inspiration and some concepts trace back to claude-seo, which is also MIT-licensed.
ML engineering — model training, deployment, MLOps, monitoring
DevOps practices — CI/CD, containers, monitoring, infrastructure automation
Professional skills marketplace with production-ready skills for enhanced development
Self-learning system that captures corrections and syncs them to CLAUDE.md and AGENTS.md
