这是一门面向开发者的 6 章课程，主题是从零编写一个 agent skill。课程面向能够写代码、但尚未编写过 skill，或者已经写过 skill、想理解为什么有些 skill 能被 agent 稳定调用而另一些无人使用的开发者。课程不要求事先了解 skill 格式，只假定具备 git、Markdown 与 JSON 的基础知识。
课程内容按章节组织。第 1 章讲清 skill 的本质及心智模型，并对比 skill、MCP、系统提示与 CLI 各自适用的场景，指出两种常见误区：把需要访问实时状态的任务写成 skill（应改用 MCP 服务器），以及把应对所有对话生效的行为写成 skill（应改用系统提示）。课程还给出判断是否需要编写 skill 的决策树。第 2 章讲解 SKILL.md 的结构：frontmatter 字段及限制、作为路由输入的 description 字段，以及“Use when / Do NOT use for”模式；正文建议按范围、决策规则、示例与反模式组织。第 3 章可选，介绍在规范之外扩展格式的方式，例如目录元数据与 sidecar 模式（以 metadata.json 为例）。第 4 章对比 references/ 与 scripts/ 的使用场景并给出示例。第 5 章讨论共享 skill 的四种场景：个人、团队、内部目录、公开目录。第 6 章提供发布前的 10 分钟检查清单，列出 10 个最常见的编写错误及规避方式。
课程还给出若干具体的格式约束：name 为 1 至 64 个字符，仅使用小写字母、数字与连字符，且必须与父目录名一致；description 为 1 至 1024 个字符；compatibility 最多 500 个字符；SKILL.md 正文建议控制在 500 行以内；激活时加载的指令建议不超过 5000 tokens。课程建议 description 使用第三人称、预留余量（约 950 字符）。此外，正文中的长查找表与模板宜放入 references/，以控制上下文成本。
适用场景包括：为 AI 助手编写特定任务的技能文件、判断某需求应做成 skill 还是 MCP 或系统提示、以及为团队或公开目录准备可共享的 skill。限制方面：课程属于教学材料，未提供收费、价格或平台支持范围的完整信息；文中提到的目录扩展字段仅为某一公开目录的约定示例，并非通用规范。