6K字干货：从0到1手把手教你编写第一个Skill

文章主旨： AI Agent的真正价值不在于简单地“问”AI，而在于通过“Skill”将个人和团队的工作流程、标准等隐性知识封装成可复用的结构化指令，从而让AI像老员工一样按标准流程高效工作。

关键要点：

1. Skill的本质： 它是AI的“员工手册”，规定了动作的先后顺序、质量底线和执行标准，解决Prompt（指令）和MCP（工具）无法解决的“怎么做”问题。
2. Skill的架构： 是一个标准的文件夹，包含SKILL.md（核心指令）、scripts/（可执行代码）、references/（参考文档）和assets/（素材），采用kebab-case命名。
3. 触发关键： description字段需包含“能做什么”、“何时使用”和“触发短语”，控制在100-150字符内，确保AI精准匹配用户意图。
4. 设计原则： 采用“渐进式披露”策略，YAML frontmatter精简，正文详细，参考资料按需加载，避免一次加载所有内容，降低上下文消耗60%-80%。
5. 避坑指南： description要具体；文件夹名用kebab-case；一个Skill只做一件事；详细内容放references/而非SKILL.md。

内容结构：

01 什么是 Skill？——给 AI 的"员工手册"
通过三个比喻（Prompt=点单、MCP=厨房工具、Skill=秘制菜谱+员工守则）解释Skill解决了每次重复教导AI的痛点。

02 Skill 的核心架构——四件套文件夹
标准文件夹结构：SKILL.md（必须，含YAML前置信息和Markdown正文）、scripts/（可选）、references/（可选）、assets/（可选）。命名规范：kebab-case，不以-skill结尾，打包为.skill格式。

03 手把手实战：创建一个"文章评分"Skill
创建文件夹article-scorer，编写SKILL.md：YAML frontmatter（name, description）、正文包括任务目标、评分标准（结构/逻辑/表达各占权重）、操作步骤、输出格式。

04 YAML frontmatter 详解——决定 Skill 是否被触发的关键
description要具体、包含触发短语。对比反面（“一个有用的工具”）和正面（含触发场景）例子。避免description过长、避免多功能合并。

05 SKILL.md 正文怎么写——渐进式披露的艺术
三层懒加载：YAML frontmatter（精简）、SKILL.md正文（详细指令）、references/（按需读取）。正文结构建议：任务目标、前置准备、操作步骤（含决策树）、资源索引、注意事项（常见陷阱）。

06 避坑指南——Anthropic 官方总结的常见错误
四大坑：description模糊、文件夹命名不规范、一个Skill做多件事、所有内容塞进SKILL.md。建议：一个Skill只做一件事，详细文档放入references。

文章总结： 文章强调，AI时代真正的竞争力不在于“问AI”，而在于“教AI”——将个人和团队的隐性知识封装成Skill，形成可复用的数字化知识资产，专注于业务本身。

车轮上的管理革命：中国车企的“华为IPD一课”

了解更多

三爷茶馆

查看原文：6K字干货：从0到1手把手教你编写第一个Skill

文章来源：

三爷茶馆

扫码关注公众号