把文件變成 SKILL.md

轉換器會寫出什麼

技能是一個資料夾，裡面只有一個必要檔案：SKILL.md。檔案開頭是一小段 YAML（前置資料），接著是用 Markdown 寫的指令。開放的 Agent Skills 格式要求這段內容有兩個欄位：

• name：1 到 64 個字元，只能用小寫英文字母、數字和連字號，開頭和結尾不能是連字號，也不能連續出現兩個連字號。必須和資料夾名稱相同。
• description：1 到 1,024 個字元，說明技能做什麼，以及何時使用。

轉換器會從文件的第一個標題產生名稱，從第一句話草擬說明，整理項目符號，文件沒有標題時也會補上一個。兩個欄位都可以修改，檔案會隨著你輸入即時更新。Anthropic 自己的規則另外加了兩條：名稱不能含有「anthropic」或「claude」，兩個欄位都不能有 XML 標籤。轉換器兩條都會檢查。

檔案要放在哪裡

• Claude（網頁版和桌面版）：前往 Customize > Skills，點選 +，再選 Create skill > Upload a skill，然後選擇 .zip。裡面是含有 SKILL.md 的資料夾，正是 Claude 要求的結構。必須開啟程式碼執行功能。
• Claude Code：自己用就解壓縮到 ~/.claude/skills/；要給每位複製儲存庫的人使用，就解壓縮到儲存庫中的 .claude/skills/。
• Codex、Cursor、OpenCode：各自從自己的位置讀取技能資料夾；同步指南列出了這些位置。

每一份手動放置的副本，都得有人手動更新。這正是 AI Skill Pod 幫你接手的工作。

寫出 AI 會照著行動的說明

在找到符合請求的技能之前，AI 只看得到每個技能的名稱和說明，所以說明決定了你的技能會不會被開啟。有三個好習慣：

• 先寫它做什麼：「用我們客服的語氣草擬退款回覆。」
• 再寫何時使用：「客戶要求退款、退貨或信用卡爭議款時使用。」
• 寫出大家會打的詞：產品名稱、檔案類型、團隊自己的用語。