UStackUStack
skills-janitor icon

skills-janitor

skills-janitor 插件用于审计和跟踪 Claude Code 技能使用情况,并与九个聚焦的斜杠命令进行对比,零依赖。

skills-janitor

skills-janitor 是什么?

skills-janitor 是 Claude Code 的插件,用于审计、跟踪使用情况并比较用户的 Claude Code 技能。其目的是帮助您保持技能集井井有条,通过识别重复项、检查错误或缺失信息,以及总结您实际调用的技能。

插件组织为九个专注操作,每个操作以独立的斜杠命令形式提供,并支持自动补全。它还包括搜索 GitHub 以安装技能的功能,以及将技能与 GitHub 上类似技能进行比较的功能。

主要功能

  • 九个审计操作作为独立技能/命令:/janitor-audit、/janitor-duplicates、/janitor-check、/janitor-fix、/janitor-cleanup、/janitor-report、/janitor-usage、/janitor-search 和 /janitor-compare。
  • 每个技能的自动补全:每个操作都是独立的斜杠命令,便于在 Claude Code UI 中直接发现可用功能。
  • 从对话历史中跟踪使用情况:解析对话历史,显示您调用的技能与从未使用的技能。
  • 完整性检查和清理工作流:包括检查技能错误/缺失信息的命令,以及移除损坏技能的命令(破坏性操作默认预览,通过 dry-run)。
  • 重复项检测:可找到功能相同的重复技能。
  • GitHub 上的技能发现和比较:通过关键字搜索 GitHub 上的技能,并将您的技能与 GitHub 上类似技能比较。

如何使用 skills-janitor

  1. 安装插件(使用文档中记录的方法之一):
    • 从 Claude Code 市场添加 khendzel/skills-janitor,或
    • 直接克隆仓库到 ~/.claude/skills/skills-janitor
  2. 通过斜杠语法运行命令。项目中展示的示例:
    • 清单/janitor-audit
    • 使用情况/janitor-usage
    • 搜索/janitor-search
    • 比较/janitor-compare
    • 验证/janitor-check
    • 自动修复(默认预览)/janitor-fix
  3. 可选:在自然语言中使用关键字。插件可根据技能描述中的关键字触发技能(示例包括“audit my skills”、“which skills do I use?”、“search for n8n skills”和“compare my-skill against alternatives”)。
  4. 在更改前审阅 dry-run 输出。项目声明破坏性操作默认使用 dry-run,且不会在没有明确确认的情况下删除任何内容。

使用场景

  • 每月技能维护:使用 /janitor-report 和 /janitor-cleanup 生成已安装技能的完整报告,并识别有问题、重复或缺失信息的技能。
  • 发现未使用技能:运行 /janitor-usage 查看活跃使用的技能与从未调用的技能,然后决定移除哪些。
  • 减少冗余:使用 /janitor-duplicates 找到执行相同任务的技能,以便整合您的技能集。
  • 调试缺失细节的技能:运行 /janitor-check 发现错误或缺失信息,然后使用 /janitor-fix(默认 dry-run)预览更改。
  • 查找和比较新技能:使用 /janitor-search 在 GitHub 上搜索技能,并使用 /janitor-compare 评估备选方案,然后安装或更新您的技能库。

常见问题

  • skills-janitor 会自动删除技能吗? 项目明确声明它绝不会在没有明确确认的情况下删除任何内容

  • 破坏性操作会立即应用吗? 仓库声明破坏性操作默认使用 dry-run

  • 它会修改市场或插件提供的技能吗? 它声明绝不会修改插件/市场技能

  • 使用报告依赖什么?解析您的对话历史,以确定您调用的技能与从未使用的技能。

  • 本地运行插件代码需要什么? 列出的要求是 Bash、Python 3 和 curl(仓库还注明无需 pip 安装无 node 模块)。

替代方案

  • Claude Code 中的手动技能整理:通过审查已安装技能并选择性移除或更新来保持技能组织;这更简单,但缺少结构化清单、重复检测和使用摘要。
  • 通用 GitHub 搜索 + README 比较:在 GitHub 上搜索技能并自行比较仓库;这适用于发现和比较,但无法提供插件的使用跟踪或内置健康检查。
  • 其他 Claude Code 技能管理工具(类别替代):专注于组织、验证或列出可用技能的工具;这些工具在是否强调使用分析、重复检测或 GitHub 支持的发现方面可能有所不同。
  • 使用自定义 CLI 的脚本化审计:构建或使用本地脚本扫描您的 ~/.claude/skills 目录;这可提供自动化,但比插件的斜杠命令工作流需要更多设置。