SKILL.md 元数据标准
OpenCode 认可的官方 frontmatter 字段。
必需字段
---name:skill-namedescription:>-Use when[trigger condition].metadata:triggers:keyword1,keyword2,error-message---| Field | Rules |
|---|---|
name | 1-64 字符，小写，只用连字符，必须与目录名匹配 |
description | 1-1024 字符，应描述何时使用 |
可选字段
---name:skill-namedescription:Purpose and triggers.metadata:license:MITcompatibility:opencodeauthor:"your-name"version:"1.0.0"category:"reference"tags:"tag1, tag2"---| Field | Purpose |
|---|---|
license | 许可证标识符（例如 MIT、Apache-2.0） |
compatibility | 工具兼容性标记 |
metadata | 自定义键值对的字符串到字符串映射 |
名称验证
^[a-z0-9]+(-[a-z0-9]+)*$有效：my-skill、git-release、tdd
无效：My-Skill、my_skill、-my-skill、my--skill
常见元数据键
使用这些约定以保持技能间一致：
| Key | Example | Purpose |
|---|---|---|
author | "your-name" | 技能创建者 |
version | "1.0.0" | 语义化版本 |
category | "reference" | 类型：reference、technique、discipline、pattern |
tags | "react, hooks" | 可搜索关键词 |
[!IMPORTANT]
此处未列出的任何字段都会被 OpenCode 的技能加载器忽略。
