家族保持在一起
真实的主 Skill 和子 Skill 合并成一个家族条目，详情里再展开子项。
一条命令开始
安装已发布的 v0.3.6 Skill，再告诉 Agent 要检查哪些本地根目录。
gh skill install mianbaofang/agent-skill-catalog agent-skill-catalog --pin v0.3.6 --agent codex --scope user
为什么需要它
不用逐个打开 SKILL.md，也能找到正确能力
平铺目录很难看出一个 Skill 是独立能力、某个主 Skill 的子项，还是插件携带的能力。目录页把这些关系放到调用前就能检查的位置。
插件单独展示
插件提供的 Skill 按服务商和插件归档，不会混进独立 Skill 数量。
证据直接可见
分类置信度、调用方式、GitHub 地址、图片来源和缺失证据都保留在详情里。
从文件夹到可用索引
一条小而可复核的流程
选择明确根目录
只把需要检查的 Skill 文件夹和插件缓存交给构建器。
对照来源
对照本地 SKILL.md 和已确认的 GitHub README，保留分类、家族、说明和图片状态的依据。
调用前先搜索
调用本 Skill 的 Agent 会按批次补齐中文说明，队列完成后才报告目录可用。
详情里有什么
用途、调用、来源和图片证据放在一起
它面向反复查找的日常工作：搜到名称后，先看详情，再决定是否让 Agent 使用。
针对不断增长的 Skill 库
常见问题
目录会修改或执行被扫描的 Skill 吗？
不会。构建器只读取操作者提供的根目录，源文件保持只读；生成的 JSON、缓存预览图和手工换图只写入选定的输出目录。
它能区分插件和独立 Skill 吗？
当配置根目录和包证据足够明确时可以。插件聚合有单独视图，不计入独立 Skill 数量。
Skill 预览图从哪里来？
优先使用输出目录里的手工覆盖图；否则使用已确认的公开 GitHub 仓库预览、Skill 自带本地图，证据不足时明确显示缺证据状态。
缺少的 Skill 说明由谁来写？
调用本 Skill 的 Agent 会读取有长度限制的本地 SKILL.md 和已确认的 GitHub README 证据，按批次写出自然中文，再通过可续跑的说明队列应用；队列未完成时构建不会报告完成。
以后新增 Skill 能刷新吗？
用启动时记录的同一批根目录运行本地服务并执行刷新。服务会拒绝替换输入，避免悄悄扫描另一套目录。
让下一个 Skill 也容易找到。
文件夹继续留在本地，把用途、调用方式、关系和证据放进一个可搜索的目录。