chelch5/skill-registry-manager

Skill Registry Manager

Owns the library catalog — the index, metadata, tags, maturity status, and consistency of all skills in the ecosystem.

Procedure

1. Scan skill inventory

# Find all active skills
find . -name "SKILL.md" -not -path "*/ARCHIVE/*" -not -path "*/node_modules/*" | sort

# Extract metadata from each
for skill_md in $(find . -name "SKILL.md" -not -path "*/ARCHIVE/*"); do
  dir=$(dirname "$skill_md")
  name=$(grep "^name:" "$skill_md" | head -1 | cut -d: -f2- | tr -d ' "')
  maturity=$(grep "maturity:" "$skill_md" | head -1 | cut -d: -f2- | tr -d ' ')
  echo "$name | $maturity | $dir"
done

2. Validate catalog consistency

For each skill, check:

| Check | Criteria | Severity | |-------|----------|----------| | Frontmatter exists | YAML between --- delimiters | Error | | name field present | Non-empty string | Error | | description field present | Non-empty, 20-100 words | Error | | Name matches directory | name field = directory name | Warning | | No duplicate names | Each name unique across catalog | Error | | Tags are valid | Tags exist in the controlled vocabulary | Warning | | Maturity is valid | One of: draft, beta, stable, deprecated | Warning |

3. Register a new skill

When adding a skill to the catalog:

1. Verify SKILL.md has required frontmatter (name, description)
2. Assign maturity level (default: draft)
3. Add to skills-lock.json with metadata snapshot
4. Verify no name collision with existing skills
5. Update library index

4. Update skill metadata

When a skill changes:

1. Read current skills-lock.json entry
2. Update changed fields (description, maturity, tags)
3. Record modification timestamp
4. Regenerate affected index entries

5. Generate library index

Produce a machine-readable index and a human-readable catalog:

skills-lock.json (machine-readable):

{
  "version": "1.0.0",
  "generated": "<ISO timestamp>",
  "skills": {
    "<skill-name>": {
      "path": "<relative path>",
      "description": "<description>",
      "maturity": "<draft|beta|stable|deprecated>",
      "tags": ["<tag1>", "<tag2>"],
      "license": "<SPDX>",
      "last_updated": "<ISO date>"
    }
  }
}

CATALOG.md (human-readable):

# Skill Catalog

## Active Skills
| Name | Maturity | Description |
|------|----------|-------------|
| [name] | [maturity] | [description] |

## Deprecated Skills
| Name | Replacement | Deprecated Date |
|------|-------------|----------------|

6. Enforce naming conventions

• Skill names: kebab-case, descriptive, 2-4 words
• Directory names match skill names exactly
• No abbreviations unless universally understood (e.g., pr, qa)

Output contract

• Updated skills-lock.json with current catalog state
• Updated CATALOG.md with human-readable index
• Validation report listing any consistency issues found

Failure handling

• Duplicate skill name: Reject registration, report collision with existing skill
• Missing frontmatter: Flag as invalid, do not register until fixed
• Orphaned lock entries: Remove entries for skills that no longer exist on disk
• Name/directory mismatch: Report as warning, recommend rename

References

• This skill manages the catalog layer — does not modify skill content
• Works with: skill-deprecation-manager (retirement), skill-packager (distribution)