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

搜 how to create a skill claude 搜出来一堆英文文档，讲范式讲得很全，但第一次动手的人只想要一个答案：建什么目录、写什么文件、写完放哪。其实最小可用的 Claude Skill 就是一个 SKILL.md，不到一百行就能跑起来。

掘技社区 · 新手提问

会写 prompt 不等于会写 skill。SKILL.md 的 description 字段决定 Agent 什么时候加载它，写得含糊技能就永远不触发；正文讲究渐进式披露，几百行全塞进去等于没写。这两个坑，每个从零写技能的人都踩过。

X · Agent 技能作者

把团队沉淀的 SOP 转成 Agent 技能，是今年最实际的 AI 落地方式之一：一次写成，所有装了它的 Agent 都按同一套规矩干活。难的不是写，是从零到「写完能稳定触发、格式不飘」。

掘技社区 · 团队效率实践者

懒人方案 · 推荐

装一次掘技，让 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 下载技能压缩包，解压到本地技能目录并启用。

进群备注你做的事

Q: 创建一个 Claude Skill 最少要几步？

A: 三步：建一个 kebab-case 命名的技能目录；在目录里写 SKILL.md(必填 name 和 description 的 frontmatter 加正文)；把目录放进 Agent 的 skills 路径。想稳一点就按 skill-creation-walkthrough 的六阶段工作流走：判断要不要建、定义触发、写 description、结构化正文、测试迭代。

Q: SKILL.md 的结构是什么？

A: 两部分：YAML frontmatter(name、description，description 决定何时触发，要写清「是什么+什么时候用」)和 Markdown 正文(按渐进式披露组织：核心流程放正文，细节拆到 references/，可执行动作写成 scripts/)。document-skills 会直接按这个结构现场生成文件，skills-best-practices 则按 Anthropic 官方规范讲透每个字段。

Q: description 怎么写才容易触发？

A: 写「是什么+什么时候用」两段式，把高频触发词写进去，别写成营销文案。反例：「强大的数据分析技能」；正例：「当用户要求分析 Excel/CSV 数据、产出结论报告时使用」。写完可用 skill-writing-guide 的三级信息分层和触发优化方法检查。

Q: 正文应该写多长？

A: 官方建议少于 500 行：核心流程放正文，参考资料拆到 references/ 一级深度，确定性动作写成脚本而不是长 prompt。skill-construction 按复杂度分级(Level 1 仅 SKILL.md，Level 3 加 4-8 个资源)帮你决定拆多细。

Q: 从零写没头绪，有没有教练带着写？

A: 有。skill-creator-optimized-pro 带新手引导模式(Phase 0-5 加六步问卷)，还配 validate/score/pack 三个脚本做质量校验；skillcreator 则按六大设计原则加 Loop Thinking 边界设计，适合要一次做完整技能包的团队。

Q: 写完怎么知道好不好？

A: 用 effective-agent-skills 的设计模式和反模式清单自检，再拿真实任务实测触发率和输出稳定性；不达标就回到 description 和信息分层迭代。掘技(Deep Skill Finder)也能帮你：说「我要一个教我写 skill 的技能」，它直接返回上面的真实技能和下载量。