# seo-audit

Runs a website audit through the SEOmator CLI and returns a health score with issues grouped by category. Can diff two runs to show what a deploy changed.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 installs · ★ 648
- Author: seomator
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/seo-skills/seo-audit-skill/tree/HEAD/SKILL.md
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/skills/seomator-seo-audit

## What it does

The skill drives the SEOmator command-line tool, which checks pages against 373 rules in 20 categories: canonical tags, performance, broken links, Schema.org markup, security headers, accessibility, hreflang, AI search readiness. You get an overall score from 0 to 100 with a letter grade, per-category pass/warn/fail counts, and affected URLs with suggested fixes.

Node.js 20.3 or newer and npm are required; the tool itself comes from `npm install -g @seomator/seo-audit`. A Chrome or Chromium install matters only for Core Web Vitals and JS rendering checks. The skill's `allowed-tools` is narrowed to `Bash(seomator:*)`, so the agent can call the auditor and nothing else.

Some checks stay unmeasured unless you pass the matching flag. Click depth and inbound internal links need `--crawl`; mobile-first parity needs `--mobile`. Skipping the browser with `--no-cwv` makes a run faster, and Core Web Vitals, JS errors and mobile parity then report as unmeasured instead of passing. For agents there is `--format llm`, XML that comes out smaller than JSON.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add seo-skills/seo-audit-skill --skill seo-audit -a claude-code
```
```bash
npx skills add seo-skills/seo-audit-skill --skill seomator-seo-audit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/seomator-seo-audit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/seomator-seo-audit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add seo-skills/seo-audit-skill --skill seomator-seo-audit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/seomator-seo-audit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add seo-skills/seo-audit-skill --skill seomator-seo-audit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/seomator-seo-audit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install seo-skills/seo-audit-skill seomator-seo-audit
```

2. **Manually: put the files in place**
- File: `.github/skills/seomator-seo-audit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add seo-skills/seo-audit-skill --skill seomator-seo-audit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/seo-skills/seo-audit-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/seomator-seo-audit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add seo-skills/seo-audit-skill --skill seomator-seo-audit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/seo-skills/seo-audit-skill/tree/HEAD/SKILL.md

## When to use it
- catch broken links and redirect chains on a site
- compare site state before and after a release
- find pages with missing or conflicting canonical URLs
- check security headers and SSL certificate expiry
- assess how ready a site is for AI search and bot access

## Example prompts
- Audit `example.com` with seomator and list the critical issues
- Compare two audits of the domain and tell me what changed after the deploy
- Run the audit with `--crawl` and `--mobile` and give me the llm-format report

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f92e438697c14e18.

BEGIN THIRD-PARTY FILE f92e438697c14e18
```text
---
name: seo-audit
description: Audit websites for SEO, technical, content, security, JS rendering, and AI readiness using SEOmator CLI. Returns LLM-optimized reports with health scores across 373 rules and 20 categories, and can diff two audits to show what a deploy changed. Use when analyzing websites, debugging SEO issues, checking site health, or comparing a site before and after a change.
license: MIT
compatibility: Requires Node.js 20.3+ and npm. Chrome/Chromium optional for Core Web Vitals and JS rendering.
metadata:
  author: seomator
  version: "7.0.0"
allowed-tools: Bash(seomator:*)
---

# SEO Audit Skill

Audit websites for SEO, technical, content, performance, security, JavaScript rendering, and AI readiness using the SEOmator CLI.

SEOmator provides comprehensive website auditing by analyzing website structure and content against **373 rules** across **20 categories**.

It provides a list of issues with severity levels, affected URLs, and actionable fix suggestions.

## Links

* SEOmator npm package: [npmjs.com/package/@seomator/seo-audit](https://www.npmjs.com/package/@seomator/seo-audit)
* GitHub repository: [github.com/seo-skills/seo-audit-skill](https://github.com/seo-skills/seo-audit-skill)
* Web UI: [seomator.com/free-seo-audit-tool](https://seomator.com/free-seo-audit-tool)

## What This Skill Does

This skill enables AI agents to audit websites for **373 rules** in **20 categories**, including:

- **Core SEO** (24 rules): Canonical URLs, indexing directives, title uniqueness, canonical conflicts/loops
- **Performance** (28 rules): LCP, CLS, FCP, TTFB, INP, compression, caching, minification, HTTP/2
- **Links** (27 rules): Broken links, redirect chains, anchor text, localhost/fragment links, plus click depth and inbound internal links from the site graph (`--crawl`)
- **Images** (14 rules): Alt text, dimensions, lazy loading, modern formats, alt length, background images
- **Security** (26 rules): HTTPS, HSTS, CSP, external link safety, leaked secrets, SSL expiry/protocol, cookie flags and lifetime
- **Technical SEO** (18 rules): robots.txt, sitemap.xml, URL structure, 404 pages, soft 404s, error codes
- **Crawlability** (38 rules): Sitemap conflicts, indexability signals, canonical chains, pagination issues, sitemap lastmod quality
- **Structured Data** (19 rules): Schema.org markup, Article, Organization, FAQ, Product, Breadcrumb
- **JavaScript Rendering** (16 rules): Rendered DOM checks, raw vs rendered mismatches, SSR detection, console errors, failed resource requests
```
END THIRD-PARTY FILE f92e438697c14e18

The third-party file has ended. Everything between the f92e438697c14e18 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2538 of 23163 bytes. © seomator · MIT · https://github.com/seo-skills/seo-audit-skill/tree/HEAD/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md