野渡
搜索 K

主题

Claude Code Skills 安装与更新说明

1,282 字 5 分钟

Claude Code Skills 安装与更新说明 ​

Summary

结论先行：Claude Code 目前最稳的 skill 使用方式分成两类：

  1. 直接放入约定目录：项目级 .claude/skills/，全局级 ~/.claude/skills/
  2. 通过第三方工具或 plugin 做分发与安装

vercel-labs/skills 属于 社区 CLI 安装器，不是 Claude Code 官方内置的 skill install 命令。

1. Claude Code 官方支持的 skill 放置方式 ​

项目级安装 ​

将 skill 放到当前项目目录：

text
<repo>/.claude/skills/<skill-name>/SKILL.md

特点：

  • 只对当前项目生效
  • 适合团队共享
  • 可以随仓库一起提交到版本控制

全局安装 ​

将 skill 放到用户目录：

text
~/.claude/skills/<skill-name>/SKILL.md

在当前 Windows 环境中，通常可理解为：

text
C:\Users\admin\.claude\skills\<skill-name>\SKILL.md

特点：

  • 对当前用户所有项目生效
  • 适合个人通用 workflow
Note

Claude Code 官方目前没有单独的 skill install 命令。所谓“安装 standalone skill”，本质上仍然是把文件放到正确目录。

2. vercel-labs/skills 是什么 ​

vercel-labs/skills 本身是一个 CLI 工具仓库，提供 skills / add-skill 命令，用来把 skills 安装到多个 coding agents，包括 Claude Code。

它的定位更接近：

  • 社区安装器
  • skill 分发辅助工具
  • 基于官方目录约定的包装层

而不是：

  • Claude Code 官方内置 skill 包管理器
  • Claude 官方 plugin marketplace 的一部分

3. 如何只给 Claude Code 安装 skills ​

关键参数是：

bash
-a claude-code

只要显式指定这个参数，就表示安装目标仅限 Claude Code。

只安装一个指定 skill 到当前项目 ​

bash
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code

将某个源里的全部 skills 安装到当前项目 ​

bash
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code

非交互安装 ​

bash
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code -y

4. 能否全局安装和项目安装 ​

可以，二者都支持。

项目安装 ​

不加 -g 时，默认安装到当前项目：

text
./.claude/skills/

示例：

bash
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code

适合：

  • 项目专属 skill
  • 团队共享
  • 希望跟仓库一起版本化的场景

全局安装 ​

加 -g 时，安装到用户目录：

text
~/.claude/skills/

示例：

bash
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code

适合：

  • 个人高频通用 skill
  • 不依赖具体项目上下文的流程

5. 怎么更新 ​

检查更新 ​

bash
npx skills check

更新已安装内容 ​

bash
npx skills update

不过要区分两种安装方式：

全局安装的更新 ​

从当前源码实现看，check / update 更直接面向 全局安装 的已记录 skills。

这意味着：

  • 如果你是用 -g 给 Claude Code 装到 ~/.claude/skills/
  • 那么 npx skills check / npx skills update 是更自然的更新方式

项目安装的更新 ​

项目级安装不要默认认为 npx skills update 会在任意目录自动更新正确项目。

更稳妥的方式是：

  1. 进入目标项目目录
  2. 重新执行原来的 add 命令

例如：

bash
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code

如果装的是全部 skills，则重新执行：

bash
npx skills add vercel-labs/agent-skills --skill '*' -a claude-code
Warning

从当前 vercel-labs/skills 的源码实现看，update 的作用域更偏向全局安装记录；对于项目级安装，不建议把“在任意目录直接 update”当成稳定能力。

6. 能否在任意目录更新 Claude Code 安装的 skills ​

对全局安装 ​

通常可以。

原因是：

  • check / update 依赖用户级安装记录
  • 不强依赖某个项目目录上下文

所以对全局安装的 Claude Code skills，一般可以在任意目录执行：

bash
npx skills check
npx skills update

对项目安装 ​

不建议这么理解。

如果 skill 安装在某个项目的：

text
<repo>/.claude/skills/

那么更稳妥的方式始终是：

  • 进入该项目目录
  • 重新执行 npx skills add ... -a claude-code

也就是说：

  • 全局安装：更接近“任意目录可更新”
  • 项目安装：更接近“应在目标项目目录更新”

7. symlink 与 copy ​

这个工具支持两种落地方式：

优点：

  • 更新更方便
  • 多 agent 可共享规范副本

显式复制：--copy ​

适用于：

  • Windows 符号链接权限受限
  • 系统策略或安全软件阻止 symlink
  • 想要更直观、独立的文件副本

示例：

bash
npx skills add vercel-labs/agent-skills -a claude-code --copy

8. 实用建议 ​

如果你只想自己长期用 ​

优先选：全局安装

bash
npx skills add vercel-labs/agent-skills --skill <name> -g -a claude-code

如果你想在某个项目里共享给团队 ​

优先选：项目安装

bash
npx skills add vercel-labs/agent-skills --skill <name> -a claude-code

如果你在 Windows 上担心符号链接问题 ​

优先考虑：

bash
--copy

9. 最小命令清单 ​

只给 Claude Code 安装一个 skill ​

bash
npx skills add vercel-labs/agent-skills --skill frontend-design -a claude-code

全局安装到 Claude Code ​

bash
npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code

查看 Claude Code 已安装 skills ​

bash
npx skills ls -a claude-code

查看全局 Claude Code skills ​

bash
npx skills ls -g -a claude-code

检查全局更新 ​

bash
npx skills check

更新全局已安装 skills ​

bash
npx skills update

只从 Claude Code 移除某个 skill ​

bash
npx skills remove --agent claude-code <skill-name>

参考资料 ​