用途：创建或更新可复用的 Agent Skills，面向需要过程指导、领域知识、工具或打包资源的任务特定工作流，适用于 Codex、ChatGPT、Claude、OpenCode 等兼容宿主。仅在需要可复用技能时使用；仓库约定用 AGENTS.md，一次性指令用提示或线程上下文，不要仅为重复宿主已有可靠行为而建技能。
主要能力：把技能视为行为产物，定义激活边界、预期行为、成功证据与安全失败行为；识别最小可复用工作流，判断仅靠说明是否足够；按需添加 references/（按需知识）、scripts/（重复确定性工作）、assets/（输出用文件）；编写能区分相邻技能的简短 description；定义输入、工作流步骤、输出、不支持的推断以及询问、停止或回退条件；针对目标宿主或规范验证技能，并测试激活与任务行为。
结构：可移植技能需要包含 name 与 description 的 SKILL.md。目录示例：skill-name/ 下含 SKILL.md、agents/openai.yaml（可选 Codex 与 ChatGPT UI 元数据、调用策略与工具依赖）、references/、scripts/、assets/、evals/（特定运行环境的评估夹具，不属于可移植格式）。name 为 1-64 个小写字母、数字和连字符，且与目录名一致；description 为 1-1024 字符。为最大兼容性，frontmatter 保持 name 与 description，除非目标宿主明确支持额外字段。SKILL.md 保持简洁，非每次调用都需要的细节移到直接链接的资源，引用保持一层深度。
描述设计：前置可识别的用户目标与重要触发词；包含技能执行的工作流、应激活的请求/工件/工具/文件类型，以及与相邻技能重叠时的路由边界。使用直接自然措辞，避免第三人称要求。
特异性匹配脆弱度：多种方法均可行且由上下文决定时用高自由度简述；存在首选模式时用中自由度说明条件；顺序、一致性或安全性脆弱时用低自由度提供确切命令或确定性脚本。使用祈使语气，保持一致术语，不把易变产品事实写死为长期真理，需当前行为时获取现行一手文档，或明确标注捆绑材料为回退指导。
资源设计：仅当能显著改善重复执行时才添加命令表、前置检查或工作流清单。依赖需说明如何验证、是否有回退、不可用时报告什么确切阻塞。缺少可选工具不等于技能不适用。优先说明而非脚本；仅在重复机械工作或确定性可靠性需要时加脚本，并记录依赖、在声称完成前运行。
评估：分别测试激活与执行。激活用例包括直接请求、表达同一目标的间接请求、应提出一个聚焦问题的不完整请求、不应激活的近似误命中、涉及不支持数据或操作的边角情况。执行用例使用真实提示或工件与可观察断言，验证输出、工具选择、安全边界与停止行为。比较修订时一次改一个行为杠杆并重跑相同用例，不按配额堆夹具，从失败中泛化。独立前向测试只给原始提示与工件，不给预期答案或先前诊断，模拟评审不等于观察到的行为。
完成检查：description 能区分相邻技能；输入、输出、不支持的推断与停止条件明确；SKILL.md 只含始终需要的说明；每个支持资源都直接链接且有明确加载条件；脚本记录依赖并已成功执行；存在 agents/openai.yaml 时其 Codex 元数据与技能匹配；目标宿主结构验证通过；已测试正、负、不完整与边角行为；剩余限制被报告而非隐藏。
限制：资料未提供具体收费、价格、平台支持范围或安装步骤等事实。