# seo-optimizer

seo-optimizer audits Yoast and Rank Math fields across a WordPress site, then fixes focus keywords, meta descriptions and missing featured images.

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

## What it does

The skill walks every page and post on a WordPress site and measures them against a fixed set of rules. Each entry needs a focus keyword of one to three words, that keyword has to appear inside the meta description, and the description itself should run 120 to 160 characters. A post without a featured image fails the check, and so does an image whose ALT text or title ignores the keyword.

Data comes over the WordPress REST API, with a fallback to SQL against `wp_postmeta` when the endpoints are restricted. The audit splits across parallel agents, so several page groups get checked at once, and each page returns a record with statuses plus a list of fixes. A second pass applies them: rewrites the description, adds the keyword, uploads a matching photo to the media library and attaches it as the featured image.

Photo lookup depends on an Unsplash MCP server declared in `/root/.claude/.mcp.json`. Skip that setup and the skill still reports problems but cannot fill in missing images. Writes also need credentials with edit rights on the site, because a read-only key stalls the fix phase.

## Install

### Claude Code (native platform)

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

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill seo-optimizer -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill seo-optimizer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aiskillstore/marketplace skills/crazyswami/seo-optimizer
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/aiskillstore/marketplace --path skills/crazyswami/seo-optimizer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add aiskillstore/marketplace --skill seo-optimizer -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/aiskillstore/marketplace/tree/HEAD/skills/crazyswami/seo-optimizer/SKILL.md

## When to use it
- find pages and posts that have no focus keyword
- check meta description length and keyword coverage
- fill in missing featured images from Unsplash
- rewrite image ALT text and title around the keyword
- produce a per-page SEO report with fixes

## Example prompts
- Run a full SEO audit across every page and post
- Check the `portfolio` page and rewrite its meta description
- Find posts without a featured image and pull photos from Unsplash

## Similar
- [seo-meta-optimizer](https://affpapa.org/en/nevibecode/agents/seo-meta-optimizer.md) — subagent · ★ 42780 repo stars
- [seo-audit-orchestration](https://affpapa.org/en/nevibecode/skills/seo-audit-orchestration.md) — skill · 287 installs
- [local-seo-optimizer](https://affpapa.org/en/nevibecode/skills/local-seo-optimizer.md) — skill · 114 installs
- [seo-podcast-optimizer](https://affpapa.org/en/nevibecode/agents/seo-podcast-optimizer.md) — subagent · 532 installs
- [akii-seo-ai-search-optimizer](https://affpapa.org/en/nevibecode/plugins/akii-seo-ai-search-optimizer.md) — plugin · ★ 80 repo stars
- [meta-description](https://affpapa.org/en/nevibecode/skills/meta-description.md) — skill · 1300 installs

## Other versions with the same name
- [seo-optimizer · claude-office-skills](https://affpapa.org/en/nevibecode/skills/claude-office-skills-seo-optimizer.md) — 5000 installs
- [seo-optimizer · ailabs-393](https://affpapa.org/en/nevibecode/skills/ailabs-393-seo-optimizer.md) — 1300 installs
- [seo-optimizer · davila7](https://affpapa.org/en/nevibecode/skills/seo-optimizer.md) — 11415 installs
- [seo-optimizer · secondsky](https://affpapa.org/en/nevibecode/skills/secondsky-seo-optimizer.md) — 462 installs
- [seo-optimizer · oakoss](https://affpapa.org/en/nevibecode/skills/oakoss-seo-optimizer.md) — 125 installs

From the same set: [aiskillstore/marketplace](https://affpapa.org/en/nevibecode/by/aiskillstore/marketplace.md) — 18 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
