Agent Skills › rohitg00/ai-engineering-from-scratch › skill-catalog-builder

skill-catalog-builder

GitHub

构建确定性技能目录，支持多目录发现与优先级冲突检测。通过运行脚本生成包含碰撞和省略信息的JSON报告，确保在加载前解决歧义，仅激活选定技能，保障发现的可靠性。

phases/13-tools-and-protocols/24-skill-discovery-and-progressive-disclosure/outputs/skill-catalog-builder/SKILL.md rohitg00/ai-engineering-from-scratch

Trigger Scenarios

需要跨多个技能目录进行确定性的技能发现在加载指令体之前需要检测和解决技能名称或路径的冲突

Install

npx skills add rohitg00/ai-engineering-from-scratch --skill skill-catalog-builder -g -y

More Options

Non-standard path

npx skills add https://github.com/rohitg00/ai-engineering-from-scratch/tree/main/phases/13-tools-and-protocols/24-skill-discovery-and-progressive-disclosure/outputs/skill-catalog-builder -g -y

Use without installing

npx skills use rohitg00/ai-engineering-from-scratch@skill-catalog-builder

指定 Agent (Claude Code)

npx skills add rohitg00/ai-engineering-from-scratch --skill skill-catalog-builder -a claude-code -g -y

安装 repo 全部 skill

npx skills add rohitg00/ai-engineering-from-scratch --all -g -y

预览 repo 内 skill

npx skills add rohitg00/ai-engineering-from-scratch --list

SKILL.md

Frontmatter

{
    "name": "skill-catalog-builder",
    "license": "MIT",
    "metadata": {
        "lesson": "24"
    },
    "description": "Build a bounded Agent Skill catalog across explicit discovery scopes and report collisions before loading instruction bodies."
}

Skill catalog builder

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

Read references/discovery-contract.md.
Review the example host policy in assets/scope-policy.json; do not assume its order is universal.
Run python3 scripts/build_catalog.py project=PATH user=PATH with scopes listed from highest to lowest precedence.
Inspect the JSON collisions and omitted arrays before activating a skill.
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.