Skilllibrary skill-catalog-curation

Audit and organize a skill library as a whole — detect duplicates, enforce category consistency, mark deprecation candidates, and ensure discoverability. Use this when the library has grown large enough that overlaps and inconsistencies emerge, before major releases, after bulk imports, or for periodic maintenance. Do not use for improving individual skills (use skill-refinement) or creating new skills (use skill-authoring).

install

source · Clone the upstream repo

git clone https://github.com/merceralex397-collab/skilllibrary

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/merceralex397-collab/skilllibrary "$T" && mkdir -p ~/.claude/skills && cp -r "$T/03-meta-skill-engineering/skill-catalog-curation" ~/.claude/skills/merceralex397-collab-skilllibrary-skill-catalog-curation && rm -rf "$T"

manifest: 03-meta-skill-engineering/skill-catalog-curation/SKILL.md

source content

Purpose

Reviews skill library as a whole: identifies duplicates/overlaps, enforces category consistency, assigns quality gates, marks deprecated skills, and ensures catalog remains navigable as it grows.

When to use this skill

Use when:

User says "audit the library", "clean up skills", "organize catalog"
Library grown large enough that overlaps/inconsistencies emerge
Periodic maintenance (recommend: monthly for active libraries)
Before major release
After bulk import

Do NOT use when:

Working on single skill
Installing/packaging skills
Creating new skills (use
```
skill-authoring
```
)
Library small (<20) and well-organized

Operating procedure

Generate inventory:
- List all skills: name, category, maturity, last modified
- Count per category
- Identify uncategorized/miscategorized
Detect duplicates/overlaps:
- Compare descriptions for similarity
- Flag >70% overlap
- Flag same name, different paths
- Recommend: merge, differentiate, or keep
Audit category assignments:
- List all categories
- Check each skill's category matches function
- Categories with 1-2 skills → consider merging
- Categories with >15 skills → consider splitting
Apply quality gates:
- Draft: Missing evals, incomplete, new
- Stable: Has evals, complete, tested
- Deprecated: Superseded, has replacement
- Flag mismatched maturity
Check discoverability:
- Descriptions clear and searchable?
- Trigger phrases present?
- Would user find when needed?
Mark deprecation candidates:
- No usage (if metrics available)
- Superseded by better alternative
- For obsolete tools
Generate report:
- Summary stats
- Action items by priority
- Recommendations

Output defaults

## Catalog Curation Report

### Summary
- Total: 47 skills
- Maturity: 12 draft, 30 stable, 5 deprecated
- Categories: 8

### Duplicates/Overlaps
| A | B | Similarity | Action |
|---|---|------------|--------|
| api-testing | api-test | 85% | Merge |

### Category Issues
| Issue | Skills | Action |
|-------|--------|--------|
| Miscategorized | X | Move to Y |

### Quality Violations
| Skill | Current | Issue | Action |
|-------|---------|-------|--------|
| skill-a | stable | No evals | Demote |

### Deprecation Candidates
| Skill | Reason | Replacement |
|-------|--------|-------------|
| old-api | Deprecated | new-api |

### Actions (Priority Order)
1. [High] Merge duplicates
2. [Medium] Add missing evals
3. [Low] Reorganize categories

References

https://docs.github.com/en/copilot/concepts/agents/about-agent-skills — Agent skills structure
https://developers.openai.com/codex/skills — Codex skill format for consistency checks
Library index/catalog files

Failure handling

Can't determine similarity: Manual review for edge cases
Conflicting categories: Propose unified scheme
No usage metrics: Base on age + last modified
Too many issues: Prioritize by impact, create phases