Skills

Guía Karpathy: un CLAUDE.md para que Claude Code sea prudente antes de cambiar código

Para quienes quieren menos trampas habituales de Claude Code al programar. La guía prioriza la prudencia frente a la velocidad; un typo o un cambio de una línea no necesita el proceso completo.

Official source · andrej-karpathy-skills

Install

/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills

Para quién es

Si editas sobre todo repositorios en Claude Code y quieres que caiga menos en las trampas habituales de los LLM al programar, este material encaja mejor. Es un CLAUDE.md para mejorar el comportamiento de Claude Code, a partir de las observaciones de Andrej Karpathy sobre esas trampas:

https://x.com/karpathy/status/2015883857489522876

La página dice que los cuatro principios están en el mismo archivo y corresponden directamente a estos problemas. El texto de página disponible no enumera los nombres ni el cuerpo de esos cuatro; no les pongas nombres por tu cuenta ni inventes un juego de lemas. Necesitas a quien ya usa Claude Code y acepta instalar un plugin. Si solo quieres leer la publicación y no piensas cambiar la configuración local de Claude Code, basta el enlace de arriba.

Primer intento en 3 minutos

La instalación oficial recomendada son dos pasos seguidos; si falta uno, no está instalada. Primero ejecuta en Claude Code:

/plugin marketplace add forrestchang/andrej-karpathy-skills

Luego instala el plugin de inmediato:

/plugin install andrej-karpathy-skills@karpathy-skills

Esto cambia la configuración de plugins de Claude Code; no es una consulta de solo lectura. Antes de ejecutarlo, confirma que estás en el entorno de Claude Code en el que quieres escribir y termina ambos pasos. No añadas solo el marketplace sin hacer install.

Tras instalar, contrasta primero; no reescribas el repositorio de golpe. Elige una intención de cambio no trivial, pide a Claude Code que explique cómo piensa cambiar y qué archivos tocará, y permite escribir código solo cuando asientas. La señal de éxito: muestra «prudencia antes que velocidad», explica y luego actúa, en lugar de desplegar un parche grande de entrada. Si empieza a refactorizar módulos ajenos, páralo.

Casos de uso

Caso 1: Una tarea de programación no trivial. La guía existe para mejorar el comportamiento de Claude Code ante las trampas de los LLM. Limita la tarea a «primero contrastar CLAUDE.md y luego cambiar». El texto de página disponible no da títulos de esos cuatro principios; no puedes pedirle que ejecute un nombre de principio inventado. Puedes pedirle: leer este único archivo y luego dar el alcance del cambio. Comprueba dos cosas: que leyó esta guía y que dio el alcance antes de cambiar archivos.

Caso 2: Decidir si aplicar el proceso riguroso completo. La página deja claro que estas guías se inclinan a la prudencia, no a la velocidad. En tareas triviales (un typo simple, un cambio de una línea obvio) decides tú; no hace falta el juego completo cada vez. Cuando solo corriges un typo evidente, dile con claridad que es un cambio trivial y que no amplíe el proceso. No define una regla automática de «evidente» ni dice qué tipos de archivo son excepción. El límite lo juzgas tú en el momento; si el agente convierte la corrección de un typo en un refactor, ya salió de este caso.

Límites de uso

Esto es un CLAUDE.md para Claude Code, no un paquete de reglas para editores genéricos. La página no describe los pasos para renombrarlo para otros productos. Los cuatro principios están en el mismo archivo, pero el texto de página disponible se queda en «hay cuatro y corresponden a estos problemas»; no hay un inventario de principios. No añadas nombres ni finjas que ya citaste las frases originales del archivo.

La instalación recomendada es el marketplace add de arriba y luego plugin install. Hay que hacer los dos pasos. No pongas otro instalador al lado. Las observaciones de origen están en la publicación de Karpathy; la guía es un uso derivado y no sustituye el contexto de esa publicación.

La primera parada es «primero explicar, luego cambiar». Cualquier refactor fuera de la tarea actual, reordenación masiva o nueva abstracción debe primero enumerar los archivos que cambiará y el motivo; tú confirmas y luego sigue. En un cambio trivial, baja tú el proceso para que un typo no recorra el juego completo.