用途:审计技能(skills)的 token 效率与渐进式披露(progressive disclosure)合规性,适用于用户想分析技能 token、审计技能或优化技能的场景。
主要能力:提供三个脚本。analyze-skill.sh 审计单个技能的 token 占用;audit-all-skills.sh 批量审计整个技能目录并生成 audit-report.json(含每个技能的评分);validate-skill.sh 检查结构与合规性。
使用方式:审计单个技能执行 ./scripts/analyze-skill.sh ~/.claude/skills/my-skill,输出 token 数、违规项和建议;批量审计执行 ./scripts/audit-all-skills.sh ~/.claude/skills。优化流程为:用 wc -w SKILL.md 测量(目标少于 2000 词)、识别违规、应用修复、再用 validate-skill.sh 校验。
校验要点:L1 描述少于 1024 字符且含触发词;L2 的 SKILL.md 少于 500 行并含导航指南;L3 及以上细节放入独立文件;避免深层嵌套(距 SKILL.md 仅一层);避免“voodoo constants”(解释 Claude 已知内容)。三级披露模型:L1 元数据约 200 字符,启动时加载全部技能;L2 的 SKILL.md 少于 500 行,技能触发时加载;L3 嵌套文档按需访问。
常见违规与修复:描述臃肿(超 1024 字符)需精简并前置关键词;voodoo constants 直接删除;内联代码块超 50 行移至 scripts/;深层嵌套 A→B→C 扁平化为一层。
额外检查:对提及 hub、router 或 routes to...skills 的技能自动检测 R001-R005(快速参考表含 Risk 列、Risk Legend、Negative Triggers、消歧示例、上下文感知);对含 scripts/ 目录的技能检测 K001-K003(破坏性脚本带 ⚠️、批量操作标 ⚠️⚠️、高风险操作记录 --dry-run)。风险等级:安全(search、list、get、export)无需防护;破坏性(create、update、delete)需确认;高风险(批量操作、管理变更)需确认加 dry-run。
限制:资料未提供安装方式、依赖环境、支持的平台及收费信息。