什么是 Claude Code Skills？完整指南与示例

了解 Claude Code Skills 是什么、底层如何工作，以及如何在 60 秒内安装你的第一个技能。本指南涵盖 SKILL.md 标准、技能目录、安装方法，以及在哪里找到 500+ 社区技能。

前置条件

已安装 Claude Code（CLI、VS Code 扩展或桌面应用）
一个用于测试技能的项目目录
基本的终端/命令行知识

什么是 Claude Code Skill？

Claude Code Skill 是一个 markdown 指令文件，教 Claude Code 如何执行特定任务。通过 /skill-name 调用时，Claude 读取 markdown 文件并按指令执行 —— 无需编译代码、无需 API 集成，只是结构化的文本。

# 示例：code-reviewer.md
审查当前 git diff 中的：
- 安全漏洞（OWASP Top 10）
- 性能退化
- 缺失的错误处理
- 破坏性 API 变更

输出带严重等级的结构化报告。

就是这么简单。把它保存为 .md 文件放到正确目录，Claude Code 就获得了新能力。

Skills vs MCP 服务器 vs 规则

特性	Skills	MCP 服务器	规则（CLAUDE.md）
格式	Markdown 文件	运行中的进程	Markdown 文件
激活	斜杠命令	始终可用	始终激活
复杂度	低（写 markdown）	高（写代码）	低（写 markdown）
用例	特定任务工作流	外部工具访问	项目级别约定

如何安装 Skills

方法 1：放入文件（最快）

# 项目级别技能
mkdir -p .claude/skills
curl -o .claude/skills/code-reviewer.md https://example.com/skill.md

# 全局技能
mkdir -p ~/.claude/skills
cp code-reviewer.md ~/.claude/skills/

方法 2：从 TokRepo 一键安装

TokRepo 上每个技能都提供复制粘贴安装命令。

2026 年十大最受欢迎的 Skills

Code Reviewer — 对抗式代码审查
GSD Workflow — 计划、执行、验证开发任务
Frontend Design — 生成生产级 UI
Commit Writer — 结构化提交信息
Test Generator — 自动生成测试
PR Creator — 创建结构良好的 PR
Deploy Pipeline — 自动化构建部署
Doc Writer — 从代码生成文档
Prompt Architect — 优化提示词
Refactoring Specialist — 安全重构

完整集合：TokRepo 上 500+ Agent Skills

如何创建自己的 Skill

步骤 1：创建文件

touch .claude/skills/my-skill.md

步骤 2：编写指令

# 我的自定义技能

## 何时使用
当用户要求 [描述触发条件] 时激活。

## 指令
1. 首先读取相关文件...
2. 然后分析代码中的...
3. 最后输出报告...

## 约束
- 未经确认不修改文件
- 始终先解释推理再做更改

步骤 3：测试

claude
/my-skill

跨平台兼容性

SKILL.md 格式可跨多个 AI 编码工具使用：

工具	技能位置	格式
Claude Code	`.claude/skills/*.md`	SKILL.md
Codex CLI	`AGENTS.md`	类似 markdown
Gemini CLI	`GEMINI.md`	类似 markdown
Cursor	`.cursorrules`	文本规则

FAQ

Q: 什么是 Claude Code Skills？ A: Markdown 指令文件，教 Claude Code 执行特定任务。通过斜杠命令调用，无需编程 —— 只需描述 Claude 应该做什么的结构化文本。

Q: Claude Code Skills 免费吗？ A: 是的。TokRepo 托管 500+ 免费社区技能，一条命令安装。

Q: 可以安装多少个 Skills？ A: 没有硬性限制。但每个技能会占用上下文窗口，所以保持活跃技能专注于你需要的。