用途：本技能是一份创建和改进智能体技能（agent skills）的参考指南，帮助后续智能体快速找到并应用有效方法。技能需满足三点：可发现（agent 能找到）、易浏览（可快速评估）、可执行（示例清晰）。核心原则是假定智能体已具备良好通用推理能力，只补充它本不具备的上下文。
何时创建：当技巧并非直觉可得、模式可广泛跨项目复用、你会再次引用、他人也会受益时创建。不要为单项目一次性方案、别处已有良好文档的标准实践或项目约定创建（项目约定应放入 AGENTS.md 等项目级指导）。
必要结构：frontmatter 仅支持 name 和 description 两个字段，总长上限 1024 字符。name 只能用字母、数字、连字符，采用动名词形式（动词 + -ing），如 creating-skills。description 用第三人称，以「Use when...」开头，同时包含触发条件和技能做什么。
文档结构：包含 Skill Name、Overview（1-2 句核心原则）、When to Use（症状与用例，含不适用情形）、Quick Reference（表或要点）、Implementation（简单模式内联代码，100 行以上参考链接到单独文件）、Common Mistakes、可选的 Real-World Impact。
自由度：按任务复杂度匹配具体程度。高自由度任务（如设计 API）给宽泛原则与示例；低自由度关键操作（如生产部署）须写明确切步骤与校验。约束过度会限制创造性任务，过于含糊则关键操作缺步骤。
发现优化：agent 常据 description 判断相关性，故描述须含触发条件与作用，覆盖错误信息、症状、同义词、工具名等关键词。命名用动名词形式，如 testing-with-subagents、debugging-memory-leaks、processing-pdfs，避免 Helper、Utils 等含糊名或被动结构。
代码示例：一个优秀示例胜过多个平庸示例。按用例选语言（测试用 TS/JS，系统调试用 Shell/Python，数据处理用 Python）。示例应完整可运行、注释解释「为什么」、来自真实场景、展示模式并可直接改造，并用 ❌/✅ 对比。不要用 5 种以上语言实现、不要填空模板、不要造作示例。
文件组织：全内联的自包含型适合约 500 词内内容；带支持文件型用于可复用工具或完整示例；重参考型用于超过 100 行的参考材料。
Token 效率：技能会载入每次对话，须精简。SKILL.md 保持 500 行以内；入门工作流少于 150 词；高频加载技能少于 200 词；其他少于 500 词。可用引用工具 --help、交叉引用其他技能、渐进披露等方式压缩。
工作流：多步流程应含清晰顺序步骤、反馈/校验环节、错误处理与检查清单。
常见错误：叙事化例子、多语言稀释、流程图中放代码、通用标签、缺少触发条件、第一人称描述、深层嵌套引用、Windows 风格路径、选项过多、忽略错误处理、时效性信息、术语不一致。流程图仅用于非显然决策点、循环与 A/B 选择，不用于参考材料、代码或线性说明。
交叉引用：用技能名加明确要求标注（REQUIRED / RECOMMENDED），避免用文件路径或 @ 强制加载。
高级实践：与 agent 迭代开发技能，从最小可用版本开始，用真实用例测试并按效果精简；先建评测再写文档；提供带显式错误处理、退出码与清晰错误信息的工具脚本；为结构化输出提供模板。
目录结构为 skills/skill-name/SKILL.md（必需）及可选的支撑文件、examples/、scripts/，采用扁平命名空间。资料未提供该技能的具体安装命令或收费信息。