
如何安装 Claude Code 技能
安装 Claude Code 技能可选三种方式:复制完整技能文件夹、从插件市场安装,或用 npx skills add 指定 Claude Code。先在临时项目中尝试,并查看下方已核验来源条目的 Install(安装)标签,确认每个技能自己的配置要求。
安装前:核对来源与作用域
复制或启用前,先阅读 SKILL.md、许可、脚本及引用文件。核对 shell 命令、网络目标和所需凭据;技能可能引导智能体调用工具。插件还可能捆绑 hooks 与 MCP 服务。测试项目不要放密钥或真实客户数据。目录核验来源不等于安全审计,也不保证技能安全。
三种安装方式对照
| 方式 | 适用情况与前提 | 作用域与位置 | 验证、更新与移除 |
|---|---|---|---|
| 复制 SKILL.md 文件夹 | 从已检查的 GitHub 版本安装单个技能;下方示例需要 Git。 | .claude/skills/<name>/ 用于当前项目;~/.claude/skills/<name>/ 用于本机各项目。 | 检查 SKILL.md 与 / 菜单。检查更新后替换文件夹;移除该文件夹即可卸载。 |
| Claude 插件市场 | 发布者提供插件及市场清单;需要支持插件的 Claude Code。 | 在插件管理器选择 user、project 或 local 作用域;缓存文件由 Claude 管理。 | 查看 /plugin → Installed。检查市场更新;通过 /plugin 禁用或卸载。 |
| npx skills add | 从仓库选择技能及目标智能体;当前 CLI 需要 Node.js 22.20+ 和网络。 | 默认当前项目;-g 为个人作用域。-a claude-code 指定 Claude 技能目录;可选符号链接或复制。 | 先用 npx skills list -a claude-code,再查 Claude 的 / 菜单。更新前用 npx skills check 检查;用 npx skills remove 移除。 |
这里的本地路径适用于本机 Claude Code,不会把技能装到 Claude.ai 网页或远程云会话。
方式一:复制完整 SKILL.md 文件夹
此示例把目录固定版本的 Frontend Design 技能装到单个项目。在全新的测试项目中执行 shell 命令,连同 SKILL.md 一起复制配套文件。
获取固定版本来源
克隆发布者仓库,并检出目录记录的版本。下载源码不会调用技能。
git clone https://github.com/anthropics/skills.git git -C skills checkout dbd4588f9e1033efb41dad4bef2f7947c8993d44阅读完整技能
打开 skills/frontend-design/SKILL.md,检查该文件夹内其他文件及引用的脚本。确认接受指令和许可后再继续。
复制到项目技能目录
确认目标位置没有已有的 frontend-design 文件夹,再复制整个文件夹,并确认 SKILL.md 直接位于其中。个人作用域可把 .claude/skills 改为 ~/.claude/skills。
mkdir -p .claude/skills cp -R skills/skills/frontend-design .claude/skills/frontend-design test -f .claude/skills/frontend-design/SKILL.md在 Claude Code 中验证发现结果
在该项目启动新的 Claude Code 会话,查看 / 菜单中的 frontend-design。调用前检查请求的工具。未出现时,核对文件名、YAML 元数据及文件夹层级。
方式二:使用 Claude 插件市场
Anthropic 技能仓库把 PDF 等文档技能打包为 document-skills 插件。以下斜杠命令在交互式 Claude Code 会话中输入,不是在终端 shell 中执行。
检查市场与插件内容
阅读 anthropics/skills 的 README 与 .claude-plugin/marketplace.json。确认市场名为 anthropic-agent-skills,document-skills 包含所需技能。分别检查每个技能的许可。
注册发布者市场
在 Claude Code 中把来源仓库添加为市场。添加市场与安装插件是两个独立操作。
/plugin marketplace add anthropics/skills安装 document-skills 并选择作用域
打开插件安装流程,检查内容。临时项目选 local,共享配置选 project,本机各项目选 user。这会安装整个包,不只 PDF。
/plugin install document-skills@anthropic-agent-skills核对已安装插件与技能
查看 /plugin → Installed,再启动新会话,检查 / 菜单中带插件命名空间的技能,例如 /document-skills:pdf。测试结束后通过 /plugin 禁用或卸载整个包。
方式三:用 npx skills add 安装
skills CLI 是 Vercel Labs 提供的独立工具。此示例选择本站已有的 React Best Practices 条目,目标为 Claude Code。在测试项目的终端中执行以下命令。
检查前提并列出可用技能
使用 Node.js 22.20 或更新版本,并确保 npm/npx 可用。允许 npx 下载运行前先阅读 skills CLI README。先列出仓库技能;该操作只列出选项,不安装技能。
node --version npx skills add vercel-labs/agent-skills --list检查选中的来源
阅读 React Best Practices 源码及 rules 目录。技能元数据名称是 vercel-react-best-practices,与仓库文件夹名称不同。GitHub 简写跟随默认分支,因此应对照目录固定版本检查当前变化。
选择一个技能并指定 Claude Code
运行安装命令,确认前检查目标位置及符号链接或复制选项。默认当前项目;需要个人作用域时才加 -g。同一技能不要再通过文件夹或插件重复安装。
npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices -a claude-code验证目标智能体与作用域
列出项目的 Claude Code 技能,再启动新的 Claude Code 会话并检查 / 菜单。全局安装时,列表命令也加 -g。应用更新前先检查;卸载时用 npx skills remove 并选择相同智能体与作用域。
npx skills list -a claude-code
来源文档
核对日期:2026 年 10 月 25 日。客户端版本或仓库结构不同时,请按发布者当前说明操作。
- Claude Code skills: 文件夹位置、SKILL.md 格式与调用。
- Claude Code plugins: 市场注册、安装作用域与插件管理。
- Anthropic skills README: document-skills 市场示例及逐技能许可说明。
- Vercel Labs skills CLI: 前提、选择参数、列表与移除;CLI 命令不是 Claude 斜杠命令。
已核验来源的技能与 Install 标签
查看各条目的固定版本、许可与 Claude Code 安装标签,再选择装法。
常见问题
Claude Code 技能放在哪里?
本地项目把完整技能文件夹放在 .claude/skills/<skill-name>/,SKILL.md 直接位于其中。本机各项目可用 ~/.claude/skills/<skill-name>/。插件自行管理技能位置。
如何从 GitHub 安装 Claude Code 技能?
先检查仓库和许可,检出已知版本,把完整技能文件夹复制到选定目录。脚本、参考文件与 SKILL.md 一起保留,再检查该项目中 Claude Code 的 / 菜单。
可以通过 Claude 插件市场安装技能吗?
可以,前提是发布者把技能打包为插件。先添加市场,再安装指定插件并选择作用域。anthropics/skills 的文档技能包为 document-skills@anthropic-agent-skills;普通 SKILL.md 文件夹不会自动成为市场。
npx skills add 如何指定 Claude Code?
添加 -a claude-code,并用 --skill 指定技能元数据名称。默认项目作用域;-g 选择个人作用域。用 npx skills list -a claude-code 检查项目,再在 Claude Code 中验证发现结果。
为什么安装后看不到技能?
检查打开的项目、所选作用域、SKILL.md 文件名、YAML 元数据是否有效,以及是否多嵌套了一层文件夹。启动新会话,检查 / 菜单,并确认插件已启用。插件技能使用 /plugin-name:skill-name 命名空间。


