🐒 大家好,我是阿衡,一年经验用了十次的游戏后端开发,辞职后成为自由职业、独立游戏开发者。
非专业 AI 玩家,日常关注 AI 编程方向的内容。
🎯 这是 Claude Code Skills 系列的第一篇,主要介绍:什么是 Skill?如何创建 Skill。
你有没有想过,可以自己"教" AI 一项新技能?
不是调参数,不是写代码训练模型,就是简单地告诉它:"以后遇到这种情况,你就这么做。"
这篇文章教你两种方法:一种 5 分钟手写速成,另一种用官方工具更专业。学完之后,你就能让 Claude Code 按你的规则干活了。
什么是 Skills?
说白了,Skills 就是给 AI 配的一本"专属攻略手册"。
你可能遇到过这种情况:每次让 Claude Code 帮你写代码,都要重复说一遍"用 TypeScript"、"加上类型注释"、"遵循这个目录结构"……
烦不烦?
有了 Skills,这些话只用说一次。你把规则写在一个文件里,Claude Code 以后就自动按这个来。
从技术上说,一个 Skill 就是一个文件夹,里面放着指令和资源[^1]。Claude Code 会按需加载这些文件,用完就释放,所以即使你装了几十个 Skills,也不会拖慢速度。
官方的说法是:每个 Skill 启动时只占用 30-50 个 tokens[^2]。
方法一:5 分钟手写你的第一个 Skill
来,做一个"每日总结"Skill——你说一句"帮我总结今天的工作",它就自动生成格式化的日报。
Step 1: 创建文件夹
在你的项目根目录下,创建这样一个结构:
.claude/
└── skills/
└── daily-summary/
└── SKILL.md
对,就这么简单。一个文件夹,一个 Markdown 文件。
Step 2: 写 SKILL.md
打开 SKILL.md,写入以下内容:
---
name: daily-summary
description: 当用户要求总结今天的工作、生成日报、回顾进展时使用。自动整理 git commits 和完成的任务,生成格式化的工作总结。
---
# 每日工作总结
## 触发条件
- 用户说"总结今天的工作"
- 用户说"生成日报"
- 用户说"今天做了什么"
## 执行步骤
1. 读取今天的 git commits(如果有)
2. 整理完成的任务
3. 按以下格式输出:
## 输出格式
### 📅 [日期] 工作总结
**完成事项**
- [ ] 事项1
- [ ] 事项2
**明日计划**
- [ ] 计划1
**备注**
(可选)
注意两个关键点:
- YAML 头部:name 和 description 是必须的。description 特别重要,它告诉 Claude 什么时候该用这个 Skill[^3]。
- 正文指令:用 Markdown 写你想让 AI 做什么。越清晰越好,但不用太啰嗦——官方说了,"Claude is already very smart"[^4]。
Step 3: 测试效果
保存文件后,在 Claude Code 里说一句:"帮我总结今天的工作"。
如果一切正常,你会看到它按照你定义的格式,自动生成日报了。
有时候如果自动判定没命中,也可以使用 /daily-summary 手动触发。
小贴士:从 v2.1.1 开始,Claude Code 支持热重载[^5]。也就是说,你改了 SKILL.md 之后,不用重启,马上就能生效。
方法二:用官方 Skill Creator
手写很快,但有个问题:如果你的 Skill 比较复杂,需要脚本、资源文件、甚至要分享给团队呢?
这时候,官方的 Skill Creator 就派上用场了。
简单场景用手写,复杂场景或者要分享的,用 skill-creator。
Skill Creator 安装与使用
安装 Skill Creator
Skill Creator 在 Anthropic 官方仓库 github.com/anthropics/… 中 安装很简单:
在 Claude Code 中输入:
# 1:将该仓库注册为 Claude Code 插件市场
/plugin marketplace add anthropics/skills
# 2:安装特定 skill
# 包括很多文档处理类的 skill
/plugin install document-skills@anthropic-agent-skills
# 这里就包括了我们说的 skill-creator
/plugin install example-skills@anthropic-agent-skills
安装完成后,你就可以在 Claude Code 里说"帮我创建一个每日工作总结 Skill",它会自动调用 Skill Creator 来引导你。
官方 Skills 速览
顺便说一下,官方仓库里有 16 个示例 Skills[^6],涵盖各种场景:
类别
Skills
文档处理
docx, pdf, pptx, xlsx
设计创作
algorithmic-art, canvas-design, frontend-design
开发工具
mcp-builder, webapp-testing
协作沟通
doc-coauthoring, internal-comms
这些不展开讲了,但强烈建议你去翻翻看——学习别人怎么写 Skill,比看文档有用多了。
用 Skill Creator 创建 Skill
现在用 Skill Creator 重新创建那个"每日总结"Skill。
在 Claude Code 里说:
"帮我创建一个新的 Skill,用于生成每日工作总结"
当然最稳妥的方式还是手动触发(我比较喜欢这种确定性):
Skill Creator 会引导你完成以下步骤[^7]:
- 理解需求:它会问你几个问题,确认 Skill 的用途
- 规划结构:自动决定需要哪些文件
- 初始化:创建文件夹和基础文件
- 编辑:你可以进一步调整内容
- 打包:生成可分享的 Skill 包
- 迭代:根据使用反馈持续优化
生成的结构可能是这样:
daily-summary/
├── SKILL.md # 核心指令
├── scripts/
│ └── get_commits.py # 获取 git commits 的脚本
└── references/
└── format.md # 输出格式参考
比手写的版本更完整、更规范。而且因为遵循官方标准,以后分享给团队或者发布到社区市场都很方便。
进阶提示
再分享几个技巧:
热重载:改完 SKILL.md 立即生效,不用重启 Claude Code。这个特性从 v2.1.1 开始支持[^5]。
社区市场:已经有社区 Skills 市场了[^8]。别人创建的好 Skill 可以直接用,不用自己造轮子。
迭代优化:Skill 不是一次性的。用着用着觉得不满意,随时改。AI 会越来越懂你的需求。
写在最后
两种方法,各有优劣:
- 手写:5 分钟速成,适合简单场景,帮你理解原理
- Skill Creator:更规范更完整,适合复杂场景和团队分享
Anthropic 的人说过一句话,我觉得很有道理[^9]:
"Skills > Agents"
比起一次性的 Agent,持续积累的 Skills 更有价值。
你构建的 Skills 越多,Claude Code 就越懂你、越有用。
所以,别光看,去动手试试吧。
创建属于你的第一个 Skill,就从今天开始。
参考资料
[1]: Anthropic. "Skills Repository." - Skills 是包含指令和代码的文件夹
[2]: Teng Yan (@tengyanAI). "Skills 技术本质." - 每个 Skill 约 30-50 tokens
[3]: Anthropic. "skill-creator SKILL.md." - description 是主要触发机制
[4]: Anthropic. "skill-creator." - "Claude is already very smart"
[5]: Eric Wang (@ericwang42). "v2.1.1 更新." - 热重载 Skills 支持
[6]: Anthropic. "Skills Repository." - 16 个官方示例 Skills
[7]: Anthropic. "skill-creator." - 6 步创建流程
[8]: Teng Yan (@tengyanAI). "Skills 市场." - 社区市场已上线
[9]: elvis (@omarsar0). "Skills > Agents." - Anthropic 演讲核心观点
💬 你平时是怎么创建 Skill 的?欢迎在评论区分享你的方法!
👍 觉得有用的话,记得点赞收藏,让更多人看到这篇文章!
配图说明:本文配图(除截图外)由 Nano Banana Pro 生成
- #公众号:阿衡的AI日常
- #小红书:阿衡的AI日常
- #CSDN:DebugEve
- #掘金:阿衡Eve