本體就是一個 Markdown 檔

一個 skill 是一個資料夾，裡面放一個 SKILL.md。上面一段 YAML 標頭，下面是正文。

---
name: "weekly-report"
description: "週報彙整。使用者要求整理本週進度或產出週報時使用。"
---

# 週報彙整
使用者給你一個資料夾，你讀完裡面的紀錄，產出一份週報。

真正決定成敗的是 description

agent 不會先讀完你的 skill 再決定要不要用它，它只看 description。

我現在有 66 個技能。使用者丟來一句話，它不可能把 66 本說明書都翻一遍，只能看目錄上那一行。

所以別寫「一個用來產生週報的工具」。使用者不會這樣講話。要寫使用者實際會打出來的句子，而且多列幾種說法。

正文寫得再好，description 沒寫對，那本說明書永遠不會被拿出來。

還有如果有相似功能的部分，請寫詳細一點，不然你會看到做的動作有機率會是錯誤的或是兩個混合

怎麼新增

三條路，結果一樣：Control UI 的「建立／匯入」、CLI 的 skills install、或直接把資料夾丟進工作區的 skills/。檔案監看預設開著，存檔就生效。

但 Companion 不行。 它只能看清單、開開關，不能新增。這點我找了很久才確定。

最後看一下現實

66 個技能裡，就緒 1 個、需要設定 31 個、已停用 34 個。

只有一個真正能用。這不算失敗，是正常的演化——裝一堆想試試看，大部分擱著。但它帶出一個問題：技能多到某個程度，選取準確度會開始掉。

明天來安裝，三個都講，話說Webui的部分又可以介紹一下了。