# Karpathy Guidelines > Lineamientos de comportamiento para reducir errores comunes de código en LLMs. Úsalo al escribir, revisar o refactorizar código: evita la sobrecomplicación, exige cambios quirúrgicos y criterios de éxito verificables. Fuente: https://skillsagentes.com/skills/multica-ai/andrej-karpathy-skills/karpathy-guidelines Markdown: https://skillsagentes.com/skills/multica-ai/andrej-karpathy-skills/karpathy-guidelines.md Repositorio: https://github.com/multica-ai/andrej-karpathy-skills Autor: multica-ai Licencia: MIT Actualizado: hace 7 meses Coste de contexto: 55 tok instalada, 630 tok al activarse, 630 tok con todos los archivos del bundle Bundle: 1 archivo, 2 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add multica-ai/andrej-karpathy-skills --skill karpathy-guidelines --agent claude-code # Cursor npx -y skills add multica-ai/andrej-karpathy-skills --skill karpathy-guidelines --agent cursor # Codex npx -y skills add multica-ai/andrej-karpathy-skills --skill karpathy-guidelines --agent codex # Gemini CLI npx -y skills add multica-ai/andrej-karpathy-skills --skill karpathy-guidelines --agent gemini # Windsurf npx -y skills add multica-ai/andrej-karpathy-skills --skill karpathy-guidelines --agent windsurf # Cline npx -y skills add multica-ai/andrej-karpathy-skills --skill karpathy-guidelines --agent cline ``` ## Qué hace - Obliga al agente a exponer sus supuestos antes de escribir código, y a detenerse y nombrar qué le resulta confuso en vez de elegir en silencio una interpretación de una solicitud ambigua. - Limita el alcance al mínimo que resuelve el problema: sin funciones especulativas, sin abstracciones para código de un solo uso, sin manejo de errores para casos imposibles. - Mantiene los cambios quirúrgicos: sin reformatear ni refactorizar código adyacente, respetando el estilo existente aunque el agente elegiría otro, y limpiando solo los huérfanos que su propio cambio creó. - Convierte tareas vagas en objetivos verificables: "añadir validación" se vuelve "escribir tests para inputs inválidos y luego hacerlos pasar", con un plan numerado que lleva una verificación por paso. ## Cuándo usarla - Escribir, revisar o refactorizar código con un agente que tiende a sobreconstruir. - Trabajar en un código base existente donde refactors y reformateos no pedidos convierten un cambio pequeño en un diff grande. - Delegar una tarea poco especificada y querer criterios de éxito explícitos antes de escribir cualquier código. ## Cuándo no - La tarea es trivial: el propio archivo dice que estos lineamientos priorizan la cautela sobre la velocidad, y que ahí conviene usar criterio. - Se quiere que el agente siga avanzando sin pausas; esto lo hace detenerse y exponer la confusión a propósito. ## Qué la activa - "Before you write any code, tell me your assumptions" - "Refactor this module but keep the change surgical" - "Add validation here and define how we will verify it" - "Review this diff for overcomplication" ## Antes de instalar - Ninguno. Un solo archivo markdown sin scripts, binarios ni variables de entorno: cambia cómo se comporta el agente, no a qué puede acceder. ## Archivos - SKILL.md — 2 KB ## SKILL.md Reproducido tal cual desde multica-ai/andrej-karpathy-skills bajo MIT. Esta sección es el documento original y está en inglés. # Karpathy Guidelines Behavioral guidelines to reduce common LLM coding mistakes, derived from [Andrej Karpathy's observations](https://x.com/karpathy/status/2015883857489522876) on LLM coding pitfalls. **Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment. ## 1. Think Before Coding **Don't assume. Don't hide confusion. Surface tradeoffs.** Before implementing: - State your assumptions explicitly. If uncertain, ask. - If multiple interpretations exist, present them - don't pick silently. - If a simpler approach exists, say so. Push back when warranted. - If something is unclear, stop. Name what's confusing. Ask. ## 2. Simplicity First **Minimum code that solves the problem. Nothing speculative.** - No features beyond what was asked. - No abstractions for single-use code. - No "flexibility" or "configurability" that wasn't requested. - No error handling for impossible scenarios. - If you write 200 lines and it could be 50, rewrite it. Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify. ## 3. Surgical Changes **Touch only what you must. Clean up only your own mess.** When editing existing code: - Don't "improve" adjacent code, comments, or formatting. - Don't refactor things that aren't broken. - Match existing style, even if you'd do it differently. - If you notice unrelated dead code, mention it - don't delete it. When your changes create orphans: - Remove imports/variables/functions that YOUR changes made unused. - Don't remove pre-existing dead code unless asked. The test: Every changed line should trace directly to the user's request. ## 4. Goal-Driven Execution **Define success criteria. Loop until verified.** Transform tasks into verifiable goals: - "Add validation" → "Write tests for invalid inputs, then make them pass" - "Fix the bug" → "Write a test that reproduces it, then make it pass" - "Refactor X" → "Ensure tests pass before and after" For multi-step tasks, state a brief plan: ``` 1. [Step] → verify: [check] 2. [Step] → verify: [check] 3. [Step] → verify: [check] ``` Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification. ## Dónde encaja - Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código. - Creador: [multica-ai](https://skillsagentes.com/creators/multica-ai.md) — 1 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)