# seo-title-optimization

The seo-title-optimization Claude Code skill audits and rewrites SEO page titles. It activates for requests about title tags, SERP titles, CTR, truncation, or title changes across pages.

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

## What it does

The skill revises page titles against a target query and the page’s search intent. It checks whether the title, meta description, H1, and URL slug address the same topic. For bulk edits, it returns a table with current and proposed titles plus a short reason for each change.

It starts by identifying the query and page type. When search-result data is available, the skill compares ranking titles before drafting options and selecting one. Its suggested target is 40–55 characters where practical. Search-result data is only used for comparison when available.

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill seo-title-optimization -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill seo-title-optimization -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Illyism/seo-skills seo/seo-title-optimization/SKILL.md
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/Illyism/seo-skills --path seo/seo-title-optimization
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Illyism/seo-skills --skill seo-title-optimization -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/Illyism/seo-skills/tree/HEAD/seo/seo-title-optimization/SKILL.md

## When to use it
- replace a vague page title with one that reflects its target query
- align a page title with its meta description and H1
- check whether key words may be cut off in search results
- revise titles across several pages in a before-and-after table

## Example prompts
- Review this page’s SEO title and suggest clearer alternatives.
- Check whether this page’s `title`, meta description, and H1 match.
- Rewrite the titles in this page list and return a before-and-after table.

## Similar
- [title-tag](https://affpapa.org/en/nevibecode/skills/title-tag.md) — skill · 1300 installs
- [product-title-optimization](https://affpapa.org/en/nevibecode/skills/product-title-optimization.md) — skill · 1400 installs
- [title-formulas](https://affpapa.org/en/nevibecode/skills/title-formulas.md) — skill · ★ 288 repo stars
- [seo-cluster](https://affpapa.org/en/nevibecode/skills/seo-cluster.md) — skill · 7800 installs
- [local-seo](https://affpapa.org/en/nevibecode/skills/local-seo.md) — skill · 5300 installs
- [r01-hesreallyhim-awesome-claude-code-seo-content-marketing](https://affpapa.org/en/nevibecode/skills/r01-hesreallyhim-awesome-claude-code-seo-content-marketing.md) — skill · 1000 installs

From the same set: [illyism/seo-skills](https://affpapa.org/en/nevibecode/by/illyism/seo-skills.md) — 29 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
