Claude Skills完全指南：写一次规则永久生效，让AI从通才变专才

引言：重复指令的痛点

你有没有遇到过这种情况——每次让Claude帮你做PPT，都得从头交代一遍用哪个颜色、哪个字体、Logo放在哪一边、标题要多大。做一次还行，做十次就要疯掉了。

如果你可以把这些规则写一次，Claude以后每次都自动按照你的标准来做，不用提醒、不用复制粘贴，甚至你不说它也知道该怎么做——这个东西就叫 Claude Skills（技能）。

本文基于B站UP主诺娅的AI编程实战系列第八期内容，系统梳理Claude Skills的核心概念、创建方法和实战案例，帮助你真正理解并用好这个被严重低估的功能。

什么是Claude Skills？

一个通俗的比喻

Skill本质上就是一个文件夹，里面装着一份说明书，告诉Claude在特定场景下应该怎么做事。这就像你给公司新来的实习生写了一份SOP（标准操作流程），实习生拿到SOP后就知道周报用什么模板、做PPT用什么颜色、写邮件用什么口吻。

Skill就是写给Claude的SOP。

Skill与Prompt、MCP有什么区别？

用一个厨师的比喻来理清三者关系：

• Prompt（提示词）= 每次点菜说的话："我想要一份宫保鸡丁，少油少盐多放花生"。说得清楚厨师就能做好，但每次来都得重新说一遍。
• Skill（技能）= 菜谱：厨师拿到菜谱就知道标准做法、用料、火候、摆盘。你只需要说"来一份宫保鸡丁"，写一次菜谱就能用无数次。
• MCP = 厨房设备的接口标准：怎么用烤箱、冰箱、搅拌机，对应外部工具和数据源。

三者的关系总结：Prompt是临时命令，Skill是可复用的领域知识，MCP是工具连接能力。 Skill和MCP经常配合使用——MCP提供连接，Skill提供工作流。

渐进式披露：Skill的核心设计思想

Claude不会一次性把Skill里的所有内容全部读出来，而是分层加载：

1. 第一层：看名字和描述 —— 启动时Claude只读取Name和Description，判断Skill跟当前任务有没有关系
2. 第二层：读说明书正文 —— 判断相关后，打开skill.md读取具体指令
3. 第三层：按需加载资源 —— 如果指令里提到详细的API文档在reference目录里，Claude在需要时才去读

这个设计解决了上下文窗口有限的根本问题。Skill可以携带大量参考资料、模板和脚本，但只有在需要时才消耗上下文空间。

Skill的文件结构详解

最简结构

一个Skill本质上就是一个文件夹。最简单的情况下只有一个文件——skill.md。如果需要更复杂的内容，可以包含脚本、参考文档和模板资源。

核心原则：skill.md是唯一必须的文件。

skill.md的组成部分

skill.md分为两部分：头部的YAML Front Matter和下面的Markdown正文。

必填字段：

• name：技能名称，最多64字符，只能用小写字母、数字和连字符。在Claude Code里会变成斜杠命令（如/code-review）
• description：技能描述，最多200字符。这是最关键的字段，Claude靠它判断什么时候该调用Skill

可选字段：

• disable_model_invocation: true —— 禁止自动调用，必须手动触发
• user_invokable: false —— 只允许自动调用，用户不能手动触发
• allowed_tools —— 限制可调用的工具集
• model —— 指定模型

官方有一个实用建议：Description要写得稍微激进一点。不要只写"生成数据看板"，而要写"生成数据看板——当用户提到仪表盘、数据可视化、内部指标或者想展示任何数据的时候都应该使用这个技能"。因为目前模型有少触发的倾向，描述里要主动列出可能的触发场景。

三个实战案例

案例一：中文博客生成器

解决的问题： 每次写博客都要交代格式、风格和结构

输入： 主题、技术要点、代码片段

输出： 完整的Markdown格式技术博客

Skill内容包含：概述、写作规范、文章结构、写作风格、代码规范、输出要求、质量检查清单。

导入方式：在Claude网页端左侧导航栏找到Customize → Skills → 点击加号 → Upload a Skill → 拖拽ZIP包。

测试时输入"帮我写一篇技术博客，主题是Claude Skills"，如果Skill被正确触发，可以在Claude的思考过程中看到它加载了自定义Skill，生成的博客格式规范、风格一致。

案例二：Git Commit Message规范化

核心亮点： 这里设置了disable_model_invocation: true，因为Git Commit是有副作用的操作，会真的修改代码仓库，不希望Claude自动执行。

这个Skill不只是文本格式化，而是真正嵌入开发工作流：读取Git Diff → 分析变更内容 → 判断类型 → 生成规范的Commit Message → 甚至提醒拆分过大的提交。

这就是Skill相比普通提示词的优势——它能编排多步骤的工作流，而不只是单次回答。

案例三：发票生成器（带Python脚本）

使用场景： 给一个Excel时间表，自动解析数据，按品牌模板生成Word/PDF发票。

目录结构：

• skill.md —— 编排者
• scripts/ —— Python脚本，负责精确计算
• reference/ —— 详细规则文档和品牌配置

这体现了Skill的设计哲学：skill.md是编排者，脚本是执行者，参考文档是知识库。 Claude按照skill.md的指令编排工作流，遇到需要精确计算的部分调用脚本，遇到需要详细规则的部分读参考文档，各司其职。

Skill的最佳实践

编写技巧

Skill做得好不好，80%取决于Description写得好不好。

1. 使用第三人称：Description会注入系统提示词，写"当我需要..."会让Claude困惑。正确写法是"处理Excel文件并生成报告"
2. 同时写明做什么和什么时候用：不要只写"生成日报"，要写"从Git活动中生成每日站会总结，当用户提到站会、日报、standup、每日总结等关键词时使用"
3. 覆盖边缘触发词：用户不一定用预期措辞。数据可视化相关的Skill，要把图表、报表、Dashboard、看板、数据大屏等同义词都写进Description
4. 用端到端测试验证触发率：写20条测试查询，一半应该触发、一半不应该触发，测试准确率后针对性优化

四种常见设计模式

模式	适用场景	示例
流程编排型	多步骤标准流程	代码审查、部署检查清单
知识注入型	Claude不知道的领域知识	公司编码规范、品牌指南
MCP增强型	工具+最佳实践	GitHub+Sentry代码审查
输出标准化型	严格格式要求	Changelog、API文档、测试报告

常见避坑指南

• skill.md不要超过500行：太长影响理解效率，详细内容拆到reference目录
• 不要硬编码敏感信息：API Key、密码、Token绝对不要放进去，用环境变量或MCP处理
• 渐进式测试：不要一口气写完巨大的Skill再测试，先写核心指令，测试通过再加细节
• ZIP包格式要对：正确结构是ZIP里有一个文件夹，文件夹里有skill.md
• Skill之间可以组合：不需要做一个"超级Skill"，多个聚焦的小Skill会自动在同一任务中组合使用

生态现状与使用方式

Claude Skills的使用场景有三个入口：

1. Claude网页端/客户端：打包ZIP上传，自动识别和调用
2. Claude Code命令行：放在项目根目录.claude/skills或全局用户目录，用斜杠命令调用
3. API调用：通过Anthropic Messages API在代码中加载Skill

三种方式用的都是同一个Skill文件，实现真正的写一次，到处用。

目前生态已相当丰富：Anthropic官方预制Skill、GitHub开源技能仓库、社区项目AntiGravity Awesome Skills（收录超1200个Skill，2万+ Star）。最关键的是Skill遵循Agent Skill开放标准，同一文件可在Claude Code、Cursor、Windsurf等多个平台通用。

总结

如果今天你只能记住一句话：Skill让AI从通才变成专才，而编写Skill就是定义AI应该专在哪里。

Claude Skills的本质是给Claude写SOP，一次编写、无限复用。核心文件skill.md由YAML元数据和Markdown指令组成，设计哲学是渐进式披露——只在需要时加载详细内容，保持上下文高效利用。三个关键要素：写好Description决定触发率，控制文件大小决定执行效率，选对设计模式决定Skill的上限。