Skills Janitor

Skills Janitor：优化与管理 Claude Code 技能的终极解决方案

在开发 AI 智能体的过程中，保持技能（Skills）生态系统的整洁与高效至关重要。Skills Janitor 是一款专为 Claude Code 设计的开源插件，旨在帮助开发者审计、追踪使用情况并对比各种技能。它包含 9 项专注的技能功能，且具有零依赖（zero dependencies）的特性，是维护 Claude Code skills 健康运行的必备利器。

什么是 Skills Janitor？

Skills Janitor 是一个集成在 Claude Code 环境中的强大工具包（Plugin）。它的核心使命是保持您的技能生态系统清洁、有序且健康。无论您是需要清理过时的代码片段，还是想要分析哪些 Claude Code skills 真正发挥了作用，Skills Janitor 都能通过其内置的 9 个核心动作提供全方位支持。

该项目托管于 GitHub，由 khendzel/skills-janitor 维护，采用 MIT 开源协议。其设计理念是轻量化，仅依赖 Bash、Python 3 和 curl，无需安装额外的 pip 或 node 模块。

Skills Janitor 的核心功能 (Features)

Skills Janitor 提供了丰富的功能集，每个功能都有专用的斜杠命令（slash command）和自动补全支持：

• 技能审计 (Audit)：使用 /janitor-audit 显示所有已安装的技能清单，让您对本地环境一目了然。
• 重复项检测 (Duplicates)：通过 /janitor-duplicates 查找执行相同任务的重复技能，优化系统效率。
• 错误检查与修复：
  • /janitor-check：检查技能是否存在错误或缺失信息。
  • /janitor-fix：自动修复技能问题（默认提供安全预览/干跑模式）。
• 清理与报告：
  • /janitor-cleanup：识别并移除破损或无效的技能。
  • /janitor-report：生成一站式的技能健康状况完整报告。
• 使用追踪 (Usage Tracking)：通过 /janitor-usage 分析对话历史，量化哪些 Claude Code skills 被频繁调用，哪些处于闲置状态。
• 技能发现与对比：
  • /janitor-search：直接在 GitHub 上通过关键词搜索新的技能。
  • /janitor-compare：将您的本地技能与 GitHub 上的替代方案进行市场化对比分析。

如何安装 (Install)

您可以根据需求选择以下两种安装 Skills Janitor 的方式：

方式一：插件市场安装（推荐）

在您的 Claude Code 终端执行：

/plugin marketplace add khendzel/skills-janitor
/plugin install skills-janitor

方式二：直接克隆仓库

如果您希望手动管理，可以使用 Git 将其克隆到本地技能目录：

git clone https://github.com/khendzel/skills-janitor ~/.claude/skills/skills-janitor

如何使用 (How to Use)

Skills Janitor 提供了极高的灵活性，支持命令调用和自然语言交互：

1. 使用斜杠命令

每个技能都配备了带自动补全的命令，例如：

• /janitor-audit → 获取完整技能库存。
• /janitor-usage → 查看实际调用的技能统计。
• /janitor-search → 查找 GitHub 上的新资源。

2. 使用自然语言触发

由于技能描述中包含了关键词，您可以直接对 Claude 说：

"帮我审计一下现有的技能" "我最近都使用了哪些技能？" "搜索关于 n8n 的技能" "对比 my-skill 和网上的替代方案"

3. 使用追踪报告示例

执行使用追踪后，您会看到类似下方的报告：

• 统计周期：过去 4 周
• 活跃技能：11%
• 未用技能：89% (建议移除 32 个未使用的技能)
• 最常使用：n8n-workflows

应用场景 (Use Case)

• 开发者环境优化：当您安装了过多的 Claude Code skills 导致响应变慢或逻辑混乱时，使用 Skills Janitor 进行清理。
• 技能性能评估：通过使用报告（Usage Report）识别生产力瓶颈，只保留真正有用的工具。
• 开源技能调研：在开发新功能前，先通过 /janitor-search 和 /janitor-compare 看看 GitHub 上是否已有成熟的实现。
• 自动化维护：利用 /janitor-fix 定期修复因配置更新导致的技能失效问题。

常见问题 (FAQ)

Q: Skills Janitor 会自动删除我的技能吗？ A: 不会。Skills Janitor 遵循安全第一原则，未经明确确认绝不删除任何内容。所有破坏性操作默认执行“干跑”（Dry-run）预览。

Q: 它会修改我从市场下载的其他插件吗？ A: 不会。它从不修改插件或市场类技能，只针对本地开发和管理的技能进行优化。

Q: 搜索 GitHub 技能时有限制吗？ A: 为了获得更好的搜索结果和更高的访问频率限制，建议设置 GITHUB_TOKEN 环境变量。

Q: 它的运行环境要求是什么？ A: 只需要系统安装有 Bash、Python 3 和 curl 即可，无需复杂的 node_modules 或 python 库环境。

---

通过使用 Skills Janitor，您可以确保您的 Claude Code 环境始终保持在巅峰状态，无论是管理 agent-skills 还是进行 cli productivity 提升，它都是开发者不可或缺的辅助工具。