fixing-metadata

Validate and repair Markdown frontmatter metadata for consistent page fields.

2.0k|183|Updated Mar 10, 2025
One-click install
npx skills add https://github.com/agentset-ai/agentset --skill fixing-metadata
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fixing-metadata
Source: https://github.com/agentset-ai/agentset/tree/main/.agents/skills/fixing-metadata
Command: npx skills add https://github.com/agentset-ai/agentset --skill fixing-metadata

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps content teams ensure metadata for pages is correct, complete, and consistent, reducing SEO and accessibility issues caused by missing or conflicting frontmatter.

Core Features & Use Cases

  • Single-source-of-truth validation: Enforces a consistent set of fields (name, description, canonical, robots, og tags) across pages.
  • Duplication detection & safe fixes: Detects conflicting or duplicate metadata and suggests deterministic fixes.
  • SEO and social metadata alignment: Ensures Open Graph, Twitter cards, and structured data reflect page content and canonical URL.
  • Use Case: When publishing new pages or updating marketing content, run the tool to validate and repair frontmatter before release.

Quick Start

  • Run the fixer on a Markdown file with frontmatter to validate and repair metadata.
  • Review the suggested changes and apply them to the frontmatter or page content.
  • Re-run validation to confirm a clean, consistent metadata state.

Frequently Asked Questions about fixing-metadata

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

FAQPage Schema
How do I validate and fix frontmatter metadata for SEO?

To validate frontmatter metadata for SEO, run a linter on your Markdown files to consolidate title, description, and canonical data into a single source of truth. It detects duplicates, enforces consistent formats, and suggests concrete code-level fixes to repair frontmatter before release.

How do I fix duplicate canonical URLs and conflicting metadata in documentation pages?

Fix duplicate canonical URLs and conflicting metadata by running a validation tool that detects duplicates and enforces consistent formats across frontmatter. It consolidates metadata fields and guides Open Graph and structured data decisions to ensure complete, correct page metadata.

What is a single source of truth for page metadata and when do I need it?

A single source of truth for page metadata is a consistent set of validated frontmatter fields including name, description, canonical, and robots tags. You need it when publishing marketing or documentation pages to reduce SEO and accessibility issues caused by missing or conflicting metadata.

Can I use this metadata linter to align Open Graph tags and Twitter cards with canonical URLs?

Yes, you can use this metadata linter to align Open Graph tags and Twitter cards with canonical URLs. It ensures social metadata and structured data accurately reflect page content and canonical URL, validating frontmatter fields like og tags and robots directives.

Does this metadata validation tool require any specific frameworks or dependencies?

No, this metadata validation tool does not require specific frameworks or dependencies. It satisfies deterministic frontmatter rules and suggests concrete code-level fixes while avoiding introducing new frameworks, making it applicable to existing marketing and documentation workflows.