最后更新: 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 <名称>。手动的话,先审查新版本,再用它替换原来的文件夹;要删除技能,删掉它的文件夹即可。