Skill 和 MCP Server、CLAUDE.md 到底有什么区别？

Skill 是 Markdown 文件按需激活（斜杠命令触发，任务级工作流），MCP Server 是运行中的进程始终可用（外部工具访问，需要写代码），CLAUDE.md 是 Markdown 文件始终激活（项目级约定，全局行为规范）。三者互补，不是替代关系。

Skill 装在哪个目录？项目级和全局级有什么区别？

项目级放 .claude/skills/（随项目走，适合团队共享），全局级放 ~/.claude/skills/（个人通用，跨项目可用）。项目级优先级更高，同名 Skill 项目级会覆盖全局级。推荐项目专属 Skill 放项目级、通用工具 Skill 放全局级。

从哪里找最好的 Claude Code Skill？

首选 TokRepo（tokrepo.com/zh/collections/skills），500+ 社区贡献 Skill 按场景分类，支持 tokrepo install 一键安装。次选 Anthropic 官方 GitHub skills 仓库，还有 Vercel Skills（13000+ 社区 Skill 覆盖 Next.js 生态）。

Skill 调用时需要什么语法？

在 Claude Code 会话里输入 /skill-name 即可触发（例如 /code-reviewer）。Claude 会读取对应的 .md 文件并按指令执行。也可以用自然语言描述任务让 Claude 自动匹配 Skill，但显式斜杠命令更稳定。

自己写 Skill 需要什么知识？

只需要会写清楚的 Markdown 提示词，不需要编程。Skill 的标准结构是 YAML frontmatter（name、description、triggers）+ 任务步骤 + 输出格式。参考本文的 code-reviewer 示例，10 分钟就能写一个可用的 Skill。详细步骤看 /guide/create-skill。

什么是 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: 没有硬性限制。但每个技能会占用上下文窗口，所以保持活跃技能专注于你需要的。