Agent skill

HTML Metadata Fixer

by ibelick in ibelick/ui-skills

Audits and fixes page titles, meta descriptions, canonical URLs, Open Graph and Twitter cards, favicons, JSON-LD and robots directives.

MITAuto-check passedMarketing & SEO

Install HTML Metadata Fixer

skills CLI
$ npx skills add ibelick/ui-skills --skill fixing-metadata -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ibelick/ui-skills fixing-metadata --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ibelick/ui-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/fixing-metadata .claude/skills/fixing-metadata && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fixing-metadata
GitHub stars
9.5k
Used in
2 other repos
Token cost
~1.1k tokens
SKILL.md length
554 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Audits and fixes page titles, meta descriptions, canonical URLs, Open Graph and Twitter cards, favicons, JSON-LD and robots directives.

  • Works in 8 steps: correctness and duplication (critical) → title and description (high) → canonical and indexing (high) → …
  • Adding SEO metadata to new pages
  • SKILL.md covers Workflow, when to apply, rule categories by priority and quick reference, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent identifies pages with missing or wrong metadata, audits them against a prioritized rule set, fixes critical problems such as duplicate tags and indexing mistakes first, and keeps the title, description, canonical URL and `og:url` consistent with each other. Diffs stay scoped to metadata, and social cards are verified on a real URL rather than localhost.

The rules are ranked: correctness and duplication, title and description, canonical and indexing, social cards, icons and manifest, structured data, locale and alternates, and tool boundaries. Examples include one metadata source per page, no duplicate tags, escaped dynamic strings, absolute URLs for Open Graph and Twitter images, noindex for staging or private pages and correct canonicals on paginated pages. The excerpt is cut off in the social cards rules.

When your agent uses it

  • Adding SEO metadata to new pages
  • Fixing broken social share previews
  • Reviewing canonical, robots and Open Graph tags before a launch

Example prompts

  • “Audit the metadata on our pricing and blog pages and fix any duplicate canonical tags.”
  • “The link preview image is missing on shared posts, find out why.”
  • “Add JSON-LD and Open Graph tags to the new landing page without touching other code.”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  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)

What it can do on your machine

Read from SKILL.md and the folder at commit 587ea30. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

HTML Metadata Fixer loads about 1.1k tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 554 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ibelick/ui-skills at commit 587ea30, republished under its MIT licence (© ibelick). 554 words, ~1,109 tokens.

Download SKILL.mdSave it as .claude/skills/fixing-metadata/SKILL.md (or your agent's skills folder).
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 SEO metadata, fixing social share previews, reviewing Open Graph tags, setting up canonical URLs, or shipping new pages that need correct meta tags.
version
1.0.1
license
MIT

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 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

rule categories by priority

prioritycategoryimpact
1correctness and duplicationcritical
2title and descriptionhigh
3canonical and indexinghigh
4social cardshigh
5icons and manifestmedium
6structured datamedium
7locale and alternateslow-medium
8tool boundariescritical

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
3. canonical and indexing (high)
  • canonical must point to the preferred URL for the page
  • use noindex only for private, duplicate, or non-public pages
  • robots meta must match actual access intent
  • previews or staging pages should be noindex by default when possible
  • paginated pages must have correct canonical behavior
Show full SKILL.md (242 more words)Show less
4. social cards (high)
  • shareable pages must set Open Graph title, description, and image
  • Open Graph and Twitter images must use absolute URLs
  • prefer correct image dimensions and stable aspect ratios
  • og:url must match the canonical URL
  • use a sensible og:type, usually website or article
  • set twitter:card appropriately, summary_large_image by default
5. icons and manifest (medium)
  • include at least one favicon that works across browsers
  • include apple-touch-icon when relevant
  • manifest must be valid and referenced when used
  • set theme-color intentionally to avoid mismatched UI chrome
  • icon paths should be stable and cacheable
6. structured data (medium)
  • do not add JSON-LD unless it clearly maps to real page content
  • JSON-LD must be valid and reflect what is actually rendered
  • do not invent ratings, reviews, prices, or organization details
  • prefer one structured data block per page unless required
7. locale and alternates (low-medium)
  • set the html lang attribute correctly
  • set og:locale when localization exists
  • add hreflang alternates only when pages truly exist
  • localized pages must canonicalize correctly per locale
8. tool boundaries (critical)
  • prefer minimal changes, do not refactor unrelated code
  • do not migrate frameworks or SEO libraries unless requested
  • follow the project's existing metadata pattern (Next.js metadata API, react-helmet, manual head, etc.)

review guidance

  • fix critical issues first (duplicates, canonical, indexing)
  • ensure title, description, canonical, and og:url agree
  • verify social cards on a real URL, not localhost
  • prefer stable, boring metadata over clever or dynamic
  • keep diffs minimal and scoped to metadata only

© ibelick, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/fixing-metadata of ibelick/ui-skills.

Open the folder on GitHubat commit 587ea30

Used in 2 other repositories

We found 7 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in ibelick/ui-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

HTML Metadata Fixer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

HTML Metadata Fixer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
HTML Metadata Fixer this skillibelick/ui-skills9.5k2 repos~1.1kAutomated safety check: PassMIT
Content Dates Auditthedaviddias/Front-End-Checklist74k—~691Automated safety check: PassMIT
FAQPage Schema Markupthedaviddias/Front-End-Checklist74k—~774Automated safety check: PassMIT
Content Freshness Signalsthedaviddias/Front-End-Checklist74k—~741Automated safety check: PassMIT
Roier SEOdavila7/claude-code-templates32k—~2.7kAutomated safety check: PassMIT
SEO Validatesoftspark/ai-toolkit179—~3.9kAutomated safety check: NotesApache-2.0

Similar skills

  • Content Dates Audit

    thedaviddias/Front-End-Checklist

    Audits article and blog pages for visible publish dates, Article JSON-LD with datePublished and dateModified, and Open Graph time tags, then fixes what is missing.

    74k GitHub stars~691 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • FAQPage Schema Markup

    thedaviddias/Front-End-Checklist

    Adds, checks and fixes FAQPage JSON-LD on pages with visible question-and-answer sections so it matches what readers see and can qualify for rich results.

    74k GitHub stars~774 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Content Freshness Signals

    thedaviddias/Front-End-Checklist

    Audits article pages for freshness signals, covering the Last-Modified header, Article JSON-LD dateModified and a visible last-updated date, and fixes mismatches.

    74k GitHub stars~741 tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Roier SEO

    davila7/claude-code-templates

    Technical SEO auditor and fixer. An agent skill from davila7/claude-code-templates.

    32k GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed
  • SEO Validate

    softspark/ai-toolkit

    SEO validator: meta/OG, Schema.org, hreflang, Core Web Vitals, crawlability.

    179 GitHub stars~3.9k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    803 GitHub starsUsed in 11 repos~3.3k tokens
    Marketing & SEOAuto-check passed

More from ibelick/ui-skills

  • Fixing Motion Performance

    ibelick/ui-skills

    Audits and fixes web animation performance: layout thrashing, work that belongs on the compositor, scroll-linked motion and costly blur effects.

    9.5k GitHub starsUsed in 5 repos~1.4k tokens
    Auto-check passed
  • Accessibility Fixer

    ibelick/ui-skills

    Audits and fixes HTML accessibility problems such as ARIA labels, keyboard navigation, focus management, contrast and form errors with minimal changes.

    9.5k GitHub starsUsed in 4 repos~1.2k tokens
    Auto-check passed
  • Baseline UI

    ibelick/ui-skills

    Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.

    9.5k GitHub starsUsed in 8 repos~855 tokens
    Auto-check passed
  • Audits one product surface against its own design evidence and writes self-contained implementation plans for another agent, without touching product source.

    9.5k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • DESIGN.md Creator

    ibelick/ui-skills

    Writes or updates a DESIGN.md for one product from its repository or a public URL, recording the design language and tokens that the evidence supports.

    9.5k GitHub stars~4k tokensUpdated yesterday
    Auto-check passed
  • UI Skills Router

    ibelick/ui-skills

    Routes UI tasks to the smallest useful set of UI Skills through the ui-skills CLI, picking a category and loading at most three skills before implementing.

    9.5k GitHub starsUsed in 2 repos~362 tokens
    Auto-check passed

Questions about HTML Metadata Fixer

What does HTML Metadata Fixer do?

Audits and fixes page titles, meta descriptions, canonical URLs, Open Graph and Twitter cards, favicons, JSON-LD and robots directives. The agent identifies pages with missing or wrong metadata, audits them against a prioritized rule set, fixes critical problems such as duplicate tags and indexing mistakes first, and keeps the title, description, canonical URL and `og:url` consistent with each other. Diffs stay scoped to metadata, and social cards are verified on a real URL rather than localhost.

When should I use HTML Metadata Fixer?

HTML Metadata Fixer fits situations like: adding SEO metadata to new pages; fixing broken social share previews; reviewing canonical, robots and Open Graph tags before a launch.

How do I install HTML Metadata Fixer in Claude Code?

Run `npx skills add ibelick/ui-skills --skill fixing-metadata -a claude-code`. Or copy the skill folder (skills/fixing-metadata in ibelick/ui-skills) into .claude/skills/fixing-metadata in your project. Claude Code loads it when a task matches its description.

How do I install HTML Metadata Fixer in Codex?

Run `npx skills add ibelick/ui-skills --skill fixing-metadata -a codex`. Or copy the skill folder (skills/fixing-metadata in ibelick/ui-skills) into .agents/skills/fixing-metadata in your project. Codex loads it when a task matches its description.

Can I use HTML Metadata Fixer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ibelick/ui-skills --skill fixing-metadata -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fixing-metadata, .gemini/skills/fixing-metadata, .github/skills/fixing-metadata and .opencode/skills/fixing-metadata in your project.

What does HTML Metadata Fixer need to run?

SKILL.md names no scripts, command-line tools or credentials: HTML Metadata Fixer is instructions for the agent only.

Does HTML Metadata Fixer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is HTML Metadata Fixer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does HTML Metadata Fixer use?

HTML Metadata Fixer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does HTML Metadata Fixer use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to HTML Metadata Fixer?

Skills that share tags, products or a category with HTML Metadata Fixer: Content Dates Audit (thedaviddias/Front-End-Checklist, 74k stars), FAQPage Schema Markup (thedaviddias/Front-End-Checklist, 74k stars), Content Freshness Signals (thedaviddias/Front-End-Checklist, 74k stars) and Roier SEO (davila7/claude-code-templates, 32k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains HTML Metadata Fixer?

ibelick (a GitHub user) maintains it in ibelick/ui-skills, which has 9,476 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 7, 2026.

Source: ibelick/ui-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.