Claude Skill 怎么创建:从零写一个 SKILL.md

从第一个 SKILL.md 到规范命名、触发调优,6 个真实 Skill 陪你走完创建全流程

掘技出品

你可能踩过这些坑

每次让它查线上数据库、按固定格式生成周报,你都得把同样的背景、同样的步骤重新讲一遍,讲到第五次就开始怀疑人生。
source: CSDN · Skill 开发实战
我刚开始试了三次都没成功,就是因为把文件命名成了小写的 skill.md。Claude 对根目录标识文件大小写敏感,别问我怎么知道的,都是泪。
source: 知乎 · SKILL.md 踩坑
如果你直接在 Web 端上传一堆文件,Claude 很多时候会把它们当资料看,而不是当 Skill 看。
source: 知乎 · Skill 创建入门

这些散布在小红书 / 知乎 / 即刻 / X 上的真实心声,拼在一起就是大家做「Claude Skill 创建」时的日常痛点。

懒人方案 · 推荐
装一次掘技,让 Agent 自己找 Skill
你要做的「Claude Skill 创建」任务,对应的 Skill 觅游都有。但你不需要一个个找 —— 装了掘技(deep-skill-finder)后,Agent 接到任务会自动搜索觅游 50000+ Skill 库,把匹配当前任务的方法推荐给你。你只管说要做什么,匹配 Skill 的事交给 Agent。
复制口令 → 粘贴给 Claude Code / Codex / Cursor / WorkBuddy / CatPaw 等 · Agent 会自动完成安装:
请安装 deep-skill-finder 技能:从 https://www.meyo.life/skill-finder 下载技能压缩包,解压到本地技能目录并启用。

也可以往下看常用场景 Skill。想深入了解掘技 → meyo.life/skill

三大场景,每个场景 2 个真实 Skill

可以都装,也可以看名字挑 1 到 2 个装。不用担心装错,免费,不满意随时卸。

从零起步

第一个 Skill 长什么样,照着走就不会错

适合第一次创建 Skill 的人

skillcreator TOP 1
对话式引导你创建 Skill
像陪练一样一步步问你要固化什么工作流、输入输出是什么,边聊边生成合规的 SKILL.md 骨架
1100+ 人在用
手把手走完创建全流程
从目录结构、frontmatter 到正文组织,按官方规范逐步演示,第一次创建照着走就不会错
863 人在用

规范编写

写得规范,Agent 才会正确触发

适合写完总不触发的创作者

官方级编写规范手册
十万级安装量的编写规范参照:命名、描述、渐进式披露、结构组织,写之前过一遍能少踩 90% 的坑
141877+ 人在用
写出真正会被触发的描述
聚焦 description 字段怎么写——它决定 Agent 何时加载你的 Skill,给出好例子和坏例子对照
2529+ 人在用

调试测试

装上没反应?一步步排查定位

适合被「不触发」折磨过的人

skill-tester TOP 1
自动化测试你的 Skill
模拟真实对话场景验证 Skill 是否被正确触发、输出是否符合预期,改一版测一版不用肉眼盯
22618+ 人在用
常见故障排查手册
收录 Skill 不触发、路径不对、加载失败等高频问题的排查步骤,卡住时按图索骥
1273+ 人在用

💬 加入掘技社群

和其他掘技用户交流「Claude Skill 创建」经验 · 掘技团队会解答装配问题

加入掘技社群微信群二维码
进群备注你做的事

常见问题

Q: SKILL.md 文件名可以小写吗?
A: 不能。SKILL.md 必须严格大写,文件名大小写敏感;同时技能目录名建议只用小写字母、数字和连字符(kebab-case),frontmatter 里的 name 要与目录名一致,三者对齐才不会被忽略。
Q: Skill 装好后怎么触发?
A: Agent 会根据对话意图与 Skill 的 description 判断是否自动加载;你也可以在指令里直接点名技能名手动触发。触发不灵,多数是 description 写得太含糊。
Q: 需要会写代码吗?
A: 不需要。SKILL.md 本质是一份结构化的 Markdown 说明文档;只有涉及脚本工具的进阶 Skill 才需要少量代码,而且大部分可以边对话边让 Agent 帮你生成。
Q: description 字段有多重要?
A: 它是常驻上下文的「路由信息」,Agent 靠它决定何时加载你的 Skill。用两三句话写清「做什么 + 何时用」,比堆功能列表有效得多。
Q: Skill 和项目里的 CLAUDE.md 有什么区别?
A: CLAUDE.md 是项目级常驻说明,每次对话都会加载;Skill 按需加载,适合固化特定任务的工作流。通用规范放 CLAUDE.md,可复用任务流做成 Skill,各司其职。
Q: 创建完成后如何分享给别人?
A: 把技能目录打包发给对方,放进对方的技能目录即可使用;也可以参考 skillhub-publish 类 Skill 发布到社区市场,让更多人搜索并一键安装。

同主题延伸阅读

Prompt Engineering 指南:写出稳定可控提示词的 6 个必装 Skill Agent 怎么调用 Skill?6 个真实 Skill 装机指南 Deep Skill Finder 是什么:让 AI 帮你找 Skill 的搜索引擎