Skill que mantiene un scratchpad local por repo (.claude/napkin.md) con lo que falló, correcciones y lo que funcionó. Claude lo lee al inicio de cada sesión para no repetir errores. Máximo 10 items por categoría, continuamente curado.
Cuándo usarlo: Proyectos donde Claude repite los mismos errores entre sesiones. Especialmente útil en equipos donde distintas personas abren el mismo repo con Claude.
Herramienta recomendada: Claude
## Instalación ```bash claude install-skill https://github.com/blader/napkin ``` o manualmente: ```bash mkdir -p ~/.claude/skills/napkin curl -o ~/.claude/skills/napkin/SKILL.md \ https://raw.githubusercontent.com/blader/napkin/main/SKILL.md ``` ## Cómo funciona 1. Claude crea `.claude/napkin.md` en la raíz de tu proyecto 2. Al inicio de cada sesión lee el napkin y aplica las lecciones silenciosamente 3. Cuando algo falla o se corrige, actualiza el napkin automáticamente ## Estructura del napkin.md ```markdown ## What went wrong - [2025-01-15] Ran migrations without --force in production → always use --force ## What was corrected - [2025-01-14] Used artisan tinker for bulk ops → use dedicated command instead ## What worked well - [2025-01-13] Seeded test data before running feature tests → faster debugging ``` ## Reglas internas - Máximo 10 items por categoría - Cada entrada incluye fecha + instrucción "do instead" - Se re-prioriza en cada lectura (más reciente y más relevante arriba) - Claude nunca menciona que está usando el napkin — simplemente lo aplica ## Hacer commit del napkin ```bash git add .claude/napkin.md git commit -m "docs: update napkin with session learnings" ``` Se recomienda incluirlo en el repo para que todo el equipo comparta las lecciones.