From b26f4c3c7371308ad7e245325da13900f5a6aba1 Mon Sep 17 00:00:00 2001 From: Shehab Tarek Date: Sat, 31 Jan 2026 22:12:23 +0200 Subject: [PATCH 1/3] Fix plugin skill path and update install instructions - Fix skill path in plugin.json to use relative path from .claude-plugin/ (changed from "skills/..." to "../skills/...") - Add /plugin add command to README alongside CLI command Co-Authored-By: Claude Opus 4.5 --- .claude-plugin/plugin.json | 2 +- README.md | 6 ++++++ 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index a5b713d..714076f 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -7,6 +7,6 @@ "license": "MIT", "repository": "https://github.com/forrestchang/andrej-karpathy-skills", "skills": [ - "skills/karpathy-guidelines/SKILL.md" + "../skills/karpathy-guidelines/SKILL.md" ] } diff --git a/README.md b/README.md index 27c028a..b866e9d 100644 --- a/README.md +++ b/README.md @@ -94,6 +94,12 @@ Strong success criteria let the LLM loop independently. Weak criteria ("make it **Option A: Claude Code Plugin (recommended)** +From within Claude Code: +``` +/plugin add https://github.com/forrestchang/andrej-karpathy-skills +``` + +Or from your terminal: ```bash claude plugins add https://github.com/forrestchang/andrej-karpathy-skills ``` From 3cf049fa3e1d7baf76a7239cc990f00a0c3bf60e Mon Sep 17 00:00:00 2001 From: Shehab Tarek Date: Sat, 31 Jan 2026 22:18:08 +0200 Subject: [PATCH 2/3] Add marketplace.json and fix plugin structure - Add marketplace.json required for /plugin marketplace add - Fix skill path to use ./ prefix (relative to plugin root) - Update README with correct two-step install process: 1. /plugin marketplace add forrestchang/andrej-karpathy-skills 2. /plugin install andrej-karpathy-skills@karpathy-skills Co-Authored-By: Claude Opus 4.5 --- .claude-plugin/marketplace.json | 29 +++++++++++++++++++++++++++++ .claude-plugin/plugin.json | 2 +- README.md | 10 +++++----- 3 files changed, 35 insertions(+), 6 deletions(-) create mode 100644 .claude-plugin/marketplace.json diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..f657354 --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,29 @@ +{ + "name": "karpathy-skills", + "id": "karpathy-skills", + "owner": { + "name": "forrestchang" + }, + "metadata": { + "description": "Behavioral guidelines to reduce common LLM coding mistakes, derived from Andrej Karpathy's observations", + "version": "1.0.0" + }, + "plugins": [ + { + "name": "andrej-karpathy-skills", + "source": "./", + "description": "Behavioral guidelines to reduce common LLM coding mistakes: Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution", + "version": "1.0.0", + "author": { + "name": "forrestchang" + }, + "keywords": [ + "guidelines", + "best-practices", + "coding", + "karpathy" + ], + "category": "workflow" + } + ] +} diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 714076f..233ef37 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -7,6 +7,6 @@ "license": "MIT", "repository": "https://github.com/forrestchang/andrej-karpathy-skills", "skills": [ - "../skills/karpathy-guidelines/SKILL.md" + "./skills/karpathy-guidelines/SKILL.md" ] } diff --git a/README.md b/README.md index b866e9d..17876fb 100644 --- a/README.md +++ b/README.md @@ -94,14 +94,14 @@ Strong success criteria let the LLM loop independently. Weak criteria ("make it **Option A: Claude Code Plugin (recommended)** -From within Claude Code: +From within Claude Code, first add the marketplace: ``` -/plugin add https://github.com/forrestchang/andrej-karpathy-skills +/plugin marketplace add forrestchang/andrej-karpathy-skills ``` -Or from your terminal: -```bash -claude plugins add https://github.com/forrestchang/andrej-karpathy-skills +Then install the plugin: +``` +/plugin install andrej-karpathy-skills@karpathy-skills ``` This installs the guidelines as a Claude Code plugin, making the skill available across all your projects. From 68b67a5bd77bddcbe88704abd9211e1de14e0860 Mon Sep 17 00:00:00 2001 From: Shehab Tarek Date: Sat, 31 Jan 2026 22:25:05 +0200 Subject: [PATCH 3/3] Fix plugin.json schema validation errors - Change author from string to object with name property - Remove invalid displayName field - Point skills to directory instead of file (auto-discovery) Co-Authored-By: Claude Opus 4.5 --- .claude-plugin/plugin.json | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 233ef37..6e88551 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,12 +1,11 @@ { "name": "andrej-karpathy-skills", - "displayName": "Karpathy Coding Guidelines", - "version": "1.0.0", "description": "Behavioral guidelines to reduce common LLM coding mistakes, derived from Andrej Karpathy's observations on LLM coding pitfalls", - "author": "forrestchang", + "version": "1.0.0", + "author": { + "name": "forrestchang" + }, "license": "MIT", - "repository": "https://github.com/forrestchang/andrej-karpathy-skills", - "skills": [ - "./skills/karpathy-guidelines/SKILL.md" - ] + "keywords": ["guidelines", "best-practices", "coding", "karpathy"], + "skills": ["./skills/karpathy-guidelines"] }