fixing-metadata_skill

Overview

This skill helps teams ship correct, consistent, and complete page metadata so pages index and share reliably. It applies lightweight, practical checks and fixes for titles, descriptions, canonicals, social cards, icons, structured data, and locale alternates. The goal is minimal, safe diffs that respect existing metadata patterns and tool boundaries.

How this skill works

Run the skill to inspect a page or a specific file for metadata violations. It reports each violation with the exact snippet, a one-sentence explanation of why it matters, and a concrete code-level fix you can apply. The skill enforces determinism, prevents duplication, and prioritizes critical issues like canonical, indexing, and social card mismatches.

When to use it

• When adding or changing page titles or descriptions
• When implementing Open Graph or Twitter card metadata
• When setting canonical URLs, robots, or noindex rules
• When adding favicons, manifest, or theme-color
• When introducing JSON-LD structured data
• When localizing pages or adding hreflang alternates

Best practices

• Define metadata in one place per page and avoid competing systems
• Prefer stable, deterministic values; never emit random or time-based values
• Keep titles short; provide plain-text descriptions for shareable pages
• Ensure canonical equals og:url and matches the preferred public URL
• Use absolute URLs for social images and validate recommended dimensions
• Limit JSON-LD to accurate, rendered content and include only one block when possible

Example use cases

• Scan a new marketing page to ensure it has title, description, canonical, og tags, and a social image with absolute URL
• Audit a site migration to remove duplicate titles/descriptions and fix canonical routing
• Validate staging previews are noindex and production pages are indexable
• Fix duplicate metadata emitted by framework defaults plus a custom head component
• Review JSON-LD to remove invented ratings or prices and align structured data with page content