🌱 Empieza aquí · Auditor Documental

¿Alguna vez sentiste que tu carpeta de notas y documentos se volvió un cajón de sastre? Archivos con nombres raros, dos versiones que se contradicen, un PDF viejo con datos que ya cambiaron, cosas guardadas donde no van. Esta semilla le da a tu asistente la capacidad de hacerle un chequeo de salud a tu base de documentos: revisa la forma (nombres, metadatos, ubicación) y también el fondo (contradicciones, información caducada, duplicados), y te entrega un reporte con propuestas de qué mover, actualizar o archivar.

Lo mejor: no toca nada por su cuenta. Primero te enseña el diagnóstico; solo mueve o corrige archivos cuando tú lo apruebas, y siempre deja un registro para poder deshacer.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo técnico y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el auditor de documentos", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Esto es un skill (habilidad) de Claude Code. No es un hook (gancho de automatización): no lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script al arrancar la sesión. Se "siembra" copiando la carpeta del skill donde tu plataforma lee las habilidades del usuario. No inventes rutas: usa $HOME siempre.

1. Copia el skill completo a la carpeta de skills del usuario

Copia toda la carpeta kernel/ como el skill doc-auditor:

Claude Code / Cowork (macOS o Linux):

DEST="$HOME/.claude/skills/doc-auditor"
mkdir -p "$DEST"
cp -R kernel/. "$DEST/"

Windows (Git Bash / WSL): misma ruta ~/.claude/skills/doc-auditor/.

La estructura final debe quedar así:

$HOME/.claude/skills/doc-auditor/
├── SKILL.md
└── esquema-frontmatter.ejemplo.md

2. (Recomendado) Aterriza el esquema y la fuente de verdad

El auditor afina mucho más si sabe cómo son los documentos de ESTA persona. Abre esquema-frontmatter.ejemplo.md y, con la persona (o detectándolo tú), llena:

Los campos de metadatos que usan sus documentos y cuáles son obligatorios (por ejemplo title, category, status, created). Si no usa metadatos, el auditor se salta esa parte solo.
La convención de nombres de archivo (por ejemplo, todo en kebab-case).
La estructura de carpetas (dónde vive lo activo, los proyectos, el archivo histórico).
La fuente de verdad: qué documento manda cuando dos se contradicen (su archivo de memoria, un índice maestro, o el documento canónico de cada área).

Reemplaza los placeholders <TU-RUTA>, <TU-PROYECTO> y <TU-ARCHIVO-DE-MEMORIA> con las rutas reales del equipo de la persona. Si no sabe dónde vive cada cosa, deja las reglas genéricas: el auditor funciona igual, solo que menos afinado.

3. (Opcional) Instala las herramientas para leer binarios

Para clasificar documentos de Office y PDFs por sus metadatos, el auditor puede apoyarse en utilidades de código abierto. No son obligatorias: si faltan, el auditor salta esos formatos y avisa, sin fallar.

# macOS (Homebrew). En Linux usa tu gestor de paquetes.
brew install pandoc poppler exiftool
pip install python-docx python-pptx openpyxl pdfplumber pypdf

4. Verificación post-siembra (obligatoria)

Como es un skill (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que la habilidad se activa de verdad.

a) El archivo quedó colocado:

ls -la "$HOME/.claude/skills/doc-auditor/SKILL.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) La habilidad responde (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y diga "audita mis documentos" o "hazle un diagnóstico de salud a mi carpeta de notas", apuntando a una carpeta con varios archivos. La conducta correcta es que el asistente corra una auditoría de solo lectura y entregue un reporte (salud, hallazgos, propuestas de destino) sin mover nada, y que solo mueva o corrija archivos si la persona lo aprueba después. Si mueve archivos de golpe sin reporte previo, algo salió mal: recuérdale que es de solo lectura por defecto.

Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

Cuando quieras poner orden, dile a tu asistente algo como "audita mis documentos", "¿qué tan sana está mi wiki?" o "encuentra contradicciones y cosas viejas en mis notas". Él revisa tu carpeta y te entrega un diagnóstico claro: una calificación de salud, qué archivos tienen problemas de forma (mal nombrados, sin metadatos, en la carpeta equivocada) y qué problemas de fondo hay (dos documentos que se contradicen, información caducada, duplicados que convendría fusionar). Cada propuesta viene con su razón y su nivel de confianza.

Y lo importante: no toca nada sin tu permiso. Tú revisas el reporte y le dices qué sí y qué no. Cuando aprueba mover algo, deja un registro para deshacer, y nunca borra: archiva. Es como tener un bibliotecario que primero te muestra el plan y solo acomoda cuando das el visto bueno. 🌱