From 64723a49ea6117894304eb491f0d32a60570bf45 Mon Sep 17 00:00:00 2001
From: Szymon Kocot <szkocot@users.noreply.github.com>
Date: Wed, 28 Jan 2026 01:40:04 +0100
Subject: [PATCH] refactor: restructure repo for skills.sh compatibility

---
 README.md                                     | 19 +++++++++----------
 .../karpathy-guidelines/SKILL.md              |  8 +++++++-
 2 files changed, 16 insertions(+), 11 deletions(-)
 rename .claude/skills/karpathy-guidelines.md => skills/karpathy-guidelines/SKILL.md (81%)

diff --git a/README.md b/README.md
index 2720ee7..817294b 100644
--- a/README.md
+++ b/README.md
@@ -92,24 +92,23 @@ Strong success criteria let the LLM loop independently. Weak criteria ("make it
 
 ## Install
 
-**Option A: CLAUDE.md (recommended)**
+**Option A: Skills CLI (recommended)**
+
+```bash
+npx skills add forrestchang/andrej-karpathy-skills
+```
+
+**Option B: CLAUDE.md**
 
 New project:
 ```bash
-curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpthy-skills/main/CLAUDE.md
+curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
 ```
 
 Existing project (append):
 ```bash
 echo "" >> CLAUDE.md
-curl https://raw.githubusercontent.com/forrestchang/andrej-karpthy-skills/main/CLAUDE.md >> CLAUDE.md
-```
-
-**Option B: Skills directory**
-
-```bash
-mkdir -p .claude/skills
-curl -o .claude/skills/karpathy-guidelines.md https://raw.githubusercontent.com/forrestchang/andrej-karpthy-skills/main/.claude/skills/karpathy-guidelines.md
+curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
 ```
 
 ## Key Insight
diff --git a/.claude/skills/karpathy-guidelines.md b/skills/karpathy-guidelines/SKILL.md
similarity index 81%
rename from .claude/skills/karpathy-guidelines.md
rename to skills/karpathy-guidelines/SKILL.md
index 3cd7d98..6a62d04 100644
--- a/.claude/skills/karpathy-guidelines.md
+++ b/skills/karpathy-guidelines/SKILL.md
@@ -1,6 +1,12 @@
+---
+name: karpathy-guidelines
+description: Behavioral guidelines to reduce common LLM coding mistakes. Use when writing, reviewing, or refactoring code to avoid overcomplication, make surgical changes, surface assumptions, and define verifiable success criteria.
+license: MIT
+---
+
 # Karpathy Guidelines
 
-Behavioral guidelines to reduce common LLM coding mistakes. Apply these principles to all coding tasks.
+Behavioral guidelines to reduce common LLM coding mistakes, derived from [Andrej Karpathy's observations](https://x.com/karpathy/status/2015883857489522876) on LLM coding pitfalls.
 
 **Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.