seo-expert — Claude Code skill for Next.js SEO
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.
no license 2 installs ★ 224 updated 2026-10-29
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a claude-codeWhat seo-expert 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.
What it helps with
- 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 for the agent
- 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.
How to install seo-expert
1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a claude-code2Manually: put the files in place
~/.claude/skills/seo-expert/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-expert/
1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a codex2Manually: put the files in place
.agents/skills/seo-expert/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a cursor2Manually: put the files in place
.cursor/skills/seo-expert/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NeverSight/learn-skills.dev data/skills-md/bh611627/skillcodex/seo-expert2Manually: put the files in place
.github/skills/seo-expert/SKILL.md1Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a gemini-cli2Platform CLI
gemini skills install https://github.com/NeverSight/learn-skills.dev --path data/skills-md/bh611627/skillcodex/seo-expertManually: put the files in place
.devin/skills/seo-expert/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about seo-expert
How do I install seo-expert in Claude Code?
Run npx skills add NeverSight/learn-skills.dev --skill seo-expert -a claude-code. The skill file is at ~/.claude/skills/seo-expert/SKILL.md.
What does seo-expert do?
It produces SEO guidance for Next.js pages, covering search intent, metadata, headings, internal links, and JSON-LD. It also suggests follow-up work involving Search Console and Core Web Vitals.
Does seo-expert support Pages Router?
Yes. It uses next/head guidance for Pages Router and metadata or generateMetadata for routes in app/. It warns against mixing the router-specific approaches on the same page.