用途:Skill Creator 用于指导创建有效的 OpenCode 技能(或更新已有技能),把专门知识、工作流和工具封装为模块化、自包含的技能包,使 OpenCode 从通用智能体变为特定领域的专用智能体。
核心原则:内容要简洁,上下文窗口是公共资源,只补充 OpenCode 本身不具备的信息,优先用简洁示例而非冗长说明;同时按任务脆弱性设置自由度——文本指令为高自由度,伪代码或带参数脚本为中自由度,固定脚本与少量参数为低自由度。
技能结构:每个技能包含必需的 SKILL.md 与可选的捆绑资源。SKILL.md 含 YAML frontmatter(name、description 必需,license、metadata、compatibility 可选;仅 name 与 description 会被读取以决定触发时机)和 Markdown 正文(触发后才加载)。捆绑资源包括 scripts(可执行代码,如 scripts/rotate_pdf.py)、references(按需加载的文档,如 finance.md、api_docs.md)与 assets(用于输出的模板、图标、字体等)。不要添加 README、安装指南等多余文档。
渐进式披露:采用三级加载——元数据始终在上下文(约 100 词)、SKILL.md 正文在触发时加载(<5k 词)、捆绑资源按需加载。SKILL.md 正文建议控制在 500 行以内,超出时按领域或变体拆分到 references 文件,并保持引用只有一层、长文件加目录。
创建流程:先用具体示例理解技能用途,再规划可复用内容,然后用 scripts/init_skill.py <skill-name> --path <output-directory> 初始化,接着编辑技能并测试脚本,之后用 package_skill.py 打包,最后根据实际使用迭代。
限制:资料未提供价格、平台支持范围或与具体版本的兼容信息;部分功能与步骤需以实际脚本和项目环境为准。