# Fix HTML Metadata and Social Previews

Missing or inconsistent metadata harms search indexing and social previews. This skill audits page metadata and guides focused fixes across common web frameworks.

## Install

```bash
npx skillstore add ibelick/fixing-metadata
```

## Metadata

- Status: approved
- Slug: ibelick-fixing-metadata
- Version: 1.0.1
- Author version: 1.0.1
- Skillstore revision: r2
- Version status: valid
- Tree hash: 516def42c1b83074e65ff3ad3a29d1e12f4e530860fe33bc3ab2fa36ebea1b8e
- Author: ibelick
- GitHub username: ibelick
- License: MIT
- Repository: https://github.com/ibelick/ui-skills/tree/main/skills/fixing-metadata/
- Ref: ebdfe608f5de2b66ff37ab4af12af8ac4f5e8006
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Quality score: 82
- Quality tier: silver
- Public page: https://skillstore.pages.dev/skills/ibelick-fixing-metadata
- Manifest: https://skillstore.pages.dev/api/skills/ibelick-fixing-metadata/manifest

## Capabilities

- Audits page titles and descriptions for omissions, duplication, readability, and consistency.
- Checks canonical URLs, robots directives, locale settings, and alternate-language relationships.
- Reviews Open Graph and Twitter metadata for consistent URLs, card types, and absolute image paths.
- Evaluates favicons, application icons, manifests, and theme colors for valid references.
- Reviews JSON-LD validity and alignment with content that users can see.
- Follows existing framework patterns and keeps metadata changes focused.

## Use Cases

- Prepare a New Marketing Page: Review essential search and sharing metadata before a new page is published.
- Correct Search Indexing Signals: Resolve duplicate titles, conflicting canonical URLs, and incorrect robots directives across important pages.
- Standardize Shared Metadata: Align framework defaults and page overrides without replacing the existing metadata system.

## Prompt Templates

### Audit One Page

```
Audit metadata for [page or file]. Identify missing or duplicate titles, descriptions, canonical URLs, and robots directives. Suggest minimal fixes.
```

### Fix Social Previews

```
Review Open Graph and Twitter metadata for [URL]. Check text, image URLs, card type, canonical agreement, and deployment requirements.
```

### Review Structured Metadata

```
Audit icons, manifest settings, locale tags, alternate links, and JSON-LD for [page]. Flag invalid or unsupported claims.
```

### Standardize Site Metadata

```
Review metadata architecture across [routes]. Find conflicting defaults and overrides, prioritize indexing risks, and propose minimal framework-consistent changes.
```

## Limitations

- Does not include an automated site crawler or metadata validation script.
- Cannot verify deployed social previews without a public URL and relevant platform tools.
- Does not guarantee search rankings or immediate search engine reindexing.
- Framework-specific implementation depends on the project files and metadata approach provided.

## Best Practices

- Provide the page route, framework, and intended public URL before requesting an audit.
- Resolve duplicate, canonical, and indexing issues before improving optional metadata.
- Validate social previews and structured data against the deployed page.

## Anti Patterns

- Do not create ratings, prices, reviews, or organization details that the page does not support.
- Do not introduce a second metadata system when the project already has one.
- Do not verify social cards only through localhost or relative image paths.

## Security Audit

- Audited at: 2026-07-23T18:41:07.748\+00:00
- Summary: All five static alerts are false positives caused by ordinary metadata guidance in SKILL.md. No reconnaissance, prompt injection, or other harmful intent was found.

## Stats

- Views: 133
- Downloads: 5
- Favorites: 0
- Popularity score: 0