An LLM-first SEO analysis skill for agent IDEs, with 16 specialized sub-skills, 10 specialist agents, and 33 scripts used as evidence collectors and workflow automation.
- Antigravity IDE (
.agent/skills/seo) - Claude Code (
~/.claude/skills/seo) - Codex (
~/.codex/skills/seo)
- Specialized sub-skills:
16 - Specialist agents:
10 - Scripts in
scripts/:33(32Python +1shell validation helper)
Recommended GitHub repository description (About field):
LLM-first SEO skill for Antigravity, Claude, and Codex with 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
| 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:
- 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.
All audits should apply:
resources/references/llm-audit-rubric.md
The rubric standardizes:
- evidence format (
Finding,Evidence,Impact,Fix) - severity (
Critical,Warning,Pass,Info) - confidence labeling
- output contract for audit reports
- Technical SEO — crawlability, indexability, security, mobile, JS rendering
- Content Quality — E-E-A-T scoring, AI content detection
- Performance — Core Web Vitals (LCP, INP, CLS) analysis
- Schema Markup — JSON-LD detection, validation, generation
- Sitemap — XML sitemap validation, quality gates
- Visual Analysis — screenshots, above-the-fold, responsiveness (Playwright)
- GitHub Analyst — metadata, topics, README, trust, title strategy
- GitHub Benchmark — query ranking and competitor intelligence
- GitHub Data — API/auth fallback and traffic archival continuity
- Verifier (Global) — dedupe/contradiction suppression before final reporting
- Core Web Vitals thresholds (INP replaced FID)
- E-E-A-T framework (Sept 2025 QRG + Dec 2025 core update)
- Schema.org types — active, restricted, deprecated
- Content quality gates & word count minimums
- Google SEO quick reference
- LLM audit rubric for consistent outputs
Pre-built strategy templates for: SaaS, E-commerce, Local Business, Publisher/Media, Agency, and Generic businesses.
# 1) Clone
git clone https://github.com/Bhanunamikaze/Agentic-SEO-Skill.git
cd Agentic-SEO-Skill
# 2) Install for your target
# Antigravity (project-local):
bash install.sh --target antigravity --project-dir /path/to/your/project
# Claude:
bash install.sh --target claude
# Codex:
bash install.sh --target codex
# Global user install (Claude + Codex):
bash install.sh --target global
# All targets (Antigravity + Claude + Codex):
bash install.sh --target all --project-dir /path/to/your/project
# Install from another local checkout:
bash install.sh --target codex --repo-path /path/to/Agentic-SEO-Skillcurl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | \
bash -s -- --target codexgit clone https://github.com/Bhanunamikaze/Agentic-SEO-Skill.gitpip install requests beautifulsoup4Optional — for visual analysis (screenshots & layout checks):
pip install playwright && playwright install chromiumIf you prefer not to use install.sh, copy or symlink manually:
mkdir -p .agent/skills
cp -r /path/to/Agentic-SEO-Skill .agent/skills/seo
# or: ln -s /path/to/Agentic-SEO-Skill .agent/skills/seomkdir -p ~/.claude/skills
cp -r /path/to/Agentic-SEO-Skill ~/.claude/skills/seo
# or: ln -s /path/to/Agentic-SEO-Skill ~/.claude/skills/seomkdir -p ~/.codex/skills
cp -r /path/to/Agentic-SEO-Skill ~/.codex/skills/seo
# or: ln -s /path/to/Agentic-SEO-Skill ~/.codex/skills/seoThe skill will auto-trigger when you mention SEO-related keywords in your IDE. Try:
- "Run an SEO audit on example.com"
- "Check the schema markup on my homepage"
- "Analyze Core Web Vitals for my site"
- "Create an SEO plan for my SaaS product"
- "Run GitHub SEO analysis for owner/repo"
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.
- To run a specific test: Ask for it specifically (e.g., "Check hreflang"). The LLM will only trigger the necessary scripts.
- To force ALL agents/tests: Ask for a "full, comprehensive audit running all checks". The LLM will route this to
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) | 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 | broken_links.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:
- LLM-first report in your IDE (Antigravity / Claude / Codex) (recommended for strategy + prioritization):
Run a full SEO audit for https://hackingdream.net and produce a prioritized action plan with evidence for each finding.
- Interactive HTML dashboard (recommended for shareable technical snapshots):
python3 scripts/generate_report.py "https://hackingdream.net" --output seo-report-hackingdream.htmlThe HTML report includes:
- overall score and category breakdown
- environment detection (platform/runtime inference)
- environment-specific fix plan
- section-level issues and recommendations
- readability "what to replace" suggestions
Example generated dashboard:
Use scripts when you need additional verification or structured JSON outputs.
# 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
# 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
# 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/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 --jsonGenerate 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 |
| Requirement | Version |
|---|---|
| Python | 3.8+ |
requests |
Any |
beautifulsoup4 |
Any |
| Playwright | Optional (for visual analysis) |
This project is heavily built from claude-seo by AgriciDaniel. All core SEO logic, reference data, agent definitions, utility scripts, and sub-skill instructions originate from that project.
This repository restructures and adapts the content to function as a compatible skill package for Antigravity IDE, Claude Code, and Codex, while preserving the same core skill layout (SKILL.md + scripts/ + resources/).
Licensed under the MIT License. See LICENSE.
Portions are derived from claude-seo, which is also MIT-licensed.