AI agent skill · by @rohitg00

Skill Catalog Builder

Build a bounded Agent Skill catalog across explicit discovery scopes and report collisions before loading instruction bodies.

Archived 2026-10-23 · Source updated 2026-09-07 · License: MIT. Check the original repository for the latest version.

SKILL.md instructions

# Skill catalog builder

Use this skill when an agent host needs deterministic discovery across more than one skill directory.

1. Read `references/discovery-contract.md`.
2. Review the example host policy in `assets/scope-policy.json`; do not assume its order is universal.
3. Run `python3 scripts/build_catalog.py project=PATH user=PATH` with scopes listed from highest to lowest precedence.
4. Inspect the JSON `collisions` and `omitted` arrays before activating a skill.
5. Load only the selected SKILL.md body. Load a direct reference only when that body names it.

Never execute a bundled script during discovery. Never choose an equal-precedence duplicate by incidental filesystem order.

Return the catalog budget, selected entries, collision resolutions, and omissions.