fixing-metadata Skill (ibelick) for Claude Code: SEO Tags
Makes your agent audit and fix page titles, meta descriptions, canonical URLs, social cards, icons and structured data with minimal diffs.
- Installs
- 18.9K
- on skills.sh
- Stars
- 10.5K
- on GitHub
- Updated
- Nov 2026
- last repo commit
The skill gives the agent a five-step workflow for page metadata. Find pages with missing or wrong metadata, fix critical problems first such as duplicates and indexing, make title, description, canonical and og:url agree, check social cards on a real URL, and keep every diff scoped to metadata.
It loads when you add SEO metadata, fix share previews or ship new pages. Its rules run in eight priority groups, from correctness and duplication to tool boundaries. It is one file with no scripts, and it tells the agent to follow your existing pattern, for example the Next.js metadata API or react-helmet, and not to switch libraries.
Good for
- Developers shipping new pages that need correct SEO and share previews
- Teams fixing duplicate or missing meta tags and canonicals
- Founders checking Open Graph and Twitter cards before a launch
Install fixing-metadata
Claude Code
- 1
Copy this prompt.
Install the fixing-metadata skill in Claude Code. Run this command: npx skills add https://github.com/ibelick/ui-skills --skill fixing-metadata Then check that it loaded and tell me how to use it.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
From its listing on skills.sh. Source.
What's in the skill
When it loads
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.
Sections in SKILL.md
- Workflow
- when to apply
- rule categories by priority
- quick reference
- 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)
- review guidance
Key facts
- Author
- ibelick
- Installs on skills.sh
- 18,866 as of 2026-11-02
- GitHub stars
- 10,454 for the whole ibelick/ui-skills repo
- Last repo commit
- 2026-11-01
- What is inside
- 1 file including SKILL.md; no scripts or reference files
- skills.sh audits
- Gen Agent Trust Hub: pass; Socket: pass; Snyk: pass
What it includes
Five steps: find, audit, align, verify, keep small
Identify pages with missing or incorrect metadata. Audit against the priority rules. Make title, description, canonical and og:url agree. Verify social cards on a real URL, not localhost. Keep diffs minimal.
Write ·
WorkflowOne source per page, no duplicate tags
Define metadata in one place per page, never emit duplicate title, description, canonical or robots tags, and keep values deterministic. Dynamic strings must be escaped.
Write ·
1. Correctness and duplication (critical)Every page has a title and a plain-text description
Consistent title format, short titles, no stuffing. Descriptions are plain text with no markdown.
Write ·
2. Title and description (high)Canonical points to the preferred URL
Use noindex only for private, duplicate or non-public pages. Preview and staging pages should be noindex by default where possible. Paginated pages need correct canonicals.
Write ·
3. Canonical and indexing (high)Open Graph and Twitter cards
Shareable pages set og title, description and image with absolute image URLs. og:url must match the canonical, and twitter:card defaults to summary_large_image.
Write ·
4. Social cards (high)Favicon, apple-touch-icon, manifest, theme-color
At least one working favicon, an apple-touch-icon where relevant, a valid referenced manifest and a deliberate theme-color.
Write ·
5. Icons and manifest (medium)JSON-LD only when it matches real content
No JSON-LD unless it maps to what the page shows. It must be valid and must not invent ratings, reviews, prices or organization details.
Write ·
6. Structured data (medium)lang, og:locale, hreflang
Set the html lang attribute, og:locale when localized, and hreflang only for pages that exist.
Write ·
7. Locale and alternates (low-medium)No refactors, no library migrations
Prefer minimal changes, do not refactor unrelated code, do not migrate frameworks or SEO libraries unless asked, and follow the project's existing metadata pattern.
Read ·
8. Tool boundaries (critical)
From the official docs
Questions
What does fixing-metadata do?
It makes your agent audit and fix the metadata of web pages. That covers titles, descriptions, canonical URLs, robots rules, Open Graph and Twitter cards, icons and JSON-LD.
How do I install it?
Use the install box at the top of this page. It lists the options for Claude Code, Codex and other tools.
Does it need an API key or any tools?
No. SKILL.md names no API key, account or command to run. It is one text file of rules, and the agent edits your code.
Will it rewrite my SEO setup?
It should not. SKILL.md says to keep diffs minimal and scoped to metadata, not to migrate frameworks or SEO libraries unless asked, and to follow your existing pattern, such as the Next.js metadata API or react-helmet.
Can it check my social cards?
It tells the agent to verify cards on a real URL, not localhost. The skill itself bundles no checking tool, so you may need a share-preview checker of your own.
Is it safe to run?
It edits your page and layout files, so read the diff and check that only metadata changed before you merge. The skill bundles no scripts and lists no commands for the agent to run.
Information
updated Nov 2, 2026
- Repository
- ibelick/ui-skills
- Folder
skills/fixing-metadata
Sources
Docs, issue trackers and discussions this page is built from.
Show all 4Hide
- fixing-metadata SKILL.md · github.com
- ibelick/ui-skills README · github.com
- fixing-metadata on skills.sh · skills.sh
- ibelick/ui-skills · github.com