用途:指导用户创建新技能或更新已有技能,用模块化、自包含的技能包扩展 Claude 的能力;技能可提供专门工作流、工具集成、领域知识以及脚本、参考文档和素材等打包资源。
主要能力与原则:强调简洁,只在需要时提供 Claude 尚不具备的上下文,优先用简短示例而非冗长解释;按任务脆弱性设定自由度——高自由度用于多路径有效的情形,中自由度用于存在推荐模式但允许变化的情形,低自由度用于操作脆弱、需固定顺序的情形。技能由必需的 SKILL.md 和可选的 scripts/、references/、assets/ 组成;SKILL.md 的 YAML frontmatter 必须含 name 与 description,正文只在触发后加载。脚本用于需要确定性或反复重写的代码,参考文档按需加载,素材用于最终输出。采用三级渐进式加载:元数据始终在上下文,正文触发时加载,打包资源按需使用;正文建议保持 500 行以内并按引用拆分,引用不超过一层,长文件加目录。技能中不应包含 README、安装指南、变更日志等多余文档。
使用方式:按六步流程进行——用具体示例理解技能、规划可复用内容、初始化技能(skills_init(name: "my-skill", directory: ".opencode/skills") 或 bun scripts/init-skill.ts my-skill --path .opencode/skills)、编辑技能并编写 SKILL.md、用 bun scripts/validate-skill.ts .opencode/skills/my-skill 校验、根据实际使用迭代。
适用场景:需要为特定领域、文件格式、API 或公司业务逻辑封装可重复工作流时。
限制:资料未提供收费、价格、平台支持范围和效果数据;技能无法包含模型本身已具备的常识性知识,且应避免与引用文件重复信息。