用途:skill-creator 用于创建新的 OpenCode 技能,并让这些技能具备可自我构建能力。最佳使用时机是用户已经执行完某个流程后提出“为这个创建技能”;若用户直接要求创建技能,建议先完成任务,再在结束时请求创建。
主要能力与脚手架:生成技能目录与最小文件集,包括 SKILL.md、scripts/、.env、.env.example 和 .gitignore。若用户需要配置,则创建不含凭据的 .env.example,并列出所有必需变量;询问用户是否要存储凭据,若同意则写入技能内的 .env,并建议之后轮换密钥。始终添加忽略 .env 的 .gitignore,并确认 .env 未被跟踪。若涉及 API 交互并创建了脚本,则把可复用脚本放在 scripts/ 下。新技能应说明如何使用 scripts/,以及 .env.example 定义了最低配置,并声明技能会从可用配置推断自身能做什么。
触发短语:description 字段决定 Claude 何时使用技能,应包含 2-3 个具体触发短语。反例:“Use when working with content”。正例:“Use when user mentions 'content pipeline', 'add to content database', or 'schedule a post'”;“Triggers on: 'rotate PDF', 'flip PDF pages', 'change PDF orientation'”。快速校验:至少包含一个带引号的短语、使用 when 或 triggers、长度超过约 50 个字符。
Frontmatter 模板:name 与 description 为必填。示例结构为 name: my-skill,description 中写一句话说明用途,并列出触发短语。
使用方式:创建技能文件夹可执行 mkdir -p .opencode/skills/<skill-name>。最小脚手架文件包括 SKILL.md、scripts/、.env、.env.example、.gitignore。.env.example 用于记录所需凭据或外部设置,不得包含真实凭据。最小技能模板包含 name、description,以及 Quick Usage、Common Gotchas、First-Time Setup 等段落。
OpenCode 文档要点:技能文件夹位于 .opencode/skills/<name>/SKILL.md;name 必须小写并与文件夹一致;frontmatter 需要 name 和 description。参考官方文档:https://opencode.ai/docs/skills/。
限制:资料未提供收费、价格、平台支持范围或效果保证等信息。