agent skills技能文件通常由yaml头部和markdown正文组成,文件名必须是skill.md。头部提供标准要求的名称和用途描述,正文告诉ai怎样处理任务。写作时先保证字段格式正确,再补充清楚的步骤、输出示例和资源读取条件。
先写标准YAML头部
文件开头与头部结尾各用单独一行---分隔。name和description是标准必填字段,例如name: meeting-summary,description写明整理会议记录的用途及适用时机。
name为1至64个字符,建议用小写英文字母、数字和短横线,不能以短横线开头或结尾,不能有连续短横线,并与目录名一致。description非空且不超过1024个字符。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

正文写成可执行的任务说明
在头部之后,用Markdown小标题组织输入、步骤和输出。步骤写具体动作,例如“提取已确认决策,按待办、负责人、截止时间整理”,少用“认真处理”等空泛要求。
补上缺失输入和常见异常的处理方法,再给一组简短输入输出示例。纯文字技能可以不带脚本;正文过长时,把详细资料拆出去,并写清何时读取。

使用相对路径并检查格式
引用资料用相对技能根目录的路径,例如references/规则.md;需要脚本时写明scripts/文件名及参数。避免只说“看附件”,也不要串接多层不清楚的引用。
可用标准参考工具skills-ref validate ./meeting-summary检查头部和命名;使用前需准备该工具。格式通过后仍要在目标宿主试用,分别验证能否调用、步骤是否执行、输出是否符合要求。












