🌱 Empieza aquí · Smart Summary

Esta semilla le enseña a tu asistente a convertir cualquier cosa larga (la grabación de una reunión, un artículo, un reporte pesado, un hilo de correos, un video) en un resumen o minuta profesional en español. Entrega dos archivos: uno en Markdown (el formato que otras IA leen y buscan bien) y un PDF bien diseñado con los colores y las fuentes de tu marca. La meta es que el resumen capture tanto que ya no tengas que volver al original.

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 smart-summary", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Esto es un skill (habilidad), no un hook (gancho de automatización). No necesita settings.json ni permisos de ejecución: los skills se descubren solos cuando viven en la carpeta correcta. Tu trabajo es copiar la carpeta del kernel al lugar adecuado y verificar que quedó.

El kernel trae:

kernel/SKILL.md — el método completo (el motor de resúmenes).
kernel/references/estructura.md — los templates del Markdown (artículo y minuta).
kernel/references/typst-template.md — el template del PDF con "bloques que respiran".

1. Decide el alcance con el usuario

Alcance global (recomendado): disponible en todas las conversaciones del usuario. Va en $HOME/.claude/skills/smart-summary/.
Alcance de un proyecto: solo dentro de una carpeta específica. Va en <TU-RUTA>/.claude/skills/smart-summary/, donde <TU-RUTA> es la raíz del proyecto.

Si el usuario no tiene preferencia, usa el alcance global.

2. Copia la carpeta del kernel (SKILL.md + references)

Claude Code / Cowork (macOS o Linux), alcance global:

mkdir -p "$HOME/.claude/skills/smart-summary/references"
cp kernel/SKILL.md "$HOME/.claude/skills/smart-summary/SKILL.md"
cp kernel/references/*.md "$HOME/.claude/skills/smart-summary/references/"

Windows (PowerShell):

New-Item -ItemType Directory -Force "$HOME\.claude\skills\smart-summary\references"
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\smart-summary\SKILL.md"
Copy-Item kernel\references\*.md "$HOME\.claude\skills\smart-summary\references\"

No hace falta chmod: son archivos de texto que el asistente lee, no programas que se ejecuten.

3. (Opcional) Aterriza los placeholders

El skill funciona tal cual. Si quieres afinarlo al usuario, edita la copia que ya quedó en el destino del paso 2, no los archivos del kernel/ de esta semilla (esos son la fuente y ya no se leen una vez sembrado). En alcance global esa copia vive en $HOME/.claude/skills/smart-summary/. Abre ahí el SKILL.md y aterriza:

<TU-GUIA-DE-MARCA> → el archivo donde el usuario definió su paleta, tipografías y si usa emojis. Sin guía, el PDF usa una identidad neutra que se ve profesional.
<TUS-FUENTES-DE-VERDAD> → dónde viven los datos confiables del usuario (notas, directorio de personas) contra los que se cruzan los nombres de un transcript.
<TU-CARPETA-DE-DOCUMENTOS> → dónde guarda el usuario sus entregables.

Y en $HOME/.claude/skills/smart-summary/references/typst-template.md (la copia sembrada), cambia las variables de color y fuente por las de su marca.

4. (Solo para el PDF) Verifica que Typst esté instalado

El resumen en Markdown funciona sin nada extra. El PDF necesita Typst:

typst --version || echo "Typst no está instalado: instálalo para generar el PDF"

Si no está, el usuario puede instalarlo (brew install typst en macOS, o el binario oficial de Typst en Linux/Windows). El .md se entrega igual sin Typst.

5. Verificación post-siembra (obligatoria)

Paso A · el archivo quedó en su lugar y con el nombre correcto:

ls -la "$HOME/.claude/skills/smart-summary/SKILL.md" && grep -m1 '^name:' "$HOME/.claude/skills/smart-summary/SKILL.md"; echo "exit=$?"

Salida esperada: el archivo listado + la línea name: smart-summary + exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 2.

Paso B · prueba de comportamiento (el asistente la corre él mismo). Los skills se cargan al inicio de la conversación, así que reinicia la sesión primero. Luego dale este texto corto de prueba:

"En la junta del lunes acordamos lanzar la nueva página el 15, subir el presupuesto de anuncios y que el equipo de diseño mande las fotos el viernes."

Pídele: "hazme un smart-summary de esto como minuta". El resultado correcto:

Un .md con las secciones del template de minuta: título, fecha, mensaje clave, desarrollo, una tabla de Tareas y compromisos (con columnas Tarea / Deadline / Estado, sin inventar responsables) y una conclusión con frase inspiradora.
Acentos correctos en español.
Si Typst está instalado, además un PDF compilado.

Si genera esa estructura, el skill está vivo. Avísale al usuario en una línea qué gana.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando le pases a tu asistente algo largo y le digas "resúmeme esto" o "hazme la minuta", te va a devolver un documento limpio, ordenado por temas y con buena pinta, listo para leer o compartir. Ya no tienes que volver a la grabación ni al reporte de 30 páginas: el resumen trae lo importante.

La prueba más fácil: pásale la transcripción de tu próxima reunión y pídele la minuta. Si al leerla entiendes todo lo que se acordó sin tener que recordar la junta, el skill está haciendo su trabajo. 🌱