sync-skill-catalog

Extract metadata from SKILL.md files and update the central skill catalog.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/sunLeee/optimization --skill sync-skill-catalog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-skill-catalog
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/utility/sync-skill-catalog
Command: npx skills add https://github.com/sunLeee/optimization --skill sync-skill-catalog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This utility automatically extracts metadata from every SKILL.md and keeps the central skill catalog up to date, ensuring consistency across skills and versions.

Core Features & Use Cases

  • Auto-extraction of name, description, category, and other fields from SKILL.md to a unified catalog.
  • Version-aware synchronization to reflect new or updated skills across the global catalog.
  • Global consistency across all skills, enabling quick discovery and governance.

Quick Start

Run /sync-skill-catalog to refresh the catalog immediately.

Frequently Asked Questions about sync-skill-catalog

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

FAQPage Schema
How do I automatically synchronize skill metadata from YAML frontmatter into a central catalog?

To synchronize skill metadata, this utility parses YAML frontmatter from all SKILL.md files and compiles the extracted names and descriptions into a unified global catalog. It tracks all changes via a changelog to ensure repository-wide consistency.

What is the best way to keep a skill catalog updated when new SKILL.md files are added?

The best way to keep a skill catalog updated is through version-aware synchronization that detects newly added or updated SKILL.md entries. Running a single non-intrusive command triggers an immediate refresh of the central catalog.

How does YAML frontmatter parsing work for extracting documentation metadata?

YAML frontmatter parsing extracts structured metadata fields like name, description, and category directly from the headers of SKILL.md files. This automated extraction compiles the data into a centralized catalog for quick discovery and governance.

Can I track versioning and categorization changes across all skills in a repository?

Yes, you can track versioning and categorization changes across all skills in a repository. The synchronization process monitors SKILL.md updates and records metadata changes in a changelog to maintain global consistency.

Does this catalog synchronization require manual updates every time a skill changes?

No, catalog synchronization does not require manual updates every time a skill changes. The process is fully automated and can be triggered on demand using a non-intrusive command to scan repository-wide SKILL.md files and refresh the catalog.

What should I do if my SKILL.md metadata is not appearing in the global catalog?

If SKILL.md metadata is not appearing in the global catalog, ensure your YAML frontmatter is properly formatted with the required name and description fields. Run the synchronization command to re-parse all files and force a catalog refresh.