01 El problema que resuelve
Durante una sesión le explicas a Claude cosas que no sabía: que el proyecto usa pnpm y no npm, que un componente falla en cierto navegador, que prefieres mensajes de error explícitos en los tests. Esas correcciones viven en la conversación y se pierden cuando termina. Aprende convierte ese conocimiento en archivos que el agente leerá la próxima vez.
Su principio de diseño es la prudencia: nada se escribe en disco sin tu confirmación. Una regla equivocada guardada en la memoria hace más daño que repetir una corrección, así que cada propuesta lleva una etiqueta de confianza y tú decides.
02 Instalación
-
1
Añade el marketplace
Dentro de una sesión de Claude Code (en el chat, no en la terminal), registra el repositorio como fuente de plugins.
-
2
Instala el plugin
Se instalan la skill, sus comandos y dos hooks opcionales que vienen activados.
-
3
Comprueba que funciona
Escribe /aprende. Si no aparece, reinicia Claude Code.
/plugin marketplace add Hainrixz/aprende-skill
/plugin install aprende@aprende-skillgit clone https://github.com/Hainrixz/aprende-skill.git
cp -r aprende-skill/skills/aprende ~/.claude/skills/
# Opcional: alias en inglés /learn
cp -r aprende-skill/skills/learn ~/.claude/skills/03 Cómo funciona una ejecución
-
1
Revisa la conversación
Busca tus correcciones explícitas, secuencias de error y arreglo, ediciones repetidas del mismo archivo, explicaciones tuyas y flujos que describiste paso a paso.
-
2
Propone candidatos
Cada señal se convierte en una propuesta con categoría, título, justificación y confianza alta, media o baja. Como máximo quince por ejecución, para forzar que sean relevantes.
-
3
Busca duplicados
Compara con tu memoria, tus skills y tus CLAUDE.md o AGENTS.md. Si algo se parece, lo marca en lugar de descartarlo en silencio.
-
4
Te pide confirmación
Respondes con números (1,3), rangos (1-4), all, none, drop low para quitar las de baja confianza o edit N para reescribir una antes de guardarla.
-
5
Guarda lo aprobado
Escribe cada elemento en su sitio y te muestra una línea por cada archivo actualizado.
04 Las cuatro categorías de aprendizaje
| Categoría | Dónde se guarda | Cuándo se usa |
|---|---|---|
| Memoria | ~/.claude/projects/<proyecto>/memory/ | Preferencias y datos estables del proyecto |
| Lección | La misma carpeta, como tipo lesson | Se cometió un error y conviene recordar por qué |
| Skill (borrador) | ~/.claude/skills/<nombre>/SKILL.md | Apareció un flujo de varios pasos reutilizable |
| Documento del proyecto | CLAUDE.md y AGENTS.md a la vez | Comandos, convenciones y trampas que cualquier agente debe conocer |
Las lecciones son lo más valioso. Siguen el método del artículo científico Reflexion (Shinn y otros, 2023) y responden siempre a cuatro preguntas: qué pasó, por qué pasó, cómo evitarlo y qué señal indica que está a punto de repetirse. Guardar el porqué, y no solo el qué, es lo que permite que el agente generalice.
05 Comandos y hooks
| Comando | Qué hace |
|---|---|
| /aprende | Ejecución normal: revisa, propone y guarda tras tu confirmación |
| /learn | Alias en inglés del anterior |
| /aprende --review | Repasa las lecciones existentes para retirarlas o actualizarlas |
| /aprende --portable | Además copia las lecciones a ./.aprende/ para que Codex las lea |
| /aprende-enable-hooks | Instala los hooks en ~/.claude/settings.json |
| /aprende-disable-hooks | Los elimina, guardando una copia de seguridad |
Los dos hooks son solo avisos. Uno se ejecuta tras cada comando o edición y, si detecta un error o el mismo archivo editado tres veces, anota una señal. El otro, al cerrar la sesión, te recuerda lanzar /aprende si hay señales pendientes. Ninguno escribe aprendizajes por su cuenta.
/aprende Prioriza lo que afecte a cómo se despliega este proyecto y a los errores que hemos corregido hoy. Descarta preferencias que solo apliquen a esta tarea concreta. Para cada lección, asegúrate de que la señal de detección sea algo observable en el código o en la salida de un comando.06 Buenas prácticas
- ✓Lánzala al final de sesiones en las que hayas corregido algo, no de forma automática en todas.
- ✓Ante la duda, no guardes: usa drop low y quédate con lo de confianza alta.
- ✓Haz /aprende --review una vez al mes para retirar lecciones obsoletas; se marcan como retiradas en lugar de borrarse.
- ✓Revisa los cambios en CLAUDE.md y AGENTS.md antes de hacer commit: los leerá todo el equipo.
- ✓No guardes datos sensibles en la memoria, como contraseñas, datos de clientes o rutas privadas.
Preguntas frecuentes
No. Los hooks solo acumulan señales y te recuerdan ejecutar /aprende. Nada se escribe como aprendizaje hasta que eliges qué conservar.
Sí. Los documentos del proyecto se escriben a la vez en CLAUDE.md y AGENTS.md, y con --portable las lecciones se copian a una carpeta .aprende que Codex puede leer.
No. Son opcionales: solo sirven para detectar señales durante la sesión y recordarte ejecutar /aprende al final. Puedes quitarlos con /aprende-disable-hooks y seguir lanzando /aprende a mano cuando lo necesites.
Claude Code ya puede guardar notas por su cuenta. Aprende añade un proceso explícito y revisado: formato de lección con causa y señal, deduplicación, etiquetas de confianza y escritura también para Codex.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.