用途:当用户提出“创建技能”“编写新技能”“添加技能”“SKILL.md 格式”“技能 frontmatter”等需求时,提供在 OpenCode 中创建可复用、可被按需发现和加载的技能(Skill)的指导。技能是模块化指令集,可包含专用工作流、领域知识、工具集成与打包资源,并采用渐进式披露:代理先看到名称与描述,命中相关请求后才加载完整内容。
主要能力:说明技能的文件位置(项目级 .opencode/skills/<name>/SKILL.md、.claude/skills/、.agents/skills/,全局 ~/.config/opencode/skills/ 等);讲解创建流程:明确用例与触发短语、规划结构、创建目录、编写 frontmatter、编写正文、添加打包资源、校验与测试。frontmatter 必填 name(1-64 字符,小写字母数字加单个连字符,须与目录名一致,模式 ^[a-z0-9]+(-[a-z0-9]+)*$)与 description(1-1024 字符,含具体触发短语);可选 license、compatibility、metadata。正文建议 1500-2000 词,使用祈使句与第三人称。资源分 references/、examples/、scripts/。
使用方式:创建目录如 mkdir -p .opencode/skills/my-skill,创建 SKILL.md 并写入 frontmatter 与正文;可用校验脚本 .opencode/skills/skill-creation/scripts/validate-skill.sh path/to/skill 检查结构;在 opencode.json 的 permission.skill 中配置 allow、deny、ask 及通配符控制访问。
适用场景:为 OpenCode 代理编写项目专用或通用技能,管理上下文加载,规范技能结构与权限。
限制:资料未提供具体收费、价格、平台支持范围或效果保证;技能名称、描述长度与路径等约束以资料所述为准,缺失信息暂未提供。