# seo-expert

The seo-expert skill reviews search intent, metadata, and technical SEO for Next.js pages. Use it when shaping a page for search or checking its structured data.

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

## What it does

The skill identifies a page’s primary search intent and aligns the URL, title, meta description, and H1/H2 outline with it. It can flag content gaps, suggest internal links, and provide checks for Open Graph and Twitter Cards. For structured data, it selects one main JSON-LD type and checks that the markup reflects the page’s visible content.

Its Next.js guidance distinguishes App Router from Pages Router: routes under `app/` use `metadata` or `generateMetadata`, while `next/head` belongs in Pages Router. The workflow also covers Search Console and Core Web Vitals. It favors Search Console field data when assessing what Google sees, rather than relying on Lighthouse alone. The skill is read-only, so it does not modify project files. For deeper CWV work it points to `performance-audit`; multilingual SEO is directed to `i18n-handbook`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NeverSight/learn-skills.dev data/skills-md/bh611627/skillcodex/seo-expert
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NeverSight/learn-skills.dev --path data/skills-md/bh611627/skillcodex/seo-expert
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NeverSight/learn-skills.dev --skill seo-expert -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/NeverSight/learn-skills.dev/tree/HEAD/data/skills-md/bh611627/skillcodex/seo-expert/SKILL.md

## When to use it
- identify the main search intent for a page
- align a URL, title, and headings with that intent
- draft JSON-LD that matches visible page content
- check metadata setup for either Next.js router
- prioritize Search Console and CWV follow-up

## Example prompts
- Review the SEO for this Next.js page: identify its search intent and suggest a URL, title, and meta description.
- Check whether this page’s JSON-LD matches the content visitors can see.
- Use these Search Console results to prioritize indexing and Core Web Vitals work.

## Similar
- [nextjs-seo](https://affpapa.org/en/nevibecode/skills/nextjs-seo.md) — skill · 2600 installs
- [seo](https://affpapa.org/en/nevibecode/skills/a5c-ai-seo.md) — skill · 3 installs
- [seo-meta-optimizer](https://affpapa.org/en/nevibecode/agents/seo-meta-optimizer.md) — subagent · ★ 42780 repo stars
- [seo-project-setup](https://affpapa.org/en/nevibecode/skills/seo-project-setup.md) — skill · 7600 installs
- [seo-audit](https://affpapa.org/en/nevibecode/skills/every-app-seo-audit.md) — skill · 6000 installs
- [anycap-ai-tool-seo](https://affpapa.org/en/nevibecode/skills/anycap-ai-tool-seo.md) — skill · 746 installs

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