最后更新: 2026-11-21
简短回答
Claude 技能,也叫智能体技能(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 服务器与智能体技能的区别;两者都要配置,见在 Claude Code 里安装技能和 MCP 服务器。
去哪里找技能
- 发布者自己的仓库。 很多技能来自做那个工具的团队。Anthropic 在
github.com/anthropics/skills有公开的技能。这是最直接的来源,但你得先知道它存在。 - 技能目录。 目录收录许多仓库,方便一次搜索。SourceWeft 技能目录收录 GitHub 上的公开技能,并为每个技能记录来源仓库和扫描时的 commit、完整的
SKILL.md和文件列表、作者选的许可证、是否带脚本、自动扫描的备注,以及是否经过 SourceWeft 管理员审核。它不托管文件,只指向仓库和 commit,安装器从那里下载。 - 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 技能和智能体技能是同一个东西吗?
是同一种格式:一个带 SKILL.md 的文件夹。"Claude skills"是常见的搜索说法,"agent skills"是格式本身的名称,其他支持它的工具也能用。
Claude 技能要钱吗? 技能是否免费取决于作者选的许可证和发布方式,所以要看许可证一栏。用我们的 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 选择移除哪一份。手动安装的技能,直接删掉文件夹。