# Skill Catalog Builder

Builds a bounded catalog of Agent Skills and reports name collisions before loading.

- Repository: https://github.com/rohitg00/ai-engineering-from-scratch (76237 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-29
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add rohitg00/ai-engineering-from-scratch --skill skill-catalog-builder -g -a claude-code -y`
Codex: `npx skills add rohitg00/ai-engineering-from-scratch --skill skill-catalog-builder -g -a codex -y`
Cursor: `npx skills add rohitg00/ai-engineering-from-scratch --skill skill-catalog-builder -g -a cursor -y`
Gemini CLI: `npx skills add rohitg00/ai-engineering-from-scratch --skill skill-catalog-builder -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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