# seo-audit

The seo-audit skill for Claude Code conducts a technical SEO audit of your website and generates a prioritized report. The agent checks indexing, meta tags, site speed, and internal links.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 285 repo stars
- Author: makushingu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makushingu/harness-maxxing/tree/HEAD/skills/seo-audit/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/makushingu-seo-audit

## What it does

This tool inspects essential SEO metrics including `robots.txt`, `sitemap.xml`, server status codes, and HTML meta tags. It relies on standard system utilities like `curl` and native Python scripts to parse HTML and retrieve live data instead of making assumptions.

To evaluate page speed, the agent queries the Google PageSpeed Insights API. It saves the findings in a markdown document, providing a table where issues are prioritized by their impact on search performance. The agent can suggest direct fixes to the site code based on the generated report.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install makushingu/harness-maxxing skills/seo-audit
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/seo-audit
```

### Windsurf (Devin Desktop)

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

### 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/makushingu/harness-maxxing/tree/HEAD/skills/seo-audit/SKILL.md

## When to use it
- Verify `robots.txt` and `sitemap.xml` validity
- Identify pages missing meta descriptions or having duplicate `title` tags
- Assess page performance via Core Web Vitals
- Locate broken internal links and redirect issues

## Example prompts
- Perform a technical SEO audit of my website
- Why are my pages ranking poorly in search?
- Check meta tags and page speed on the homepage

## Similar
- [seo-audit-full](https://affpapa.org/en/nevibecode/skills/seo-audit-full.md) — skill · 537 installs
- [firecrawl-seo-audit](https://affpapa.org/en/nevibecode/skills/firecrawl-seo-audit.md) — skill · 32400 installs
- [ecommerce-seo-audit](https://affpapa.org/en/nevibecode/skills/ecommerce-seo-audit.md) — skill · 859 installs
- [SEO Web Analysis MCP — Site Audit & Tech Stack](https://affpapa.org/en/nevibecode/mcp/seo-web-analysis-mcp-site-audit-tech-stack.md) — MCP server · 9357 installs
- [seo-site-health-audit](https://affpapa.org/en/nevibecode/skills/seo-site-health-audit.md) — skill · 291 installs
- [seo-backlink-audit](https://affpapa.org/en/nevibecode/skills/seo-backlink-audit.md) — skill · 288 installs

## Other versions with the same name
- [seo-audit · coreyhaines31](https://affpapa.org/en/nevibecode/skills/coreyhaines31-seo-audit.md) — 257200 installs
- [seo-audit · agricidaniel](https://affpapa.org/en/nevibecode/skills/agricidaniel-seo-audit.md) — 9200 installs
- [seo-audit · every-app](https://affpapa.org/en/nevibecode/skills/every-app-seo-audit.md) — 6000 installs
- [seo-audit · anthropics](https://affpapa.org/en/nevibecode/skills/anthropics-seo-audit.md) — 4000 installs
- [seo-audit · sickn33](https://affpapa.org/en/nevibecode/skills/sickn33-seo-audit.md) — 1000 installs

From the same set: [makushingu/harness-maxxing](https://affpapa.org/en/nevibecode/by/makushingu/harness-maxxing.md) — 21 cards

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