技能骨架模板

新建技能时的常见痛点

从零编写智能体技能包时，开发者常遇到三类问题：目录结构不统一，导致后续引用 references/ 资源混乱；SKILL.md 元数据字段缺失或不规范，例如 description 写得过于宽泛，无法被下游工具正确识别；正文缺少标准段落，校验时频繁报“sections_ok=false”。这些问题不仅拖慢迭代速度，还可能让技能包无法通过自动激活。

技能如何帮你写对结构

这个骨架模板将技能创建流程拆解为可执行的步骤，每一步都给出明确规则：

• 建目录骨架：新建根目录与 references/，slug 用 kebab-case 命名（2–128字符），避免空格与特殊符号。
• 填前置元数据：按 references/template.md 逐项写入 name、version（遵循 SemVer）、displayName（4–8字）等字段，description 需具体且用第三人称，控制在200字符以内。
• 写六段式正文：包含角色目标、适用边界、工作流、互操作（I/O）、输出规范、使用示例，确保结构完整。
• 校验与自查：用 skillhub publish --dry-run 验证元数据与段落是否齐备，同时检查禁用字样（占位符、危险命令）。

适用边界与注意点

仅适合新建技能包或补全已有技能的 references/ 模板；若只是撰写纯文档，本模板不适用。生成的 SkillScaffold 工件可对接 mg-skill-creator 深化内容，或直接用于发布前校验。