Skill本质就是在一个特定的文件夹里创建一个格式规范的 Markdown 文件用来教 AI 如何完成一项特定的任务。整个过程就像是在给 AI 写一份清晰的操作说明书。下面我为你梳理了两种主流的创建方法你可以根据自己的习惯来选择。 方法一手动创建最基础这种方式能让你完全掌控 Skill 的每一个细节。创建文件夹在 OpenCode 能识别到的路径下为你的新 Skill 创建一个文件夹。文件夹名就是未来的 Skill 名需遵循命名规范。项目局部路径仅当前项目可用.opencode/skills/你的-skill-名/用户全局路径所有项目可用~/.config/opencode/skills/你的-skill-名/创建核心文件在上述文件夹中新建一个名为SKILL.md的文件注意大小写。编写文件内容SKILL.md由两部分组成你可以直接复制下面的模板进行修改。--- # 1. YAML Frontmatter (元数据) name: your-skill-name # 必填必须与文件夹名一致 description: 用一句话清晰描述这个技能是做什么的。 # 必填Agent靠它来理解和选择 # 可选字段例如 # author: your-name # version: 1.0.0 --- # 2. Markdown 正文 (核心指令) ## 技能目标 详细说明这个技能要解决什么问题在什么场景下使用。 ## 执行步骤 1. **第一步**清晰地写出要做的第一件事。 2. **第二步**说明第二步如果涉及命令可以用代码块标出例如 bash git log --oneline -5 3. **第三步**说明如何判断任务是否成功或者如何处理可能出现的错误。 ## 注意事项 * 列出任何需要特别注意的点比如权限要求、依赖的环境等。⚡ 方法二对话生成最高效这是官方推荐的高效方式你只需要通过对话让 OpenCode 自己帮你写 Skill。核心思想实战 - 总结 - 测试 - 迭代。操作步骤实战在 OpenCode 会话中像平时一样通过对话完成一个具体的任务例如合并两个 Git 仓库。总结任务成功后在同一个会话中输入命令/skill-creator 请把刚才的任务方法总结为一个标准技能。OpenCode 会自动分析你的操作过程并生成一个SKILL.md文件放在正确的目录下。测试与迭代新建一个会话测试这个新 Skill 的效果。如果效果不完美可以再次执行任务并用/skill-creator命令要求它基于这次的经验改进之前的 Skill。经过几轮迭代你的 Skill 就会非常稳定可靠。 技能的基本结构无论用哪种方法创建一个完整的 Skill 不仅仅是一个SKILL.md文件它可以有更丰富的结构来支持复杂的功能your-skill-name/ # 技能文件夹名称即技能ID ├── SKILL.md # 核心指令文件必需 ├── scripts/ # 可选存放可被 Skill 调用的脚本 ├── references/ # 可选存放供 Agent 阅读的参考文档 └── assets/ # 可选存放模板、图片等静态资源 进阶权限与工具控制访问权限如果你想限制某些高风险 Skill 的使用比如只有特定 Agent 能用或使用时需询问用户可以在项目根目录的opencode.json文件中配置permission.skill规则。区分 Command, Agent 和 SkillCommand (/)是你输入的命令快捷方式。Agent是执行任务的角色如plan智能体。Skill是 Agent 可以按需加载的知识和操作流程。