skills-janitor

¿Qué es skills-janitor?

skills-janitor es un plugin para Claude Code que audita, registra el uso y compara las habilidades de Claude Code de un usuario. Su propósito es ayudarte a mantener tu conjunto de habilidades organizado identificando duplicados, verificando errores o información faltante, y resumiendo qué habilidades invocas realmente.

El plugin está organizado en nueve acciones enfocadas, cada una expuesta como su propio comando slash con autocompletado. También incluye funcionalidad para buscar habilidades en GitHub para instalar y comparar una habilidad con otras similares encontradas en GitHub.

Características principales

• Nueve acciones de auditoría expuestas como habilidades/comandos individuales: /janitor-audit, /janitor-duplicates, /janitor-check, /janitor-fix, /janitor-cleanup, /janitor-report, /janitor-usage, /janitor-search y /janitor-compare.
• Autocompletado por habilidad: cada acción es su propio comando slash, lo que facilita descubrir las capacidades disponibles directamente en la interfaz de Claude Code.
• Seguimiento de uso desde el historial de conversaciones: analiza el historial de conversaciones para mostrar qué habilidades invocaste versus cuáles nunca usaste.
• Verificaciones de integridad y flujos de limpieza: incluye comandos para verificar habilidades en busca de errores/información faltante y eliminar habilidades rotas (operaciones destructivas con vista previa mediante dry-run).
• Detección de duplicados: puede encontrar habilidades duplicadas que hacen efectivamente lo mismo.
• Descubrimiento y comparación de habilidades en GitHub: busca habilidades en GitHub por palabra clave y compara tu habilidad con otras similares en GitHub.

Cómo usar skills-janitor

1. Instala el plugin (uno de los métodos documentados):
   • Desde el marketplace de Claude Code agregando khendzel/skills-janitor, o
   • Clona el repositorio directamente en ~/.claude/skills/skills-janitor.
2. Ejecuta comandos mediante sintaxis slash. Ejemplos mostrados en el proyecto:
   • Inventario: /janitor-audit
   • Uso: /janitor-usage
   • Búsqueda: /janitor-search
   • Comparación: /janitor-compare
   • Validación: /janitor-check
   • Reparación automática (vista previa primero): /janitor-fix
3. Opcionalmente usa palabras clave en lenguaje natural. El plugin puede activar habilidades basadas en palabras clave en descripciones de habilidades (ejemplos incluyen “audit my skills”, “which skills do I use?”, “search for n8n skills” y “compare my-skill against alternatives”).
4. Revisa salidas dry-run antes de cambios. El proyecto indica que las operaciones destructivas usan dry-run por defecto y no eliminará nada sin confirmación explícita.

Casos de uso

• Higiene mensual de habilidades: genera un informe completo de tus habilidades instaladas e identifica aquellas con problemas, duplicados o información faltante usando /janitor-report y /janitor-cleanup.
• Identificar habilidades no usadas: ejecuta /janitor-usage para ver qué habilidades se usan activamente versus nunca invocadas, luego decide cuáles eliminar.
• Reducir redundancia: usa /janitor-duplicates para encontrar habilidades que realizan el mismo trabajo y así consolidar tu conjunto de habilidades.
• Depurar habilidades con detalles faltantes: ejecuta /janitor-check para detectar errores o información faltante, luego sigue con /janitor-fix (dry-run por defecto) para previsualizar cambios.
• Encontrar y comparar nuevas habilidades: busca habilidades en GitHub con /janitor-search y evalúa alternativas con /janitor-compare antes de instalar o actualizar tu biblioteca de habilidades.

Preguntas frecuentes

• ¿skills-janitor elimina habilidades automáticamente alguna vez? El proyecto indica explícitamente que nunca eliminará nada sin confirmación explícita.

• ¿Se aplican las operaciones destructivas inmediatamente? El repositorio indica que las operaciones destructivas usan dry-run por defecto.

• ¿Modificará habilidades del marketplace o proporcionadas por plugins? Indica que nunca modificará habilidades de plugins/marketplace.

• ¿En qué se basa el informe de uso? Analiza tu historial de conversaciones para determinar qué habilidades invocas y cuáles nunca usas.

• ¿Qué necesito localmente para ejecutar el código del plugin? Los requisitos listados son Bash, Python 3 y curl (el repositorio también nota que no hay instalaciones de pip y no hay módulos de node).

Alternativas

• Curación manual de habilidades en Claude Code: mantener tus habilidades organizadas revisando las habilidades instaladas y eliminándolas o actualizándolas selectivamente sin auditoría automatizada; es más simple, pero carece de inventario estructurado, detección de duplicados y resúmenes de uso.
• Búsqueda genérica en GitHub + comparación de README: buscar habilidades en GitHub y comparar repositorios manualmente; puede servir para descubrimiento y comparación, pero no ofrece seguimiento de uso del plugin ni verificaciones de salud integradas.
• Otras herramientas de gestión de habilidades de Claude Code (alternativa por categoría): herramientas enfocadas en organizar, validar o listar habilidades disponibles; pueden diferir en si enfatizan análisis de uso, detección de duplicados o descubrimiento respaldado por GitHub.
• Auditorías con scripts usando un CLI personalizado: crear o usar scripts locales para escanear tu directorio ~/.claude/skills; puede ofrecer automatización, pero requiere más configuración que el flujo de trabajo de slash-command del plugin.