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 存放位置、找出重複項或失效的 symlink,並清理會為工作脈絡帶來雜訊的未使用項目。

此專案圍繞著獨立的 skill 資料夾與腳本進行組織,並提供 Claude Code 外掛工作流程與直接複製兩種安裝路徑。README 也說明它零依賴,並將 Bash、Python 3 與 curl 列為指定的執行需求。

核心功能

skills 稽核

建立 skills 清單,並標示跨使用者、專案、codex 與外掛安裝的 skills 中的重複項、失效 symlink 與其他雜項。

修復與清理

在需要使用 fix 指令時,執行自動清理動作,包括修剪失效 symlink 與空目錄。

使用與價值檢視

以整合檢視呈現 token 與使用浪費,讓你能依成本或雜亂程度排序 skills,而不必逐一手動檢查。

skills 探索

可在安裝前於 GitHub 搜尋 skills 或驗證 URL,符合先探索再安裝的流程。

跨工具相容性

支援 Claude Code 與 OpenAI Codex,每個指令都打包為獨立的 `SKILL.md` 加上一個相鄰腳本。

向後相容的指令集

追蹤 v1.2 到 v1.3 的指令重新命名,並在過渡期間保留舊指令作為已棄用別名。

常見使用情境

  • 稽核現有 skills 設定

    執行健康檢查來建立 skills 清單、找出重複項,並在它們於工作區造成混亂之前顯示失效 symlink。

  • 清理過時或無效的 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 未提供獨立的網頁應用程式或代管服務;它是一個以儲存庫為基礎的工具,需要安裝並在自己的環境中執行。
  • 指令清單與命名在 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 定價頁面顯示有免費與付費帳號方案,但此專案本身未列出產品價格