用途：本技能提供一套编写智能体技能（agent skill）的程序，目标产物符合 agentskills.io 规范并遵循渐进式披露原则，用于创建新的技能目录或起草技能流程说明。
主要能力与步骤：
- 初始化并校验元数据。名称需唯一，1–64 字符，仅小写字母、数字和单个连字符。描述不超过 1,024 字符，用第三人称书写，并包含否定触发条件。用只读校验脚本检查：python3 <skill-best-practices-dir>/scripts/validate-metadata.py --name "[name]" --description "[description]"。若报错，依据 stderr 自行修正并重跑直至通过。
- 组织结构。以校验后的名称创建根目录，并初始化 scripts/（小型 CLI 工具与确定性逻辑）、references/（一层深的扁平上下文，如 schema 或 API 文档）、assets/（输出模板、JSON schema、静态文件）。不要创建 README.md、INSTALLATION.md 等面向人的文件。
- 起草核心逻辑 SKILL.md。以 assets/SKILL.template.md 为起点，全部指令用第三人称祈使句。主逻辑控制在 500 行以内；庞大 schema 或复杂规则移入 references/，并指示智能体按需读取，如“Read references/api-spec.md to identify the correct endpoint.”。
- 识别并打包脚本。将正则、复杂解析、重复样板等脆弱任务做成单一用途脚本放入 scripts/，用 stdout/stderr 汇报成功或失败。在 SKILL.md 中以智能体工作目录下无歧义的路径引用助手，不要用依赖 CWD 的裸 scripts/helper.py。为每个助手标注只读、引导（bootstrap）或变更（mutating）。
- 最终校验。排查“幻觉缺口”（迫使智能体猜测之处）；确认所有路径为相对路径并使用正斜杠；确认每个助手路径无歧义且角色已注明；阅读 references/checklist.md 并逐项核对最终产物。
捆绑路径规则：相对于包含本 SKILL.md 的目录解析路径；在其他工作目录调用助手时，先将 <skill-best-practices-dir> 展开为该目录。
错误处理：元数据失败时定位具体错误（如 STYLE ERROR）并改写字段，去除第一、第二人称；上下文膨胀时抽取最大流程块移入 references/。
限制：资料未提供安装方式、收费、价格、平台支持或效果数据。