> ## Documentation Index
> Fetch the complete documentation index at: https://docs.karpathy.phronesisagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Karpathy Skills: Claude Code and Cursor setup

> Install the Karpathy Skills plugin via the Claude Code marketplace in two commands, or add the CLAUDE.md file directly to any project.

Karpathy Skills can be installed in two ways: as a Claude Code plugin that applies the guidelines across all your projects, or as a `CLAUDE.md` file dropped into a single project. Choose the option that fits your workflow.

<Info>
  The Claude Code plugin applies the guidelines globally — every project you open in Claude Code inherits them. The `CLAUDE.md` approach applies the guidelines only to the project where the file lives.
</Info>

<Tabs>
  <Tab title="Option A: Claude Code plugin (recommended)">
    Installing as a plugin is the fastest way to get the guidelines running across all your projects without touching individual repositories.

    <Steps>
      <Step title="Add the marketplace">
        Inside Claude Code, run:

        ```bash theme={null}
        /plugin marketplace add forrestchang/andrej-karpathy-skills
        ```

        This registers the Karpathy Skills marketplace so Claude Code can find the plugin.
      </Step>

      <Step title="Install the plugin">
        ```bash theme={null}
        /plugin install andrej-karpathy-skills@karpathy-skills
        ```

        After installation, the four behavioral guidelines are active in every Claude Code session — no per-project setup required.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Option B: Per-project CLAUDE.md">
    If you prefer to keep the guidelines scoped to a single project, or if you are not using the Claude Code plugin system, you can add the `CLAUDE.md` file directly.

    <Steps>
      <Step title="New project">
        In your project root, run:

        ```bash theme={null}
        curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
        ```

        This downloads the file and saves it as `CLAUDE.md` in the current directory.
      </Step>

      <Step title="Existing project (append)">
        If you already have a `CLAUDE.md`, append the guidelines rather than overwriting:

        ```bash theme={null}
        echo "" >> CLAUDE.md
        curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
        ```

        The blank line separates your existing instructions from the appended guidelines.
      </Step>
    </Steps>

    <Tip>
      The guidelines are designed to be merged with project-specific instructions. After appending, you can add a `## Project-Specific Guidelines` section below them with any rules unique to your codebase.
    </Tip>
  </Tab>
</Tabs>

## Cursor setup

If you use Cursor, the repository includes a committed Cursor project rule that applies the same guidelines. See the [Cursor setup guide](/guides/cursor) for instructions on enabling the rule in Cursor and using it across other projects.