Skill 是一个文件夹，可以包含 Markdown、脚本、资产、数据、配置等。Agent 会自主发现和使用其中的所有内容。

把它想成一个小型项目，而不是一份文档。

这个非常重要
如果是一个很小的skill,用文件也是没问题的,但是俺公司有一个2000字的文档,ai根本读不到…而且拓展性极差

skills/<name>/ ├── SKILL.md # 入口：路由表 + 优先级 ├── rules/ # 长期约束 ├── workflows/ # 步骤流程 ├── references/ # 背景资料：架构、坑点、索引 │ └── gotchas.md # 已知的坑（通常是最高价值内容） ├── docs/ # 可选：提示词、报告 └── scripts/ # 可选：辅助脚本、脚手架工具

Skill 文件夹能放什么

image1438×544 39.8 KB

来自 Anthropic 的关键洞察： 让 Agent 花时间在组合和编排上，而非从头写样板代码。Skill 文件夹中的脚本和可复用资产能显著降低 Agent 的出错率。