你可能踩过这些坑
每次让它查线上数据库、按固定格式生成周报,你都得把同样的背景、同样的步骤重新讲一遍,讲到第五次就开始怀疑人生。
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 的人
对话式引导你创建 Skill
像陪练一样一步步问你要固化什么工作流、输入输出是什么,边聊边生成合规的 SKILL.md 骨架
1100+ 人在用
手把手走完创建全流程
从目录结构、frontmatter 到正文组织,按官方规范逐步演示,第一次创建照着走就不会错
863 人在用
规范编写
写得规范,Agent 才会正确触发
适合写完总不触发的创作者
官方级编写规范手册
十万级安装量的编写规范参照:命名、描述、渐进式披露、结构组织,写之前过一遍能少踩 90% 的坑
141877+ 人在用
写出真正会被触发的描述
聚焦 description 字段怎么写——它决定 Agent 何时加载你的 Skill,给出好例子和坏例子对照
2529+ 人在用
调试测试
装上没反应?一步步排查定位
适合被「不触发」折磨过的人
自动化测试你的 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 发布到社区市场,让更多人搜索并一键安装。