几种安装 ClaudeCode Skills的方式

一、从插件市场安装（以 Superpowers 为例）

场景：安装社区知名的 superpowers 技能包，它提供了头脑风暴、写计划、TDD 等标准化工作流。

步骤与示例：

1. 启动 Claude Code 会话

2. 依次执行以下命令：

# 添加插件市场（作者提供的市场地址）
/plugin marketplace add obra/superpowers-marketplace

# 安装插件
/plugin install superpowers@superpowers-marketplace

3. 完全退出 Claude Code（Ctrl+C 或 /exit），重新启动

4. 验证：输入 /help，应该看到 superpowers:brainstorm 等命令

另一个示例：从私有 Git 仓库安装（假设你的公司内部技能市场地址为 https://gitlab.com/company/claude-skills-marketplace）

/plugin marketplace add https://gitlab.com/company/claude-skills-marketplace
/plugin install internal-qa@company-marketplace

二、使用 npx skills add 命令安装

示例 1：从 GitHub 仓库安装单个技能

场景：只安装 Superpowers 中的 using-superpowers 核心技能，不装全套。

npx skills add https://github.com/obra/superpowers --skill using-superpowers -g -y

• -g：全局安装（~/.claude/skills/）

• -y：跳过确认提示

• 安装后重启 Claude Code，输入 /find-skills 应看到 using-superpowers。

示例 2：从本地文件夹安装（自己写的技能）

场景：你写了一个 react-component-generator 技能，文件夹位于 ~/my-skills/react-gen/，里面包含 SKILL.md。

npx skills add ~/my-skills/react-gen -g -y

示例 3：从本地 .zip 压缩包安装

场景：同事发给你一个 api-testing-skill.zip，保存在 ~/Downloads/。

# 不需要手动解压，直接运行
npx skills add ~/Downloads/api-testing-skill.zip -g -y

示例 4：只安装到当前项目（不加 -g）

场景：技能仅用于当前项目，方便通过 Git 分享。

cd ~/my-project
npx skills add https://github.com/team/special-debug-skill -y
# 不加 -g，技能会安装在 ./claude/skills/ 下

三、手动复制到技能目录

示例 1：全局安装（所有项目可用）

场景：你下载了一个 code-review-skill.zip，想全局启用。

# 1. 解压到临时目录
unzip code-review-skill.zip -d ~/temp/code-review-skill

# 2. 确保解压后的文件夹直接包含 SKILL.md（不是多一层目录）
ls ~/temp/code-review-skill/
# 应该输出：SKILL.md  以及其他辅助文件

# 3. 复制到 Claude Code 全局技能目录
mkdir -p ~/.claude/skills
cp -r ~/temp/code-review-skill ~/.claude/skills/

# 4. 重启 Claude Code

示例 2：项目级安装（仅当前项目）

场景：你希望团队成员拉取代码后自动获得某个技能。

cd ~/my-project

# 在项目根目录下创建技能目录
mkdir -p .claude/skills

# 将技能文件夹复制进去（假设技能叫 security-scanner）
cp -r ~/Downloads/security-scanner .claude/skills/

# 将 .claude/skills/ 提交到 Git
git add .claude/skills/security-scanner
git commit -m "Add security scanner skill for the team"

示例 3：手动处理多层嵌套的压缩包

场景：解压后发现文件夹结构是 my-skill-main/skill-files/SKILL.md（多了一层无效目录），Claude 无法识别。

# 错误的结构
my-skill-main/
└── skill-files/
    └── SKILL.md

# 修正方法：将 SKILL.md 上移一层
cd my-skill-main
mv skill-files/* .
rmdir skill-files

# 现在结构正确
my-skill-main/
└── SKILL.md

# 再复制到技能目录
cp -r my-skill-main ~/.claude/skills/

四、快速决策示例

你的情况	推荐方式	具体命令/操作
想安装 Superpowers 全套	插件市场	/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace
只想装 Superpowers 里的一个技能	npx skills add	npx skills add https://github.com/obra/superpowers --skill using-superpowers -g -y
同事给了你一个 .zip 技能包	npx skills add	npx skills add ~/Downloads/xxx.zip -g -y
你写了一个私有技能，不想上网	手动复制	解压后复制到 ~/.claude/skills/
团队需要共享一个定制技能	手动复制到项目目录	放入 项目根目录/.claude/skills/ 并提交 Git
技能来自 GitHub 仓库，但不是插件市场格式	npx skills add	npx skills add https://github.com/user/repo -g -y