ayush8620/skillsmith

skillsmith 是做什麼的？

根據一行想法建立符合規範的 Agent 技能，並對 SKILL.md 檔案進行檢查（名稱規則、描述長度與「Use when」、相容性限制、metadata 對應、主體長度、洩漏機密）。 零依賴的 CLI 工具 cli.js 位於 SkillSmith 儲存庫根目錄，負責所有操作。

使用時機

• 使用者想為某項任務建立一個新技能（例如：「做一個技能，可以……」）。
• 使用者想知道某個技能資料夾或 SKILL.md 是否符合標準，或想要修正它。

步驟

1. 若要驗證，執行 node <path-to-skillsmith>/cli.js validate <skill-dir>（可接受多個資料夾）。exit code 為 0 表示有效。
2. 回報每一個 error 並在使用者的 SKILL.md 中修正：重新命名為小寫連字號形式，確保資料夾名稱與 name 相符，將 description 維持在 1024 個字元以內並包含「Use when …」。然後重新執行步驟 1。
3. 若要建立技能，請先設定 GEMINI_API_KEY（切勿列印），然後執行： node <path-to-skillsmith>/cli.js new "<功能描述及使用時機>" --out <skills-dir> --author "<作者名>"。
4. 向使用者展示產生的 SKILL.md，接著對新資料夾執行步驟 1。必要時可編輯；CLI 絕不會覆蓋已存在的 SKILL.md。

範例

• node cli.js validate skills/commitcraft skills/skillsmith
• node cli.js new "總結 CSV 檔案並建議圖表。當使用者分享 .csv 時使用" --out ./skills

備註

• 未知的頂層欄位會產生警告；自訂資料應放在 metadata 之下。
• 規格建議主體不超過 500 行；較長的文件請移至 references/。