# rji113/andrej-karpathy-skills architecture

> Architecture diagram of the GitHub repository rji113/andrej-karpathy-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rji113/andrej-karpathy-skills
- Repository: https://github.com/rji113/andrej-karpathy-skills

## Overview

This is a small set of AI coding guidelines distributed for Claude Code and Cursor, not a runtime software application. The main workflow is to choose an integration, make the guidelines available to the coding assistant, and have it apply four principles during coding tasks. The README documents the integrations and intended behavior; source excerpts were not provided, so the graph shows only those documented relationships.

Main entry points: [`.claude-plugin/plugin.json`](https://github.com/rji113/andrej-karpathy-skills/blob/main/.claude-plugin/plugin.json) (Plugin metadata), [`skills/karpathy-guidelines/SKILL.md`](https://github.com/rji113/andrej-karpathy-skills/blob/main/skills/karpathy-guidelines/SKILL.md) (Guidelines skill), [`CLAUDE.md`](https://github.com/rji113/andrej-karpathy-skills/blob/main/CLAUDE.md) (Claude guidelines), [`.claude-plugin/marketplace.json`](https://github.com/rji113/andrej-karpathy-skills/blob/main/.claude-plugin/marketplace.json) (Plugin marketplace)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("Project user"))
node_claude["Claude Code"]
node_cursor["Cursor"]
node_marketplace["Plugin marketplace<br/>[marketplace.json]"]
node_plugin["Plugin metadata<br/>[plugin.json]"]
node_skill["Guidelines skill<br/>[SKILL.md]"]
node_claude_file["Claude guidelines<br/>[CLAUDE.md]"]
node_cursor_rule["Cursor rule"]

node_user -->|"adds marketplace"| node_marketplace
node_user -->|"installs plugin"| node_plugin
node_plugin -->|"exposes skill"| node_skill
node_claude -->|"uses skill"| node_skill
node_user -->|"copies guidelines"| node_claude_file
node_claude -->|"reads instructions"| node_claude_file
node_cursor -->|"reads rule"| node_cursor_rule

click node_marketplace "https://github.com/rji113/andrej-karpathy-skills/blob/main/.claude-plugin/marketplace.json"
click node_plugin "https://github.com/rji113/andrej-karpathy-skills/blob/main/.claude-plugin/plugin.json"
click node_skill "https://github.com/rji113/andrej-karpathy-skills/blob/main/skills/karpathy-guidelines/SKILL.md"
click node_claude_file "https://github.com/rji113/andrej-karpathy-skills/blob/main/CLAUDE.md"
click node_cursor_rule "https://github.com/rji113/andrej-karpathy-skills/blob/main/.cursor/rules/karpathy-guidelines.mdc"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_user toneBlue
class node_claude,node_cursor toneIndigo
class node_marketplace,node_plugin,node_skill,node_claude_file,node_cursor_rule toneTeal
```

## Components

### Other components

- **Project user**
- **Claude Code**
- **Cursor**
- [Plugin marketplace](https://github.com/rji113/andrej-karpathy-skills/blob/main/.claude-plugin/marketplace.json): `.claude-plugin/marketplace.json`
- [Plugin metadata](https://github.com/rji113/andrej-karpathy-skills/blob/main/.claude-plugin/plugin.json): `.claude-plugin/plugin.json`
- [Guidelines skill](https://github.com/rji113/andrej-karpathy-skills/blob/main/skills/karpathy-guidelines/SKILL.md): `skills/karpathy-guidelines/SKILL.md`
- [Claude guidelines](https://github.com/rji113/andrej-karpathy-skills/blob/main/CLAUDE.md): `CLAUDE.md`
- [Cursor rule](https://github.com/rji113/andrej-karpathy-skills/blob/main/.cursor/rules/karpathy-guidelines.mdc): `.cursor/rules/karpathy-guidelines.mdc`

## Connections

- Project user → Plugin marketplace: adds marketplace
- Project user → Plugin metadata: installs plugin
- Plugin metadata → Guidelines skill: exposes skill
- Claude Code → Guidelines skill: uses skill
- Project user → Claude guidelines: copies guidelines
- Claude Code → Claude guidelines: reads instructions
- Cursor → Cursor rule: reads rule