返回部落格

去哪裡找 Claude 的代理程式技能,以及如何從 GitHub 安裝

代理程式技能放在哪裡,安裝前怎樣檢查,以及從 GitHub 儲存庫安裝技能的兩種方法:用一個會驗證每個檔案的 CLI,或者手動安裝。

SOSourceWeftNov 20, 20266 分鐘閱讀

最後更新: 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」,能找到還沒有被任何目錄索引的儲存庫。這種方式沒有任何篩選,所以安裝前要把所有內容都讀一遍。

安裝前先檢查技能

花兩分鐘做這五項檢查:

  1. 讀 SKILL.md。 裡面的說明就是代理程式要照著做的事。如果它讓代理程式做你自己不會做的事,就此打住。
  2. 看檔案列表。 技能裡有腳本嗎?腳本是程式碼,使用技能時會在你的機器上執行。
  3. 檢查來源。 儲存庫是不是來自你預期的發布者?它有提交歷史嗎,還是僅有一個新帳號提交的一個 commit?
  4. 檢查授權條款。 沒有授權條款,就意味著你沒有明確的權利在工作中使用它。
  5. 讀掃描提示。 「會發起對外的網路請求」這樣的提示不是結論,但你應該弄清楚技能為什麼需要這樣做。每種提示的含義見安裝代理程式技能之前怎麼檢查。

用 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 手動安裝

你也可以自己複製資料夾。這種方法適用於任何儲存庫裡的任何技能,包括沒有被任何目錄收錄的技能。

  1. 找到技能資料夾。 它就是儲存庫裡包含 SKILL.md 的那個資料夾。
  2. 固定到某個 commit。 開啟你審查過的那個 commit,從這個 commit 下載,不要從會變動的預設分支下載。
  3. 複製整個資料夾,不要只複製 SKILL.md。腳本和參考檔案也是技能的一部分。
  4. 放到代理程式尋找技能的位置。 對 Claude Code 來說,放在 ~/.claude/skills/<skill-name>/ 對你的所有專案生效,放在某個專案裡的 .claude/skills/<skill-name>/ 只對該專案生效。
  5. 資料夾名要與技能的 name 保持一致。 規範要求兩者相同。
  6. 開一個新工作階段,讓代理程式做一件這個技能涵蓋的事。

手動複製沒有雜湊驗證,技能在上游有變化時也不會有人通知你。每次更新技能,都要重新審查一遍。

用 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 <名稱>。手動的話,先審查新版本,再用它替換原來的資料夾;要刪除技能,刪掉它的資料夾即可。

相關文章

可分享連結

繼續閱讀

相關文章

全部文章

Claude Code 教學:用一行指令安裝 skills 與 MCP(從零到能用)

從空資料夾開始,一步一步在 Claude Code 裡安裝技能(skills)與 MCP 伺服器:搜尋、安裝前先看詳情、設定檔寫在哪裡、怎麼確認裝好了。所有指令都是實際執行過的結果。

繼續閱讀

Claude skills(技能)是什麼?怎麼找、怎麼安裝

用白話說明 Claude skills(agent skills)是什麼、一個技能資料夾長什麼樣子、去哪裡找,以及兩種安裝方法:用指令安裝,或手動複製資料夾。附上安裝前要先看的幾件事。

繼續閱讀

什麼是代理程式技能目錄?按類別瀏覽 26,423 個技能

代理程式技能目錄是什麼,一個好的收錄條目在你安裝之前應該展示什麼,以及怎樣透過搜尋、CLI 和每個技能的安裝指南,在 15 個類別裡瀏覽 26,423 個技能。數字讀取於 2026 年 11 月 21 日。

繼續閱讀