okhp3-skill-catalogerlisted
Install: claude install-skill OKHP3/skillz
# okhp3-skill-cataloger
**OverKill Hill P³** · [overkillhill.com](https://overkillhill.com) · [github.com/OKHP3](https://github.com/OKHP3)
**Intent:** Turn a repository’s `SKILL.md` files into a reproducible inventory
without editing skill content or hiding validation failures.
## Scope boundary
| In scope | Out of scope |
|---|---|
| Discovering skills and reading their frontmatter | Rewriting, installing, deleting, or upgrading skills |
| Validating names, descriptions, and duplicate names | Editing README prose outside generated markers |
| Generating marked README catalogs and `.catalog-meta.json` | Claiming a benchmark, security audit, or live marketplace result |
| Generating full-index `FAMILY.md` inventory sections | Running `--full` casually in an application repository |
## Mode contract
Run from the repository root. The bundled script is the fallback; prefer a
project-level `scripts/gen-skills-readme.py` only when it is the same or newer
implementation and you have inspected it.
| Operation | Command | Scans | Generated outputs |
|---|---|---|---|
| Catalog (default) | `python3 ${SCRIPT} --skills-dir .agents/skills` | Direct child skill folders | `.agents/skills/README.md` between catalog markers and `.agents/skills/.catalog-meta.json` |
| Catalog, flat | add `--mode project` | `.agents/skills/<skill>/SKILL.md` | One flat table: Skill, Description, Version, Category |
| Catalog, categorized | add `--mode library` | `.agents/skills/<category>/<skill>/SKILL.md