用途：定义向 OpenCode 仓库添加新技能（skill）的步骤与检查项，确保技能可被 skill 工具发现，并校验命名、frontmatter 与放置规则。适用于把可复用工作流或手册沉淀为技能，或更新技能元数据以满足 OpenCode 发现要求。
主要能力与工作流：1）技能名需匹配 ^[a-z0-9]+(-[a-z0-9]+)*$，长度 1–64 字符；2）创建 .opencode/skill/<name>/SKILL.md，目录名与技能名一致；3）添加 YAML frontmatter，包含 name 与 description（可选 license、compatibility、metadata）；4）正文按清晰分段撰写（Purpose/What I do、When to use、Workflow、Completion criteria）；5）验证发现：在仓库中运行 OpenCode 并查看 skill 工具列表；6）若权限阻止，需在 opencode.json 中更新 permission.skill 规则。
放置规则（来自 opencode.ai 文档）：项目级 .opencode/skill/<name>/SKILL.md；项目级（Claude 兼容）.claude/skills/<name>/SKILL.md；全局级 ~/.config/opencode/skill/<name>/SKILL.md；全局级（Claude 兼容）~/.claude/skills/<name>/SKILL.md。
校验清单：SKILL.md 全大写且包含 YAML frontmatter；name 与文件夹名一致；description 为 1–1024 字符；仓库内无重名技能。完成标准：技能出现在 skill 工具列表；skill({ name }) 能无错误加载；说明足够清晰，无需额外上下文即可执行。限制：资料未提供其他平台支持、错误码或更详细的权限配置说明。