skill-authoring 是一个关于「如何编写 Agent Skill」的规范型技能，面向需要让 AI 智能体自主创建、维护或检查技能包的场景。其核心主张是：智能体在缺少严格结构约束时，会以推测性免责声明、通用模板和随意目录结构填补未明确的部分，这些虚构内容会被后续智能体当作权威规则执行；因此技能编写必须受结构分离、最小差异和机械校验的约束。
用途
- 按 AgentSkills.io v1 规范从零搭建新技能。
- 根据反馈修订已有技能，同时避免架构漂移。
- 对技能包执行静态验证和质量审计。
- 评估技能是否达到精简、确定、结构合规的目标状态。
三段式目录标准
每个合格技能目录须遵循以下结构：
- SKILL.md：入口文件，含 frontmatter、理由说明和不变量规则，少于500行。
- usecases/：过程性操作手册，文件名使用动词短语，如 create.md、revise.md。
- references/：领域模式、错误目录、规范参考等资料。
- scripts/：可选的确定性工具和测试脚本。
- evals/：可选的 BinEval 测试套件与断言库。
SKILL.md 必备章节
- Frontmatter：name 必须与目录名完全一致，使用小写 kebab-case；description 需说明技能做什么以及何时使用（含自然语言触发词）；如派生自其他技能，需提供 metadata.derived-from 永久链接。
- 标题与单行职责：以 # 技能名开头，并跟一句简洁的引用块说明。
- 为什么需要该技能与目标状态：一段说明缺少该技能时的机械性失败模式，一段说明遵循后的目标状态。
- 不变量规则：编号的、不可协商的架构约束，每条附单行理由。
- 执行流程：以项目符号列出并链接到 usecases/<动词>.md。
- 领域引用：以项目符号列出并链接到 references/<名称>.md。
- 委派技能：按技能名直接委派，不重复对方的内容。
编写不变量
- 不填充空话：不生成未被请求的注释、假设性警告或推测性免责声明；细节未说明时给出临时建议并加以核实。
- 委派而非重述：依赖其他技能时直接点名，不重新总结其指令。
- 控制行数预算：SKILL.md 保持在500行以内，深度领域指南移入 references/，分步流程移入 usecases/。
- 流程文件用动词命名：如 create.md、measure.md、integrate.md，而不是主题词。
使用方式
技能内置三条执行流程：create（从零搭建并编写新技能）、revise（基于反馈更新现有技能且不产生架构漂移）、audit（对技能包运行静态验证与质量检查）。执行时还委派 poteto-principles（从第一性原理重设计、先减后加、边界纪律）、writing（直接载荷与节奏清晰）和 humanity-and-humanness（为直觉式人工反馈组织草稿）等技能。
适用场景与限制
适用于智能体技能的编写、维护与审计工作流，尤其适合需要规范一致性和自动化静态检查的团队。资料未说明具体的安装命令、运行环境、收费方式或平台支持情况，这些信息暂未提供。