Claude Code 配置 Skills 的三种姿势：从手动拖放、skills.sh 一键安装到官方 Plugin

Skills 的本质

• 一个文件夹 + 入口文件 SKILL.md，里面用 YAML frontmatter（name + description）做路由，用 Markdown 正文写指令
• Claude Code 启动时只扫描 metadata（约 50 tokens/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 生态 ------ 搜索 → 选 → 一条命令安装

适合场景：你不确定具体要哪个文件，想逛商店、看排行榜、按分类筛，装完还能 update 一把升。

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 <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 交互界面里：

/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 的核心不是"装多少个"，而是你手上哪些重复任务值得被固化成可复用的知识包 。先从你自己真实 workflow 里找一个痛点（周报模板？PR 描述格式？API 规范检查？），用方法一手动塞一个最简单的 SKILL.md 进去，跑通了，再去方法二/三扩军------这样学，比一口气装十个榜单 Skill 有用得多。