karpathy-guidelines

Enforce disciplined behavioral guidelines for LLM coding tasks.

1|Updated Aug 28, 2025
One-click install
npx skills add https://github.com/yilinfang/dotfiles-public --skill karpathy-guidelines-yilinfang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: karpathy-guidelines
Source: https://github.com/yilinfang/dotfiles-public/tree/main/home/dot_claude/skills/karpathy-guidelines
Command: npx skills add https://github.com/yilinfang/dotfiles-public --skill karpathy-guidelines-yilinfang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, surface assumptions, and define verifiable success criteria.

Core Features & Use Cases

  • Think Before Coding: explicitly state assumptions, surface tradeoffs, and ask when unclear.
  • Simplicity First: prefer minimal, direct changes with no unnecessary abstractions.
  • Surgical Changes: modify only what is necessary and preserve existing style.
  • Goal-Driven Execution: define verifiable success criteria and loop until satisfied.

Quick Start

Ask the AI to apply these guidelines during writing, reviewing, or refactoring tasks.

Frequently Asked Questions about karpathy-guidelines

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

FAQPage Schema
How do I reduce common LLM coding mistakes during refactoring?

To reduce LLM coding mistakes during refactoring, apply behavioral guidelines that enforce simplicity, surgical changes, and verifiable success criteria. This approach minimizes overcomplication and surfaces hidden assumptions.

What are the best guidelines for LLM-assisted code review?

The best guidelines for LLM-assisted code review require explicitly stating assumptions, surfacing tradeoffs, and defining verifiable success criteria before execution. This ensures the AI loops until the goal is satisfied.

How do I make LLM code changes more surgical and minimal?

To make LLM code changes surgical, enforce guidelines that prefer minimal, direct modifications and preserve existing style. The AI modifies only what is necessary, avoiding unnecessary abstractions.

Does applying LLM coding guidelines work for any programming language?

Yes, applying LLM coding guidelines works across multiple languages and project sizes. The behavioral rules focus on iterative improvement and risk management rather than language-specific syntax.

Why does my LLM generate overcomplicated code with unnecessary abstractions?

Your LLM generates overcomplicated code because it lacks enforced simplicity constraints. By applying structured guidelines, the AI prioritizes minimal, direct changes and must think before coding.

How do I define verifiable success criteria for LLM coding tasks?

To define verifiable success criteria for LLM coding tasks, enforce goal-driven execution guidelines that require the AI to loop and test iteratively until the explicit success conditions are satisfied.