mcpField
S
skill-auditor

skill-auditor

github.com/majesticlabs-devAgent 工作流5047 次安装7 周前更新
代码仓库

关于 skill-auditor

Skill Auditor 用于审查全局、项目和插件目录中的 Claude 技能。它统计技能大小与元数据,再对选定技能检查简洁度、清晰度、范围重叠和结构。

主要功能

  1. 01扫描三个位置的技能文件
  2. 02统计元数据和行数
  3. 03按大小与状态排序
  4. 04检查简洁度、清晰度和重叠
  5. 05汇总发现与改进优先级

适用场景

  1. 01查找超过行数限制的技能
  2. 02挑选大型技能进行详细审查
  3. 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