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 a5b713d..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"]
 }
diff --git a/README.md b/README.md
index 27c028a..17876fb 100644
--- a/README.md
+++ b/README.md
@@ -94,8 +94,14 @@ Strong success criteria let the LLM loop independently. Weak criteria ("make it
 
 **Option A: Claude Code Plugin (recommended)**
 
-```bash
-claude plugins add https://github.com/forrestchang/andrej-karpathy-skills
+From within Claude Code, first add the marketplace:
+```
+/plugin marketplace add 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.