vault-cleanup-auditor

Descripción general de vault-cleanup-auditor

Qué hace vault-cleanup-auditor

El skill vault-cleanup-auditor audita un vault de Obsidian en Claude Code y genera un informe de limpieza con fecha. Busca borradores obsoletos, notas incompletas, nombres de archivo duplicados y carpetas vacías, y convierte esos hallazgos en una revisión priorizada para que puedas actuar rápido.

Para quién es

Usa el skill vault-cleanup-auditor si gestionas un vault personal o de equipo en crecimiento y necesitas una pasada de limpieza repetible en lugar de un prompt puntual. Es especialmente útil para quienes ya tienen una estructura de vault, pero quieren una forma rápida y sin fricción de detectar desviaciones, desorden y contenido que nunca se terminó.

En qué se diferencia

No es un prompt genérico para “organizar mis notas”. La guía de vault-cleanup-auditor está construida alrededor de un flujo de auditoría fijo, un requisito de entrada explícito y un archivo de informe guardado. Eso lo hace más adecuado para mantenimiento recurrente y Workflow Automation que para reestructurar notas de forma subjetiva.

Cómo usar el skill vault-cleanup-auditor

Instalación y configuración de vault-cleanup-auditor

Instala el skill vault-cleanup-auditor en Claude Code y luego apúntalo a la raíz de tu vault de Obsidian. La entrada principal que necesita es la ruta absoluta del vault, no una carpeta dentro de él. Si omites eso, el skill está diseñado para pedir la ruta que falta antes de ejecutarse.

Cómo activar la auditoría

Un prompt práctico para usar vault-cleanup-auditor es simple y específico:
Run the Vault Cleanup Auditor skill against my vault at /path/to/vault.

Normalmente eso basta porque el skill ya sabe qué comprobar. Si tu vault tiene subcarpetas poco habituales o solo quieres revisar una parte, dilo desde el principio para que la auditoría no revise de más ni de menos.

Qué leer primero

Para revisar la instalación de vault-cleanup-auditor, empieza por SKILL.md y SKILL-OC.md. En SKILL.md, céntrate en la fase de entrada y en las cuatro comprobaciones para entender exactamente qué va a ocurrir. También revisa el árbol de archivos del repo en GitHub para ver rutas de apoyo, pero este skill no tiene rules/, resources/ ni scripts extra que interpretar.

La mejor entrada para obtener mejores resultados

Las mejores entradas para usar vault-cleanup-auditor incluyen una ruta absoluta limpia y una expectativa clara de qué significa “desordenado” en tu flujo de trabajo. Por ejemplo, especifica si los borradores de más de 30 días deben considerarse obsoletos, si el contenido archivado debe ignorarse y si los nombres de archivo duplicados entre secciones son aceptables. Esos detalles reducen falsos positivos y hacen que el informe sea más útil.

Preguntas frecuentes sobre el skill vault-cleanup-auditor

¿vault-cleanup-auditor es solo para Obsidian?

Sí, el skill está centrado en la estructura de un vault de Obsidian y asume archivos markdown locales. Puede seguir siendo útil para otros sistemas de notas basados en carpetas, pero las comprobaciones incluidas están ajustadas a contenido al estilo Obsidian y quizá necesiten adaptación.

¿Es mejor que un prompt normal?

Por lo general, sí, si quieres la misma auditoría cada vez. Un prompt normal puede pedir ideas de limpieza, pero vault-cleanup-auditor añade un patrón de análisis fijo, manejo obligatorio de la entrada y un informe guardado, lo que hace que los resultados sean más repetibles y más fáciles de comparar mes a mes.

¿Los principiantes necesitan conocer la estructura del repo?

No, pero sí deberían leer las secciones breves de instrucciones antes de ejecutarlo. Lo principal que hay que entender es que vault-cleanup-auditor no arrancará sin la ruta del vault y que espera una raíz real del vault para que las comprobaciones recorran las carpetas correctas.

¿Cuándo no debería usarlo?

No uses vault-cleanup-auditor si quieres reescrituras editoriales amplias, consejo de estrategia de contenidos o un criterio “humano” sobre la calidad de las notas. Es un auditor de limpieza, no un asistente de redacción, y aporta más valor cuando la pregunta es “¿qué está obsoleto, roto, duplicado o vacío?”.

Cómo mejorar el skill vault-cleanup-auditor

Dale un alcance más limpio

La forma más importante de mejorar los resultados de vault-cleanup-auditor es definir con claridad el límite del vault. Si tu vault incluye archivos archivados, copias de seguridad sincronizadas, plantillas o contenido generado, indícalo explícitamente. Eso ayuda al skill a no confundir almacenamiento intencional con desorden.

Ajusta los criterios de auditoría

Si las comprobaciones por defecto son demasiado laxas o demasiado estrictas, afina la interpretación de las reglas en tu solicitud. Por ejemplo, dile si “obsoleto” significa 30 días o 90 días, si las carpetas vacías dentro de un sistema de plantillas deben ignorarse y si los nombres de archivo duplicados importan solo dentro de un proyecto o en todo el vault.

Mejora el primer informe

La primera salida es más útil cuando la ruta del vault es correcta y tus convenciones de notas son coherentes. Si ves resultados ruidosos, el problema suele ser la higiene de entrada: archivos sin encabezados, estados de borrador mezclados o nombres duplicados que en realidad son intencionales. Corrige la convención o describe la excepción, y luego vuelve a ejecutar la guía de vault-cleanup-auditor.

Itera sobre lo que más importa

Después de la primera ejecución, revisa primero los hallazgos de mayor prioridad antes de cambiar el skill en sí. A la mayoría de usuarios les importan más los borradores obsoletos y los nombres de archivo duplicados, porque son los que más carga de mantenimiento generan. Si el informe pasa por alto algo importante, actualiza tus instrucciones con un ejemplo concreto en lugar de pedir una auditoría “mejor” en términos generales.