用途：为创建、编辑和审查智能体技能（SKILL.md）提供写作规范，帮助技能保持可移植、简洁且易于触发。
主要能力：默认建议使用单个自包含的 SKILL.md；frontmatter 使用可移植字段，name 为小写 kebab-case 并与目录名一致，description 说明技能做什么和何时使用；建议用折叠 YAML（description: >-）书写；description 默认控制在 1024 字符内，避免 XML 尖括号，避免 claude、anthropic 等保留名，compatibility 仅用于具体平台或环境要求。
正文写法：从核心原则和默认做法开始，只解释非显而易见的约束、启发式与模式；优先紧凑分节和短示例，给一两个好默认值而非五个并列选项；可在用户明确要求或任务易因歧义失败时才使用严格分步指令；不重复模型已掌握的基础知识。技能过大时先删重复与样板，必要时才拆分文件，职责真正不同才拆成多个技能。
可发现性：描述面向发现而非营销，假设调用前只能看到目录名、name 和 description，调用指引应放在 description 而非正文；名称使用真实任务词并覆盖同义说法，可加入具体触发短语和失败症状；用 ALWAYS LOAD THIS SKILL WHEN X 之类硬性指令确保在明确范围内稳定加载，但不要整篇大写。触发不足时改 description，过度触发也改 description，不要改正文。
验证：验证强度与风险匹配。简单技能由独立子代理仔细阅读即可；含非平凡脚本、复杂指令、易碎流程或决策逻辑时，先用若干应触发与不应触发的提示做低成本检查，再让子代理或新审阅者使用或审阅技能，观察误读、跳过或范围过窄过宽之处并修正。触发敏感的技能可让新智能体执行一个合理任务，看技能是否自然加载并改变所关注行为。
额外文件：默认不需要。可接受理由包括可执行脚本、待填充模板、结构化数据或大表格、工作流中的外部可变产物（如 credentials.txt）；弱理由包括可选阅读、额外理论、可缩短的长示例、与主技能重复且未被显式链接的参考文档。依赖其他文件时必须显式说明。
平台特定字段：默认使用标准 frontmatter 以保持可移植，仅在需要调用控制、子代理执行、工具权限或参数替换等平台特定行为时添加，且添加前查阅目标宿主文档。参考资料：Claude Code 技能文档 https://docs.anthropic.com/en/docs/claude-code/skills，OpenCode 技能文档 https://opencode.ai/docs/skills。
限制：资料未提供收费、价格、具体平台支持范围等信息；支持的智能体路径可参考 https://github.com/vercel-labs/skills#supported-agents。