什么是 Claude Code Skills？完整指南与示例
一句话：Claude Code Skill 就是一个 Markdown 指令文件，教 Claude Code 干某件具体的活。把 .md 文件放进
.claude/skills/（或.claude/commands/），用/skill-name斜杠命令调用，Claude 就获得新能力——不用写代码、不用接 API，60 秒装好第一个。
Skill 是什么
一个 Skill = 一个任务说明书。比如一个代码审查 Skill 的全部内容：
# 示例：code-reviewer.md
审查当前 git diff 中的：
- 安全漏洞（OWASP Top 10）
- 性能退化
- 缺失的错误处理
- 破坏性 API 变更
输出带严重等级的结构化报告。
保存成 .md 放到正确目录，Claude Code 就会用它。
Skill / MCP / CLAUDE.md 三者区别
| Skills | MCP Server | CLAUDE.md | |
|---|---|---|---|
| 形式 | Markdown 文件 | 运行中的进程 | Markdown 文件 |
| 激活 | 斜杠命令按需触发 | 始终可用 | 每次会话始终加载 |
| 上手难度 | 低（写 markdown） | 高（要写代码） | 低（写 markdown） |
| 适用 | 某个任务的工作流 | 连接外部工具（数据库/浏览器等） | 项目级编码约定 |
三者互补，不是替代关系：约定写 CLAUDE.md，工作流做成 Skill，外部工具用 MCP。
怎么安装
方法 1：直接放文件（最快）
# 项目级（随项目走，适合团队共享）
mkdir -p .claude/skills
cp code-reviewer.md .claude/skills/
# 全局级（个人通用，跨项目）
mkdir -p ~/.claude/skills
cp code-reviewer.md ~/.claude/skills/
同名时项目级优先于全局级。推荐：项目专属 Skill 放项目级，通用工具 Skill 放全局级。
方法 2：从 TokRepo 一键安装
tokrepo install <uuid>
去哪找 Skill：TokRepo（500+ 社区 Skill，按场景分类）、Anthropic 官方 GitHub skills 仓库、Vercel Skills（13,000+，偏 Next.js 生态）。
2026 年十大热门 Skill
- Code Reviewer — 对抗式代码审查
- GSD Workflow — 计划、执行、验证开发任务
- Frontend Design — 生成生产级 UI
- Commit Writer — 结构化提交信息
- Test Generator — 自动生成测试
- PR Creator — 创建结构良好的 PR
- Deploy Pipeline — 自动化构建部署
- Doc Writer — 从代码生成文档
- Prompt Architect — 优化提示词
- Refactoring Specialist — 安全重构
自己写一个（3 步）
touch .claude/skills/my-skill.md
# 我的自定义技能
## 何时使用
当用户要求 [触发条件] 时激活。
## 指令
1. 先读取相关文件……
2. 再分析代码中的……
3. 最后输出报告……
## 约束
- 未经确认不修改文件
- 先解释推理再动手
测试：在 Claude Code 会话里输入 /my-skill。
调用方式：显式斜杠命令 /skill-name 最稳定；也可以自然语言描述任务让 Claude 自动匹配。
跨平台兼容
Skill 本质是 Markdown，其他工具也能读：
| 工具 | 位置 | 文件 |
|---|---|---|
| Claude Code | .claude/skills/*.md |
SKILL.md |
| Codex CLI | 项目根 AGENTS.md | AGENTS.md |
| Gemini CLI | 项目根 GEMINI.md | GEMINI.md |
| Cursor | 项目根 | .cursorrules |
内容基本不用改，换个文件名和路径就行。
常见问题
Skill 装多了会变慢吗？
没有硬性限制。Skill 只在被调用时才加载进上下文，平时不占 Token。但建议只留常用的 5–10 个，太多会忘记有哪些可用。
要会编程吗？
不用。会写清楚的 Markdown 就行：YAML frontmatter（name、description、triggers）+ 任务步骤 + 输出格式。