laguagu/claude-code-nextjs-skills / skills/nextjs-seo
nextjs-seo
VerifiedNext.js App Router SEO implementation and audits. Use for metadata and social images, sitemap/robots, canonicals and localization, structured data, Core Web Vitals evidence, AI crawler policy or search-indexing diagnosis. Not for general Next.js feature work unrelated to SEO.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.0 KB |
| references/ai-search.md | markdown | 7.1 KB |
| references/checklist.md | markdown | 2.6 KB |
| references/json-ld.md | markdown | 2.2 KB |
| references/metadata-api.md | markdown | 3.7 KB |
| references/sitemap-robots.md | markdown | 2.9 KB |
| references/troubleshooting.md | markdown | 4.3 KB |
references/json-ld.md
View on GitHub# Structured data
Start from the page's real content and intended consumer. Schema.org validity
and Google rich-result eligibility are different checks. Consult the current
[Google search gallery](https://developers.google.com/search/docs/appearance/structured-data/search-gallery)
and the selected feature's documentation before choosing a type; supported
features and restrictions change.
Retired Google rich results that older examples still add (as of 2026-10):
FAQ (gone for all sites from 2026-05-07), HowTo (2023), Sitelinks search box
(the `SearchAction` in `WebSite` markup, 2024; `WebSite` still serves site
names), Course Info, Claim Review, Estimated Salary, Learning Video, Special
Announcement and Vehicle Listing (2025), Practice Problems (2026-01). Dataset
markup serves Dataset Search only. Such markup can remain for other consumers
but yields no Google rich result ([Search updates](https://developers.google.com/search/updates)).
Mark up only facts users can verify on the page or through its legitimate
associated content. Do not invent reviews, ratings, prices, stock, authors,
credentials or organization details. An optional FAQ section does not justify
schema solely for search visibility.
Use stable absolute URLs and identifiers for the relevant entities. Share
organization/page data where useful; `@graph` is an organizational option,
not a requirement. Avoid conflicting duplicates from manual markup and a
library. In App Router, a plain `application/ld+json` script is appropriate;
it does not require executable-script loading strategies.
Serialize data safely. JSON text inside an HTML script can contain
`</script>`; escape `<` after JSON serialization or use an established safe
serializer, for example `JSON.stringify(data).replace(/</g, '\\u003c')`.
Do not concatenate untrusted strings into markup. See the
[Next.js JSON-LD guide](https://nextjs.org/docs/app/guides/json-ld).
Validate the served production markup with the relevant consumer's validator.
Google's Rich Results Test assesses supported features; a Schema.org
validator answers a broader vocabulary question. Fix invalid or misleading
markup, then inspect Search Console reporting where available. Valid markup
does not guarantee a rich result or ranking improvement.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |