用途：这是一个关于“如何编写与维护 Agent Skills”的技能，用于稳定代理执行不可靠的流程，而非存放模型已掌握的知识或文档。价值集中在过程锚定：设置顺序、工具调用次序、能捕获特定失败的检查。
主要能力与原则：只在该流程无技能时模型会失败的地方编写技能；一个技能对应一次用户请求能命名的流程。必须始终成立的禁止项放在 hook；需要干净上下文并返回摘要的工作放子代理；外部系统连接放工具或服务器。技能承载流程，工具承载能力。
路由元数据：description 是唯一始终在上下文中的部分。使用“[动词] [做什么]。Use when [触发条件]。”的形式，区分相邻技能边界，前置用例并控制在 250 字符内，用用户会输入的词写触发条件，路由信息不放正文。
内容取舍：优先写反面规则与 gotcha，而非教程；编码仓库、框架或服务本地知识；删除模型已会做的事；给一个默认值加逃生出口，不给菜单。按脆弱度校准规定性：顺序或标志错误会导致不可自动恢复损害时（迁移序列、破坏性操作、已发布产物）才规定精确步骤，其余给约束而非步骤。面向前沿模型时省略完整示例，可保留输出模板。
加载拆分：正文每次激活都加载并留在上下文，捆绑文件在被读取前无成本。正文只保留每次运行都适用的内容，条件内容放捆绑文件，并在条件出现处说明加载条件；参考文件保持一层深度并按内容命名，模板与静态资源放 assets/。确定性操作或反复被重新发明的操作可捆绑脚本，脚本代码不进上下文，仅输出进上下文；执行意图必须明确。
验证与维护：每次变更运行宿主的校验器，但它不预测技能是否有用。在依赖前分别测量激活与行为，均对照无技能基线、在全新会话中进行；有宿主评估工具则用，没有就说明未测量。检查新规则与已加载规则是否冲突，在全新上下文或换模型测试。按任务不确定性、变更规模和风险设定验证条件。模型或宿主升级后重新测量；技能会不经编辑而衰减。效用与模型绑定，一对技能-任务可能在一个模型上有帮助、在另一个上有害。停止产生价值的技能应删除。
打包与跨宿主：资料提到六字段可移植契约、插件包格式、额外 frontmatter 可能导致硬错误、分发范围，详见 references/portability.md；宿主行为（完整 frontmatter 字段集、列表预算与截断顺序、内容生命周期与压缩限制、调用控制、每轮权限、替换、动态上下文注入、分叉执行、优先级、版本门）详见 references/claude-code.md；评估（触发集、近似反面例、断言设计、评分、迭代循环与工具）详见 references/evaluation.md；安全（不应发布的内容、审查第三方技能、扫描器盲点、已检入技能带来的权限风险）详见 references/security.md。限制：具体命令、完整模板与各宿主字段值未在给定资料中提供，需查阅相应参考文件；原文未给出收费或价格信息。