Skill Catalog — Inventory Management
Maintains catalog.json as the single source of truth for installed skills.
Commands
Inventory (/meta-skill-catalog or /meta-skill-catalog inventory)
- Scan
.claude/skills/for all skill directories - Read each SKILL.md frontmatter
- Compare with
catalog.json - Report:
- Skills on disk but not in catalog (unregistered)
- Skills in catalog but not on disk (orphaned entries)
- Skills with mismatched metadata (stale entries)
Rebuild (/meta-skill-catalog rebuild)
- Scan
.claude/skills/for all skill directories - Read each SKILL.md frontmatter
- Rebuild
catalog.jsonfrom scratch - Report what changed
Audit (/meta-skill-catalog audit)
- Load
catalog.json - For each skill, check:
- Does SKILL.md exist and have valid frontmatter?
- Does the name follow
{category}-{function}convention? - Is the description clear and specific enough for auto-triggering?
- Are there any trigger overlaps between skills?
- Is the skill under 500 lines?
- Does the SKILL.md have a
versionfield in frontmatter? - Does the catalog version match the SKILL.md version?
- Report issues with recommendations
Catalog Format
catalog.json structure:
{
"version": 1,
"updated": "YYYY-MM-DD",
"skills": [
{
"name": "meta-heartbeat",
"category": "meta",
"description": "Session startup ritual...",
"path": ".claude/skills/meta-heartbeat/",
"invocation": "user-only",
"added": "YYYY-MM-DD",
"version": "1.0.0",
"installed_from": "agentic-workflow",
"installed_version": "1.0.0",
"installed_date": "YYYY-MM-DD"
}
]
}
Fields
| Field | Description |
|---|---|
name |
Skill name (matches directory name with category prefix) |
category |
Category prefix (meta, dev, ops, tool, viz, doc) |
description |
One-line description |
path |
Relative path to skill directory |
invocation |
user-only, model-only, or both |
added |
Date skill was added |
version |
Current version at source (from SKILL.md frontmatter) |
installed_from |
Provenance: "agentic-workflow" or "local" |
installed_version |
Version that was installed in this project |
installed_date |
When this version was installed |