用途:指导创建 SKILL.md 技能文件。技能是教 AI 智能体特定工作流、工具或模式的 markdown 文件,当智能体识别到匹配任务时加载。
文件位置:仓库根目录的 skills/<skill-name>/SKILL.md,文件夹名与技能名一致(kebab-case)。个人技能放 ~/.config/opencode/skills/<skill-name>/SKILL.md。不要放进 cli/skills/ 等包目录,除非仓库有意同步。从其他仓库同步来的技能不要直接编辑,应改源仓库,否则同步时会被覆盖。
分发安装:发布到 GitHub 后可用 npx skills add owner/repo 安装,并建议在 README 中说明。
Frontmatter:必填 name、repo、description 三个字段。description 最关键,需说明技能做什么、何时使用及触发关键词。
写作风格:面向 AI 智能体而非人类,直接使用祈使句,给出可复制命令与代码,用 Never/Always/Must 陈述规则,标注常见错误。
保持精简:尽量把文档放在 README 或 CLI --help 中,SKILL.md 只做指向。CLI 工具用 <tool> --help,库与项目用 curl 拉取根目录 README。禁止用 head、tail、sed、awk、less 截断文档输出。
限制:资料未提供具体收费、平台或效果信息。