karpathy-guidelines

Applies behavioral guidelines to reduce common LLM coding mistakes during code writing and review.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/assafmanor/waypoint --skill karpathy-guidelines-assafmanor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: karpathy-guidelines
Source: https://github.com/assafmanor/waypoint/tree/main/.claude/skills/karpathy-guidelines
Command: npx skills add https://github.com/assafmanor/waypoint --skill karpathy-guidelines-assafmanor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? LLM-generated code often suffers from overcomplication, unrequested features, silent assumptions, and sprawling edits that touch unrelated code. This Skill provides a set of behavioral guidelines, derived from Andrej Karpathy's observations on LLM coding pitfalls, that keep AI-assisted coding focused, minimal, and verifiable. ## Core Features & Use Cases - Think Before Coding: Surfaces assumptions, ambiguities, and simpler alternatives before implementation instead of silently picking an interpretation. - Simplicity First: Blocks speculative abstractions, unrequested configurability, and unnecessary error handling so code stays minimal. - Surgical Changes: Restricts edits to lines that trace directly to the user's request, matching existing style and leaving unrelated code untouched. - Goal-Driven Execution: Converts vague tasks into verifiable success criteria, such as writing a failing test before fixing a bug. - Use Case: When asking an AI to refactor a function or fix a bug, activate these guidelines so the change is minimal, assumptions are stated explicitly, and success is verified by tests rather than by "it looks right". ## Quick Start Ask the AI to apply the karpathy-guidelines skill while implementing or reviewing your next code change so it states assumptions, keeps edits surgical, and defines verifiable success criteria.

Frequently Asked Questions about karpathy-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reduce overcomplication in AI-generated code?▼

Apply guidelines that forbid speculative features, single-use abstractions, and unrequested configurability. The skill instructs the AI to write the minimum code that solves the problem and to rewrite anything a senior engineer would call overcomplicated.

How to make AI coding assistants make smaller, safer edits?▼

Use surgical-change rules: every modified line must trace directly to the user's request, adjacent code and formatting stay untouched, and existing style is matched. Pre-existing dead code is mentioned but never deleted without being asked.

When should I not use these coding guidelines?▼

The guidelines bias toward caution over speed, so for trivial tasks they may add unnecessary overhead. The skill itself advises using judgment and skipping the full rigor for simple, low-risk changes.

How do I turn vague coding tasks into verifiable goals?▼

Transform each task into a testable criterion: write tests for invalid inputs before adding validation, or write a failing test that reproduces a bug before fixing it. Multi-step work gets a short plan with a verification check per step.

Does this skill work with any programming language or framework?▼

Yes, the guidelines are language-agnostic behavioral instructions rather than code or scripts. They apply to any writing, reviewing, or refactoring task regardless of the tech stack involved.