智慧體技能構建器

在瀏覽器中把 Markdown 草稿整理為 Claude 或 Codex SKILL.md 檔案。

技能構建工作臺
生成的 SKILL.md
Frontmatter 已就緒 正文已就緒
什麼是 SKILL.md 檔案?

代理技能是一個包含 SKILL.md 檔案的資料夾,用來告訴編碼代理如何處理某一類工作。檔案以帶有 name 與 description 的 YAML frontmatter 開頭,後面接著 Markdown 指示。代理會依 description 判斷何時使用這個技能,因此那一行決定了技能會不會被用到。

建構工具如何運作

貼上或撰寫 Markdown 草稿,建構工具就會在這個瀏覽器分頁內把它改寫成有效的技能檔案。草稿中既有的 frontmatter 會在寫入新區塊前移除,換行字元與重複空行會被正規化,若草稿有 H1,第一個 H1 會成為顯示標題。輸出是固定格式的 YAML frontmatter,加上標題以及 When to Use 與 Instructions 兩個章節。

常見使用場景
  • 從粗略 Markdown 筆記起草新的 Claude 或 Codex 技能
  • 儲存 SKILL.md 檔案前清理已有 frontmatter
  • 不呼叫 AI API,準備瀏覽器本地的技能交接
  • 把維運手冊或事故檢查清單變成代理能自行選用的技能
  • 重寫代理從不觸發的技能,讓描述說明適用情境而不是功能本身
建構工具保證什麼
  • 固定格式的 YAML frontmatter,包含代理用來比對的 name 與 description
  • 加入新區塊前先移除既有的 frontmatter
  • 統一換行字元並合併重複空行
  • 每個產生的檔案都包含標題以及 When to Use 與 Instructions 章節
  • 整理過程完全在這個瀏覽器分頁內完成,不呼叫任何外部 AI API
示例
輸入: # Quick Triage Helper
輸出: name: quick-triage-helper
輸入: --- title: old ---
輸出: 移除舊的 frontmatter,寫入新的 name 與 description
輸入: ~/.claude/skills/quick-triage-helper/SKILL.md
輸出: 作為個人技能時產生檔案的儲存位置
常見問題

產生的檔案放在哪裡?

把它儲存為 SKILL.md,放在以技能名稱命名的資料夾內:個人技能用 ~/.claude/skills/<name>/SKILL.md,若要整個儲存庫共用,則放在專案內的 .claude/skills/<name>/SKILL.md。

什麼樣的描述才能讓代理選中這個技能?

寫清楚應該在什麼情境下觸發,而不是列出功能。以「何時使用」開頭的描述勝過只是重述標題的描述,因為代理會拿描述去比對眼前的工作。

我的草稿會離開瀏覽器嗎?

不會。整理與 frontmatter 產生都在這個分頁內完成,不呼叫任何 AI API。除非你自己把結果複製到別處,否則什麼都不會上傳。

輸出能用於 Claude 以外的代理嗎?

輸出是帶 YAML frontmatter 的一般 Markdown,因此任何從資料夾載入技能檔案的代理都能讀取。不同工具之間只有安裝路徑不同。

產生之後還能繼續編輯嗎?

可以。輸出只是起點。Instructions 章節可自由修改,需要重寫 frontmatter 時再把草稿放進建構工具跑一次即可。