Skills 的本质
- 一个文件夹 + 入口文件 SKILL.md，里面用 YAML frontmatter（name + description）做路由，用 Markdown 正文写指令
- Claude Code 启动时只扫描 metadata（约 50 tokens/Skill），任务匹配到了才把完整指令加载进来——这就是所谓的渐进式披露
三个存放位置（决定“谁能用到”）
|
1 2 3 4 5 6 7 |
# ① 个人级 —— 所有项目通用（最常用） ~/.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）
|
1 2 3 4 5 6 7 8 |
# 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 验证是否生效
|
1 2 3 |
# 重启 Claude Code 会话，然后在对话里： /skills list # 看看列出来没有 # 或直接用自然语言触发，看 description 匹配 |
方法二：用 skills.sh 生态 —— 搜索 → 选 → 一条命令安装
适合场景：你不确定具体要哪个文件，想逛商店、看排行榜、按分类筛，装完还能 update 一把升。
2.1 skills.sh 是什么
- skills.sh 是 Vercel 推动的开放 Agent Skills 目录/生态入口，本质是把 Skill 做成像 npm 包一样的“可发现、可安装、可更新”的标准件
- 平台地址：
- 覆盖的分类：编程开发 / 效率自动化 / 内容创作 / 运维工程 等
2.2 前置准备
|
1 2 3 4 5 6 |
# 需要 Node.js ≥ 16 node -v # 安装 Skills CLI（按你验证过的方式写，下面是一种常见写法） npx skills --version # 或全局 npm install -g skills-cli # 如果有这个包的话，按实际情况调整 |
2.3 实操步骤（Linux/WSL）
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
# 浏览 / 搜索 npx skills search react npx skills search "code review"
# 安装某个 skill（从 skills.sh 目录） npx skills add <skill-name> # 或从 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 交互界面里：
|
1 2 3 4 5 |
/plugin → 选 "Browse and install plugins" → 选市场（anthropics/claude-plugins-official 默认就在） → 挑你要的（如 document-skills / frontend-design 等） → Install |
安装成功
3.3 实操：命令行安装
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
# 确保官方市场源在 /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 的核心不是“装多少个”，而是你手上哪些重复任务值得被固化成可复用的知识包。先从你自己真实 workflow 里找一个痛点（周报模板？PR 描述格式？API 规范检查？），用方法一手动塞一个最简单的 SKILL.md 进去，跑通了，再去方法二/三扩军——这样学，比一口气装十个榜单 Skill 有用得多。
