This project provides Andrej Karpathy's coding guidelines as installable extensions for Cursor and VS Code. It aims to help developers integrate these principles directly into their workflow, promoting cleaner, more effective code by leveraging editor capabilities.

How It Works

The extension packages Karpathy's coding guidelines, originally presented as markdown, into a format compatible with Cursor and VS Code's rule systems. The core value proposition is the instructional content itself, requiring minimal runtime or dependencies. This approach allows the principles to be directly applied within the editor environment, enhancing developer adherence to best practices.

Quick Start & Requirements

• Install: Search for "Andrej Karpathy Skills" in the VS Code Extensions view or the Open VSX Registry for Cursor.
• Prerequisites: VS Code or Cursor editor.
• Setup: After installation, open the Command Palette and run Karpathy Rules: Add to project (.cursor/rules) (recommended for Cursor, sets alwaysApply: true) or Karpathy Rules: Add to .cursorrules (legacy).
• Manual Setup: Copy rules/karpathy-guidelines.md to .cursor/rules/karpathy-guidelines.md (Cursor) or .cursorrules (legacy).
• Links: Available via VS Code Marketplace and Open VSX Registry.

Highlighted Details

• Integrates Andrej Karpathy's four core principles: Think Before Coding, Simplicity First, Surgical Changes, and Goal-Driven Execution.
• Inspired by a similar markdown-based extension that gained significant community traction (3,500+ stars).
• Designed for seamless integration into Cursor and VS Code workflows.

Maintenance & Community

This plugin was developed as part of the Samotics AI Challenge Day. Publisher verification is pending eligibility. No specific community channels or roadmap details are provided in the README.

Licensing & Compatibility

Guidelines are adapted from a MIT-licensed source. The extension operates under a similar spirit, deferring exact terms to the upstream repository. Compatibility for commercial use is likely permissive, aligning with the MIT license of the adapted guidelines.

Limitations & Caveats

As a new extension, it may display an "untrusted publisher" warning in VS Code until Microsoft verification is granted. The extension's simplicity means its functionality is primarily driven by the content of the rules themselves, offering limited customization beyond what the guidelines dictate.