前言¶
skills 积累多了以后，常见的问题是：不知道装了哪些、每个 skill 干什么、怎么快速回答”目前有哪些 skills 可用”。手工逐个翻 SKILL.md 费时间，复制粘贴整理又容易过时。这个 Skill 的价值在于，一次扫描就把目录里的 skills 解析、分类，产出一份人类可读的 Markdown 目录和一份机器可读的 JSON 目录，后续更新可以重跑。
这是什么¶
一句话定位：扫描指定目录下的所有 skill，解析各自的 SKILL.md，按功能分类，生成 SKILL_CATALOG.md 与 SKILL_CATALOG.json。
发布信息：SkillHub 社区来源，坐标 @user_211e8f0b/skill-catalog-generator，发布者 user_211e8f0b，版本 1.2.0，官方分类 dev-programming。页面标注 requires_api_key=false，即使用不需要 API Key。抓取时页面显示评分 100000、下载 1085 次、安装 0 次，这些数字以 SkillHub 页面实时数据为准。
核心功能¶
下面介绍的能力均来自官方页面说明：
1、自动扫描指定目录下的所有 skill，逐个定位 SKILL.md。
2、智能解析 SKILL.md 的 frontmatter，提取 name、description、version 等字段。
3、基于关键词和语义的多维度分类算法，把 skill 归入功能类别。
4、生成结构化的 Markdown 目录，包含目录索引、分类详情和统计信息。
5、生成机器可读的 JSON 目录，便于程序消费。
6、支持定时任务自动更新，覆盖 Windows/Linux/Mac。
7、完善的日志系统和错误处理，解析失败时有记录而不是直接中断。
目录结构要求¶
输入目录按下面的约定组织，每个 skill 一个子目录，子目录内是 SKILL.md：
.trae/skills/
├── skill-name-1/
│ └── SKILL.md
├── skill-name-2/
│ └── SKILL.md
└── ...
也可以把脚本指向其他目录，只要目录内是同样的”一个 skill 一个子目录、内含 SKILL.md”结构。
安装与启用¶
该 Skill 通过 SkillHub 页面安装，来源为 community，无需 API Key。安装后，AI 收到触发词时会自动执行其脚本。触发词包括：用户需要生成 skill 目录或清单；用户提到”skill 分类”、”skill 目录”、”skill 列表”、”整理 skills”；用户需要了解有哪些 skills 可用；用户需要批量管理或归档 skills；用户需要自动化生成 skill 文档。
典型用法¶
在 Skill 所在环境中执行脚本即可。默认行为是对约定目录扫描并生成目录文档：
python scripts/generate_skill_catalog.py
指定目录和输出格式时，用下面的参数形式：
python scripts/generate_skill_catalog.py --skills-dir <目录> --format both
其中 –skills-dir 指定扫描目录，–format both 表示同时生成 Markdown 和 JSON。执行后在输出位置得到两个文件：
SKILL_CATALOG.md # 人类可读的分类目录
SKILL_CATALOG.json # 机器可读的完整数据
Markdown 版用于人看和归档，JSON 版用于程序处理，例如被其他工具读取后做统计、筛选或二次分发。
适用场景与注意¶
适合的场景：skill 数量较多，人工维护目录不划算；需要给项目或团队提供一份 skills 清单；需要把 skills 信息交给程序消费；需要定期刷新目录文档。
使用上的注意：分类基于关键词和语义算法，边界模糊的 skill（功能横跨多个类别）可能被归入相邻类别，生成后建议人工复核一次，必要时调整描述里的措辞；解析依赖 SKILL.md 的 frontmatter 完整，字段缺失的 skill 信息会不全；定时任务需要运行环境能访问脚本路径，且脚本环境里有 Python。
结尾¶
这个 Skill 解决的是”skills 多了以后目录怎么维护”的问题：输入是约定目录下的 SKILL.md，输出是一份可读的 Markdown 目录和一份可程序消费的 JSON，中间不依赖手工整理。官方地址：https://api.skillhub.cn/user_211e8f0b/skill-catalog-generator ，页面上也有对应的 SkillHub 详情页。
