🌱 Empieza aquí · Tablero de programa en PDF

Esta semilla le enseña a tu asistente a generar un tablero de programa en PDF: una lámina que muestra, de un vistazo, todo lo que tu organización planea para el trimestre. Cada frente de trabajo en su propio carril de color, con tarjetas de entregables por semana, las dependencias entre frentes, quién es responsable de qué, y una página de riesgos y plan B. Está pensada para presentarla en una junta o entregarla impresa a directivos, así que también trae reglas para que el contenido nunca se desborde y para que quien no maneja la jerga ágil entienda cada término.

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 tablero de programa", "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 el kernel al lugar adecuado, avisar del requisito de Typst y verificar que quedó.

1. Avisa del requisito: Typst

El tablero se compila a PDF con Typst, un motor de tipografía gratuito y de código abierto. El skill funciona (escribes el .typ) aunque Typst no esté, pero para generar el PDF hay que instalarlo. Comprueba si ya está:

typst --version

Si no aparece, instálalo (una sola vez):

• macOS: brew install typst
• Windows (PowerShell): winget install --id Typst.Typst
• Linux: el binario oficial del sitio de Typst, o cargo install typst-cli.

Opcional — poppler: la verificación del paso 5B y la Regla 10 del método usan pdfinfo y pdftotext, que NO vienen con Typst (son del paquete poppler). No bloquean nada: si no están, abre el PDF y cuenta las páginas a ojo. Para instalarlos: brew install poppler (macOS) · apt install poppler-utils (Linux) · el binario de poppler (Windows).

2. Decide el alcance con el usuario

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

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

3. Copia el kernel

Copia todo el contenido de kernel/ (el SKILL.md y la plantilla perfil.ejemplo.md) a la carpeta del skill.

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

mkdir -p "$HOME/.claude/skills/pdf-program-board"
cp kernel/SKILL.md "$HOME/.claude/skills/pdf-program-board/SKILL.md"
cp kernel/perfil.ejemplo.md "$HOME/.claude/skills/pdf-program-board/perfil.ejemplo.md"

Windows (PowerShell):

New-Item -ItemType Directory -Force "$HOME\.claude\skills\pdf-program-board"
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\pdf-program-board\SKILL.md"
Copy-Item kernel\perfil.ejemplo.md "$HOME\.claude\skills\pdf-program-board\perfil.ejemplo.md"

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

4. (Opcional) Aterriza el método al caso del usuario

El skill funciona tal cual, con una paleta neutra y ejemplos genéricos. Para que el tablero salga con los datos reales del usuario, abre perfil.ejemplo.md y llénalo con él: sus frentes, sus objetivos clave, su paleta de colores, sus responsables (iniciales) y dónde vive su backlog. Es opcional, pero mejora mucho el resultado.

5. Verificación post-siembra (obligatoria)

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

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

Salida esperada (el archivo listado + la línea del nombre + exit=0):

-rw-r--r--  1 usuario  staff  ...  SKILL.md
name: pdf-program-board
exit=0

Si sale No such file or directory, la copia no se hizo; repite el paso 3.

Parte B · prueba de comportamiento (que el método esté vivo). Los skills se cargan al inicio de la conversación, así que reinicia la sesión primero. Luego pídele al asistente un tablero de prueba mínimo, por ejemplo:

"Hazme un tablero de programa de prueba: 2 frentes, 3 objetivos, 3 sprints, con datos de ejemplo, y compílalo a PDF."

La conducta correcta es que el asistente escriba un archivo .typ que use las reglas del método (celdas de rejilla en vez de cajas de altura fija, un color por frente, tarjetas compactas, mini-glosarios al pie), lo compile con typst compile, y verifique el número de páginas (con pdfinfo si lo tiene, o abriendo el PDF). Si en su lugar improvisa un PDF sin esas reglas, el skill no se cargó: revisa que SKILL.md esté en la carpeta de skills.

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

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando pidas "un tablero de programa" o "la lámina de planeación del trimestre", tu asistente te la arma en PDF con todos los frentes en sus carriles, las tarjetas de entregables, la matriz de responsables y la página de riesgos, sin que el contenido se salga de la hoja y con cada término explicado para quien no es del gremio ágil. Tú solo le das tus datos (o dejas que lea tu backlog), lo revisas cuando te lo manda, y le pides los ajustes que quieras hasta que quede como lo necesitas. 🌱