Agentic-SEO-Skill
Bhanunamikaze · Bhanunamikaze/Agentic-SEO-Skill
A comprehensive SEO analysis skill with 16 sub-skills and 89 utility scripts for AI coding agents to perform in-depth website optimization.
An LLM-first SEO analysis skill for Antigravity, Codex, Claude with 16 specialized sub-skills, 10 specialist agents, and 88 optional utility scripts used as evidence collectors.
Preview
What you can do with it
- Analyze competitor websites for SEO strengths and weaknesses using AI.
- Generate detailed SEO reports and recommendations for specific web pages or keywords.
- Automate content gap analysis and keyword research for new articles or blog posts.
Safety check
Usable, but read the notes first.
- ●Installer downloads a remote script and pipes it to the shell.
README.md
Automated scan of the repo files. Always review code you run.
From the README
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(88Python +1shell 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:
- Collect page evidence (
read_url_contentfirst, scripts optional). - Analyze with LLM using explicit proof for each finding.
- Apply confidence labels (
Confirmed,Likely,Hypothesis). - Prioritize by impact and effort.
- Produce a structured action plan.
Required Rubric
All audits should apply:
resources/references/llm-audit-rubric.md
The rubric standardizes:
- e