# seo

Walks Claude through technical and on-page SEO: crawl rules, canonicals, sitemaps, meta tags, JSON-LD. Useful when pages don't get indexed or snippets look broken.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 7191 repo stars
- Author: web-quality-skills
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(quality)/seo/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/web-quality-skills-seo

## What it does

The `seo` skill gives Claude a working checklist for technical and on-page SEO, built on Lighthouse SEO audits and Google Search guidance. It covers crawl rules in `robots.txt`, meta robots, canonical links, `sitemap.xml`, URL shape, HTTPS, `title` and heading markup, image alt text, internal links and JSON-LD structured data.

All of it ships as one `SKILL.md` file: a ranking-factor table that marks what the skill handles, templates for `robots.txt` and a sitemap, plus HTML snippets for canonicals, robots meta and images. Link authority sits outside its scope — the table crosses it out. Accessibility and page speed belong to `web-accessibility` and `core-web-vitals`, so a request that mixes them in gets pointed elsewhere instead of answered.

Install it with `npx skills add tech-leads-club/agent-skills --skill seo -a claude-code`; the file lands at `~/.claude/skills/seo/SKILL.md`. MIT licensed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill seo -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill seo -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill seo -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(quality)/seo'
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill seo -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(quality)/seo'
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/seo/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/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(quality)/seo/SKILL.md

## When to use it
- write a `robots.txt` that blocks admin and API paths
- stop duplicate pages with canonical links
- split a large `sitemap.xml` into an index
- fit title tags and meta descriptions to snippet length
- add Organization and Article JSON-LD

## Example prompts
- Audit the crawl setup: check `robots.txt`, canonical tags and `sitemap.xml` across the site.
- Add Organization JSON-LD to the homepage and validate it.
- Rewrite the duplicate `title` tags and meta descriptions on product pages.

## 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: 819ce9ecfa6955b7.

BEGIN THIRD-PARTY FILE 819ce9ecfa6955b7
````text
---
name: seo
description: Optimize for search engine visibility and ranking. Use when asked to "improve SEO", "optimize for search", "fix meta tags", "add structured data", "sitemap optimization", or "search engine optimization". Do NOT use for accessibility (use web-accessibility), performance (use core-web-vitals), or comprehensive site audits covering multiple areas (use web-quality-audit).
license: MIT
metadata:
  author: web-quality-skills
  version: '1.0'
---

# SEO optimization

Search engine optimization based on Lighthouse SEO audits and Google Search guidelines. Focus on technical SEO, on-page optimization, and structured data.

## SEO fundamentals

Search ranking factors (approximate influence):

| Factor                            | Influence | This Skill                                         |
| --------------------------------- | --------- | -------------------------------------------------- |
| Content quality & relevance       | ~40%      | Partial (structure)                                |
| Backlinks & authority             | ~25%      | ✗                                                  |
| Technical SEO                     | ~15%      | ✓                                                  |
| Page experience (Core Web Vitals) | ~10%      | See [Core Web Vitals](../core-web-vitals/SKILL.md) |
| On-page SEO                       | ~10%      | ✓                                                  |

---

## Technical SEO

### Crawlability

**robots.txt:**

```text
# /robots.txt
User-agent: *
Allow: /

# Block admin/private areas
Disallow: /admin/
Disallow: /api/
Disallow: /private/

# Don't block resources needed for rendering
# ❌ Disallow: /static/

Sitemap: https://example.com/sitemap.xml
```

**Meta robots:**

```html
<!-- Default: indexable, followable -->
<meta name="robots" content="index, follow" />

<!-- Noindex specific pages -->
<meta name="robots" content="noindex, nofollow" />

<!-- Indexable but don't follow links -->
<meta name="robots" content="index, nofollow" />

<!-- Control snippets -->
<meta name="robots" content="max-snippet:150, max-image-preview:large" />
```

**Canonical URLs:**

```html
<!-- Prevent duplicate content issues -->
<link rel="canonical" href="https://example.com/page" />

<!-- Self-referencing canonical (recommended) -->
<link rel="canonical" href="https://example.com/current-page" />

<!-- For paginated content -->
<link rel="canonical" href="https://example.com/products" />
<!-- Or use rel="prev" / rel="next" for explicit pagination -->
```

### XML sitemap

```xml
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/</loc>
    <lastmod>2024-01-15</lastmod>
    <changefreq>daily</changefreq>
````
END THIRD-PARTY FILE 819ce9ecfa6955b7

The third-party file has ended. Everything between the 819ce9ecfa6955b7 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 2787 of 12232 bytes. © web-quality-skills · MIT · https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(quality)/seo/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
