一句话定义
一个 skill 本质上是一个文件夹，核心是 SKILL.md，旁边可以放脚本、参考文档和素材。文件夹给 skill 划边界，SKILL.md 给智能体说明什么时候用、怎么做。
机制 / 原理
最小 skill 只需要一个 SKILL.md。这个文件通常包含三部分：description 告诉智能体技能干什么、什么时候用；正文指令 写清执行步骤、标准和边界；可选附件 提供脚本、模板、参考资料或示例。路径可以因平台不同而变化，但结构思想相同：一个文件夹承载一项可复用能力。
经典实验 / 例子
本书案例：用户让智能体查看周报技能文件夹，看到最核心的文件是 SKILL.md。这个文件前面有 description，用来告诉智能体什么时候该选中它；正文保存周报标题、栏目、语气、保存格式等规则；文件夹里还可以继续放脚本、参考文档或模板。技能不是一句提示词，而是一个能把说明、资料和工具组织在一起的目录。
书中案例出处
周报 skill 文件夹结构
核心原文线索
周报 skill 文件夹结构
案例现场复述
周报技能文件夹展示了 SKILL.md 的核心地位，以及 description、正文规则和可选附件之间的关系。
为什么重要
理解文件夹结构后，用户才知道经验、模板和脚本分别放在哪里。
生活中的例子
引申案例：月度销售报告 skill 可以有一个 SKILL.md 写清触发条件、报告结构和检查清单；旁边放一个指标计算脚本、一个报告模板、一个品牌配色说明。智能体先看 description 判断是否该用，再按任务需要读取模板或运行脚本。目录结构让经验不必全挤进一段提示词。
常见误区
误区：skill 就是一段提示词。 提示词通常是一次性交代，skill 则是一个可维护的文件包。它可以把规则、脚本、模板和参考资料组织在一起。