Skill是一个文件夹,核心是SKILL.md(必需),加上可选的scripts/、references/、assets/目录。SKILL.md使用YAML frontmatter,包含name(kebab-case)和description(写清WHAT+WHEN,1024字符以内)。
Skill使用三级渐进披露系统:第一级YAML frontmatter始终加载,让AI知道何时使用;第二级SKILL.md正文在相关时加载;第三级链接文件仅在需要时导航。这最小化了token使用同时保持专业能力。
创建流程:1.规划可复用内容(哪些脚本/参考/资产需要反复使用);2.使用init_skill.py初始化目录结构;3.编辑SKILL.md写入具体流程指导;4.用package_skill.py打包为.skill文件分发。
关键规则:SKILL.md命名大小写敏感;文件夹用kebab-case不含空格/下划线/大写;description同时包含功能和触发条件。