fixing-metadata

Audit and fix HTML metadata including titles, canonical URLs, Open Graph tags, and JSON-LD.

1|Updated Aug 31, 2026
One-click install
npx skills add https://github.com/gagandeepgill/puzzle-game --skill fixing-metadata-gagandeepgill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fixing-metadata
Source: https://github.com/gagandeepgill/puzzle-game/tree/main/.claude/skills/fixing-metadata
Command: npx skills add https://github.com/gagandeepgill/puzzle-game --skill fixing-metadata-gagandeepgill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Web pages often ship with missing, duplicated, or inconsistent metadata, which breaks search indexing, canonical routing, and social share previews. This Skill provides a prioritized audit workflow to find and fix those issues without touching unrelated code. ## Core Features & Use Cases - Prioritized audit rules: Eight rule categories ranked by impact, from critical duplication and indexing issues down to locale and alternate handling. - Social card verification: Ensures Open Graph and Twitter card tags use absolute URLs, correct image dimensions, and an og:url that matches the canonical URL. - Structured data and icons: Validates JSON-LD against actual page content and checks favicons, apple-touch-icons, manifests, and theme-color settings. - Use Case: Before launching a new marketing page, run the audit to confirm the title, description, canonical, and og:url all agree, then verify the share card renders correctly on the live URL rather than localhost. ## Quick Start Audit the metadata on my site's pages and fix any duplicate titles, missing canonical tags, or broken Open Graph images.

Frequently Asked Questions about fixing-metadata

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix duplicate title and meta description tags on a page?▼

Define metadata in one place per page and remove competing sources that emit the same tags. The audit treats duplicate title, description, canonical, and robots tags as critical issues to fix first, before lower-priority categories.

How do I set up Open Graph tags for social share previews?▼

Set Open Graph title, description, and image on every shareable page, using absolute URLs for images and an og:url that matches the canonical URL. Use summary_large_image as the default twitter:card and verify rendering on a live URL, not localhost.

When should I use noindex versus a canonical URL?▼

Use noindex only for private, duplicate, or non-public pages such as staging previews, and use a canonical tag to point to the preferred URL for indexable pages. The robots meta directive must match the actual access intent of the page.

Does this work with Next.js metadata API or react-helmet?▼

Yes, the workflow follows the project's existing metadata pattern, whether that is the Next.js metadata API, react-helmet, or manual head tags. It does not migrate frameworks or SEO libraries unless explicitly requested.

Why does my social card show the wrong image after fixing the tags?▼

Social platforms cache scraped metadata aggressively, so updated tags may not appear immediately. Verify the tags on the real deployed URL and use the platform's sharing debugger to force a re-scrape.

When should I add JSON-LD structured data to a page?▼

Add JSON-LD only when it clearly maps to real rendered page content, and prefer one structured data block per page. Never invent ratings, reviews, prices, or organization details that are not actually shown.