Install any skill in seconds. Free to start, no credit card required.
Get Started Free →okhp3/okhp3-skill-cataloger
OverKill Hill P³ skill cataloger. Inventory and validate repository-local Agent Skills, then safely regenerate a marked README catalog and machine-readable catalog metadata.
Passed 16 of 18 test cases with the skill, and 7 of 18 without it.
and 8 more in the full report
11 fixed8 passed either way3 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
If no explicit mode argument is supplied and the first inspected directory in `.agents/skills` directly contains `SKILL.md`, which mode is automatically chosen?
| Checked | Without skill | With skill |
|---|---|---|
| identifies project mode as the automatic default when child folders contain direct skill files | Missed | Passed |
The instructions your model reads when the skill loads.
OverKill Hill P³ · overkillhill.com · github.com/OKHP3
Intent: Turn a repository’s SKILL.md files into a reproducible inventory
without editing skill content or hiding validation failures.
| 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 |
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 | Category sections with skill counts |
| Full index | python3 ${SCRIPT} --full | Root <family>/<skill>/SKILL.md folders; skips .agents/, skills/ export mirrors, and tool directories | Root README.md, active-family FAMILY.md, root .catalog-meta.json |
--full is a distinct distribution-surface operation and always uses library
grouping. It does not catalog .agents/skills/ or the root skills/ publication
mirror. In full mode, --output changes the root catalog path; family files and
root metadata remain part of the run.
Confirm the repository root, target surface, desired mode, output path, and whether writes are authorized. Inspect the target README markers before a normal
test cases passed, vs 7 / 18 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.