用途：在 Pi 或其他 agent 运行时中创建或更新可复用的 AI 技能。当某工作流或约定会跨会话复用、需要为通用 agent 行为加项目特定约束、需要决策树辅助安全选择，或需要示例/模板/参考提升可靠性时，才应创建技能；一次性任务、通用文档或应写入代码/测试的规则不应做成技能。
主要能力与规则：以 docs/skill-style-guide.md 为规范来源；技能是 LLM 运行时契约而非人类文档；SKILL.md 尽量保持 180–450 tokens、上限 1000；使用祈使句和具体门控，避免教程与背景叙述；frontmatter 的 description 必须是单行、YAML 安全，并把触发词放在最前面；不添加 Keywords 区块。模板、schema、生成的示例放入 assets/；较长理由或本地文档链接放入 references/。
决策门：小型可复用行为只建 skills/{skill-name}/SKILL.md；需要模板/schema/夹具时加 assets/；需要较长说明或边界情况时加 references/；若已有技能覆盖则更新现有技能；若影响委派发现，确保触发词出现在 description 中。
执行步骤：先读 docs/skill-style-guide.md；检查现有技能避免重复；选择与用户可见触发词匹配的 kebab-case 名称；按 skills/{skill-name}/ 结构创建或更新；frontmatter 使用规定的 name、description、license、metadata 形状；按 Activation Contract、Hard Rules、Decision Gates、Execution Steps、Output Contract、References 顺序写章节；若是打包的 gentle-pi 技能，加入 scripts/verify-package-files.mjs；刷新或记录技能注册表更新路径。
输出契约：返回创建或修改的文件、属于新建还是更新、新增的 assets/ 或 references/ 文件、是否需要包校验或技能注册表刷新。
限制：具体实现细节、安装命令、价格与平台支持暂未提供；须以 docs/skill-style-guide.md 与 skills/skill-registry/SKILL.md 为准，不得编造。