fixing-metadata
Installation
Summary
Audit and fix HTML metadata including titles, descriptions, canonical URLs, Open Graph tags, and structured data.
- Covers eight priority categories: correctness and duplication, title and description, canonical and indexing, social cards, icons and manifest, structured data, locale and alternates, and tool boundaries
- Ensures metadata consistency across page titles, descriptions, canonical URLs, and Open Graph tags; prevents duplicates and enforces deterministic values
- Includes rules for social card rendering, favicon setup, JSON-LD validation, and hreflang alternates for localized content
- Designed to work within existing metadata patterns (Next.js metadata API, react-helmet, manual head tags) without framework migration
SKILL.md
Workflow
- Identify pages with missing or incorrect metadata (titles, descriptions, canonical, OG tags)
- Audit against the priority rules below — fix critical issues (duplicates, indexing) first
- Ensure title, description, canonical, and og:url all agree with each other
- Verify social cards render correctly on a real URL, not localhost
- Keep diffs minimal and scoped to metadata only — do not refactor unrelated code
when to apply
Reference these guidelines when:
- adding or changing page titles, descriptions, canonical, robots
- implementing Open Graph or Twitter card metadata
- setting favicons, app icons, manifest, theme-color
- building shared SEO components or layout metadata defaults
- adding structured data (JSON-LD)
- changing locale, alternate languages, or canonical routing
- shipping new pages, marketing pages, or shareable links