fix: Correct plugin installation instructions across all documentation

The previous instructions incorrectly used direct GitHub URL installation,
which is not supported. Users must first add the marketplace, then install.

Correct installation:
1. /plugin marketplace add rand/cc-polymath
2. /plugin install cc-polymath@cc-polymath

Updated:
- README.md
- docs/GETTING_STARTED.md
- docs/FIRST_CONVERSATIONS.md
- docs/TROUBLESHOOTING.md
- docs/FAQ.md
- scripts/verify-install.sh
- scripts/diagnose.sh
- scripts/demo-skills.sh

Author: rand

README.md

@@ -10,7 +10,8 @@
 
 **Install in 30 seconds**:
 ```
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 ```
 
 **Your first 3 commands**:

docs/FAQ.md

@@ -9,7 +9,8 @@ Quick answers to frequently asked questions about cc-polymath, organized by topi
 Open Claude Code and run:
 
 ```
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 ```
 
 That's it. All 447 skills are immediately available and auto-discover as you work.
@@ -303,7 +304,8 @@ bash ~/.claude/plugins/cc-polymath/scripts/verify-install.sh
 If it fails, reinstall:
 ```
 /plugin uninstall cc-polymath
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 ```
 
 If the plugin is installed but commands don't work, restart Claude Code.

docs/FIRST_CONVERSATIONS.md

@@ -1314,7 +1314,8 @@ Every example produces immediately actionable output:
 
 Ready to get started?
 
-1. **Install the plugin**: `/plugin install https://github.com/rand/cc-polymath`
+1. **Install the plugin**: `/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath`
 2. **Verify it works**: `bash ~/.claude/plugins/cc-polymath/scripts/verify-install.sh`
 3. **Start with your project**: Ask Claude about building React components, optimizing queries, designing APIs - whatever you're working on
 4. **Skills load automatically** - no manual loading needed for common tasks

docs/GETTING_STARTED.md

@@ -13,7 +13,8 @@ cc-polymath is a Claude Code plugin that provides **447 production-ready skills*
 Open Claude Code and install the plugin:
 
 ```
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 ```
 
 Wait for the confirmation message:

docs/TROUBLESHOOTING.md

@@ -38,11 +38,13 @@ Error: Command not found
 
 # You should see "cc-polymath" in the list with version 2.0.0+
 # If not found, install it:
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 
 # Step 2: If installed but commands don't work, reload the plugin
 /plugin uninstall cc-polymath
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 
 # Step 3: Verify installation worked
 bash ~/.claude/plugins/cc-polymath/scripts/verify-install.sh
@@ -72,7 +74,8 @@ ls -la ~/.claude/plugins/cc-polymath/skills/ | head -20
 
 # Step 3: If the directory doesn't exist, reinstall
 /plugin uninstall cc-polymath
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 
 # Step 4: Verify it worked
 bash ~/.claude/plugins/cc-polymath/scripts/verify-install.sh
@@ -130,7 +133,8 @@ rm -rf ~/.claude/skills
 
 # Step 4: Verify plugin installation is current
 /plugin uninstall cc-polymath
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 
 # Step 5: Run verification
 bash ~/.claude/plugins/cc-polymath/scripts/verify-install.sh
@@ -190,7 +194,8 @@ ls -ld ~/.claude/plugins/cc-polymath/     # Check current owner
 
 # Step 2: Update to latest version
 /plugin uninstall cc-polymath
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 
 # Step 3: Verify new version installed
 /plugin list | grep cc-polymath
@@ -234,7 +239,8 @@ find ~/.claude/plugins/cc-polymath/skills -name "INDEX.md" | wc -l
 
 # Step 4: If counts are low, reinstall
 /plugin uninstall cc-polymath
-/plugin install https://github.com/rand/cc-polymath
+/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath
 
 # Step 5: Verify
 bash ~/.claude/plugins/cc-polymath/scripts/verify-install.sh
@@ -419,7 +425,8 @@ If you've tried these solutions and still have issues:
 
 | Issue | Symptom | Quick Fix |
 |-------|---------|-----------|
-| Plugin not installed | Command not found | `/plugin install https://github.com/rand/cc-polymath` |
+| Plugin not installed | Command not found | `/plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath` |
 | Wrong file path | "No such file or directory" | Update path to `~/.claude/plugins/cc-polymath/` |
 | Auto-discovery not working | Skills don't auto-load | Use `/discover-*` commands explicitly |
 | Old installation conflict | Inconsistent behavior | `rm -rf ~/.claude/skills` |

scripts/demo-skills.sh

@@ -15,7 +15,8 @@ PLUGIN_DIR="$HOME/.claude/plugins/cc-polymath"
 if [ ! -d "$PLUGIN_DIR" ]; then
     echo "Error: cc-polymath plugin not found at $PLUGIN_DIR"
     echo ""
-    echo "Install with: /plugin install https://github.com/rand/cc-polymath"
+    echo "Install with: /plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath"
     exit 1
 fi
 

scripts/diagnose.sh

@@ -59,7 +59,8 @@ if [ -d "$PLUGIN_DIR" ]; then
     echo "│ ✓ Gateway skills:    $gateway_dirs"
 else
     echo "│ ✗ Plugin not installed"
-    echo "│   Install: /plugin install https://github.com/rand/cc-polymath"
+    echo "│   Install: /plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath"
 fi
 echo "└─"
 echo ""
@@ -253,7 +254,8 @@ echo "│"
 recommendations=()
 
 if [ ! -d "$PLUGIN_DIR" ]; then
-    recommendations+=("Install plugin: /plugin install https://github.com/rand/cc-polymath")
+    recommendations+=("Install plugin: /plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath")
 fi
 
 if [ -d "$HOME/.claude/skills" ] && [ ! -L "$HOME/.claude/skills" ]; then

scripts/verify-install.sh

@@ -31,7 +31,8 @@ if [ -d "$PLUGIN_DIR" ]; then
     ((PASSED++))
 else
     echo "✗ Plugin directory not found: $PLUGIN_DIR"
-    echo "  Run: /plugin install https://github.com/rand/cc-polymath"
+    echo "  Run: /plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath"
     ((FAILED++))
     echo ""
     echo "━━━ Summary ━━━"
@@ -116,7 +117,8 @@ else
     echo ""
     echo "Try reinstalling:"
     echo "  /plugin uninstall cc-polymath"
-    echo "  /plugin install https://github.com/rand/cc-polymath"
+    echo "  /plugin marketplace add rand/cc-polymath
+/plugin install cc-polymath@cc-polymath"
     echo ""
     echo "For more help:"
     echo "  • Troubleshooting: $PLUGIN_DIR/docs/TROUBLESHOOTING.md"