返回部落格

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

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

SOSourceWeftNov 21, 20265 分鐘閱讀

最後更新: 2026-11-21

先講結論

Claude skills(也常被叫做 agent skills,中文多半稱「技能」)就是一個資料夾,裡面有一份 SKILL.md,用文字寫著「遇到某類工作時,該怎麼做」。你把這個資料夾放到 Claude Code 找得到的地方,Claude 就能在需要的時候讀它,照著做。

找技能有三個管道:發布者自己的 GitHub 儲存庫、收錄很多儲存庫的技能目錄,或直接在 GitHub 搜尋。安裝有兩種方法:用指令安裝,或自己複製資料夾。不管用哪一種,裝之前都先看一下它帶不帶腳本,因為腳本會在你的電腦上執行。

技能長什麼樣子

一個技能資料夾最少只需要 SKILL.md。檔案開頭有一小段中繼資料,寫著 name(名稱)和 description(說明),後面就是用 Markdown 寫的指示。我們實際安裝一個技能後,看到的 SKILL.md 開頭是這樣:

---
name: frontend-design
description: Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. …
license: Complete terms in LICENSE.txt
---

資料夾裡也可能有 scripts/(腳本)、references/(參考資料)和 assets/(素材)。這個格式有公開規格,放在 agentskills.io,所以同一個技能資料夾,其他支援這個格式的工具也能用,不是只有 Claude。

技能和 MCP 差在哪

簡單說:技能是「寫給 Claude 看的做事說明」,MCP 是「讓 Claude 呼叫外部工具的服務」。前者是資料夾,後者要連線。完整比較請看MCP 伺服器與智慧體技能的差別;如果你想連 MCP 一起設定,請看在 Claude Code 裡安裝 skills 與 MCP 的教學。

去哪裡找技能

  1. 發布者自己的儲存庫。 很多技能由做那個工具的團隊自己發布,例如 Anthropic 在 github.com/anthropics/skills 就有公開的技能。這是最直接的來源,缺點是你得先知道它存在。
  2. 技能目錄。 目錄把許多儲存庫的技能收在一起,讓你一次搜尋。SourceWeft 技能目錄收錄 GitHub 上的公開技能,每個技能都會記錄來源儲存庫與掃描當時的確切版本、完整的 SKILL.md 與檔案清單、作者選的授權、有沒有腳本、自動掃描的備註,以及是否經過 SourceWeft 管理員審核。目錄本身不存放技能檔案,它指向儲存庫和版本,安裝時是從那裡下載。
  3. GitHub 搜尋。 搜尋 SKILL.md 或「主題 + agent skill」,能找到還沒被任何目錄收錄的儲存庫。這個方式完全沒有任何篩選,所以安裝前要把內容全部讀過。

安裝前先看什麼

最少看三件事:SKILL.md 的內容(Claude 會照著做)、檔案清單裡有沒有腳本(腳本會在你的電腦上執行),以及授權與來源。每個掃描備註代表什麼,我們寫在安裝智慧體技能之前怎麼檢查。

方法一:用指令安裝

先搜尋,再看詳情,最後安裝(以下都是我們用 CLI 0.3.0 實際執行過的):

npx @sourceweft/cli skills search "frontend design" --limit 5
npx @sourceweft/cli skills info @anthropics/frontend-design-skills
npx @sourceweft/cli skills install @anthropics/frontend-design-skills --scope project

info 會印出來源、版本、授權、信任標籤與檔案數;install 會再印一次,並在寫入前問你要不要繼續。在沒有終端機互動的環境,它不會替你做決定,而是顯示 Error: Confirmation required. Re-run with --yes to proceed without asking. 並停止,什麼都不會寫入。

  • 預設是替 Claude Code 安裝,放進 ~/.claude/skills/;加上 --scope project 則放進目前專案的 .claude/skills/。
  • 想替別的工具安裝,用 --agent。npx @sourceweft/cli skills agents 會列出支援的工具和各自的資料夾,包含 Codex、Cursor、Gemini CLI、Windsurf、GitHub Copilot 等。

CLI 會對照掃描時記錄的雜湊值檢查每個檔案;這只能證明「你裝的就是被掃描的那份」,不能證明內容無害,判斷內容仍然要靠上面「安裝前先看什麼」那一段。逐步的畫面請看用 SourceWeft CLI 安裝智慧體技能。

之後可以用這些指令管理:

npx @sourceweft/cli skills list
npx @sourceweft/cli skills doctor
npx @sourceweft/cli skills update --dry-run

方法二:手動複製資料夾

技能不在任何目錄裡時,也可以自己把含有 SKILL.md 的整個資料夾複製到 ~/.claude/skills/<技能名稱>/(所有專案)或 .claude/skills/<技能名稱>/(單一專案),再開一個新的工作階段。手動複製不會做雜湊檢查,上游更新也不會有人通知你。完整步驟(固定在某個 commit、資料夾名稱要與 name 一致等)請看哪裡找智慧體技能、怎麼安裝。

想要快、想要檔案檢查,或之後要管理很多技能,選指令安裝;技能不在目錄裡,才手動複製。兩種都一樣:裝之前先看過。

常見問題

Claude skills 和 agent skills 是同一個東西嗎? 是同一種格式(資料夾加 SKILL.md)。「Claude skills」是大家搜尋時常用的叫法,「agent skills」是格式規格的稱呼,其他支援這個格式的工具也能用。

Claude skills 要錢嗎? 技能本身是不是免費,要看作者選的授權和發布方式,所以安裝前要看授權欄。用我們的 CLI 搜尋、查看和安裝,不需要登入或帳號。

技能放在哪個資料夾? Claude Code 是 ~/.claude/skills/(所有專案)或 .claude/skills/(單一專案)。

裝了很多技能,會不會互相影響? 我們沒有測試過這個問題,所以不下結論。建議只裝你用得到的,並定期用 skills list 檢查。

怎麼移除技能? npx @sourceweft/cli skills remove <名稱> --yes,名稱要用 skills update --dry-run 輸出的那個(例如 gh-anthropics-skills-frontend-design),不是安裝名稱;加 --scope project 或 --scope user 指定要移除哪一份。手動安裝的技能,直接刪掉資料夾即可。

相關文章

可分享連結

繼續閱讀

相關文章

全部文章

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

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

繼續閱讀

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

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

繼續閱讀

處理 PDF、Word、Excel 和 PowerPoint 檔案的代理程式技能:有哪些、怎麼選

哪些代理程式技能能處理 PDF、Word、Excel 和 PowerPoint 檔案,每個技能帶什麼(檔案數、腳本、掃描備註、授權條款),以及怎樣用一條指令把它安裝到 Claude Code。資料於 2026 年 11 月 21 日對照線上目錄核對。

繼續閱讀