UStackUStack
skills-janitor icon

skills-janitor

skills-janitor 可審核並追蹤 Claude Code 技能用量,與 9 個聚焦指令做比較,幫你找重複與缺失資訊,無需依賴。

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 目錄;這可提供自動化,但比插件的斜線指令工作流程需要更多設定。
skills-janitor | UStack