关于 skill-auditor
Skill Auditor 用于审查全局、项目和插件目录中的 Claude 技能。它统计技能大小与元数据,再对选定技能检查简洁度、清晰度、范围重叠和结构。
主要功能
- 01扫描三个位置的技能文件
- 02统计元数据和行数
- 03按大小与状态排序
- 04检查简洁度、清晰度和重叠
- 05汇总发现与改进优先级
适用场景
- 01查找超过行数限制的技能
- 02挑选大型技能进行详细审查
- 03确定技能精简工作的优先顺序
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill skill-auditor安装后在 Claude Code 中输入/skill-auditor确认已加载。
详细介绍
技能审计员
工作流
步骤 1:发现所有技能
扫描以下位置中的 SKILL.md 文件:
| 级别 | 路径 |
|---|---|
| 全局 | ~/.claude/skills/*/SKILL.md |
| 项目 | .claude/skills/*/SKILL.md |
| 插件 | plugins/*/skills/*/SKILL.md |
对于找到的每项技能,收集:
- 名称:取自 frontmatter 中的
name:字段(若无,则使用目录名) - 级别:global / project / plugin(插件技能需注明插件名称)
- 行数:
SKILL.md的总行数 - 是否包含 allowed-tools:是/否
- 描述长度:
description:字段的字符数
步骤 2:呈现汇总表
按行数降序排序。格式:
| # | Level | Plugin | Skill Name | Lines | Status |
状态标记:
OVER— 超过 500 行限制HEAVY— 300–499 行(接近限制)OK— 少于 300 行
包含以下统计:
- 各级别的技能总数
- 所有技能的总行数
- 每项技能的平均行数
- 超出限制的技能
步骤 3:让用户选择
使用 AskUserQuestion 询问要审查哪些技能。建议选项:
- 所有标记为 OVER 或 HEAVY 的技能
- 按行数排序最大的前 5 项技能
- 按插件名称审查
- 审查指定级别的所有技能
步骤 4:深入审查(针对每项选定的技能)
完整阅读每项选定的技能。根据以下标准进行评估:
简洁性(令牌效率)
- 不会改变大模型行为的行(冗余内容、出处说明、角色设定)
- 对 Claude 已经了解的概念所作的冗余解释
- 可以压缩的冗长示例
- 重复 CLAUDE.md 规则的章节
清晰度
- 可能产生多种解读的模糊指令
- 导致 Claude 不得不猜测的上下文缺失
- 技能内部术语不一致
范围重叠
- 将技能的用途与同级别的其他技能进行比较
- 标记涵盖内容大致相同的技能
- 找出适合合并或拆分的候选项
结构
- Frontmatter 是否完整(name、description、allowed-tools)
- 描述质量(过短 = 不易发现;过长 = 浪费)
- 章节组织(是否遵循市场惯例?)
步骤 5:报告发现
对于每项审查的技能,输出:
## {skill-name} ({lines} lines)
**Verdict:** {TRIM | RESTRUCTURE | MERGE | OK}
**Issues:**
- [CONCISENESS] {specific finding with line reference}
- [CLARITY] {specific finding}
- [OVERLAP] overlaps with {other-skill}: {shared scope}
**Suggested savings:** ~{N} lines ({percentage}% reduction)
**Recommended actions:**
1. {specific action}
2. {specific action}
步骤 6:汇总
完成所有审查后,提供:
- 预计可减少的总行数
- 建议合并的技能(并说明理由)
- 改进优先级(按节省令牌数量从高到低排序)
评论
支持 Markdown