Skill Craft 是一个用于编写、编辑和审阅智能体技能文件（SKILL.md 及相关目录）的指南型技能，来自 bmcszk/agent-skills 仓库。其核心主张是：一个技能由路由触发条件加上修复重复失败所需的最小必要流程组成，正文越短且承载同等规则越好。
用途与核心观点 该技能面向三类场景：编写或编辑任意 SKILL.md 或智能体技能文件；决定哪些内容放进技能正文、哪些放入引用文件；审阅技能质量。资料指出，标准长度的指导优于详尽文档，一次加载一到三个技能优于灌满上下文。
描述字段是路由而非文档 描述会被注入模型上下文用于每个任务，正文只在匹配时加载。描述应写成加载条件、第三人称并包含触发条件，例如“在功能分支变基与 master 冲突时，或合并后 CI 失败时使用”。应在相邻技能易混淆时加入负向触发（“不用于 X”），因为偏离目标激活是首要失败模式。需用两组提示词校准：必须触发的和近似但不应触发的，反复编辑直到双向路由正确。一次性简单任务不会触发技能。
正文的取舍 正文只保留模型无法推断的流程（确切命令、顺序、决策点）、无从得知的机构上下文（名称、路径、约定）、带有机制的注意事项（“做 X，因为否则 Y 会失败”）。通用建议属于无效负担。资料还提到低上下文预算下的做法：向委派工作者传递显式技能清单，关闭发现机制属于模式选择而非默认。
知识增量测试与自由度校准 技能必须改变行为：非显而易见的判定标准、与条件绑定的权衡、实践中习得的失败模式、顺序重要的领域流程。指令刚性应匹配任务脆弱性：创意工作给原则和示例，审阅与设计给中等自由的判定标准，脆弱操作（文件编辑、安全、迁移、外部写入）给明确步骤与验证。
渐进式披露 一个 SKILL.md 加一层深的引用文件。正文说明做什么和何时做，引用文件承载详细内容；每个引用都需在正文中写明加载条件且文件必须存在，正文提到不存在的文件会让运行卡死。引用按内容命名、单一关注点、按领域拆分；超过 300 行加目录。机械性内容优先用脚本，脚本被执行只消耗输出 token。规则屡遭违反时可用网关插件（pre_tool_call 钩子）硬性拦截。
精简与风格 正文超预算时通过移动而非删除规则来精简：只有部分运行需要的流程移入引用文件，正文保留一行指向它；硬规则即使耗 token 也留在正文。完成精简前需用 grep 检查正文中的 --flags 是否存在于工具的 argparse。风格上使用祈使语气、无叙事，术语前后一致，不写日期、工单号或事件故事，不用破折号和 AI 填充词，拼写检查组合词。
可移植性 技能应在任意仓库、任意智能体运行时、任意模型上表现一致：规则不含仓库名、机器路径或团队专用工具；描述能力而非具体客户端；流程要能撑过小模型，每行一条指令、显式 1-2-3 顺序，硬规则解释原因。
测试与质量门禁 发布前在全新会话中加载技能并在目标任务上对比有无技能的表现。机械质量门禁分两步：先运行结构性门禁 skillscheck（命令为 uvx skillscheck <skills-dir>），检查 frontmatter、代码围栏、断链、token 预算、引用嵌套、密钥泄漏、孤儿文件和适配器规则；再运行 scripts/skill-lint.py 检查正文风格与项目内容泄漏。随后按硬阻塞、风格清扫、路由、内容差异分类处理，修复后复跑两门禁并验证 YAML、确保行预算低于 500，才提交或开 PR。第三方安装的技能只报告上游问题，不在原地修复。
附加流程 资料还给出多 PR 合并为单一分支的 git 做法，以及从 ~/.agents/skills 同步安装内容的增量流程：导出 origin/master 树、归一化后逐技能比较、过滤风格差异、保留安装独有内容并作为单个 PR 提交。这些内容属于操作流程描述，具体命令以资料为准。