Better Skill Creator 是一套面向 AI Agent 技能制作的创作方法论与工具集，用于构建能可靠触发、干净完成工作流并与其他技能良好共存的技能。
用途 它解决的核心问题是技能质量：不只是产出合法的 YAML，而是让技能在正确的时机被激活、不被无关请求误触发、能独立跑完流程，并且能和其他技能组合使用。其基本观点是：description 是技能面向 Agent 的接口，技能不触发就等于技能不存在，触发错误的场景会造成混乱，因此描述必须首先写对。
主要能力 1）用例画布：在写 SKILL.md 之前先填写技能名称、至少两个用例（各自的触发短语、步骤 1→2→3、预期输出）、依赖（API 密钥、Python 包、外部服务）与成功标准。若无法填出两个带具体触发短语的用例，说明技能尚不具备构建条件，应要求用户澄清。 2）需求理解：判断技能是 API 集成、工作流自动化、知识领域还是元工具；映射用户会说的确切短语作为 description 来源；判断自由度（高自由度用自然语言指导，中自由度用伪代码加关键参数，低自由度用 scripts/ 中的脚本经 bash 执行）；并提前定义成功标准。 3）脚手架：使用 python skills/skill-creator/scripts/init_skill.py my-new-skill --path ./skills 创建技能；可加 --resources scripts,references 生成资源目录。 4）编写 SKILL.md：给出 description 撰写公式（[做什么] + [在何时使用]），示例与反例，硬性限制（最多 1024 字符、不得出现 XML 标签 < >、不得使用 claude/anthropic 等名称）；frontmatter 模板包含 name（小写连字符，2-64 字符）、version（semver）、description、author、tags，以及 metadata.starchild 下的 emoji、skillKey、requires.env/bins/anyBins、install（pip/apt 等），另有 user-invocable。正文结构可选工作流型、任务型、参考/指南型、能力型；写作面向 Agent 而非用户；应包含领域知识、决策树、边界情况与关键阈值，排除工具参数文档、通用编程建议、README/变更日志。 5）链上技能前置条件：若涉及交易、授权、兑换、跨链、签名等操作，必须先加载 wallet-policy 技能并提议标准通配策略（拒绝密钥导出并允许 *）。 6）可组合性检查：检查工具名冲突、description 与其他技能重叠、是否硬编码其他技能的存在假设、与所替代技能同时加载是否出问题。 7）成功标准：量化指标包括对用例画布中查询的触发率 ≥90%、对无关查询的误触发 ≤5%、在预期工具调用次数内完成流程、因参数错误导致的 API 调用失败为零；定性指标包括用户无需中途纠正、相同输入输出一致、可与其他技能并行。 8）验证：语法校验命令 python skills/skill-creator/scripts/validate_skill.py ./skills/my-new-skill，检查 frontmatter 结构、必填字段、TODO 占位符、正文长度与字段位置；行为测试需运行用例画布中的 3 个以上测试用例，并对照典型失败模式（从不触发、误触发、流程中断、首次可行二次失败、与其他技能冲突）与其修复方式；还给出应测试的边界情况。 9）刷新与确认：执行 skill_refresh() 后跑最后一次测试确认加载、触发与完成。 10）结构规范与上下文预算：SKILL.md（frontmatter + 核心指令，< 500 行，每次激活加载）、scripts/（执行而非读取，无上下文成本）、references/（按需读取）、assets/（从不进入上下文）。 11）发布到技能市场：给出发布前检查清单（命名、semver 且发布后不可变、description 符合公式、author 与 tags、无 TODO 占位符、校验通过、行为测试通过、description 无 XML 标签）以及获取 OIDC token 与 POST /skills/publish 的完整命令；版本发布后不可变，重新发布前需升级到 1.0.1。
使用方式 按阶段推进：先填用例画布，再理解需求，随后脚手架、写 SKILL.md、定义成功标准、验证（语法与行为）、最后刷新并确认；准备共享时按预检清单发布。
适用场景 适用于需要为 Agent 平台创作、校验与发布技能的开发者，尤其适合希望提升技能触发准确率与多技能协同性的场景，也覆盖链上操作类技能的钱包策略前置要求。
限制 资料未提供该技能自身的收费、价格、平台支持范围或效果数据，暂未提供相关信息；description 最多 1024 字符且不得含 XML 标签；SKILL.md 建议不超过 500 行；版本发布后不可变；不得硬编码 API 密钥。