# forrestchang-andrej-karpathy-skills-claude-code-2026-01-27

## Veille

Claude Code guidelines inspired by Karpathy - 4 anti-bloat principles

## Titre Article

Andrej Karpathy Skills for Claude Code

## Date

2026-01-27

## URL

https://github.com/forrestchang/andrej-karpathy-skills

## Keywords

Claude Code, Andrej Karpathy, skills, CLAUDE.md, AI coding principles, simplicity, surgical changes, prompt engineering, LLM limitations, development best practices

## Authors

forrestchang (GitHub), basé sur observations d'Andrej Karpathy

## Ton

**Profile**: Concise technical documentation, prescriptive and practical register, intermediate technical level

**Description**: The README adopts a direct, pragmatic tone, structured around observed problems and concrete solutions. The style is that of well-written open source documentation: clear sections, copyable installation examples, numbered principles. Authority rests on the reference to Andrej Karpathy (a respected figure in AI) and on the empirical observation of problematic LLM behaviors. The target audience consists of developers using Claude Code who seek to improve output quality.

## Pense-betes

- **3,456 stars** within days - a sign of a real need within the Claude Code community
- **Problems identified by Karpathy**: 1. Erroneous assumptions without verification 2. Over-engineering and unnecessary abstractions 3. Modifications/removal of code not fully understood
- **Principle 1 - Think Before Coding**: Make assumptions explicit, ask clarifying questions, present several approaches in case of ambiguity, stop when confused
- **Principle 2 - Simplicity First**: Minimal code addressing only the request, no speculative features, no unnecessary abstractions, no unrequested configurability. Test: "would an experienced engineer find this over-engineered?"
- **Principle 3 - Surgical Changes**: Modify only the code related to the request, preserve existing style and comments, do not remove pre-existing dead code unless explicitly requested
- **Principle 4 - Goal-Driven Execution**: Convert tasks into verifiable success criteria. E.g.: "add validation" → "write tests for invalid inputs, then make them pass"
- **Key insight**: Models excel at "looping until a specific goal is reached" - define success criteria rather than imperative instructions
- **Installation**: Claude plugin (`claude plugins add`) or per-project CLAUDE.md file
- **Important caveat**: For trivial changes (typos, obvious one-liners), apply common sense rather than full rigor

## RésuméDe400mots

This GitHub repository offers a set of guidelines for Claude Code, inspired by Andrej Karpathy's observations on the limitations of LLMs in software development. With over 3,400 stars within days, it clearly addresses a need within the community.

**Identified problems**: Karpathy observed that models tend to make erroneous assumptions without verification and to "head off in a direction" without validating their premises. They often over-complicate solutions, creating unnecessary abstractions when simple approaches would suffice. Finally, they sometimes modify or remove code they do not fully understand, even when unrelated to the requested task.

**Four founding principles**:

The first principle, "Think Before Coding", requires making assumptions explicit and asking clarifying questions rather than guessing. In case of ambiguity, present several viable approaches. Stop and acknowledge confusion when it occurs.

The second principle, "Simplicity First", prescribes writing the minimal code that addresses only what is requested. Avoid speculative features, unnecessary abstractions, and unsolicited configurability. Remove error handling for impossible scenarios. The test: would an experienced engineer consider this code over-engineered?

The third principle, "Surgical Changes", limits modifications to code directly related to the user's request. Preserve existing style and comments. Remove pre-existing dead code only upon explicit request.

The fourth principle, "Goal-Driven Execution", converts tasks into specific, verifiable success criteria. Rather than "add validation", formulate "write tests for invalid inputs, then make them pass". Use brief numbered plans with verification steps.

**Core insight**: Models excel at "looping until specific goals are reached". Rather than issuing imperative instructions, define clear success criteria and let the system iterate toward those goals.

**Installation and usage**: The repository can be installed as a Claude plugin (`claude plugins add`) or downloaded as a per-project CLAUDE.md file. The guidelines are designed to be merged with project-specific rules.

**Success indicators**: Diffs contain only the requested changes, code avoids unnecessary complexity on the first attempt, clarifying questions precede implementation, and pull requests remain focused without tangential refactoring.

**Caveat**: These guidelines prioritize precision over speed. For trivial changes (typos, obvious one-line edits), apply common sense rather than full rigor.

## GrapheDeConnaissance

- andrej-karpathy-skills —s_inspire_de→ Andrej Karpathy (PERSONNE, 0.97)
- forrestchang —a_créé→ andrej-karpathy-skills (TECHNOLOGIE, 0.99)
- andrej-karpathy-skills —améliore→ Claude Code (TECHNOLOGIE, 0.92)
- andrej-karpathy-skills —utilise→ CLAUDE.md (TECHNOLOGIE, 0.98)
- hypothèses erronées sans vérification —observé_dans→ Claude Code (TECHNOLOGIE, 0.93)
- sur-ingénierie —observé_dans→ Claude Code (TECHNOLOGIE, 0.93)
- Think Before Coding —réduit→ hypothèses erronées sans vérification (CONCEPT, 0.9)
- Simplicity First —réduit→ sur-ingénierie (CONCEPT, 0.9)
- Surgical Changes —recommande→ préservation du code existant (CONCEPT, 0.88)
- Goal-Driven Execution —remplace→ instructions impératives (CONCEPT, 0.87)
- Goal-Driven Execution —utilise→ critères de succès vérifiables (CONCEPT, 0.92)
- andrej-karpathy-skills —mesure→ 3 456 étoiles GitHub (MESURE, 0.95)
- andrej-karpathy-skills —utilise→ licence MIT (CONCEPT, 0.99)

---
Canonical: https://www.thekb.eu/en/fiches/forrestchang-andrej-karpathy-skills-claude-code-2026-01-27/