最後更新: 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 的教學。
去哪裡找技能
- 發布者自己的儲存庫。 很多技能由做那個工具的團隊自己發布,例如 Anthropic 在
github.com/anthropics/skills就有公開的技能。這是最直接的來源,缺點是你得先知道它存在。 - 技能目錄。 目錄把許多儲存庫的技能收在一起,讓你一次搜尋。SourceWeft 技能目錄收錄 GitHub 上的公開技能,每個技能都會記錄來源儲存庫與掃描當時的確切版本、完整的
SKILL.md與檔案清單、作者選的授權、有沒有腳本、自動掃描的備註,以及是否經過 SourceWeft 管理員審核。目錄本身不存放技能檔案,它指向儲存庫和版本,安裝時是從那裡下載。 - 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 指定要移除哪一份。手動安裝的技能,直接刪掉資料夾即可。