🌱 Empieza aquí · Reporte de auditoría antes y después
¿Alguna vez tu asistente (o uno de sus agentes) revisó tu sistema, arregló cosas... y al final te dejó un montón de texto suelto imposible de leer? Esta semilla resuelve justo eso. Le enseña a tu asistente a cerrar toda auditoría con un reporte bonito y siempre igual: qué había antes, qué encontró, qué corrigió, qué quedó pendiente, y una firma para que tú lo apruebes. Te lo entrega en un HTML que se abre solo en el navegador.
Lo mejor: el reporte muestra el antes y el después lado a lado, así ves de un vistazo qué mejoró ("0 → 12 archivos ordenados", "40% de desorden → 0%").
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 demás 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 generador de reportes de auditoría", "haz el setup de esto". Te entiende igual.
Para el asistente que siembra 🤖
Este componente es una habilidad (skill): un archivo de instrucciones (SKILL.md) que
tu plataforma carga y activa cuando la situación lo amerita. No es un programa
ejecutable ni un hook: no lleva chmod, no lleva entrada en settings.json y no corre
ningún script en segundo plano. Se "siembra" colocando el SKILL.md donde tu plataforma
descubre las habilidades.
1. Copia la habilidad donde tu plataforma la descubra
El kernel trae dos archivos:
kernel/SKILL.md— la habilidad en sí (las instrucciones que vas a seguir para armar el reporte).kernel/plantilla-reporte.ejemplo.html— un esqueleto de HTML autocontenido para partir de él y vestirlo con la marca de esta persona.
Coloca SKILL.md en la carpeta de habilidades de la plataforma:
Claude Code (macOS / Linux / Windows con Git Bash):
mkdir -p "$HOME/.claude/skills/audit-pre-post-report-generator"
cp kernel/SKILL.md "$HOME/.claude/skills/audit-pre-post-report-generator/SKILL.md"
Las habilidades dentro de
~/.claude/skills/<nombre>/SKILL.mdse descubren solas y se activan cuando sudescriptioncoincide con lo que pasa en la conversación. Solo se copia elSKILL.md. La plantilla del kernel se usa en el paso 2 (y, si quieres, se guarda junto alSKILL.mdpara vestir los reportes).
Cowork: usa la misma carpeta de habilidades si tu proyecto la soporta
(.claude/skills/audit-pre-post-report-generator/SKILL.md). La habilidad se activa igual.
Codex: Codex no tiene el mecanismo de auto-activación de habilidades, pero el método
sí es portable. Copia el contenido de kernel/SKILL.md dentro de tu archivo de
instrucciones AGENTS.md (o guárdalo aparte en el proyecto y agrégale un puntero), y
aplícalo manualmente cuando termines una auditoría: "arma el reporte antes/después con
el método de la habilidad".
2. Aterriza la paleta a la marca de ESTA persona (recomendado)
La paleta que los reportes usan de verdad vive en el bloque "Paleta de marca" del
SKILL.md que acabas de copiar: son seis variables de color dentro de un :root. Ese
bloque es la fuente de la verdad, porque cuando la habilidad arme un reporte lee los
colores de ahí. Con la persona (o detectándolo tú), reemplaza esos seis valores por los de
su marca dentro del SKILL.md ya copiado. Con eso, todos los reportes que generes
salen con su identidad visual y se ven iguales entre sí.
Para ver cómo queda antes de comprometerte, abre kernel/plantilla-reporte.ejemplo.html
en el navegador: es el mismo esqueleto con datos de muestra. Pinta ahí la paleta, revísala,
y cuando te guste copia esos seis valores al bloque del SKILL.md. Si quieres, guarda tu
versión con marca junto al SKILL.md, como
~/.claude/skills/audit-pre-post-report-generator/plantilla-reporte.html, para que la
habilidad arranque de un esqueleto ya vestido.
Si la persona no tiene una marca definida, no pasa nada: la paleta neutral funciona tal cual. Y si maneja varias marcas o áreas, deja un juego de colores por cada una y elige según el área que cubra la auditoría.
3. Verificación post-siembra (obligatoria)
Como es una habilidad (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 (ejemplo Claude Code):
ls -la "$HOME/.claude/skills/audit-pre-post-report-generator/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 se activa (prueba de comportamiento): pídele a la persona que corra una
auditoría o mantenimiento pequeño (o simúlalo tú con hallazgos y correcciones de muestra) y
luego di: "genera el reporte antes/después de esta revisión". La conducta correcta es que
armes un REPORTE.md + REPORTE.html con las 7 secciones y abras el HTML en el
navegador. Si no aparece la habilidad, revisa que el SKILL.md esté en la carpeta de
habilidades (o dentro de AGENTS.md en Codex).
Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.
✅ ¿Cómo sé que funcionó?
De ahora en adelante, cada vez que tu asistente (o uno de sus agentes) revise tu sistema y arregle cosas, te va a entregar un reporte parejo y fácil de leer: el antes y el después lado a lado, los problemas que encontró ordenados por importancia, lo que corrigió, lo que todavía falta, y tres maneras de firmarlo. Y se abre solito en tu navegador para que lo revises sin buscar nada.
No tienes que hacer nada especial en el día a día. Solo vas a notar que las auditorías dejan de ser un muro de texto y se vuelven un reporte que de verdad te dice qué pasó. 🌱