用途:将技能设计或重构为体积小、易触发且机械上有效的形态,并为打包分发做好准备。
主要能力:定义应触发该技能的确切用户请求;保持 SKILL.md 简短,把深层细节放入 references/;只添加真正提升执行可靠性的脚本、资产或引用;生成 agents/openai.yaml 并在打包前校验。
脚本:scripts/init_skill.py 初始化新技能,可附带资源文件夹与 agents/openai.yaml;scripts/generate_openai_yaml.py 依据显式接口值写出 agents/openai.yaml;scripts/quick_validate.py 强制执行严格 frontmatter、目录命名、agent 元数据与脚本依赖规则;scripts/package_skill.py 先校验再压缩技能以便分发。
规则:frontmatter 只保留 name 与 description;让 description 承担触发职责,说明做什么与何时使用;文件夹名与 name 完全一致;优先单一聚焦工作流而非大杂烩;发布前移除占位文件与通用样板。
典型命令: python3 skill-creator/scripts/init_skill.py my-skill --path . python3 skill-creator/scripts/generate_openai_yaml.py my-skill --interface display_name="My Skill" --interface short_description="One-line summary" --interface default_prompt="Help me use this skill." python3 skill-creator/scripts/quick_validate.py my-skill python3 skill-creator/scripts/package_skill.py my-skill ./dist
适用场景:构建或重构技能、需要校验与打包发布的场合。限制:资料未提供具体依赖版本、收费、平台支持范围与效果说明。