🌱 Empieza aquí · Visuales rápidos con Typst

Esta semilla le enseña a tu asistente a crearte imágenes y PDFs de una sola pieza —un poster, un thumbnail para redes, un cover de artículo, un flyer de una página— en un par de minutos, sin que tengas que abrir Canva ni Figma. Le dices qué quieres y con qué texto, y él te devuelve el archivo listo, con los colores de tu marca y ya revisado.

Por debajo usa una herramienta gratuita llamada Typst (un motor que convierte un texto sencillo en imágenes y PDFs nítidos). No te preocupes por eso: tu asistente la maneja por ti.

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", "ponme a funcionar lo de los visuales con Typst", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Esto es un skill (habilidad), no un hook. No necesita settings.json ni permisos de ejecución: los skills se descubren solos cuando viven en la carpeta correcta. Tu trabajo es (1) confirmar que el binario de Typst está disponible, (2) copiar el kernel al lugar adecuado, y (3) verificar que quedó.

1. Confirma que Typst está instalado

Este skill ejecuta el comando typst para compilar los visuales. Verifica:

typst --version

Si responde con una versión, listo. Si no aparece, instálalo (elige lo que corresponda):

# macOS (Homebrew)
brew install typst
# Windows (winget)
winget install Typst.Typst
# Linux con Rust instalado
cargo install --locked typst-cli

Si no puedes instalar Typst en este entorno, avísale a la persona: este skill necesita el binario de Typst para funcionar. No prometas visuales que no puedas compilar.

2. Decide el alcance con la persona

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

Si no tiene preferencia, usa el alcance global.

3. Copia el kernel completo (el skill + sus plantillas)

Ojo: hay que copiar el SKILL.md y la carpeta templates/ juntos, porque el skill usa esas plantillas .typ como punto de partida.

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

mkdir -p "$HOME/.claude/skills/typst-quick-visuals"
cp -R kernel/. "$HOME/.claude/skills/typst-quick-visuals/"

Windows (Git Bash / WSL): misma ruta ~/.claude/skills/typst-quick-visuals/. Son archivos de texto, así que funciona igual. Si prefieres PowerShell nativo:

New-Item -ItemType Directory -Force "$HOME\.claude\skills\typst-quick-visuals"
Copy-Item -Recurse kernel\* "$HOME\.claude\skills\typst-quick-visuals\"

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de kernel/SKILL.md como una sección dentro de AGENTS.md (o agrégale un puntero al archivo) y guarda la carpeta kernel/templates/ dentro del proyecto para que el skill encuentre las plantillas.

No hace falta chmod: aquí no se ejecuta ningún script propio. Lo único que se ejecuta es el comando typst, que instalaste en el paso 1.

4. (Opcional) Aterriza la paleta a la marca de la persona

El skill funciona tal cual con una paleta neutra de arranque. Pero rinde mucho mejor si le dices con qué colores y tipografía trabajar:

Pregúntale a la persona por los colores de su marca (en formato hex, ej. #1E2A44) y su tipografía, o búscalos si tiene un documento donde los definió.
Cuando generes un visual, sustituye esos valores en la sección BRAND CONFIG de la plantilla que uses. El skill ya está escrito para hacerlo así en su paso 3.

Si la persona todavía no tiene marca, no pasa nada: la paleta neutra de las plantillas sirve para explorar, y solo avísale que es provisional.

5. Verificación post-siembra (obligatoria)

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

ls -la "$HOME/.claude/skills/typst-quick-visuals/SKILL.md" \
       "$HOME/.claude/skills/typst-quick-visuals/templates/"; echo "exit=$?"

Salida esperada: el SKILL.md listado y la carpeta templates/ con al menos tres archivos .typ, más exit=0. Si algo falta, repite el paso 3.

b) El skill compila de verdad (prueba de comportamiento): Pídele a la persona algo simple, por ejemplo "hazme un poster de prueba con el título Hola Mundo". La conducta correcta es que elijas una plantilla, generes el .typ, corras typst compile, y le entregues un PDF o PNG real (con su ruta), ya pasado por la checklist visual. Si en vez de eso solo describes lo que harías sin producir el archivo, algo falló: revisa que typst --version responda y que la carpeta templates/ esté completa.

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

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando necesites una imagen o un PDF de una sola pieza, ya no tienes que abrir Canva ni pelearte con plantillas. Le dices a tu asistente qué quieres —"un cover para mi newsletter", "un poster para el status de mañana"— con el texto que va, y él te devuelve el archivo listo, con tus colores y ya revisado para que se vea bien.

No tienes que aprender la herramienta ni tocar código. Solo pides, y recibes el visual. 🌱