skills-janitor

O que é skills-janitor?

skills-janitor é um plugin para Claude Code que audita, rastreia o uso e compara as skills do Claude Code de um usuário. Seu propósito é ajudar a manter seu conjunto de skills organizado, identificando duplicatas, verificando erros ou informações ausentes, e resumindo quais skills você realmente invoca.

O plugin é organizado em nove ações focadas, cada uma exposta como seu próprio comando slash com autocompletar. Ele também inclui funcionalidade para buscar skills no GitHub para instalação e para comparar uma skill com similares encontrados no GitHub.

Principais Recursos

• Nove ações de auditoria expostas como skills/comandos individuais: /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search e /janitor-compare.
• Autocompletar por skill: cada ação é seu próprio comando slash, facilitando a descoberta das capacidades disponíveis diretamente na UI do Claude Code.
• Rastreamento de uso a partir do histórico de conversas: analisa o histórico de conversas para mostrar quais skills você invocou versus quais nunca usou.
• Verificações de integridade e fluxos de limpeza: inclui comandos para verificar skills por erros/informações ausentes e remover skills quebradas (operações destrutivas são preview-first via dry-run).
• Detecção de duplicatas: pode encontrar skills duplicadas que fazem efetivamente a mesma coisa.
• Descoberta e comparação de skills no GitHub: busca skills no GitHub por palavra-chave e compara sua skill com similares no GitHub.

Como Usar skills-janitor

1. Instale o plugin (um dos métodos documentados):
   • Do marketplace do Claude Code adicionando khendzel/skills-janitor, ou
   • Clone o repositório diretamente em ~/.claude/skills/skills-janitor.
2. Execute comandos via sintaxe slash. Exemplos mostrados no projeto:
   • Inventário: /janitor-audit
   • Uso: /janitor-usage
   • Busca: /janitor-search
   • Comparar: /janitor-compare
   • Validação: /janitor-check
   • Correção automática (preview-first): /janitor-fix
3. Opcionalmente use palavras-chave em linguagem natural. O plugin pode acionar skills com base em palavras-chave nas descrições de skills (exemplos incluem “audit my skills”, “which skills do I use?”, “search for n8n skills” e “compare my-skill against alternatives”).
4. Revise saídas dry-run antes de alterações. O projeto afirma que operações destrutivas usam dry-run por padrão e não deletará nada sem confirmação explícita.

Casos de Uso

• Higiene mensal de skills: gere um relatório completo das suas skills instaladas e identifique as com problemas, duplicatas ou informações ausentes usando /janitor-report e /janitor-cleanup.
• Identificar skills não usadas: execute /janitor-usage para ver quais skills são ativamente usadas versus nunca invocadas, depois decida quais remover.
• Reduzir redundância: use /janitor-duplicates para encontrar skills que fazem o mesmo trabalho e assim consolidar seu conjunto de skills.
• Depurar skills com detalhes ausentes: execute /janitor-check para revelar erros ou informações ausentes, depois siga com /janitor-fix (dry-run por padrão) para preview das alterações.
• Encontrar e comparar novas skills: busque skills no GitHub com /janitor-search e avalie alternativas com /janitor-compare antes de instalar ou atualizar sua biblioteca de skills.

FAQ

• skills-janitor deleta skills automaticamente? O projeto afirma explicitamente que nunca deletará nada sem confirmação explícita.

• Operações destrutivas são aplicadas imediatamente? O repositório afirma que operações destrutivas usam dry-run por padrão.

• Ele modifica skills de marketplace ou plugins? Afirma que nunca modifica skills de plugin/marketplace.

• No que o relatório de uso se baseia? Analisa seu histórico de conversas para determinar quais skills você invoca e quais nunca usa.

• O que preciso localmente para executar o código do plugin? Os requisitos listados são Bash, Python 3 e curl (o repositório também nota que não há instalações pip e sem módulos node).

Alternativas

• Curadoria manual de skills no Claude Code: manter suas skills organizadas revisando as skills instaladas e removendo ou atualizando seletivamente sem auditoria automatizada; isso é mais simples, mas carece de inventário estruturado, detecção de duplicatas e resumos de uso.
• Pesquisa genérica no GitHub + comparação de README: pesquisar skills no GitHub e comparar repositórios manualmente; isso pode funcionar para descoberta e comparação, mas não oferece rastreamento de uso do plugin ou verificações de integridade integradas.
• Outras ferramentas de gerenciamento de skills do Claude Code (alternativa por categoria): ferramentas que focam em organizar, validar ou listar skills disponíveis; elas podem diferir no quanto enfatizam análises de uso, detecção de duplicatas ou descoberta baseada no GitHub.
• Auditorias scriptadas com CLI personalizada: criar ou usar scripts locais para escanear seu diretório ~/.claude/skills; isso pode oferecer automação, mas exige mais configuração que o fluxo de trabalho por comandos slash do plugin.