$npx -y skills add seo-skills/seo-audit-skill --skill skillAudit websites for SEO, technical, content, security, JS rendering, and AI readiness using SEOmator CLI. Returns LLM-optimized reports with health scores across 251 rules and 20 categories. Use when analyzing websites, debugging SEO issues, or checking site health.
| 1 | # SEO Audit Skill |
| 2 | |
| 3 | Audit websites for SEO, technical, content, performance, security, JavaScript rendering, and AI readiness using the SEOmator CLI. |
| 4 | |
| 5 | SEOmator provides comprehensive website auditing by analyzing website structure and content against **251 rules** across **20 categories**. |
| 6 | |
| 7 | It provides a list of issues with severity levels, affected URLs, and actionable fix suggestions. |
| 8 | |
| 9 | ## Links |
| 10 | |
| 11 | * SEOmator npm package: [npmjs.com/package/@seomator/seo-audit](https://www.npmjs.com/package/@seomator/seo-audit) |
| 12 | * GitHub repository: [github.com/seo-skills/seo-audit-skill](https://github.com/seo-skills/seo-audit-skill) |
| 13 | * Web UI: [seomator.com/free-seo-audit-tool](https://seomator.com/free-seo-audit-tool) |
| 14 | |
| 15 | ## What This Skill Does |
| 16 | |
| 17 | This skill enables AI agents to audit websites for **251 rules** in **20 categories**, including: |
| 18 | |
| 19 | - **Core SEO** (19 rules): Canonical URLs, indexing directives, title uniqueness, canonical conflicts/loops |
| 20 | - **Performance** (22 rules): LCP, CLS, FCP, TTFB, INP, compression, caching, minification, HTTP/2 |
| 21 | - **Links** (19 rules): Broken links, redirect chains, anchor text, orphan pages, localhost/fragment links |
| 22 | - **Images** (14 rules): Alt text, dimensions, lazy loading, modern formats, alt length, background images |
| 23 | - **Security** (16 rules): HTTPS, HSTS, CSP, external link safety, leaked secrets, SSL expiry/protocol |
| 24 | - **Technical SEO** (13 rules): robots.txt, sitemap.xml, URL structure, 404 pages, soft 404s, error codes |
| 25 | - **Crawlability** (18 rules): Sitemap conflicts, indexability signals, canonical chains, pagination issues |
| 26 | - **Structured Data** (13 rules): Schema.org markup, Article, Organization, FAQ, Product, Breadcrumb |
| 27 | - **JavaScript Rendering** (13 rules): Rendered DOM checks, raw vs rendered mismatches, SSR detection |
| 28 | - **Accessibility** (12 rules): ARIA labels, color contrast, form labels, landmarks, touch targets |
| 29 | - **Content** (17 rules): Word count, readability, keyword density, duplicate detection, pixel widths |
| 30 | - **Social** (9 rules): Open Graph tags, Twitter cards, share buttons, profile links |
| 31 | - **E-E-A-T** (14 rules): Author bylines, citations, trust signals, about/contact pages, YMYL detection |
| 32 | - **URL Structure** (14 rules): Keyword slugs, stop words, uppercase, underscores, session IDs, tracking params |
| 33 | - **Redirects** (8 rules): Redirect loops, types (301/302), meta refresh, JavaScript redirects, broken redirects |
| 34 | - **Mobile** (5 rules): Font sizes, horizontal scroll, intrusive interstitials, viewport issues |
| 35 | - **Internationalization** (10 rules): lang attribute, hreflang validation (return links, conflicts, mismatches) |
| 36 | - **HTML Validation** (9 rules): Doctype, charset, head structure, lorem ipsum, multiple titles/descriptions |
| 37 | - **AI/GEO Readiness** (5 rules): Semantic HTML, AI bot access, llms.txt, schema drift |
| 38 | - **Legal Compliance** (1 rule): Cookie consent |
| 39 | |
| 40 | The audit crawls the website, analyzes each page against audit rules, and returns a comprehensive report with: |
| 41 | - Overall health score (0-100) with letter grade (A-F) |
| 42 | - Category breakdowns with pass/warn/fail counts |
| 43 | - Specific issues with affected URLs grouped by rule |
| 44 | - Actionable fix recommendations |
| 45 | |
| 46 | ## When to Use |
| 47 | |
| 48 | Use this skill when you need to: |
| 49 | - Analyze a website's SEO health |
| 50 | - Debug technical SEO issues |
| 51 | - Check for broken links and redirect chains |
| 52 | - Validate meta tags, canonical URLs, and structured data |
| 53 | - Audit security headers, SSL, and HTTPS |
| 54 | - Check accessibility compliance |
| 55 | - Analyze JavaScript rendering and SSR compatibility |
| 56 | - Evaluate AI/GEO readiness (semantic HTML, llms.txt, bot access) |
| 57 | - Detect duplicate content across pages |
| 58 | - Validate hreflang and internationalization setup |
| 59 | - Check HTML document structure and validation |
| 60 | - Generate site audit reports in multiple formats |
| 61 | - Compare site health before/after changes |
| 62 | |
| 63 | ## Prerequisites |
| 64 | |
| 65 | This skill requires the SEOmator CLI to be installed. |
| 66 | |
| 67 | ### Installation |
| 68 | |
| 69 | ```bash |
| 70 | npm install -g @seomator/seo-audit |
| 71 | ``` |
| 72 | |
| 73 | ### Verify Installation |
| 74 | |
| 75 | Check that seomator is installed and the system is ready: |
| 76 | |
| 77 | ```bash |
| 78 | seomator self doctor |
| 79 | ``` |
| 80 | |
| 81 | This checks: |
| 82 | - Node.js version (18+ recommended) |
| 83 | - npm availability |
| 84 | - Chrome/Chromium for Core Web Vitals and JS rendering |
| 85 | - Write permissions for ~/.seomator |
| 86 | - Local config file presence |
| 87 | |
| 88 | ## Setup |
| 89 | |
| 90 | Running `seomator init` creates a `seomator.toml` config file in the current directory. |
| 91 | |
| 92 | ```bash |
| 93 | seomator init # Interactive setup |
| 94 | seomator init -y # Use defaults |
| 95 | seomator init --preset blog # Blog-optimized config |