🌱 Empieza aquí · PDF profesional con Typst y tu marca

Esta semilla le enseña a tu asistente a convertir contenido que ya tienes escrito —una minuta, un reporte, una carta, una ficha— en un PDF que parece hecho por un estudio de diseño: con los colores y la tipografía de tu marca, bien espaciado, y revisado antes de que lo abras. Se apoya en Typst, un motor de documentos gratuito. De un texto a un PDF bonito en un par de minutos.

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 el resto 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 lo de los PDF con Typst", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un workflow (método de trabajo), no un programa ejecutable. No es un hook: no lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script por su cuenta. Se "siembra" colocando el método donde tú, el asistente, lo leas de forma automática, y dejando la plantilla y la guía de marca a la mano para usarlas cuando la persona pida un PDF.

0. Prerequisito: el binario de Typst

Este método compila con el comando typst. Verifica que exista:

typst --version

Si no aparece, instálalo según el sistema de la persona:

# macOS (Homebrew)
brew install typst
# Windows (winget)
winget install Typst.Typst
# Linux (cargo, si hay Rust) o descarga el binario desde github.com/typst/typst
cargo install --locked typst-cli

Para el control de calidad visual conviene también pdftoppm (paquete poppler; brew install poppler en macOS). Si no puedes instalar Typst, dile a la persona que este método lo necesita y detente ahí; no inventes un output.

1. Copia el método donde lo leas siempre

El kernel trae tres archivos:

• kernel/pdf-profesional-typst.md — el método en sí (las 4 fases + la regla de oro del espaciado).
• kernel/plantilla-documento.ejemplo.typ — una plantilla Typst lista, con tokens de marca para reemplazar.
• kernel/tokens-de-marca.ejemplo.md — una guía para aterrizar los colores y fuentes de la persona.

Coloca pdf-profesional-typst.md donde tu plataforma cargue instrucciones permanentes, y guarda la plantilla y la guía de tokens en una carpeta de trabajo accesible:

Claude Code (macOS / Linux / Windows con Git Bash):

mkdir -p "$HOME/.claude/rules"
cp kernel/pdf-profesional-typst.md "$HOME/.claude/rules/pdf-profesional-typst.md"
mkdir -p "$HOME/.claude/plantillas-pdf"
cp kernel/plantilla-documento.ejemplo.typ "$HOME/.claude/plantillas-pdf/"
cp kernel/tokens-de-marca.ejemplo.md      "$HOME/.claude/plantillas-pdf/"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo el método; la plantilla .typ y la guía de tokens NO son reglas, son insumos que usas al generar un PDF.

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/pdf-profesional-typst.md) y deja la plantilla dentro del proyecto. Si no, coloca el método dentro del proyecto y agrega una línea que apunte a él en el CLAUDE.md: "Para generar PDFs, aplica el método de pdf-profesional-typst.md."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de pdf-profesional-typst.md dentro de AGENTS.md (o agrégale un puntero al archivo) y deja la plantilla .typ en el proyecto.

2. Aterriza la marca (recomendado)

Abre kernel/tokens-de-marca.ejemplo.md. Con la persona (o detectándolo tú), llena la columna "Tu valor" con sus colores en HEX y sus fuentes reales. Luego copia esos valores al bloque de tokens (arriba del todo) de plantilla-documento.ejemplo.typ. Si la persona no tiene marca definida, deja los valores neutros de arranque y avísale que son provisionales; el método funciona igual.

3. Verificación post-siembra (obligatoria)

a) Los archivos quedaron colocados (ejemplo Claude Code):

ls -la "$HOME/.claude/rules/pdf-profesional-typst.md" "$HOME/.claude/plantillas-pdf/"; echo "exit=$?"

Salida esperada: lista los archivos y exit=0. Si sale No such file or directory, repite el paso 1.

b) La plantilla compila (prueba de comportamiento):

typst compile "$HOME/.claude/plantillas-pdf/plantilla-documento.ejemplo.typ" /tmp/prueba-pdf.pdf && ls -la /tmp/prueba-pdf.pdf; echo "exit=$?"

Salida esperada: compila sin error, ls lista el PDF generado (con un tamaño mayor a cero) y exit=0. Esta prueba solo necesita Typst, nada más. Es normal ver un aviso de "unknown font family" si la fuente de marca no está instalada: significa que el respaldo del sistema tomó su lugar, que es justo lo que debe pasar. Si la compilación falla (sale exit distinto de 0 y no se generó el PDF), revisa que copiaste bien el .typ y que Typst está instalado.

¿Instalaste poppler (el paquete que trae pdfinfo y pdftoppm)? Entonces, como extra opcional, puedes ver también el conteo de páginas con pdfinfo /tmp/prueba-pdf.pdf | grep Pages. Si no lo tienes, no pasa nada: el PDF ya quedó generado arriba y esa es la prueba que cuenta.

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

✅ ¿Cómo sé que funcionó?

La próxima vez que le des a tu asistente un texto y le pidas "pásame esto en un PDF bonito", en vez de un documento genérico vas a recibir un PDF con tus colores y tu tipografía, bien espaciado, y ya revisado por él antes de mandártelo. Cuando te lo entregue te va a decir algo como "lo revisé, quedó en una página, ábrelo". No tienes que tocar nada técnico: tú das el texto, él te devuelve el PDF listo para compartir. 🌱