Skills Janitor icon

Skills Janitor

Skills Janitor 是一组托管于 GitHub 的斜杠命令,用于审计、跟踪和管理 Claude Code 与 OpenAI Codex skills。可查找重复项、损坏链接和未使用的 skills,并用独立命令清理。

Skills Janitor

概述

Skills Janitor 是一个 GitHub 仓库,打包了用于审计、跟踪和管理 Claude Code 与 OpenAI Codex skills 的斜杠命令。其文档化用途是帮助用户查看 skills 存放位置、识别重复项或损坏的符号链接,并清理会给工作上下文带来噪音的未使用项目。

该项目围绕独立的 skill 文件夹和脚本组织,既支持 Claude Code 插件工作流的安装路径,也支持直接克隆。README 还说明它零依赖,Bash、Python 3 和 curl 是其声明的运行时要求。

核心能力

技能审计

为 skills 建立清单,并标记重复项、损坏的符号链接,以及用户、项目、codex 和插件安装的 skills 中的其他杂项。

修复与清理

在需要使用修复命令时执行自动清理操作,包括清除损坏的符号链接和空目录。

使用与价值视图

以统一视图展示 token 和使用浪费,方便按成本或杂项对 skills 排序,而无需逐个手动检查。

技能发现

允许先在 GitHub 上搜索 skills,或在安装前验证 URL,适合先发现再安装的工作流。

跨工具兼容性

支持 Claude Code 和 OpenAI Codex;每个命令都打包为自包含的 `SKILL.md` 以及对应的脚本。

向后兼容的命令集

跟踪 v1.2 到 v1.3 的命令重命名,并在过渡期内保留旧命令作为已弃用别名。

常见用例

  • 审计现有 skills 设置

    运行健康检查来盘点 skills、发现重复项,并在它们给工作区带来混淆之前暴露损坏的符号链接。

  • 清理陈旧或无效的 skills

    在识别出应删除的杂项后,使用修复工作流清除损坏的链接和空目录。

  • 查看 skills 使用情况与浪费

    对比各个 skills 的 token 和使用浪费,以决定哪些应保持启用、哪些应合并。

  • 发现并验证新 skills

    当你想以更少猜测安装新内容时,先在 GitHub 上搜索 skill,或先验证 URL。

  • 采用较新的命令集

    按照文档中的 v1.2 到 v1.3 重命名进行迁移,同时在过渡期间继续使用已弃用别名。

Pros and Cons

Pros

  • 覆盖多个 skills 范围,包括用户、项目、codex 和插件安装的 skills。
  • 同时提供报告和修复工作流,因此你可以先检查问题再修复。
  • 包含 discover 命令,可在安装前于 GitHub 上查找 skills 或检查 URL。
  • 不使用包管理器依赖,安装保持轻量。
  • 记录了已弃用别名,以减少 v1.2 到 v1.3 过渡期间的干扰。

Cons

  • README 没有提供独立的 Web 应用或托管服务;它是一个基于仓库的工具,需要在你自己的环境中安装和运行。
  • 命令列表和命名从 v1.2 改到了 v1.3,因此现有用户需要遵循迁移说明。

FAQ

Skills Janitor 做什么?

这是面向 Claude Code 和 OpenAI Codex 的一组斜杠命令,用于审计 skills、报告重复项和损坏链接、帮助修复问题,并在安装前搜索新 skills。

它支持哪些工具?

README 说明它可与 Claude Code 和 OpenAI Codex 配合使用,安装示例展示了 `/plugin marketplace add khendzel/skills-janitor` 以及克隆到 Claude skills 目录这两种方式。

它包含多少个命令?

README 中的当前发布说明描述了七个斜杠命令。该页面还指出,v1.2 的五个命令会继续以已弃用别名的形式保留到 v1.4。

它需要额外安装依赖包吗?

不需要。该仓库将其描述为零依赖,并列出 Bash、Python 3 和 curl 作为要求。

有从 v1.2 迁移的路径吗?

README 指向 `CHANGELOG.md` 查看完整发布说明,并说明 v1.2 到 v1.3 的命令重命名会以已弃用别名的形式保留到 v1.4。

Quick Facts

类别
开发者工具
来源
github.com/khendzel/skills-janitor
主要环境
Claude Code 和 OpenAI Codex
安装方式
插件市场添加、直接克隆,或安装到 Claude skills 目录
要求
Bash、Python 3 和 curl
价格
开源 GitHub 仓库;GitHub 定价页面显示有免费和付费账户方案,但此项目本身未列出产品价格