Karpathy Coding Skills
Four rules from Karpathy's LLM coding critiques baked into a Claude Code plugin
A single CLAUDE.md file encoding four coding principles derived from Andrej Karpathy's public observations about where LLMs fail at software development: think before coding (write a plan first), simplicity first (fewest lines that solve the problem), surgical changes (modify the minimum surface area), and goal-driven execution (stay focused on the stated objective). Install it as a global Claude Code plugin or drop it in any project repo. It acts as a persistent system prompt that nudges the model toward the behaviors Karpathy identified as missing from most AI coding sessions — particularly the tendency to over-engineer and produce sprawling diffs. The file isn't officially from Karpathy — it's a community distillation — but it went viral anyway, accumulating 16k+ GitHub stars in under 48 hours. Whether it actually changes model behavior meaningfully is debated, but the overwhelming community reaction suggests these four principles resonated as a clean articulation of what's actually broken.
Panel Reviews
The Builder
Developer Perspective
“I dropped this in my project root on Monday and by Wednesday I'd noticed my Claude sessions were producing tighter PRs. Could be placebo, but the 'surgical changes' rule alone seems to cut diff sizes by 30-40% in my experience. It costs nothing to try.”
The Skeptic
Reality Check
“This is a CLAUDE.md file with four bullet points. The 16k stars are for Karpathy's credibility as a meme, not the engineering content. Any experienced prompt engineer has been writing these instructions for months. There's nothing novel here — the viral success is marketing, not substance.”
The Futurist
Big Picture
“What's interesting here isn't the file — it's the behavior. The community converged on four agreed-upon principles for AI coding in under 48 hours, without any coordination. That's an emergent standards moment. Expect these four principles (or close variants) to be embedded in default system prompts within 6 months.”
The Creator
Content & Design
“The 'simplicity first' rule applies just as well to AI-generated copy and design briefs as it does to code. I've adapted this into a writing CLAUDE.md for my content workflow and it actually does reduce the 'AI maximalism' problem where everything comes back more elaborate than you wanted.”
Community Sentiment
“Skepticism about whether CLAUDE.md actually changes behavior”
“Karpathy's four principles, installation simplicity”
“Viral spread, Karpathy association”