如何不要使用可攜式 skill

description 含糊、檔案太大,或把店面頁當成工作工具時,skill 會安靜地失敗。這些是浪費一個工作階段的錯誤 — 老實說,不責罵。

不要把 hub 或 companion 當成工作工具。

Hub 列出 packs。Companion 頁是 Setup:複製或下載。兩者都不會畫線框、跑稽核,或截圖斷點。那些工作請打開對應的瀏覽器工具,或讓已安裝的 skill 在你的 agent 執行。

不要安裝一次後,又把同一個 skill 當第二條流程下載。

執行 npx skills@latest add iruhdam1/skills 從 companion 下載一個 pack — 同一個 skill 不要兩者都做。兩份副本會漂移;agent 可能載入過期的那份。

不要寫第一人稱或含糊的 description。

Claude 與其他主機從 description 欄位發現 skills。第一人稱(“I help you…”)或空的範圍代表 agent 永遠不會選這個檔。用第三人稱寫它做什麼、何時使用。Anthropic 的撰寫說明也涵蓋同一條規則。

不要把所有東西塞進 SKILL.md。

讓本文維持一份程序。把長註解放到下一層的相鄰參考檔,讓主機只在需要時載入。一面牆的文字會燒掉 context,並藏起觸發條件。

不要複製店面的 .agents/skills,也不要編輯 Analog。

這個店的 .agents/skills 資料夾(COSS、Phosphor 與其他 agent 幫手)不是公開 pack。不要複製。不要編輯 Analog。公開集合是 hub 上列出的 GitHub pack。

不要追一個缺少的 skills.sh 列表。

skills.sh 是公開列表加上安裝遙測。缺少徽章不是失敗的 GitHub push。若 pack 尚未列出,用 GitHub 或店面 companion。見 skills.sh vs GitHub