Skill 推荐文件结构
除了 SKILL.md 以外，一个 Skill 还可以包含哪些内容，这些内容应该放在什么位置。
在上一章我们提到，Skill 在形式上是一个包含 SKILL.md 文件的文件夹。 但实际上，一个 Skill 的文件结构并不局限于只有 SKILL.md，它还可以包含其他相关的文件和文件夹，以支持技能的执行和优化。
之所以要把这些内容独立出来，主要原因有：
- Agent 的上下文是有限的，尽可能地把当前用不上的信息放在上下文之外 →
/references； - 一些任务通过脚本执行更高效稳定 →
/scripts - 有些文件是媒体格式、需要独立存放 →
/assets
Skill 的文件夹结构并不是严格规定的，但官方建议的命名和组织方式如下：
scripts/
有些 Skill 可能需要一些可执行的脚本来完成特定的任务， 比如数据处理、API 调用、文件操作等。 通过将这些操作封装成脚本，可以让 Agent 更高效地稳定地完成任务，同时也能更好地管理和维护这些操作。
脚本文件通常放在 scripts/ 文件夹下，文件名应该清晰地反映脚本的功能，例如 generate_report.py、fetch_weather_data.js 等。
比如下面的 Skill 。
该 Skill 包含了一个 scripts/ 文件夹，里面包含了一系列Python脚本，用来处理 SEO 审计过程中需要执行的各种操作，比如检查页面结构、获取页面内容、检查页面加载速度、检查站点结构、检查 Schema 标记等。
这些任务都更适合通过脚本来完成，而不是通过提示词来让 Agent 去尝试。
references/
为了避免把所有内容都塞进 SKILL.md 里，参考资料、背景知识、相关流程等信息建议放在 references/ 文件夹下，Agent 在执行任务时可以根据需要加载和参考这些资料。
比如
- REFERENCE.md：详细技术参考；
- CHECKLIST.md：检查清单；
- 以及一些领域相关的知识库文档等，比如：
- finance.md
- legal.md
- marketing.md
同样，Agent 会按需加载这些参考资料，尽可能保证这些资料简洁，从而减少对上下文的占用。
如何引用呢？在 SKILL.md 里直接写上引用路径即可，比如：
详细检查清单参见 [检查清单](references/CHECKLIST.md).
运行下面的脚本来检查页面速度：
scripts/check-pagespeed.pyassets/
该文件夹主要用于存放一些资源文件，比如模板、图片、PDF等。在 “SEO 基础审计“ 这个 Skill 里，assets中存放了报告的模板文件—report-template.html 的报告模板文件，Agent 在生成 SEO 审计报告时可以直接使用这个模板来生成最终的 HTML 报告。