VS Code中添加Claude Skill的正确方法

在 VS Code 中为 Claude Code 添加 Skill，核心是通过skillsCLI 工具，并确保安装到正确的路径。以下是详细的操作步骤和关键要点。

power_Max@

4202人浏览 · 2026-04-15 16:00:10

power_Max@ · 2026-04-15 16:00:10 发布

在 VS Code 中为 Claude Code 添加 Skill，核心是通过 skills CLI 工具，并确保安装到正确的路径。以下是详细的操作步骤和关键要点。

1. 核心工具与环境准备

首先，你需要使用 Claude Code 提供的 skills CLI 工具。它通常随 Claude Code 插件或环境一同安装。

# 检查 skills 命令是否可用
npx @anthropic-ai/skills --help

如果提示命令未找到，你可能需要先安装 Node.js 和 npm，并通过 npm 全局安装该工具包。

2. 添加 Skill 的标准流程

Skill 可以是一个本地目录、一个 Git 仓库或一个已发布的 npm 包。

# 基础添加命令
npx @anthropic-ai/skills add <skill_identifier>

# 示例1：添加一个本地 Skill 目录
npx @anthropic-ai/skills add ./path/to/my-awesome-skill

# 示例2：添加一个 Git 仓库中的 Skill
npx @anthropic-ai/skills add https://github.com/user/skill-repo.git

# 示例3：添加一个 npm 包形式的 Skill
npx @anthropic-ai/skills add @scope/skill-package-name

3. 关键参数：`-a claude-code`

这是最容易出错的地方。Claude Code 的 Skill 和普通的 Agent Skill 安装路径不同，必须通过 -a 或 --app 参数指定应用类型。

# 为 VS Code 中的 Claude Code 添加 Skill 的正确命令
npx @anthropicic-ai/skills add <skill_identifier> -a claude-code

参数选项	作用	安装路径示例
`-a claude-code`	必须。指定为 Claude Code 安装 Skill。	`~/.claude/skills/`
(默认或无参数)	为通用 AI Agent 安装 Skill。	`~/.anthropic/skills/`

如果不加 -a claude-code 参数，Skill 会被安装到错误的目录，导致 VS Code 中的 Claude Code 无法识别和调用该 Skill。

4. 验证与管理已安装的 Skill

添加后，可以使用以下命令进行验证和管理。

# 列出已为 Claude Code 安装的所有 Skill
npx @anthropic-ai/skills ls -a claude-code

# 输出示例：
# /Users/username/.claude/skills/my-awesome-skill
# /Users/username/.claude/skills/github-skill

# 移除一个不再需要的 Skill
npx @anthropic-ai/skills remove my-awesome-skill -a claude-code

5. Skill 在 VS Code 中的触发与使用

Skill 安装成功后，其核心逻辑由 skill.md 文件中的 description 字段控制触发。当你在 Claude Code 的聊天界面中输入与某个 Skill 的 description 匹配的自然语言指令时，Claude 会自动调用该 Skill。

例如，一个用于生成测试用例的 Skill，其 description 可能为：“ALWAYS invoke this skill when the user asks to generate test cases or unit tests.” 。当你在聊天框输入“为这个函数生成单元测试”，该 Skill 就会被触发并执行其预设的脚本或逻辑。

6. 常见问题与排查

如果 Skill 添加后不触发，请按以下步骤排查：

检查安装路径：确认 Skill 是否安装在 ~/.claude/skills/ 目录下。
检查 description 字段：description 是 Claude 发现 Skill 的唯一依据。确保其描述清晰、具有指令性（例如使用“ALWAYS invoke...”），并与你的用户查询意图高度相关。
检查 Skill 结构：一个完整的 Skill 目录至少应包含 skill.md 文件，以及可选的 references（参考文件）和 scripts（脚本）目录。
重启 VS Code：有时安装新 Skill 后需要重启 VS Code 或重新加载 Claude Code 窗口以使更改生效。