agentic-seo-skill

# Agentic SEO Skill > Skill by [ara.so](https://ara.so) — AI Agent Skills collection. The Agentic SEO Skill is an LLM-first SEO analysis framework designed for AI coding assistants and agent IDEs. It provides 16 specialized sub-skills, 10 specialist agents, and 89 Python scripts for evidence-based SEO analysis. The skill follows a reasoning-first workflow: collect evidence, analyze with LLM proof, apply confidence labels, prioritize by impact, and produce actionable plans. ## Installation ### Quick Install (No Cloning Required) **Linux/macOS:** ```bash # Install to all supported IDEs curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online # Install to Claude Code only curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online --target claude # Install to specific project curl -fsSL https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.sh | bash -s -- --online --target all --project-dir /path/to/project ``` **Windows (PowerShell 7+):** ```powershell irm https://raw.githubusercontent.com/Bhanunamikaze/Agentic-SEO-Skill/main/install.ps1 -OutFile install.ps1 powershell -ExecutionPolicy Bypass -File .\install.ps1 --online ``` ### From Source ```bash git clone https://github.com/Bhanunamikaze/Agentic-SEO-Skill.git cd Agentic-SEO-Skill # Install to Claude Code with dependencies bash install.sh --target claude --install-deps # Install with Playwright for visual analysis bash install.sh --target claude --install-deps --install-playwright ``` ### Installation Targets | Target | Location | Format | |--------|----------|--------| | `claude` | `~/.claude/skills/seo` | Skill directory | | `codex` | `~/.codex/skills/seo` | Skill directory | | `cursor` | `<project>/.cursor/rules/seo.mdc` | MDC rule | | `windsurf` | `<project>/.windsurf/rules/seo.md` | Windsurf rule | | `copilot` | `<project>/.github/copilot-instructions.md` | Repo instructions | | `cline` | `<project>/.clinerules` | Project rules | | `continue` | `<project>/.continue/prompts/seo.prompt` | Slash command | | `antigravity` | `<project>/.agent/skills/seo` | Skill directory | ## Core Workflow The skill follows an LLM-first analysis pattern: 1. **Collect Evidence** — Use `read_url_content` MCP tool or evidence collection scripts 2. **Analyze with LLM** — Apply explicit proof and reasoning for each finding 3. **Label Confidence** — Mark findings as `Confirmed`, `Likely`, or `Hypothesis` 4. **Prioritize** — Rank by impact and implementation effort 5. **Generate Action Plan** — Produce structured, evidence-backed recommendations All audits must follow the `resources/references/llm-audit-rubric.md` standard. ## 16 Specialized Sub-Skills ### 1. SEO Audit (Full Site) Run comprehensive site-wide audits with evidence-backed scoring: ```python # Quick full audit with all outputs python3 scripts/audit_runner.py https://example.com # Outputs: # - audit_results.json # - audit_report.html # - FULL-AUDIT-REPORT.md # - ACTION-PLAN.md ``` **Agent prompt:** ``` Use the seo audit sub-skill to analyze https://example.com — follow the LLM audit rubric, collect evidence first with read_url_content, then reason through technical, content, and performance issues. ``` ### 2. SEO Page (Single Page Analysis) Deep analysis of individual pages: ```python # Fetch page content python3 scripts/fetch_page.py https://example.com/page # Parse HTML for SEO signals python3 scripts/parse_html.py example_com_page.html # Check Core Web Vitals python3 scripts/pagespeed.py https://example.com/page ``` **Agent prompt:** ``` Analyze this single page for SEO: https://example.com/about — check title, meta description, headings hierarchy, internal links, schema markup, and Core Web Vitals. ``` ### 3. SEO Technical Crawlability, indexability, security, mobile-friendliness, and AI crawler policies: ```python # Check robots.txt policies python3 scripts/robots_checker.py https://example.com # Run indexability matrix (robots, meta robots, canonicals, status codes) python3 scripts/indexability_matrix.py https://example.com # Multi-page crawl audit python3 scripts/crawl_audit.py https://example.com --max-depth 3 ``` **Agent prompt:** ``` Run a technical SEO audit on https://example.com — check robots.txt, XML sitemaps, HTTPS, mobile responsiveness, JS rendering, and AI crawler access (GPTBot, ClaudeBot). ``` ### 4. SEO Content Content quality assessment with E-E-A-T framework (September 2025 Quality Rater Guidelines): ```python # Extract article content python3 scripts/fetch_page.py https://example.com/article # Run content quality checks (agent analyzes with LLM) # Check: word count, readability, E-E-A-T signals, topical depth ``` **Agent prompt:** ``` Assess content quality for https://example.com/blog/post using E-E-A-T criteria — check expertise signals, author credentials, content depth, readability, and December 2025 core update alignment. ``` ### 5. SEO Schema Schema.org detection, validation, and JSON-LD generation: ```python # Validate existing schema markup python3 scripts/validate_schema.py example_com.html # Check for deprecated schema types python3 scripts/parse_html.py example_com.html --extract-schema ``` **Agent prompt:** ``` Validate schema markup on https://example.com — check JSON-LD syntax, required fields, deprecated types, and suggest appropriate schema.org types (Article, Product, LocalBusiness, etc.). ``` **Example JSON-LD generation:** ```python # Agent generates schema based on page content schema = { "@context": "https://schema.org", "@type": "Article", "headline": "Page Title", "author": { "@type": "Person", "name": "Author Name" }, "datePublished": "2026-01-15", "dateModified": "2026-05-27", "image": "https://example.com/image.jpg", "publisher": { "@type": "Organization", "name": "Publisher Name", "logo": { "@type": "ImageObject", "url": "https://example.com/logo.png" } } } ``` ### 6. SEO Sitemap XML sitemap validation and generation: ```python # Discover and validate sitemaps python3 scripts/sitemap_checker.py https://example.com # Check for issues: 404s, lastmod quality, URL limits (50,000 per file) ``` **Agent prompt:** ``` Audit XML sitemaps for https://example.com — check discovery (robots.txt reference), URL limits, 404s, lastmod accuracy, and sitemap index structure. ``` ### 7. SEO Images Image optimization audit (alt text, formats, lazy loading, CLS): ```python # Generate image inventory python3 scripts/image_inventory.py https://example.com # Outputs: alt text coverage, dimensions, loading behavior, LCP candidates ``` **Agent prompt:** ``` Analyze image SEO for https://example.com — check alt text, file formats (WebP), lazy loading, responsive images (srcset), and LCP image optimization. ``` ### 8. SEO GEO (Generative Engine Optimization) Optimize for AI Overviews, ChatGPT, Perplexity: **Agent prompt:** ``` Optimize this content for AI search engines (ChatGPT, Perplexity, Google AI Overviews) — add clear definitions, structured facts, citations, and FAQ sections. ``` **Pattern:** - Use concise definitions (20-30 words) - Add structured lists and tables - Include citations and sources - Create FAQ sections for common queries ### 9. SEO AEO (Answer Engine Optimization) Optimize for Featured Snippets, People Also Ask, Knowledge Panels: **Agent prompt:** ``` Optimize for Featured Snippets — structure content with clear question headers, concise answers (40-60 words), and bulleted/numbered lists. ``` **Pattern:** ```markdown ## What is [Topic]? [Topic] is [concise 40-60 word definition]. ### Key Benefits: 1. Benefit one 2. Benefit two 3. Benefit three ``` ### 10. SEO Links Link profile analysis — internal links, backlinks, anchor text, orphan pages: ```python # Extract all links from page python3 scripts/parse_html.py example_com.html --extract-links # Agent analyzes: internal link structure, anchor text distribution, orphan pages ``` **Agent prompt:** ``` Audit internal linking structure for https://example.com — identify orphan pages, check anchor text diversity, analyze link depth, and suggest hub pages. ``` ### 11. SEO Programmatic Quality gates for programmatic SEO pages: **Agent prompt:** ``` Review programmatic SEO pages for quality — check for thin content, duplicate patterns, template issues, and unique value signals on each page. ``` **Quality gates:** - Minimum 800 words unique content per page - No placeholder text (e.g., "[City]", "Lorem ipsum") - Unique titles and meta descriptions - 3+ internal links to related pages ### 12. SEO Competitors Comparison and alternatives page generation: **Agent prompt:** ``` Generate a "Competitors" or "Alternatives" comparison page for [Product] — include feature tables, pricing comparison, use case fit, and neutral tone. ``` ### 13. SEO Hreflang International SEO and hreflang validation: ```python # Parse hreflang tags python3 scripts/parse_html.py example_com.html --extract-hreflang ``` **Agent prompt:** ``` Validate hreflang implementation for multi-language site — check bidirectional links, correct language codes (ISO 639-1), regional variants (en-US, en-GB), and x-default fallback. ``` ### 14. SEO Plan Strategic SEO planning with topical clusters and industry templates: **Agent prompt:** ``` Create an SEO content strategy for a SaaS product — build topical clusters, identify pillar pages, keyword themes, and internal linking structure. ``` **Industry templates available:** - SaaS - E-commerce - Local Business - Publisher/Media - Agency - Generic ### 15. SEO GitHub GitHub repository SEO optimization: ```python # Generate GitHub SEO report python3 scripts/github_seo_report.py owner/repo # Outputs: # - GITHUB-SEO-REPORT.md # - GITHUB-ACTION-PLAN.md ``` **Agent prompt:** ``` Optimize GitHub repository SEO for [owner/repo] — improve description, add topics, enhance README structure, optimize title/headline, and benchmark against query results. ``` **Key checks:** - Repository description (160 chars, keyword-rich) - Topics (8-12 relevant tags) - README structure (clear headline, features, installation) - Social preview image - Community health files (CODE_OF_CONDUCT.md, CONTRIBUTING.md) ### 16. SEO Article Article data extraction and LLM-driven content optimization: **Agent prompt:** ``` Extract article content and optimize — check headline, readability, keyword density, internal links, meta description, and suggest improvements. ``` ## 10 Specialist Agents The skill includes specialized agents for domain-specific analysis: 1. **Technical SEO Agent** — Crawlability, indexability, security, mobile, JS rendering 2. **Content Quality Agent** — E-E-A-T scoring, AI content detection 3. **Performance Agent** — Core Web Vitals (LCP, INP, CLS) 4. **Schema Markup Agent** — JSON-LD validation and generation 5. **Sitemap Agent** — XML sitemap quality gates 6. **Visual Analysis Agent** — Screenshots, above-the-fold analysis (requires Playwright) 7. **GitHub Analyst Agent** — Repository metadata and README optimization 8. **GitHub Benchmark Agent** — Query ranking and competitor intelligence 9. **GitHub Data Agent** — API fallback and traffic archival 10. **Verifier Agent (Global)** — Deduplication and contradiction suppression ## Key Scripts Reference ### Evidence Collection ```python # Fetch page with SEO crawler headers python3 scripts/fetch_page.py https://example.com # Output: example_com.html # Parse HTML for all SEO signals python3 scripts/parse_html.py example_com.html # Extracts: title, meta, headings, links, images, schema, canonical # Check robots.txt and crawler policies python3 scripts/robots_checker.py https://example.com # Multi-page crawl python3 scripts/crawl_audit.py https://example.com --max-depth 2 --max-pages 50 ``` ### Performance & Core Web Vitals ```python # PageSpeed Insights + Core Web Vitals python3 scripts/pagespeed.py https://example.com # Returns: LCP, INP, CLS scores + recommendations # Note: Requires PAGESPEED_API_KEY environment variable # Get free key: https://developers.google.com/speed/docs/insights/v5/get-started ``` ### Indexability & Crawlability ```python # Comprehensive indexability matrix python3 scripts/indexability_matrix.py https://example.com # Checks: robots.txt, meta robots, X-Robots-Tag, canonical, status codes, sitemaps # Sitemap validation python3 scripts/sitemap_checker.py https://example.com # Validates: URL limits, 404s, lastmod, discovery ``` ### Schema Validation ```python # Validate JSON-LD schema python3 scripts/validate_schema.py page.html # Checks: syntax, required fields, deprecated types, placeholders ``` ### Report Generation ```python # Full audit with all outputs