Skill

Skill 结构

怎么组织 SKILL.md、references、scripts 和 assets，才能让 Agent 按需加载专业知识。

最小目录

一个 Skill 只需要一个必需文件：SKILL.md。文件夹名要稳定、可读，因为用户和工具经常会在目录里直接展示它。

data-cleanup/
└── SKILL.md

SKILL.md 格式

文件以 YAML frontmatter 开头，然后是 Markdown 指令。至少提供一个简短的 name 和一个能触发的 description。

---
name: data-cleanup
description: 清洗混乱的 CSV 或表格数据，统一列名，并生成验证报告。
---

# 数据清洗

当用户要求清洗、规范化、校验或准备表格数据时使用这个 Skill。

## 工作流
1. 检查源文件并识别 schema 问题。
2. 统一列名和数据类型。
3. 输出简洁报告，说明假设和未解决行。

可选目录

主说明要尽量短，把辅助材料放进可预测的目录里，并明确告诉 Agent 什么时候读它们。

references/

背景文档、策略、schema、示例和详细领域解释。

scripts/

用于解析、校验、转换、评分或重复机械工作的复用脚本。

assets/

模板、样例文件、报告格式、片段、提示词碎片和其他可复用资源。

如何引用资源

不要让 Agent 一次加载整个目录。要在 SKILL.md 里写清楚条件式指令，让上下文只在有用时才花出去。

更好的指令 只有当输入文件存在无效行时，才读取 references/validation-rules.md，然后把每类问题映射到清洗清单。

验证清单

Namefrontmatter 里的 name 要短、稳定，并且和文件夹意图一致。

Description描述要说明什么时候用、什么时候不用。

正文正文要给出流程、默认值、坑点和成功标准。

资源参考文件和脚本都要命名清楚，并按条件加载。