ProgramaciónKarpathy Guidelines (andrej-karpathy-skills)
Son 4 reglas de comportamiento para que tu IA deje de cometer los errores típicos al programar: no asumir cosas por su cuenta, no complicar el código, no tocar lo que no debe y trabajar con objetivos verificables. Es un único archivo de texto basado en las observaciones de Andrej Karpathy.
Revisada el 2026-09-21
- Popularidad
- 214.5k
- Licencia
- MIT
- Categoría
- Programación
Seguridad: revisada
Revisada, sin código malicioso.
¿Qué es?
Es un archivo corto de reglas de conducta (un CLAUDE.md/skill) que corrige los defectos más comunes de las IA al programar. Nace de unas observaciones que publicó Andrej Karpathy (ex-director de IA en Tesla, cofundador de OpenAI).
Piénsalo como las normas de un buen programador senior, escritas para que la IA las respete: piensa antes de escribir, hazlo simple, toca solo lo necesario y define cómo saber si funcionó.
Las 4 reglas:
| Regla | Problema que corrige |
|---|---|
| 1. Piensa antes de programar | La IA asume cosas y sigue adelante sin preguntar; no expone dudas ni alternativas |
| 2. Simplicidad primero | La IA complica el código, crea abstracciones inútiles y hace 1000 líneas donde bastan 100 |
| 3. Cambios quirúrgicos | La IA "mejora" código que no le pediste y borra cosas que no entiende |
| 4. Ejecución por objetivos | Convertir órdenes vagas ("arregla el bug") en metas verificables ("escribe un test que falle, luego hazlo pasar") |
Ejemplos concretos:
- Regla 1: si hay dos interpretaciones, que las presente en vez de elegir una en silencio.
- Regla 2: prohibido añadir funciones ni "flexibilidad" que no pediste.
- Regla 3: cada línea cambiada debe corresponder directamente a lo que pediste.
- Regla 4: definir criterios de éxito y repetir hasta cumplirlos.
Aviso del propio repo: estas reglas van por la vía de la cautela sobre la velocidad. Para tareas triviales (arreglar una errata), usa el criterio.
¿Cuándo me sirve?
Cuando programas con IA y notas que comete estos errores:
- "La IA cambia cosas que no le pedí" → regla 3.
- "Me hace un código gigante y complicado" → regla 2.
- "Asume cosas mal y no pregunta" → regla 1.
- "No sé si de verdad funciona" → regla 4.
¿Esto me sirve a mí?
Sí, si usas IA para programar y te frustran sus "vicios" habituales.
| Si un día piensas... | Estas reglas corrigen... |
|---|---|
| "Me toca código que no debe" | Cambios quirúrgicos |
| "Hace 500 líneas para algo simple" | Simplicidad primero |
| "Se inventa requisitos" | Piensa antes de programar |
| "Dice que funciona pero no lo prueba" | Ejecución por objetivos |
| "Vibe-codear me da desastres" | Las 4 reglas juntas |
No te sirve si no programas.
¿Es segura?
Veredicto: ✅ SÍ, es limpia (y de las más simples que hay).
- Contenido: el repositorio entero son 4 archivos de texto (
CLAUDE.md,SKILL.md,EXAMPLES.md,CURSOR.md) más unos pocos de configuración. No hay ni un solo script. - Qué hace: solo da instrucciones de comportamiento a tu IA. No ejecuta nada, no se conecta a internet, no instala nada.
- Origen: el repo lo mantiene
multica-ai, basado en las observaciones públicas de Andrej Karpathy (figura muy respetada). Licencia MIT. - A tener en cuenta: el README menciona el comando de instalación con el nombre antiguo (
forrestchang/...), porque el repo se transfirió amultica-ai. Es solo un detalle de la mudanza, no un problema.
Casos de uso
- Mejorar el comportamiento general de tu IA: instalarlo como skill o pegar su contenido en
CLAUDE.md/AGENTS.md. - Evitar sobreingeniería: regla 2.
- Reducir cambios no pedidos: regla 3.
- Trabajar con objetivos claros: regla 4.
- Complemento de TDD: la regla 4 encaja con las skills de pruebas.
Cómo se instala
Opción A — como skill (cualquier agente):
npx skills add multica-ai/andrej-karpathy-skillsOpción B — como CLAUDE.md (por proyecto):
curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.mdOpción C — Cursor: usa el archivo .cursor/rules/karpathy-guidelines.mdc.
¿Dónde funciona?
| CLI | ¿Funciona? | Notas |
|---|---|---|
| OpenCode | ✅ Sí | Vía npx skills add o pegando el texto en AGENTS.md |
| Claude Code | ✅ Sí | Entorno principal (plugin y CLAUDE.md) |
| Cursor | ✅ Sí | Incluye regla específica para Cursor |
| Codex | ✅ Sí | Pegando el texto en AGENTS.md |
| Gemini CLI | ✅ Sí | Pegando el texto en GEMINI.md |
| Otros | ✅ Sí | Es texto puro; se pega donde lea instrucciones tu asistente |
Es la más universal de todas: al ser solo texto, funciona en cualquier asistente que lea instrucciones.
Enlaces
- Repositorio: https://github.com/multica-ai/andrej-karpathy-skills
- Post original de Karpathy: https://x.com/karpathy/status/2015883857489522876