Bhanunamikaze/Agentic-SEO-Skill

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:

📦 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.

🐙 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

🧠 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:

• evidence format (Finding, Evidence, Impact, Fix)
• severity (Critical, Warning, Pass, Info)
• confidence labeling
• output contract for audit reports

🤖 Specialist Agents

• 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

📚 Reference Data

• 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

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.

🏭 Industry Templates

Pre-built strategy templates for: SaaS, E-commerce, Local Business, Publisher/Media, Agency, and Generic businesses.

---

🔧 Installation

All --online commands below download the latest release package from GitHub automatically. With no --target, --online installs to every supported IDE.

Quick install (no cloning required)

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

From source

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

All flags

Python dependencies (manual)

If you skipped --install-deps:

pip install requests beautifulsoup4
# Optional — for visual analysis (screenshots & layout checks):
pip install playwright && playwright install chromium

Verify Triggering

The 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"

---

💬 Example Prompts (hackingdream.net)

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.

How Prompts Route to Agents & Scripts

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:

Domain vs URL vs Blog Post — What's Different?

---

🌐 Full Domain Audit

Run a full SEO audit for https://hackingdream.net and prioritize fixes by impact.

📄 Single Page / Blog Post Analysis

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.

🔧 Technical SEO

Analyze technical SEO for https://hackingdream.net (robots, crawlability, canonicals, redirects, headers).

📝 Content Quality & E-E-A-T

Review content quality and E-E-A-T signals on https://hackingdream.net and suggest concrete rewrites.

🏷️ Schema Markup

Check schema markup on https://hackingdream.net, validate errors, and generate corrected JSON-LD.

⚡ Performance & Core Web Vitals

Run Core Web Vitals analysis on https://hackingdream.net and break down LCP subparts.

🤖 GEO / AI Search Readiness

Evaluate GEO readiness for https://hackingdream.net (AI crawler access, llms.txt, citation structure).

🎯 Answer Engine Optimization (AEO)

Analyze AEO signals for https://hackingdream.net — Featured Snippet targeting, PAA optimization, Knowledge Panel readiness.

🔗 Link Profile Analysis

Analyze internal link structure and backlink profile for https://hackingdream.net.

🏛️ Entity SEO / Knowledge Graph

Check entity SEO for https://hackingdream.net — Wikidata presence, sameAs links, Knowledge Graph signals.

📊 Competitor Topic Gap

Find content gaps between https://hackingdream.net and competitors https://hackerone.com https://portswigger.net.

🌍 Hreflang / International SEO

Validate hreflang implementation on https://hackingdream.net — BCP-47 tags, bidirectional links, x-default.

📡 IndexNow

Check IndexNow implementation for https://hackingdream.net with key abc123def456.

📋 Topical Cluster Planning

Create a topical authority cluster plan for https://hackingdream.net covering cybersecurity topics.

📈 Google Search Console (requires credentials)

Pull GSC performance data for https://hackingdream.net and identify striking-distance keywords.

🗺️ Sitemap Audit

Audit sitemap quality for https://hackingdream.net and flag missing, redirected, or noindex URLs.

🖼️ Image SEO

Run image SEO checks for https://hackingdream.net (alt text, lazy loading, dimensions, format suggestions).

📋 Strategic SEO Plan

Create a 6-month SEO strategy for https://hackingdream.net with milestones and KPIs.

📱 Visual / Mobile Analysis

Take desktop and mobile screenshots of https://hackingdream.net and analyze above-the-fold content.

---

Run Everything at Once

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 findings
• ACTION-PLAN.md — prioritized fixes

---

📊 Report Generation

You can generate reports in two ways:

1. 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.

2. Interactive HTML dashboard (recommended for shareable technical snapshots):

python3 scripts/generate_report.py "https://hackingdream.net" --output seo-report-hackingdream.html

The 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:

---

⚙️ Optional Script Workflow

Use scripts when you need additional verification or structured JSON outputs.

Credentials (.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.

# 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"

---

🛡️ Critical Rules Enforced

---

📋 Requirements

---

🙏 Credits

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/).

---

📄 License

Licensed under the MIT License. See LICENSE.

Earlier inspiration and some concepts trace back to claude-seo, which is also MIT-licensed.