最後更新: 2026-11-20
先說結論
代理程式技能(下文簡稱「技能」)放在 GitHub 儲存庫裡。找技能有三個地方:發布者自己的儲存庫,索引了許多儲存庫的技能目錄,或者直接在 GitHub 上搜尋。
安裝技能,就是把技能的資料夾放到代理程式尋找技能的位置。可以用命令列安裝工具,這樣更快,還能驗證檔案;也可以自己複製資料夾。
不管用哪種方法,先讀一讀技能的 SKILL.md,再看它有沒有帶腳本。帶腳本的技能會在你的機器上執行程式碼。
你要找的是什麼
技能是一個資料夾,根部有一個 SKILL.md 檔案。檔案開頭是一小段後設資料,包含 name 和 description,後面是用 Markdown 寫的說明。資料夾裡還可以有 scripts/、references/ 和 assets/。
格式就這麼多。它是一份開放規範,定義在 agentskills.io,所以同一個技能資料夾可以用在任何支援這種格式的代理程式上,不只是 Claude。
去哪裡找技能
1. 發布者自己的儲存庫
很多技能是由對應工具的開發團隊發布的。Anthropic 在 github.com/anthropics/skills 維護著一個公開的技能儲存庫。其他公司也用同樣的方式為自己的產品發布技能。
發布者的儲存庫是最直接的來源。它的侷限是,你得先知道有這個儲存庫。
2. 技能目錄
目錄把許多儲存庫裡的技能索引起來,讓你可以一起搜尋。好用的目錄會為每個技能列出來源儲存庫、授權條款、完整的 SKILL.md 和檔案列表,這樣你在安裝前就能判斷這個技能怎麼樣。
SourceWeft 技能目錄索引了 GitHub 儲存庫裡的公開技能。對每個技能,它記錄:
- 來源儲存庫,以及掃描該技能時所在的那個 commit
- 完整的
SKILL.md和檔案列表 - 作者選擇的授權條款
- 技能是否帶腳本
- 自動掃描給出的提示,比如「會發起對外的網路請求」
- 一個信任標籤,說明是否有 SourceWeft 管理員審核過它
目錄不託管技能檔案。它指向儲存庫和 commit,它的安裝工具從那裡下載。
3. GitHub 搜尋
在 GitHub 上搜尋 SKILL.md,或者搜尋某個主題加上「agent skill」,能找到還沒有被任何目錄索引的儲存庫。這種方式沒有任何篩選,所以安裝前要把所有內容都讀一遍。
安裝前先檢查技能
花兩分鐘做這五項檢查:
- 讀
SKILL.md。 裡面的說明就是代理程式要照著做的事。如果它讓代理程式做你自己不會做的事,就此打住。 - 看檔案列表。 技能裡有腳本嗎?腳本是程式碼,使用技能時會在你的機器上執行。
- 檢查來源。 儲存庫是不是來自你預期的發布者?它有提交歷史嗎,還是僅有一個新帳號提交的一個 commit?
- 檢查授權條款。 沒有授權條款,就意味著你沒有明確的權利在工作中使用它。
- 讀掃描提示。 「會發起對外的網路請求」這樣的提示不是結論,但你應該弄清楚技能為什麼需要這樣做。每種提示的含義見安裝代理程式技能之前怎麼檢查。
用 CLI 安裝
SourceWeft CLI 從目錄安裝技能,並把每個檔案與掃描技能時記錄的雜湊逐一比對。只要有一個檔案對不上,就什麼都不會寫入。
搜尋:
npx @sourceweft/cli skills search "pdf forms"
安裝前先檢視。這條指令會顯示儲存庫、commit、授權條款、信任標籤、技能是否帶腳本,以及掃描提示:
npx @sourceweft/cli skills info <名稱>
安裝:
npx @sourceweft/cli skills install <名稱>
預設情況下,技能會安裝到家目錄下,供 Claude Code 使用。有兩個選項可以改變這一點:
--agent選擇目標代理程式:claude-code、codex、cursor,或者用universal安裝到許多代理程式都會讀取的共享資料夾.agents/skills。執行npx @sourceweft/cli skills agents檢視完整列表,其中還包括 Gemini CLI、Windsurf、GitHub Copilot 等,並列出每個代理程式使用的資料夾。--scope project安裝到目前專案,而不是家目錄。
在寫入任何內容之前,CLI 會顯示技能的來源、授權條款和檔案數量,並請你確認。如果技能帶腳本,提示語裡會說明。
<名稱> 是搜尋結果裡列印的安裝名稱,例如 @owner/skill-name。想看一步一步的操作和真實輸出,見用 SourceWeft CLI 安裝代理程式技能。
檢視、更新或刪除已安裝的技能:
npx @sourceweft/cli skills list
npx @sourceweft/cli skills update
npx @sourceweft/cli skills remove <名稱>
update 在替換任何內容之前都會先詢問,因為新版本可能帶來新的腳本。
從 GitHub 手動安裝
你也可以自己複製資料夾。這種方法適用於任何儲存庫裡的任何技能,包括沒有被任何目錄收錄的技能。
- 找到技能資料夾。 它就是儲存庫裡包含
SKILL.md的那個資料夾。 - 固定到某個 commit。 開啟你審查過的那個 commit,從這個 commit 下載,不要從會變動的預設分支下載。
- 複製整個資料夾,不要只複製
SKILL.md。腳本和參考檔案也是技能的一部分。 - 放到代理程式尋找技能的位置。 對 Claude Code 來說,放在
~/.claude/skills/<skill-name>/對你的所有專案生效,放在某個專案裡的.claude/skills/<skill-name>/只對該專案生效。 - 資料夾名要與技能的
name保持一致。 規範要求兩者相同。 - 開一個新工作階段,讓代理程式做一件這個技能涵蓋的事。
手動複製沒有雜湊驗證,技能在上游有變化時也不會有人通知你。每次更新技能,都要重新審查一遍。
用 CLI 還是手動?
| CLI | 手動 | |
|---|---|---|
| 速度 | 一條指令 | 幾分鐘 |
| 驗證檔案 | 是,與記錄的雜湊比對 | 否 |
| 固定版本 | 是,固定到掃描時的 commit | 只有你自己動手才會 |
| 更新 | skills update,需要確認 | 手動 |
| 適用於不在目錄裡的技能 | 否 | 是 |
| 提醒帶有腳本 | 是 | 否 |
安裝之後
- 試一試。 先用一個小任務測試,再放心依賴它。
- 留意它做了什麼。 第一次使用時尤其要看,特別是它會執行腳本的時候。
- 不用了就刪掉。 可以用
skills remove,也可以直接刪除它的資料夾。已安裝技能的描述在每個工作階段裡都會被載入。
常見問題
去哪裡找 Claude 的代理程式技能?
三個地方:發布者自己的 GitHub 儲存庫,比如 anthropics/skills;技能目錄,比如 SourceWeft 技能目錄;或者在 GitHub 上搜尋包含 SKILL.md 的儲存庫。
如何從 GitHub 安裝代理程式技能?
把包含 SKILL.md 的資料夾複製到代理程式的技能資料夾裡。對 Claude Code 來說,就是 ~/.claude/skills/<skill-name>/。也可以用 CLI 安裝工具,它做的是同一件事,還能驗證檔案。
安裝代理程式技能安全嗎? 技能是第三方內容。不帶腳本的技能就是文字,你可以從頭到尾讀完。帶腳本的技能會在你的機器上執行程式碼,所以要麼把腳本讀一遍,要麼只安裝你信任的發布者的技能。
技能只能在 Claude 上用嗎? 不是。Agent Skills 是一種開放格式。同一個資料夾可以用在任何支援它的代理程式上。
使用 SourceWeft 目錄裡的技能,必須用 SourceWeft 嗎? 不需要。CLI 會為 Claude Code、Codex、Cursor 這樣的本機代理程式安裝技能。你也可以在技能的頁面上把它新增到 SourceWeft 工作區。
如何更新或刪除技能?
用 CLI 的話,執行 skills update 或 skills remove <名稱>。手動的話,先審查新版本,再用它替換原來的資料夾;要刪除技能,刪掉它的資料夾即可。