用途：指导作者创建符合 agentskills.io 规范、结构化的专业级智能体技能（skill）。适用场景为新建技能目录、起草程序化说明、整理元数据与打包脚本。
主要能力：提供一套五步编写流程——初始化并校验元数据、构建目录结构、编写核心逻辑（SKILL.md）、识别并打包脚本、最终逻辑校验；并给出错误处理与上下文膨胀的应对方式。
必要用法： 一、元数据。名称要求1-64字符，仅小写字母、数字与单个连字符；描述最长1,024字符，用第三人称书写并包含负向触发条件。校验命令：python3 scripts/validate-metadata.py --name "[name]" --description "[description]"；若报错，依据 stderr 自行修正并重跑至通过。 二、目录。用通过校验的名称建立根目录，并初始化 scripts/（小型 CLI 工具与确定性逻辑）、references/（一层深度的上下文，如 schema、API 文档）、assets/（输出模板、JSON schema 或静态文件）；不创建面向人的文件如 README.md、INSTALLATION.md。 三、核心逻辑。以 assets/skill-template.md 为起点，全部指令用第三人称祈使句；主逻辑控制在500行以内，大 schema 或复杂规则移至 references/，并指示智能体仅在需要时读取具体文件。 四、脚本。识别正则、复杂解析、重复样板等“脆弱”任务，为 scripts/ 编写单一用途脚本，通过 stdout/stderr 反馈成功或失败。 五、最终校验。排查迫使智能体猜测的“幻觉缺口”，确认所有路径为相对路径且使用正斜杠，并对照 references/checklist.md 交叉检查。
限制：资料未提供该技能的收费、平台、效果或安装方式。元数据校验失败时需依错误类型（如 STYLE ERROR）改写字段、去除第一人称与第二人称；草稿超过500行时，把最大的过程块移入 references/ 文件以缓解上下文膨胀。