karpathy-guidelines

Apply Karpathy-inspired coding guidelines to code reviews and refactoring.

Updated May 27, 2026
One-click install
npx skills add https://github.com/RuifengFu/agent-skills --skill karpathy-guidelines-ruifengfu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: karpathy-guidelines
Source: https://github.com/RuifengFu/agent-skills/tree/main/opencode/karpathy-guidelines
Command: npx skills add https://github.com/RuifengFu/agent-skills --skill karpathy-guidelines-ruifengfu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill assists developers in adhering to Karpathy-inspired coding principles, helping to avoid common mistakes and overengineering.

Core Features & Use Cases

  • Think Before Coding: Encourages explicit assumptions and tradeoff considerations before implementation.
  • Simplicity First: Promotes writing minimal, non-speculative code for the specific problem at hand.
  • Surgical Changes: Instructs on making changes only where necessary, avoiding unnecessary code alteration.
  • Goal-Driven Execution: Ensures every change is verifiable, with defined success criteria and iterative improvement.
  • Use Case: Ideal for code reviews, refactoring sessions, or before implementing new features.

Quick Start

Apply the 'karpathy-guidelines' skill when beginning a new coding task to ensure best practices are followed.

Frequently Asked Questions about karpathy-guidelines

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

FAQPage Schema
How do I avoid overengineering when developing new software features?

To avoid overengineering during software development, define explicit assumptions and tradeoffs before coding. Maintain simplicity by writing minimal, non-speculative code, and ensure every change is verifiable with defined success criteria.

What are the best coding guidelines for making surgical changes during code refactoring?

Effective coding guidelines for refactoring dictate making surgical changes only where necessary. Avoid altering unrelated code by defining clear goals and assumptions beforehand, ensuring your refactoring remains focused and verifiable through testable criteria.

How should I define assumptions and tradeoffs before writing code?

Defining assumptions and tradeoffs before writing code involves explicitly stating your goals and constraints. This goal-driven execution ensures every implementation step is verifiable, promoting simplicity and preventing speculative, unnecessary code.

Can I use Karpathy coding principles for code reviews?

Yes, you can apply Karpathy coding principles during code reviews to enforce clarity and efficiency. They help reviewers check for defined success criteria, minimal non-speculative code, and surgical changes, preventing overengineering.

Why does my code lack simplicity and become overengineered?

Code often becomes overengineered when developers skip defining clear goals and assumptions before implementation. Adopting coding guidelines that promote minimal, non-speculative code and surgical changes restores simplicity and focus.

When do I need coding guidelines to improve code quality?

You need coding guidelines to improve code quality when beginning new feature development, conducting code reviews, or refactoring. They ensure goal-driven execution, surgical changes, and verifiable success criteria to prevent overengineering.