用途:指导创建 Claude Code 技能,把技能写作视为需要实证验证的流程文档,而非纯理论说明。核心是 TDD 与合规研究中的说服原则。
主要能力:提出“铁律”——没有失败测试就不写技能,每个技能须先记录 Claude 在无该技能时的失败证据。将技能分为三类:Technique(具体方法)、Pattern(可复用方案)、Reference(速查与清单)。提供描述优化公式:[做什么]+[何时用]+[关键触发],用第三人称、具体用例,避免营销化措辞。
使用方式:TDD 循环分 RED(记录基线失败,至少三个压力场景)、GREEN(最小实现,写 SKILL.md 与 frontmatter)、REFACTOR(强化触发,加入例外表、红旗清单等反合理化措施)。可用命令:python scripts/skill_analyzer.py、python scripts/token_estimator.py、python scripts/abstract_validator.py --check。技能可用 ${CLAUDE_SKILL_DIR} 引用自身目录。
适用场景:新技能开发、技能描述优化、技能结构验证与部署前检查。
限制:不用于评估已有技能、编写 hook、验证技能触发。部署前须完成三阶段并记录,frontmatter 有效、描述优化、行数低于 500 行、模块引用有效且含至少一个具体示例。所有 markdown 须通过 scribe 校验(slop 分数低于 2.5、路径与命令可运行、项目符号与散文比例低于 60%)。描述字符预算随上下文窗口缩放(200K 约 4000 字符,1M 约 20000 字符),但仍应简洁。2.1.33+ 插件名自动显示,勿在描述中重复。2.1.69+ 修复描述含冒号需加引号的问题,无 description 字段的技能也会出现在列表中。具体收费、价格、平台等信息暂未提供。