O que donald-agent-hygiene faz?
Audita e limpa skills/MCP/hooks/memória do Claude Code e Codex — higiene orientada por uso com relatório HTML, aplicação segura (dry-run + backup) e servidor local de execução com um clique.
Visão Geral
Este skill analisa seu ambiente Claude Code (e Codex) para:
- Listar todas as skills instaladas, MCP servers, hooks e arquivos de memória.
- Verificar o histórico de uso de cada skill com base nos logs de habilidade.
- Gerar um relatório HTML interativo mostrando skills usadas, skills órfãs e recomendações.
- Executar a limpeza de forma segura: dry-run primeiro, backup automático, e então mover skills não utilizadas para um diretório
disabled/. - Iniciar um servidor local (Python ou Node.js) para executar a limpeza com um clique no navegador.
Como Usar
# Se você tem Python
python audit_skills.py
# Se você tem Node.js
node audit_skills.mjs
O script:
- Escaneia
~/.claude/skills/,~/.claude/hooks/, e configurações MCP. - Verifica
~/.claude/claude.jsone~/.claude/logs/para uso. - Gera
relatorio-higiene.html. - Oferece aplicar alterações: dry-run primeiro, depois backup, depois mover skills.
Recursos
- Relatório HTML: Visualização limpa com tabelas e status de uso.
- Dry-run: Simula alterações sem modificar nada.
- Backup: Cria diretório
.agenthygiene-backups/com timestamp. - Servidor local:
python servidor.pyounode servidor.mjs— abre em http://localhost:8765. - Suporte a múltiplas fontes: skills do Claude Code nativo, pasta
skills/, hooks, MCP config.
Requisitos
- Claude Code ou Codex instalado.
- Python 3.7+ ou Node.js 16+.
- Sistema macOS ou Linux.
Arquivos de Configuração
| Caminho | Descrição |
|---|---|
~/.claude/skills/ | Diretório de skills do Claude Code |
~/.claude/hooks/ | Diretório de hooks |
~/.claude/claude.json | Configuração principal (inclui MCP servers) |
Exemplo de Uso
# Auditar e gerar relatório
python audit_skills.py --report
# Aplicar limpeza (com confirmação)
python audit_skills.py --apply
# Iniciar servidor web
python servidor.py