Claude Code Skills：让AI更懂你的魔法配方

摘要：Skills 是 Claude Code 的核心扩展机制，让 AI 自动按你的方式工作；2025年12月已成为开放标准，被 OpenAI Codex 和 GitHub Copilot 采用；本文详解 Skills 概念、现成资源、跨平台生态和创建方法。

你有没有遇到过这种情况：

用 AI 写代码时，每次都要重复解释：项目用的是 React、要遵循团队代码规范、测试要用 Jest……明明上次说过，这次又得从头来。

但用 Claude Code 的老手们早就发现了一个秘密：只要配置好 Skills，Claude 就能自动记住这些偏好，甚至比你还懂项目。

今天这篇文章，带你彻底搞懂 Claude Code Skills——这个让 AI 编程效率翻倍的功能。

一、Skills 是什么：给 AI 的入职培训手册

想象你新招了一个实习生。

第一天，你得告诉他：我们的代码风格是这样的，提交信息要这么写，测试覆盖率要达到80%……

如果每来一个新人都要重复一遍，累不累？

聪明的做法是写一份入职手册。新人照着做就行。

Skills 就是 Claude 的入职手册。

Anthropic 官方的定义是：Skills 是包含指令、脚本和资源的文件夹，Claude 可以动态加载这些内容来更好地完成特定任务。

说人话就是：你把工作方法写成配置文件，Claude 就能自动按你的方式干活。

Skills 的三个核心特点

1. 模型自动调用

你不需要每次都说请按照我的代码规范来。Claude 会根据你的请求，自动判断需要加载哪个 Skill。

比如你说帮我处理这个 PDF，Claude 就会自动调用 PDF 处理 Skill。

2. 渐进式披露

这个词听起来高大上，其实很简单。

Claude 不会一开始就把所有 Skill 内容都加载到记忆里。那样太浪费资源了。

它的做法是：

• 启动时只看每个 Skill 的名字和简介（约100个 token）
• 发现需要某个 Skill 时，才加载完整内容
• 需要更多细节时，再读取 Skill 里的参考文档

就像你不会把整本员工手册背下来，而是需要时翻到对应章节。

3. 跨平台通用

同一个 Skill 配置文件，可以在 Claude.ai 网页版、Claude Code 命令行、Claude API 里通用。写一次，到处用。

Skills vs 其他扩展方式

Claude 有好几种扩展能力的方式，别搞混了：

简单记：Skills 是 Claude 自己会用的能力包，Slash Commands 是你主动触发的快捷键。

二、去哪找现成的 Skills

好消息是，你不用从零开始。已经有大量现成的 Skills 可以直接用。

2.1 内置 Skills：开箱即用

Claude Code 自带了几个实用的文档处理 Skill：

这些 Skill 已经预装好了。当你让 Claude 处理相关文件时，它会自动调用。

2.2 官方仓库：Anthropic 精选

Anthropic 在 GitHub 上维护了一个官方 Skills 仓库：

github.com/anthropics/skills

里面有从创意到技术到企业场景的各类示例：

• theme-factory：主题工厂
• mcp-builder：MCP 服务器生成器
• webapp-testing：Web 应用测试
• brand-guidelines：品牌规范助手
• skill-creator：帮你创建新 Skill 的 Skill

2.3 社区精选集合

社区贡献了大量实用 Skills：

travisvn/awesome-claude-skills

• 20多个经过验证的 Skills
• 包括 TDD 开发、系统调试、团队协作等
• 持续更新中

ComposioHQ/awesome-claude-skills

• 聚焦生产力工具
• git 操作、代码审查、测试修复等

alirezarezvani/claude-code-skill-factory

• Skill 生成工具包
• 帮你批量创建生产级 Skills

2.4 Skills 市场：25000+ 选择

SkillsMP.com 是一个 Skills 聚合市场，收录了超过25000个 Skills。

它从 GitHub 公开仓库自动抓取，只收录星标数达到一定标准的项目。你可以按类别浏览、搜索、一键安装。

2025年12月，Skills 规范成为开放标准后，这个市场同时支持 Claude Code、OpenAI Codex CLI 和 ChatGPT。

2.5 必装 Skills 推荐

如果你刚开始用，这里按场景分类推荐。

编程开发类

1. test-driven-development（⭐ 10.7k）

• 功能：强制执行 TDD 流程，先写测试、再写代码、最后重构
• 适合：想养成 TDD 习惯的开发者
• 来源：obra/superpowers

2. systematic-debugging（⭐ 10.7k）

• 功能：像高级工程师一样调试，从复现到根因分析到修复
• 适合：经常需要排查 bug 的场景

3. webapp-testing（⭐ 7.9k）

• 功能：用 Playwright 自动化测试 Web 应用，验证 UI、截图对比
• 适合：前端开发、需要回归测试的场景

4. git-pushing（⭐ 126）

• 功能：自动化 git 操作，规范 commit 信息格式
• 适合：团队协作开发

5. frontend-design（⭐ 23.9k）

• 功能：避免 AI 生成的"塑料感"界面，产出专业级前端设计
• 适合：用 React + Tailwind 构建 UI 的开发者
• 来源：Anthropic 官方

行政办公类

1. file-organizer（⭐ 7.9k）

• 功能：智能整理文件夹，识别重复、建议分类结构
• 适合：桌面文件混乱、需要定期整理的用户

2. invoice-organizer（⭐ 7.9k）

• 功能：自动整理发票和收据，提取信息、统一命名，方便报税
• 适合：财务人员、需要报销整理的场景

3. meeting-insights-analyzer（⭐ 7.9k）

• 功能：分析会议录音转写稿，提取发言比例、冲突点、行动项
• 适合：需要复盘会议效果的管理者

4. internal-comms（⭐ 7.9k）

• 功能：撰写内部通讯，包括周报、FAQ、项目状态更新
• 适合：需要定期汇报的职场人

5. content-research-writer（⭐ 7.9k）

• 功能：辅助内容写作，自动搜索资料、添加引用、优化开头
• 适合：内容创作者、需要写文章的场景

科研辅助类

科研场景是 Claude Skills 的强项。K-Dense 团队开发了一套完整的科研工具包，覆盖从文献检索到论文写作的全流程。

1. claude-scientific-skills（⭐ 2.2k，强烈推荐）

• 功能：125+ 科研技能的超级合集，覆盖生物信息学、药物发现、临床研究、数据分析等
• 包含：
  • 26+ 科学数据库接口（PubMed、ChEMBL、UniProt、ClinicalTrials.gov 等）
  • 54+ Python 科学计算包（RDKit、Scanpy、BioPython 等）
  • 文献综述、同行评审、科学写作等工具
• 适合：生物医药、化学、临床研究等领域的科研人员

2. claude-scientific-writer（⭐ 199）

• 功能：科研写作全流程工具，包含 19+ 写作技能
• 包含技能：
  • literature-review：系统性文献综述
  • citation-management：引用和 BibTeX 管理
  • peer-review：同行评审模拟
  • research-grants：基金申请书撰写（支持 NSF、NIH 格式）
  • latex-posters：学术海报生成
  • hypothesis-generation：科学假设生成
• 适合：需要撰写论文、基金申请、学术报告的研究者

3. csv-data-summarizer（⭐ 108）

• 功能：自动分析 CSV 数据，生成统计摘要和可视化图表
• 适合：需要快速探索数据集、生成分析报告的场景

4. claude-d3js-skill（⭐ 39）

• 功能：用 D3.js 生成交互式数据可视化图表
• 适合：需要制作精美数据可视化的研究者

5. tapestry（⭐ 122）

• 功能：将多篇相关文档互联成知识网络，自动生成摘要和关联
• 适合：做文献调研、构建知识库的场景

6. brainstorming（⭐ 10.7k）

• 功能：结构化头脑风暴，通过提问和替代方案探索，将粗略想法变成完整设计
• 适合：科研选题、实验设计、方案论证阶段
• 来源：obra/superpowers

三、跨平台调用：Skills 的开放生态

2025年12月，一个重要的事情发生了：

Anthropic 宣布将 Agent Skills 规范开源，作为开放标准发布。

这意味着什么：

同一个 SKILL.md 文件，不仅能在 Claude 里用，还能在其他工具里用。

3.1 OpenAI 采用了这个标准

OpenAI 的 Codex CLI 和 ChatGPT 已经支持 SKILL.md 格式。

你为 Claude 写的 Skill，理论上可以直接给 Codex 用。这在 AI 工具史上是头一次——不同厂商的 AI 助手，能共享同一套能力配置。

3.2 Cursor 中使用 Claude

Cursor 是很多开发者喜欢的 AI 代码编辑器。它可以和 Claude Code 配合使用。

方法一：在 Cursor 终端里运行 Claude Code

• 打开 Cursor 的集成终端
• 直接运行 claude 命令
• Claude Code 会自动连接到 IDE

方法二：使用 /ide 命令

• 在外部终端启动 Claude Code
• 输入 /ide 连接到正在运行的 Cursor

两者配合的优势：

很多开发者的做法是：用 Cursor 做日常编辑，遇到复杂任务切到 Claude Code。

3.3 和其他 AI 编程工具对比

Claude Code vs OpenAI Codex

一个关键区别：Claude Code 是本地优先的。你的代码不会传到 Anthropic 的服务器。对于涉密项目，这点很重要。

Claude Code vs Google Jules

Jules 是 Google 推出的 AI 编程助手，还在 Beta 阶段。

Jules 更适合批量派发任务然后等结果，Claude Code 更适合边做边聊的协作模式。

3.4 API 调用方式

如果你想在自己的应用里调用 Claude，有几种方式：

Python SDK：

import anthropic

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}]
)

云服务集成：

• Amazon Bedrock：AWS 用户可以直接调用
• Google Cloud Vertex AI：GCP 用户的选择
• OpenRouter：第三方统一网关，一个 API 调用多个模型

四、动手创建：你的第一个 Skill

看了这么多，是时候自己动手了。

创建一个 Skill，只需要三步。

4.1 第一步：创建文件夹和 SKILL.md

Skill 的本质就是一个文件夹，里面必须有一个 SKILL.md 文件。

存放位置有两种：

比如创建一个代码审查 Skill：

mkdir -p ~/.claude/skills/code-review

4.2 第二步：编写 SKILL.md

SKILL.md 的格式分两部分：头部的 YAML 元数据 + 正文的 Markdown 指令。

---
name: code-reviewing
description: 审查代码的安全性、性能和可读性。当用户要求代码审查、PR审查或代码质量评估时使用。
---

# 代码审查技能

## 审查清单

### 安全检查
- 没有硬编码的密钥或凭证
- 有输入验证
- 防止SQL注入
- 防止XSS攻击

### 质量检查
- 函数小而专注
- 命名清晰
- 有适当的错误处理
- 测试覆盖

### 性能检查
- 没有N+1查询
- 适当使用缓存
- 算法效率合理

## 输出格式

对发现的每个问题：
1. **位置**：文件名:行号
2. **严重程度**：严重/高/中/低
3. **问题描述**：具体说明
4. **修复建议**：如何改进

关键字段说明：

• name：技能名称，只能用小写字母、数字、连字符，最多64字符
• description：这是最重要的字段！Claude 靠它判断什么时候该用这个 Skill

description 的写法有讲究：

• 要说清楚做什么（WHAT）
• 要说清楚什么时候用（WHEN）
• 包含触发关键词

好的写法：

description: 审查代码的安全性、性能和可读性。当用户要求代码审查、PR审查或代码质量评估时使用。

差的写法：

description: 代码相关工具

4.3 第三步：可选的扩展文件

如果你的 Skill 比较复杂，可以加入更多文件：

code-review/
├── SKILL.md           # 主文件（必需）
├── SECURITY.md        # 安全检查详细清单
├── PERFORMANCE.md     # 性能优化指南
└── scripts/
    └── run-linters.sh # 辅助脚本

在 SKILL.md 里引用它们：

详细的安全检查清单见 `SECURITY.md`。
性能优化指南见 `PERFORMANCE.md`。

Claude 会按需加载这些文件，不会一开始就全部读入。

4.4 最佳实践清单

创建 Skill 时记住这几点：

命名： 使用动名词形式，如 code-reviewing、data-analyzing

内容精简： SKILL.md 控制在500行以内，超过就拆分到单独文件

路径规范： 文件路径用正斜杠 /，不要用反斜杠 \

重启生效： 修改 Skill 后需要重启 Claude Code 才能生效

增量测试： 改一点测一点，别一次性写完再调试

4.5 常见问题排查

Skill 没有自动触发？

• 检查 description 是否足够具体
• 确认触发词和用户请求匹配

YAML 格式报错？

• 检查开头和结尾是否都有 ---
• 用空格缩进，不要用 Tab
• 特殊字符要加引号

Skill 不工作？

• 确认文件放对了位置
• 重启 Claude Code
• 检查脚本是否有执行权限

五、结语

Skills 的本质很简单：把你的工作方法写成配置文件，让 AI 自动按你的方式干活。

2025年12月，这个格式成为了开放标准。你为 Claude 写的 Skill，也能给其他 AI 工具用。

工作流可以跨工具复用，团队知识可以打包分发。

现在，去创建你的第一个 Skill 吧。

参考来源：

• Agent Skills - Claude Code官方文档
• Skill authoring best practices - Claude Docs
• Equipping agents for the real world with Agent Skills - Anthropic Engineering
• anthropics/skills - GitHub官方仓库
• travisvn/awesome-claude-skills - 社区精选集
• SkillsMP.com - Agent Skills市场