# Skill Catalog Builder

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

- Skill: `gabrielmoreira/skill-catalog-builder` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/skill-catalog-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/skill-catalog-builder/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/skill-catalog-builder

---


# 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.