Skills 的本质
从根本上讲，Skill 究竟是什么？其架构非常清晰：一个文件夹 + 一个入口文件。
这个入口文件被命名为 SKILL.md，它利用 YAML frontmatter（包含 name 和 description 字段）来进行路由，而真正的指令内容则写在 Markdown 正文之中。Claude Code 启动时仅会扫描元数据——每个 Skill 大约消耗 50 个 token——只有当任务匹配时，才会加载完整的指令内容。这种机制的专业术语是"渐进式披露"，通俗地说就是：先判断是否必要，必要再深入查看。
Skill 有三个存放位置，这决定了"谁能使用它们"：
# ① 个人级 —— 所有项目通用（最常用）
~/.claude/skills/my-skill/SKILL.md
# ② 项目级 —— 仅对当前仓库生效，可随 Git 提交实现团队共享
.claude/skills/my-skill/SKILL.md
# ③ Plugin 级 —— 随插件安装，命名空间隔离，不会与手动放置的冲突
优先级规则清晰明确：Enterprise > Personal > Project。当名称相同时，高优先级会覆盖低优先级。
方法一：从 GitHub / 社区直接拉取，手动放到 .claude/skills/ 目录
这是最为直接的方式。它适合什么场景？就是当你已经在某个开源仓库中看中了一个具体的 Skill，或者别人提供给你一个链接说"我就要这个"，那么这条路径是最快的。
1.1 在哪里寻找
- Anthropic 官方 Skills 仓库：
github.com/anthropics/skills - GitHub 全局搜索技巧：搜索
claude skill path:/.claude/或.claude/skills - 社区整理帖、awesome-claude-skills 类的汇总页面
1.2 操作步骤（Linux 系统 / WSL）
# Step 1: 确认目录存在
mkdir -p ~/.claude/skills
# Step 2: clone 你需要的仓库（示例）
git clone https://github.com/anthropics/skills.git /tmp/anthropic-skills
# Step 3: 将目标 skill 文件夹复制进去
cp -r /tmp/anthropic-skills/skills/某个skill名 ~/.claude/skills/
# 最终结构应为：
# ~/.claude/skills/某个skill名/SKILL.md
请注意！SKILL.md 必须放置在 skillName 文件夹内部，否则系统将无法识别。
Windows 用户的操作更简单：找到所需的 Skills，下载文件，直接复制到可用的 skills 目录即可。
1.3 验证是否生效
# 重启 Claude Code 会话，然后在对话中：
/skills list
# 查看是否列出
# 或直接使用自然语言触发，看 description 是否匹配
方法二：使用 skills.sh 生态 —— 搜索 → 选择 → 一条命令安装
这种方法适合你不确定具体需要哪个文件，想要逛逛商店、查看排行榜、按分类筛选。安装完成后还能方便地更新升级。
2.1 skills.sh 是什么
skills.sh 是 Vercel 推动的一个开放 Agent Skills 目录和生态入口。其核心思路是将 Skill 做得像 npm 包一样——"可发现、可安装、可更新"，标准化程度更高。
- 平台地址：skills.sh/
- 覆盖的分类：编程开发 / 效率自动化 / 内容创作 / 运维工程 等等
2.2 前置准备
# 需要 Node.js ≥ 16
node -v
# 安装 Skills CLI
npx skills --version
# 或全局安装
npm install -g skills-cli
2.3 操作步骤（Linux / WSL）
# 浏览 / 搜索
npx skills search react
npx skills search "code review"
# 安装某个 skill（从 skills.sh 目录）
npx skills add
# 或从 git 地址直接安装
npx skills add https://github.com/xxx/some-skill
# 更新
npx skills update
# 查看已安装的
npx skills list
# 然后去对应目录检查
ls ~/.claude/skills/
Windows 版本：直接访问 skills.sh 官网选择你需要的 Skill，将安装命令发送给 Claude 即可。
2.4 热榜淘金技巧
- 优先查看 All Time 或 24h Trending 榜单，挑选安装量高的——这代表经过了更多人的验证
- 点击某个 Skill 页面，关注两点：适配工具列表中是否有 Claude Code，以及最近是否有持续维护
- description 写得越具体（最好附带触发词列表），安装后越容易自动命中
2.5 优缺点分析
| ✅ 优点 | ❌ 缺点 |
|---|---|
| 可发现性强，有排行榜 | 生态仍较新，个别条目可能已过时 |
| 一条命令搞定，支持更新 | 需要 Node 环境和 CLI 工具链 |
| 社区共建，覆盖面广 | 质量参差不齐，选择时需要筛选 |
方法三：通过 Claude Code 官方 Plugin / Marketplace 安装（最规范）
3.1 核心概念区分
有必要先理清一点：Skills ≠ Plugins。但在官方路径中，Plugin 是分发载体。官方将一些 Skills 打包成 Plugin，通过 marketplace 分发，安装后它们最终也会落到 Claude Code 能识别的 skills 路径中。
3.2 操作：交互式安装（最友好）
在 Claude Code 交互界面中操作：
/plugin
→ 选择 "Browse and install plugins"
→ 选择市场（anthropics/claude-plugins-official 默认已存在）
→ 挑选你需要的（如 document-skills / frontend-design 等）
→ Install
安装成功后即可使用。
3.3 操作：命令行安装
# 确保官方市场源已添加
/plugin marketplace list
# 如果没有，补充添加
/plugin marketplace add anthropics/claude-plugins-official
# 刷新
/plugin marketplace update claude-plugins-official
# 安装示例：document-skills（Excel/Word/PPT/PDF）
/plugin install document-skills@claude-plugins-official
# 查看已安装的
/plugin list
3.4 优缺点分析
| ✅ 优点 | ❌ 缺点 |
|---|---|
| 官方背书，相对最稳定 | 选择面目前没有社区商店宽 |
| 版本管理和更新正规 | 有些高级场景官方包覆盖不到 |
| 权限和审计链条更清晰 | 需要 Claude Code 登录账号 |
总结与建议
| 方法一：手动放入 .claude/skills/ | 方法二：skills.sh CLI 安装 | 方法三：官方 Plugin Marketplace | |
|---|---|---|---|
| 最适用场景 | "我就需要这一个 Skill，链接已拿到" | "我想逛商店、发现新工具、追热榜" | "我需要官方维护、稳定、可管理的方案" |
| 上手速度 | ⚡ 最快 | 快（需 Node 环境） | 中等（需走插件流程） |
| 可维护性 | 手动更新 | npx skills update |
/plugin update |
| 安全信任链 | 需要自行审查来源 | 查看榜单 + star 数，但仍属社区 | ✅ 官方 |
| 团队协作 | 提交到项目 .claude/skills/ 即可共享 | 编写 skills.lock / 安装脚本 | 企业版可组织级下发 |
说了这么多，其实 Skills 的核心不在于"安装了多少个"，而在于你工作中哪些重复性任务，值得被固化成可复用的知识包。不妨从自己真实的工作流程中挑选一个痛点——周报模板也好、PR 描述格式也罢、API 规范检查也行——先用方法一手动创建一个最简单的 SKILL.md 文件，跑通流程。之后再考虑使用方法二或方法三扩展技能库。这样学习，比一口气安装十个榜单上的 Skills 要有效得多。
