用途:当用户想要创建新技能或更新既有技能以扩展 Kimi 能力时,使用本技能获得指导。技能是模块化、自包含的包,通过提供专门知识、工作流与工具扩展 Kimi 能力。
主要能力:讲解技能提供的专门工作流、工具集成、领域专业知识与捆绑资源;给出核心设计原则,包括以简洁为要(上下文窗口是公共资源,只补充 Kimi 尚不具备的信息)、按任务脆弱性与可变性设置自由度(高自由度文本指令、中自由度带参数伪代码或脚本、低自由度具体脚本少参数)。
结构:技能包含必需的 SKILL.md 与可选捆绑资源。SKILL.md 由 YAML frontmatter(仅 name 和 description 两个字段,是触发依据)与 Markdown 正文组成,正文仅在技能触发后加载。可选目录为 scripts/(可执行代码,用于确定性或重复重写的任务)、references/(按需加载的文档与参考资料)、assets/(用于最终输出、不加载进上下文的模板、图标、字体等)。不应包含 README.md、INSTALLATION_GUIDE.md、QUICK_REFERENCE.md、CHANGELOG.md 等冗余文档。
用法:采用三级渐进式披露(元数据常驻、SKILL.md 触发时加载、捆绑资源按需加载),SKILL.md 正文尽量在 500 行以内,超出则拆分并在 SKILL.md 中说明何时读取,避免深层嵌套引用。创建流程为:用具体示例理解技能、规划可复用内容、初始化技能、编辑技能、打包技能、依据真实使用迭代。命名只用小写字母、数字和连字符,长度小于 64 字符,优先动词开头短语,目录名与技能名一致。脚本需实际运行测试,删除不需要的占位文件。技能按内置、用户、项目分层加载,用户级优先目录为 ~/.config/agents/skills/、~/.kimi/skills/、~/.claude/skills/,项目级为 .agents/skills/,--skills-dir 可覆盖发现目录(仍加载受支持的内置技能)。
限制:资料提到初始化与打包需运行 init_skill.py 和 package_skill.py,但未提供这两个脚本的具体路径、完整参数与安装命令;收费与平台信息暂未提供。