karpathy-guidelines

Enforce behavioral discipline for LLM coding with explicit assumptions and verifiable criteria.

2|Updated May 12, 2026
One-click install
npx skills add https://github.com/youfengknight/Android-Code-Skills --skill karpathy-guidelines-youfengknight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: karpathy-guidelines
Source: https://github.com/youfengknight/Android-Code-Skills/tree/main/karpathy-guidelines
Command: npx skills add https://github.com/youfengknight/Android-Code-Skills --skill karpathy-guidelines-youfengknight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It reduces common LLM-generated coding mistakes by enforcing clear thinking, minimal changes, and verifiable success criteria instead of overconfident or overcomplicated implementations.

Core Features & Use Cases

  • Surgical Changes: limits edits to only what’s required and cleans up only your own introduced artifacts to prevent unintended side effects.
  • Simplicity First: discourages speculative abstractions, unnecessary error handling, and “flexibility” not requested by the task.
  • Goal-Driven Execution: turns vague requests into explicit, testable success criteria with checkpoints for iterative verification.

What it’s for

Use it during LLM-assisted coding, code reviews, and refactors where the risk is misunderstanding requirements, bloating the solution, or failing to verify outcomes.

Quick Start

Ask the AI to apply the karpathy-guidelines to your task by explicitly listing assumptions and required interpretations, proposing the smallest surgical change set, and defining concrete success criteria you can verify with tests or checks.

Frequently Asked Questions about karpathy-guidelines

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

FAQPage Schema
How do I stop LLM coding from generating bloated or overcomplicated solutions?

To stop LLM coding from generating bloated solutions, enforce simplicity-first implementation by discouraging speculative abstractions and unnecessary error handling. This approach limits edits to only what the task requires, preventing overconfident or unintended side effects.

What is the best way to ensure surgical changes during LLM-assisted refactoring?

The best way to ensure surgical changes during refactoring is to limit edits strictly to what is required and clean up only your own introduced artifacts. This prevents unintended side effects and maintains code integrity during LLM-assisted modifications.

How do you define verifiable success criteria for ambiguous coding tasks?

Defining verifiable success criteria for ambiguous coding tasks involves turning vague requests into explicit, testable checkpoints. This goal-driven execution requires iterative verification to ensure outcomes match expectations without guessing.

Why does LLM-generated code fail when requirements are ambiguous?

LLM-generated code fails when requirements are ambiguous because it often makes hidden assumptions without explicit verification. Surfacing assumptions before implementation prevents overcomplicated solutions and ensures the code meets actual requirements.

Do I need to explicitly list assumptions before an AI refactors my code?

Yes, you need to explicitly list assumptions before an AI refactors code to ensure clear thinking and minimal changes. Explicit assumption surfacing prevents misunderstandings and bloated solutions during the modification process.