fixing-metadata

name	fixing-metadata
description	Audit and fix HTML metadata including page titles, meta descriptions, canonical URLs, Open Graph tags, Twitter cards, favicons, JSON-LD structured data, and robots directives. Use when adding or reviewing SEO and social metadata.
type	skill
created	2026-02-27T00:00:00.000Z
domain	communication-content
category	social-media
risk	safe
source	community
tags	["skill","communication-content","social-media","fixing","metadata"]

Workflow

1. Identify pages with missing or incorrect metadata (titles, descriptions, canonical, OG tags)
2. Audit against the priority rules below — fix critical issues (duplicates, indexing) first
3. Ensure title, description, canonical, and og:url all agree with each other
4. Verify social cards render correctly on a real URL, not localhost
5. Keep diffs minimal and scoped to metadata only — do not refactor unrelated code

When to Use

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

rule categories by priority

priority	category	impact
1	correctness and duplication	critical
2	title and description	high
3	canonical and indexing	high
4	social cards	high
5	icons and manifest	medium
6	structured data	medium
7	locale and alternates	low-medium
8	tool boundaries	critical

quick reference

1. correctness and duplication (critical)

• define metadata in one place per page, avoid competing systems
• do not emit duplicate title, description, canonical, or robots tags
• metadata must be deterministic, no random or unstable values
• escape and sanitize any user-generated or dynamic strings
• every page must have safe defaults for title and description

2. title and description (high)

• every page must have a title
• use a consistent title format across the site
• keep titles short and readable, avoid stuffing
• shareable or searchable pages should have a meta description
• descriptions must be plain text, no markdown or quote spam