AgentSkillsCN

vkc-seo-metadata

在 VKC 中标准化 Next.js 元数据(generateMetadata、buildPageMetadata、canonical、alternates、OG、Twitter、robots/noindex)。在调整 SEO、站点地图、robots 或社交预览时使用此技能。

SKILL.md
--- frontmatter
name: vkc-seo-metadata
description: Standardize Next.js metadata in VKC (generateMetadata, buildPageMetadata, canonical, alternates, OG, Twitter, robots/noindex). Use when changing SEO, sitemap, robots, or social previews.
metadata:
  short-description: SEO metadata + sitemap/robots

VKC SEO Metadata (generateMetadata)

When to use

  • You touch generateMetadata or page metadata behavior.
  • You need canonical / alternates (hreflang) alignment for i18n routes.
  • You change OpenGraph(OG) / Twitter previews.
  • You change src/app/sitemap.ts or src/app/robots.ts.
  • You need robots control (e.g. noindex, gated pages, admin-only pages).

Hard rules (this repo)

  • Prefer buildPageMetadata from src/lib/seo/metadata.ts to avoid drift.
  • Always set:
    • alternates.canonical
    • alternates.languages
  • If a page should not be indexed, set robots in metadata (do not rely on ad-hoc tags).

Canonical references

  • Metadata builder: src/lib/seo/metadata.ts (buildPageMetadata)
  • Sitemap: src/app/sitemap.ts
  • Robots: src/app/robots.ts

References

  • Spec & checklist: .codex/skills/vkc-seo-metadata/references/metadata-spec.md