Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/multica-ai/andrej-karpathy-skills/llms.txt

Use this file to discover all available pages before exploring further.

This page explains how to use the Karpathy-inspired behavioral guidelines in Cursor. The andrej-karpathy-skills repository includes a committed Cursor project rule — .cursor/rules/karpathy-guidelines.mdc — so the same four principles that govern Claude Code behavior apply automatically whenever you open the project in Cursor, without any extra setup.

Set up in this repository

1

Open the folder in Cursor

Open the andrej-karpathy-skills repository folder in Cursor as you would any project. No additional installation is needed.
2

The rule is already committed

The file .cursor/rules/karpathy-guidelines.mdc is committed to the repository with alwaysApply: true. Cursor picks it up automatically when the folder is open.
When a rule has alwaysApply: true, Cursor injects it into every agent and chat context within the project without you needing to reference it manually. You will never have to remember to attach it.
3

Verify under Settings → Rules

In Cursor, open Settings → Rules (or the project rules UI). The karpathy-guidelines rule should appear in the list of active project rules, confirming it is loaded.

Use the guidelines in another project

To bring the same behavioral guidelines into a different codebase, copy the committed rule file into that project.

Optional: personal Agent Skills

If you want the guidelines available as a reusable personal skill across all your projects — not just ones where you copy the rule file — use the ~/.cursor/skills/ approach. The repository includes skills/karpathy-guidelines/SKILL.md. Copy or symlink it into your personal Cursor skills directory:
mkdir -p ~/.cursor/skills/karpathy-guidelines
cp skills/karpathy-guidelines/SKILL.md ~/.cursor/skills/karpathy-guidelines/SKILL.md
Use whatever layout you already use for other personal skills. Once placed there, the skill is available in Cursor agent contexts across any project you open.

Claude Code vs Cursor

The guidelines are the same in both tools, but the delivery mechanism differs:
Claude CodeCursor
Primary methodPlugin marketplace or CLAUDE.md in project rootCommitted .cursor/rules/karpathy-guidelines.mdc
Reads CLAUDE.mdYes, by defaultNo — Cursor does not read CLAUDE.md automatically
Reads .cursor/rules/NoYes — loaded automatically when alwaysApply: true
Per-project installCopy CLAUDE.md to projectCopy .mdc file to .cursor/rules/
Personal/global installPlugin marketplace installationCopy skill to ~/.cursor/skills/
If you use both tools on the same project, commit both CLAUDE.md and .cursor/rules/karpathy-guidelines.mdc so each editor picks up its own format.

For contributors

When you update the four principles, keep the following files in sync manually — there is no automated check:
  • CLAUDE.md — read by Claude Code
  • .cursor/rules/karpathy-guidelines.mdc — read by Cursor
  • skills/karpathy-guidelines/SKILL.md — used as a personal reusable skill
The content of all three should reflect the same four principles so behavior is consistent regardless of which editor a contributor uses.

Build docs developers (and LLMs) love