diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index adc2d95..ffa5301 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -12,8 +12,8 @@
     {
       "name": "lumen",
       "source": {
-        "source": "github",
-        "repo": "ory/lumen"
+        "source": "url",
+        "url": "https://github.com/ory/lumen.git"
       }
     }
   ]
diff --git a/CLAUDE.md b/CLAUDE.md
index 428c8d4..33aa335 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -21,10 +21,12 @@ Add an entry to the `plugins` array in `.claude-plugin/marketplace.json`:
 {
   "name": "your-plugin",
   "source": {
-    "source": "github",
-    "repo": "ory/your-plugin"
+    "source": "url",
+    "url": "https://github.com/ory/your-plugin.git"
   }
 }
 ```
 
+Use `"source": "url"` with a full HTTPS URL. The `"source": "github"` shorthand is not supported by the Claude Code plugin installer and will cause SSH authentication failures for users without GitHub SSH keys configured.
+
 The plugin repository must contain a `.claude-plugin/plugin.json` with the full plugin metadata.