Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NeverSight/learn-skills.dev --skill seo-expert -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/seo-expert/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-expert/

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.

Similar skills

All skills for SEO and GEO →

From the same set6

Project sponsors

Companies that keep this analytics open