🌱 Empieza aquí · Aprende mientras construyes

Esta semilla le enseña a tu asistente a enseñarte mientras trabajan. En vez de leer tutoriales sueltos que se te olvidan, tu asistente aprovecha una tarea real tuya para mostrarte un truco nuevo de tu herramienta: una micro-lección al día, corta, con tu permiso, y siempre amarrada a lo que estás haciendo en ese momento. Además va armando un "playbook" tuyo que traduce tu forma de pedir las cosas a lo que tu asistente sabe hacer.

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 lo de aprender mientras construyo", "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 copiar los dos archivos del kernel al lugar adecuado, aterrizar el playbook a esta persona y verificar que quedó.

1. Decide el alcance con el usuario

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

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

2. Copia los archivos del kernel

El kernel trae dos archivos:

kernel/SKILL.md — el skill en sí (el método de las micro-lecciones).
kernel/playbook.ejemplo.md — una plantilla para armar el playbook personal del usuario.

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

mkdir -p "$HOME/.claude/skills/aprende-mientras-construyes"
cp kernel/SKILL.md "$HOME/.claude/skills/aprende-mientras-construyes/SKILL.md"
cp kernel/playbook.ejemplo.md "$HOME/.claude/skills/aprende-mientras-construyes/playbook.ejemplo.md"

Windows (Git Bash / WSL): misma ruta ~/.claude/skills/aprende-mientras-construyes/. Son archivos de texto, así que funcionan igual en cualquier sistema. Si prefieres PowerShell nativo:

New-Item -ItemType Directory -Force "$HOME\.claude\skills\aprende-mientras-construyes"
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\aprende-mientras-construyes\SKILL.md"
Copy-Item kernel\playbook.ejemplo.md "$HOME\.claude\skills\aprende-mientras-construyes\playbook.ejemplo.md"

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

3. Aterriza el playbook a ESTA persona (recomendado)

Crea el playbook activo copiando la plantilla dentro de la misma carpeta del skill (la del paso 2). El playbook activo se llama playbook.md; la plantilla .ejemplo.md se queda como referencia:

cp "$HOME/.claude/skills/aprende-mientras-construyes/playbook.ejemplo.md" \
   "$HOME/.claude/skills/aprende-mientras-construyes/playbook.md"

Si elegiste alcance de proyecto, usa la carpeta del proyecto en vez de $HOME.

Abre ese playbook.md. Con el usuario (o detectándolo tú), llena el mapa "yo digo → se resuelve con" usando sus palabras reales y las herramientas que de verdad tiene instaladas (lístalas primero: skills, comandos, agentes, integraciones). Reemplaza los placeholders <...> por herramientas reales. Si el usuario no sabe qué tiene, tú descúbrelo y propón el mapa.

Si de momento no hay tiempo, no pasa nada: el skill funciona igual y creará playbook.md desde la plantilla la primera vez que lo necesite.

4. Verificación post-siembra (obligatoria)

a) Los archivos quedaron en su lugar (ejemplo Claude Code, alcance global):

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

Salida esperada: el listado de los dos archivos, la línea name: aprende-mientras-construyes y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 2.

b) El skill se activa (prueba de comportamiento, en una conversación nueva). Los skills se cargan al inicio de la sesión, así que reinicia primero. Luego pídele algo como: "dame una micro-lección de algo útil de esta herramienta, amarrada a mi pendiente de hoy". La conducta correcta es que pida tu permiso primero, proponga un solo patrón, lo ejecute sobre una tarea real y te diga la señal de éxito. Si en vez de eso suelta un tutorial genérico desconectado de tu trabajo, 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 trabajes con tu asistente, de vez en cuando te va a decir algo como: "esto se presta para que aprendas un truco nuevo, ¿lo metemos?". Si dices que sí, te enseña usando tu propia tarea de ejemplo, no un tutorial de manual. Máximo una lección por día, para no saturarte, y siempre con tu permiso.

Con el tiempo vas a notar que tu asistente te entiende mejor cuando le pides las cosas con tus palabras, porque va guardando en tu playbook cómo hablas tú y qué herramienta resuelve cada cosa. No tienes que hacer nada especial: solo trabajar normal e ir diciendo "sí" o "hoy no" a las lecciones. 🌱