安装 Claude Code 技能:文件夹、插件与 CLI 项目配图

如何安装 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 一起复制配套文件。

  1. 获取固定版本来源

    克隆发布者仓库,并检出目录记录的版本。下载源码不会调用技能。

    git clone https://github.com/anthropics/skills.git
    git -C skills checkout dbd4588f9e1033efb41dad4bef2f7947c8993d44
  2. 阅读完整技能

    打开 skills/frontend-design/SKILL.md,检查该文件夹内其他文件及引用的脚本。确认接受指令和许可后再继续。

  3. 复制到项目技能目录

    确认目标位置没有已有的 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
  4. 在 Claude Code 中验证发现结果

    在该项目启动新的 Claude Code 会话,查看 / 菜单中的 frontend-design。调用前检查请求的工具。未出现时,核对文件名、YAML 元数据及文件夹层级。

方式二:使用 Claude 插件市场

Anthropic 技能仓库把 PDF 等文档技能打包为 document-skills 插件。以下斜杠命令在交互式 Claude Code 会话中输入,不是在终端 shell 中执行。

  1. 检查市场与插件内容

    阅读 anthropics/skills 的 README 与 .claude-plugin/marketplace.json。确认市场名为 anthropic-agent-skills,document-skills 包含所需技能。分别检查每个技能的许可。

  2. 注册发布者市场

    在 Claude Code 中把来源仓库添加为市场。添加市场与安装插件是两个独立操作。

    /plugin marketplace add anthropics/skills
  3. 安装 document-skills 并选择作用域

    打开插件安装流程,检查内容。临时项目选 local,共享配置选 project,本机各项目选 user。这会安装整个包,不只 PDF。

    /plugin install document-skills@anthropic-agent-skills
  4. 核对已安装插件与技能

    查看 /plugin → Installed,再启动新会话,检查 / 菜单中带插件命名空间的技能,例如 /document-skills:pdf。测试结束后通过 /plugin 禁用或卸载整个包。

方式三:用 npx skills add 安装

skills CLI 是 Vercel Labs 提供的独立工具。此示例选择本站已有的 React Best Practices 条目,目标为 Claude Code。在测试项目的终端中执行以下命令。

  1. 检查前提并列出可用技能

    使用 Node.js 22.20 或更新版本,并确保 npm/npx 可用。允许 npx 下载运行前先阅读 skills CLI README。先列出仓库技能;该操作只列出选项,不安装技能。

    node --version
    npx skills add vercel-labs/agent-skills --list
  2. 检查选中的来源

    阅读 React Best Practices 源码及 rules 目录。技能元数据名称是 vercel-react-best-practices,与仓库文件夹名称不同。GitHub 简写跟随默认分支,因此应对照目录固定版本检查当前变化。

  3. 选择一个技能并指定 Claude Code

    运行安装命令,确认前检查目标位置及符号链接或复制选项。默认当前项目;需要个人作用域时才加 -g。同一技能不要再通过文件夹或插件重复安装。

    npx skills add vercel-labs/agent-skills --skill vercel-react-best-practices -a claude-code
  4. 验证目标智能体与作用域

    列出项目的 Claude Code 技能,再启动新的 Claude Code 会话并检查 / 菜单。全局安装时,列表命令也加 -g。应用更新前先检查;卸载时用 npx skills remove 并选择相同智能体与作用域。

    npx skills list -a claude-code

来源文档

核对日期:2026 年 10 月 25 日。客户端版本或仓库结构不同时,请按发布者当前说明操作。

已核验来源的技能与 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 命名空间。