前言¶
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 詳情頁。
