安装 Skill 之前确保你已经装好了Claude Code。如果没装，先去装。
什么是 Skill？Skill 是给 AI 的"使用说明书"。装了之后 AI 就知道遇到特定任务该怎么做了。不了解的话先看这篇。
开始之前：怎么打开终端
所有安装方式都需要在终端（也叫命令行）里操作。如果你不知道怎么打开：
- Mac：同时按
Command (⌘)和空格，在搜索框里输入"终端"，回车 - Windows：按
Win + R，输入cmd，回车 - 如果你用的是 VS Code 编辑器：顶部菜单选"终端" → "新建终端"
打开后你会看到一个黑底白字的窗口，光标在闪烁，等待你输入命令。
方式一：一行命令安装（最简单）
大部分公开 Skill 都支持这种方式。你只需要知道 Skill 的 GitHub 地址（格式：作者名/项目名）。
把下面这行复制到终端里，按回车：
npx skills add 作者名/项目名这行命令在干什么？
npx是一个运行工具，skills add是安装 Skill 的指令。整行的意思是："帮我从 GitHub 上找到这个 Skill，下载并安装到正确位置。"
实际例子：
# 安装女娲人格蒸馏（分析名人思维方式的 Skill）
npx skills add alchaincyf/nuwa-skill
# 安装 Taste 前端设计（让 AI 生成更好看的界面）
npx skills add Leonxlnx/taste-skill
# 安装科研工具（142 个科研相关的子技能）
npx skills add K-Dense-AI/scientific-agent-skills
如果报错"npx 不是内部或外部命令"：说明你的电脑还没装 Node.js。去nodejs.org下载安装（选 LTS 版本），装好后重启终端再试。
优点：一行命令搞定，自动处理依赖
方式二：手动下载安装（所有 Skill 都支持）
如果方式一不行（比如那个 Skill 不支持 npx），用这种方式。
git clone https://github.com/作者名/项目名 ~/.claude/skills/你想起的名字这行命令在干什么？
git clone：从 GitHub 下载代码（类似于"下载 ZIP 文件"）https://github.com/...：下载地址~/.claude/skills/...：下载到哪。~代表你的用户目录，.claude/skills/是 Claude Code 存放 Skill 的文件夹
实际例子：
# 安装 GStack（虚拟团队 Skill）
git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack
cd ~/.claude/skills/gstack
./setup
注意上面的三行要逐行执行（复制第一行按回车 → 等它跑完 → 复制第二行按回车 → 以此类推）
--single-branch --depth 1：只下载最新版本，不下载历史记录，这样下载更快cd：进入刚下载的文件夹./setup：运行安装脚本（不是所有 Skill 都需要这步，看项目的 README 说明）
# 安装 Superpowers（开发方法论 Skill）
git clone https://github.com/obra/superpowers ~/.claude/skills/superpowers
优点：所有 Skill 通用，可以自定义文件夹名字
方式三：插件市场安装
适合官方和大型项目的 Skill。好处是能自动更新。
# 第一步：注册插件市场（只需要做一次）
/plugin marketplace add anthropics/skills
# 第二步：安装指定的 Skill
/plugin install document-skills@anthropic-agent-skills
/plugin命令在哪输入？不是在终端里，是在 Claude Code 里面。启动 Claude Code 后，直接在里面输入这些命令就行。
Superpowers 也有自己的市场：
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace优点：自动更新、卸载方便
方式四：用 GitHub CLI 安装
如果你已经装了GitHub CLI（一个 GitHub 官方的命令行工具，版本 2.90.0 以上）：
# 交互式安装（会让你选装哪些子技能）
gh skill install K-Dense-AI/scientific-agent-skills
# 只安装某一个子技能
gh skill install K-Dense-AI/scientific-agent-skills scanpy
优点：自动安装到正确目录、记录来源信息
安装到哪了？
| 你用的工具 | Skill 存放在哪 |
|---|---|
| Claude Code | ~/.claude/skills/ |
| Codex CLI | ~/.codex/skills/ |
| Cursor | ~/.cursor/skills/ |
| OpenCode | ~/.config/opencode/skills/ |
怎么查看这个文件夹？
- Mac：打开 Finder，按
Cmd+Shift+G，输入~/.claude/skills/- Windows：打开文件管理器，地址栏输入
%USERPROFILE%.claude\skills\- 注意
.claude是隐藏文件夹，可能需要先设置"显示隐藏文件"
验证安装成功
安装后必须重启 Claude Code。不是关终端——在 Claude Code 里输入/exit，然后重新启动。
重启后验证：
- 输入
/，查看可用 Skill 列表——新装的 Skill 应该出现在里面 - 或者直接说一句会触发该 Skill 的话——比如装了女娲 Skill 后说"蒸馏一个保罗·格雷厄姆"，如果 AI 开始执行蒸馏流程，说明安装成功
常见问题
技能没出现在列表里
打开 Skill 文件夹，确认里面有SKILL.md文件。有些项目下载后 Skill 不在根目录——需要把包含SKILL.md的子文件夹移到~/.claude/skills/下。
安装后 AI 没触发 Skill
检查SKILL.md文件开头几行的description是否准确描述了触发场景。AI 是根据这段文字判断该不该加载的。
多个 Skill 冲突
卸载不需要的：
rm -rf ~/.claude/skills/不需要的Skill名字
rm -rf是什么意思？删除文件夹及里面所有内容。用之前确认名字没错，删了就没了。
怎么更新 Skill
cd ~/.claude/skills/Skill名字
git pull插件市场安装的，在 Claude Code 里运行/plugin upgrade。
终端提示 "permission denied"
有些命令需要加sudo（管理员权限）：
sudo git clone https://github.com/xxx ~/.claude/skills/xxx输入后会要求输入你的电脑密码（输入时屏幕不会显示字符，这是正常的，输完按回车）。
找更多 Skill
- HaluTool— 按场景分类的中文 Skill 目录，适合国内用户
- Awesome Claude Skills— 1000+ Skills 英文索引
- Awesome Agent Skills— 1400+ Skills 英文索引
- Anthropic 官方— 官方示例 Skill
浏览更多 Skill 推荐：halutool.com/skills