karpathy-guidelines

Applies behavioral guidelines to reduce overcomplication and unverified changes in LLM-generated code.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? LLM coding assistants often overcomplicate solutions, make sweeping unrequested changes, hide assumptions, and declare success without verification. This Skill provides a set of behavioral guidelines, derived from Andrej Karpathy's observations on LLM coding pitfalls, that keep code changes minimal, explicit, and verifiable. ## Core Features & Use Cases - Think Before Coding: Forces explicit statement of assumptions, presentation of alternative interpretations, and stopping to ask when requirements are unclear. - Simplicity and Surgical Changes: Enforces minimum-code solutions with no speculative abstractions, and restricts edits to only what the request requires while matching existing style. - Goal-Driven Execution: Transforms vague tasks into verifiable success criteria (e.g., write a failing test, then make it pass) with step-by-step verification plans. - Use Case: When asking an AI to fix a bug or refactor a module, apply these guidelines so the agent writes a reproduction test first, changes only the relevant lines, and verifies the fix instead of self-attesting success. ## Quick Start Ask the agent to apply the karpathy-guidelines skill while implementing or reviewing your next code change so it states assumptions, keeps edits surgical, and verifies against defined 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 stop an AI coding assistant from overcomplicating code?

Apply guidelines that require minimum code to solve the problem: no unrequested features, no abstractions for single-use code, and no speculative configurability. The skill instructs the agent to rewrite any solution that a senior engineer would call overcomplicated.

How to make LLM code changes surgical instead of rewriting everything?

Instruct the agent to touch only what the request requires: no improving adjacent code, no refactoring unbroken code, and matching existing style. Every changed line should trace directly back to the user's request.

When should I not use these coding guidelines?

The guidelines bias toward caution over speed, so they may be excessive for trivial tasks. For small one-off edits or throwaway scripts, use judgment rather than applying the full assumption-surfacing and verification process.

How do I verify an AI actually fixed a bug instead of claiming it did?

Convert the task into a verifiable goal: write a test that reproduces the bug, then make it pass. The skill's goal-driven execution section requires defining success criteria and looping until they are verified rather than accepting self-attestation.

Does this skill work with any programming language or framework?

Yes, the guidelines are language-agnostic behavioral instructions, not code or scripts. They apply to any writing, reviewing, or refactoring task regardless of the tech stack, since they govern agent behavior rather than tooling.