fix: Update plugin installation commands to use correct CLI syntax

Changed all installation instructions from the deprecated TUI-style commands to the correct CLI syntax: - Old: `/plugin marketplace install daymade/claude-code-skills#skill-name` - New: `claude plugin install skill-name@daymade/claude-code-skills` - Old: `/plugin marketplace add daymade/claude-code-skills` - New: `claude plugin marketplace add daymade/claude-code-skills` Files updated: - README.md and README.zh-CN.md - QUICKSTART.md and QUICKSTART.zh-CN.md - CLAUDE.md - scripts/install.sh - scripts/install.ps1 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-26 12:54:46 +08:00
parent acd4bb2dfc
commit 2d9dde15f7
7 changed files with 201 additions and 52 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

 ## Repository Overview

-This is a Claude Code skills marketplace containing 11 production-ready skills organized in a plugin marketplace structure. Each skill is a self-contained package that extends Claude's capabilities with specialized knowledge, workflows, and bundled resources.
+This is a Claude Code skills marketplace containing 12 production-ready skills organized in a plugin marketplace structure. Each skill is a self-contained package that extends Claude's capabilities with specialized knowledge, workflows, and bundled resources.

 **Essential Skill**: `skill-creator` is the most important skill in this marketplace - it's a meta-skill that enables users to create their own skills. Always recommend it first for users interested in extending Claude Code.

@@ -40,8 +40,8 @@ curl -fsSL https://raw.githubusercontent.com/daymade/claude-code-skills/main/scr
 iwr -useb https://raw.githubusercontent.com/daymade/claude-code-skills/main/scripts/install.ps1 | iex

 # Manual installation
-/plugin marketplace add daymade/claude-code-skills
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin marketplace add daymade/claude-code-skills
+claude plugin install skill-creator@daymade/claude-code-skills
 ```

 ### Skill Validation and Packaging
@@ -61,10 +61,10 @@ skill-creator/scripts/init_skill.py <skill-name> --path <output-directory>

 ```bash
 # Add local marketplace
-/plugin marketplace add daymade/claude-code-skills
+claude plugin marketplace add daymade/claude-code-skills

 # Install specific skill (start with skill-creator)
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin install skill-creator@daymade/claude-code-skills

 # Test by copying to user skills directory
 cp -r skill-name ~/.claude/skills/
@@ -118,10 +118,28 @@ Skills for public distribution must NOT contain:
 ## Marketplace Configuration

 The marketplace is configured in `.claude-plugin/marketplace.json`:
- Contains 11 plugins, each mapping to one skill
+- Contains 12 plugins, each mapping to one skill
 - Each plugin has: name, description, version, category, keywords, skills array
 - Marketplace metadata: name, owner, version, homepage

+### Versioning Architecture
+
+**Two separate version tracking systems:**
+
+1. **Marketplace Version** (`.claude-plugin/marketplace.json` → `metadata.version`)
+   - Tracks the marketplace catalog as a whole
+   - Current: v1.5.0
+   - Bump when: Adding/removing skills, major marketplace restructuring
+   - Semantic versioning: MAJOR.MINOR.PATCH
+
+2. **Individual Skill Versions** (`.claude-plugin/marketplace.json` → `plugins[].version`)
+   - Each skill has its own independent version
+   - Example: ppt-creator v1.0.0, skill-creator v1.0.0
+   - Bump when: Updating that specific skill
+   - **CRITICAL**: Skills should NOT have version sections in SKILL.md
+
+**Key Principle**: SKILL.md files should be timeless content focused on functionality. Versions are tracked in marketplace.json only.
+
 ## Available Skills

 **Priority Order** (by importance):
@@ -137,6 +155,7 @@ The marketplace is configured in `.claude-plugin/marketplace.json`:
 9. **cli-demo-generator** - CLI demo and terminal recording with VHS
 10. **cloudflare-troubleshooting** - API-driven Cloudflare diagnostics and debugging
 11. **ui-designer** - Design system extraction from UI mockups
+12. **ppt-creator** - Professional presentation creation with dual-path PPTX generation

 **Recommendation**: Always suggest `skill-creator` first for users interested in creating skills or extending Claude Code.

@@ -180,6 +199,136 @@ For Chinese users having API access issues, recommend [CC-Switch](https://github

 See README.md section "🇨🇳 中文用户指南" for details.

+## Release Workflow
+
+When adding a new skill or creating a marketplace release:
+
+### 1. Create the Skill
+```bash
+# Develop skill in its directory
+skill-name/
+├── SKILL.md (no version history!)
+├── scripts/
+└── references/
+
+# Validate
+./skill-creator/scripts/quick_validate.py skill-name
+
+# Package
+./skill-creator/scripts/package_skill.py skill-name
+```
+
+### 2. Update Marketplace Configuration
+
+Edit `.claude-plugin/marketplace.json`:
+
+```json
+{
+  "metadata": {
+    "version": "1.x.0"  // Bump minor version for new skill
+  },
+  "plugins": [
+    {
+      "name": "new-skill",
+      "version": "1.0.0",  // Skill's initial version
+      "description": "...",
+      "category": "...",
+      "keywords": [...],
+      "skills": ["./new-skill"]
+    }
+  ]
+}
+```
+
+### 3. Update Documentation
+
+**README.md:**
+- Update badges (skills count, marketplace version)
+- Add skill description and features
+- Create demo GIF using cli-demo-generator
+- Add use case section
+- Add documentation references
+- Add requirements (if applicable)
+
+**CLAUDE.md:**
+- Update skill count in Repository Overview
+- Add skill to Available Skills list
+- Update Marketplace Configuration count
+
+### 4. Generate Demo (Optional but Recommended)
+
+```bash
+# Use cli-demo-generator to create demo GIF
+./cli-demo-generator/scripts/auto_generate_demo.py \
+  -c "command1" \
+  -c "command2" \
+  -o demos/skill-name/demo-name.gif \
+  --title "Skill Demo" \
+  --theme "Dracula"
+```
+
+### 5. Commit and Release
+
+```bash
+# Commit marketplace update
+git add .claude-plugin/marketplace.json skill-name/
+git commit -m "Release vX.Y.0: Add skill-name
+
+- Add skill-name vX.Y.Z
+- Update marketplace to vX.Y.0
+..."
+
+# Commit documentation
+git add README.md CLAUDE.md demos/
+git commit -m "docs: Update README for vX.Y.0 with skill-name"
+
+# Push
+git push
+
+# Create GitHub release
+gh release create vX.Y.0 \
+  --title "Release vX.Y.0: Add skill-name - Description" \
+  --notes "$(cat <<'EOF'
+## New Skill: skill-name
+
+Features:
+- Feature 1
+- Feature 2
+
+Installation:
+```bash
+claude plugin install skill-name@daymade/claude-code-skills
+```
+
+Changelog: ...
+EOF
+)"
+```
+
+### Version Bumping Guide
+
+**Marketplace version (metadata.version):**
+- **MAJOR** (2.0.0): Breaking changes, incompatible marketplace structure
+- **MINOR** (1.5.0): New skill added, significant feature addition
+- **PATCH** (1.4.1): Bug fixes, documentation updates, skill updates
+
+**Skill version (plugins[].version):**
+- **MAJOR** (2.0.0): Breaking API changes for the skill
+- **MINOR** (1.2.0): New features in the skill
+- **PATCH** (1.1.1): Bug fixes in the skill
+
+### Example: v1.5.0 Release (ppt-creator)
+
+```bash
+# 1. Created ppt-creator skill
+# 2. Updated marketplace.json: 1.4.0 → 1.5.0
+# 3. Added ppt-creator plugin entry (version: 1.0.0)
+# 4. Updated README.md (badges, description, demo)
+# 5. Generated demo GIF with cli-demo-generator
+# 6. Committed changes
+# 7. Created GitHub release with gh CLI
+```
+
 ## Best Practices Reference

 Always consult Anthropic's skill authoring best practices before creating or updating skills:
--- a/QUICKSTART.md
+++ b/QUICKSTART.md
@@ -10,10 +10,10 @@ Get started with Claude Code Skills Marketplace in less than 2 minutes!

 ```bash
 # Add the marketplace
-/plugin marketplace add daymade/claude-code-skills
+claude plugin marketplace add daymade/claude-code-skills

 # Install skill-creator
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin install skill-creator@daymade/claude-code-skills
 ```

 ### Step 2: Initialize Your First Skill
@@ -102,11 +102,11 @@ Follow the interactive prompts to select skills.

 ```bash
 # Step 1: Add the marketplace
-/plugin marketplace add daymade/claude-code-skills
+claude plugin marketplace add daymade/claude-code-skills

 # Step 2: Install skills you need
-/plugin marketplace install daymade/claude-code-skills#github-ops
-/plugin marketplace install daymade/claude-code-skills#markdown-tools
+claude plugin install github-ops@daymade/claude-code-skills
+claude plugin install markdown-tools@daymade/claude-code-skills
 # ... add more as needed

 # Step 3: Restart Claude Code
@@ -129,7 +129,7 @@ Follow the interactive prompts to select skills.

 ```bash
 # Use the same install command to update
-/plugin marketplace install daymade/claude-code-skills#skill-name
+claude plugin install skill-name@daymade/claude-code-skills
 ```

 ---
--- a/QUICKSTART.zh-CN.md
+++ b/QUICKSTART.zh-CN.md
@@ -10,10 +10,10 @@

 ```bash
 # 添加市场
-/plugin marketplace add daymade/claude-code-skills
+claude plugin marketplace add daymade/claude-code-skills

 # 安装 skill-creator
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin install skill-creator@daymade/claude-code-skills
 ```

 ### 步骤 2：初始化你的第一个技能
@@ -102,11 +102,11 @@ iwr -useb https://raw.githubusercontent.com/daymade/claude-code-skills/main/scri

 ```bash
 # 步骤 1：添加市场
-/plugin marketplace add daymade/claude-code-skills
+claude plugin marketplace add daymade/claude-code-skills

 # 步骤 2：安装你需要的技能
-/plugin marketplace install daymade/claude-code-skills#github-ops
-/plugin marketplace install daymade/claude-code-skills#markdown-tools
+claude plugin install github-ops@daymade/claude-code-skills
+claude plugin install markdown-tools@daymade/claude-code-skills
 # ... 根据需要添加更多

 # 步骤 3：重启 Claude Code
@@ -129,7 +129,7 @@ iwr -useb https://raw.githubusercontent.com/daymade/claude-code-skills/main/scri

 ```bash
 # 使用相同的安装命令进行更新
-/plugin marketplace install daymade/claude-code-skills#skill-name
+claude plugin install skill-name@daymade/claude-code-skills
 ```

 ---
--- a/README.md
+++ b/README.md
@@ -49,8 +49,8 @@ The `skill-creator` is the **meta-skill** that enables you to build, validate, a
 ### Quick Install

 ```bash
-/plugin marketplace add daymade/claude-code-skills
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin marketplace add daymade/claude-code-skills
+claude plugin install skill-creator@daymade/claude-code-skills
 ```

 ### What You Can Do
@@ -108,34 +108,34 @@ Add the marketplace:

 **Essential Skill** (recommended first install):
 ```bash
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin install skill-creator@daymade/claude-code-skills
 ```

 **Install Other Skills:**
 ```bash
 # GitHub operations
-/plugin marketplace install daymade/claude-code-skills#github-ops
+claude plugin install github-ops@daymade/claude-code-skills

 # Document conversion
-/plugin marketplace install daymade/claude-code-skills#markdown-tools
+claude plugin install markdown-tools@daymade/claude-code-skills

 # Diagram generation
-/plugin marketplace install daymade/claude-code-skills#mermaid-tools
+claude plugin install mermaid-tools@daymade/claude-code-skills

 # Statusline customization
-/plugin marketplace install daymade/claude-code-skills#statusline-generator
+claude plugin install statusline-generator@daymade/claude-code-skills

 # Teams communication
-/plugin marketplace install daymade/claude-code-skills#teams-channel-post-writer
+claude plugin install teams-channel-post-writer@daymade/claude-code-skills

 # Repomix extraction
-/plugin marketplace install daymade/claude-code-skills#repomix-unmixer
+claude plugin install repomix-unmixer@daymade/claude-code-skills

 # AI/LLM icons
-/plugin marketplace install daymade/claude-code-skills#llm-icon-finder
+claude plugin install llm-icon-finder@daymade/claude-code-skills

 # CLI demo generation
-/plugin marketplace install daymade/claude-code-skills#cli-demo-generator
+claude plugin install cli-demo-generator@daymade/claude-code-skills
 ```

 Each skill can be installed independently - choose only what you need!
@@ -500,7 +500,7 @@ No, these skills are specifically designed for Claude Code. You'll need Claude C

 Use the same install command to update:
 ```bash
-/plugin marketplace install daymade/claude-code-skills#skill-name
+claude plugin install skill-name@daymade/claude-code-skills
 ```

 ### Can I contribute my own skill?
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -49,8 +49,8 @@
 ### 快速安装

 ```bash
-/plugin marketplace add daymade/claude-code-skills
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin marketplace add daymade/claude-code-skills
+claude plugin install skill-creator@daymade/claude-code-skills
 ```

 ### 你可以做什么
@@ -108,34 +108,34 @@ iwr -useb https://raw.githubusercontent.com/daymade/claude-code-skills/main/scri

 **必备技能**（推荐首先安装）：
 ```bash
-/plugin marketplace install daymade/claude-code-skills#skill-creator
+claude plugin install skill-creator@daymade/claude-code-skills
 ```

 **安装其他技能：**
 ```bash
 # GitHub 操作
-/plugin marketplace install daymade/claude-code-skills#github-ops
+claude plugin install github-ops@daymade/claude-code-skills

 # 文档转换
-/plugin marketplace install daymade/claude-code-skills#markdown-tools
+claude plugin install markdown-tools@daymade/claude-code-skills

 # 图表生成
-/plugin marketplace install daymade/claude-code-skills#mermaid-tools
+claude plugin install mermaid-tools@daymade/claude-code-skills

 # 状态栏定制
-/plugin marketplace install daymade/claude-code-skills#statusline-generator
+claude plugin install statusline-generator@daymade/claude-code-skills

 # Teams 通信
-/plugin marketplace install daymade/claude-code-skills#teams-channel-post-writer
+claude plugin install teams-channel-post-writer@daymade/claude-code-skills

 # Repomix 提取
-/plugin marketplace install daymade/claude-code-skills#repomix-unmixer
+claude plugin install repomix-unmixer@daymade/claude-code-skills

 # AI/LLM 图标
-/plugin marketplace install daymade/claude-code-skills#llm-icon-finder
+claude plugin install llm-icon-finder@daymade/claude-code-skills

 # CLI 演示生成
-/plugin marketplace install daymade/claude-code-skills#cli-demo-generator
+claude plugin install cli-demo-generator@daymade/claude-code-skills
 ```

 每个技能都可以独立安装 - 只选择你需要的！
@@ -492,7 +492,7 @@ CC-Switch 支持以下中国 AI 服务提供商：

 使用相同的安装命令进行更新：
 ```bash
-/plugin marketplace install daymade/claude-code-skills#skill-name
+claude plugin install skill-name@daymade/claude-code-skills
 ```

 ### 我可以贡献自己的技能吗？
--- a/scripts/install.ps1
+++ b/scripts/install.ps1
@@ -66,14 +66,14 @@ if ($isInteractive) {
 }

 $commands = @()
-$commands += "/plugin marketplace add daymade/claude-code-skills"
+$commands += "claude plugin marketplace add daymade/claude-code-skills"

 switch ($choice) {
    "1" {
        Write-Host ""
        Write-Cyan "Installing skill-creator..."
        Write-Host ""
-        $commands += "/plugin marketplace install daymade/claude-code-skills#skill-creator"
+        $commands += "claude plugin install skill-creator@daymade/claude-code-skills"

        $afterInstall = @"
 After installation, ask Claude Code:
@@ -91,7 +91,7 @@ Claude Code will guide you through the skill creation process!
        $skills = @("skill-creator", "github-ops", "markdown-tools", "mermaid-tools",
                    "statusline-generator", "teams-channel-post-writer", "repomix-unmixer", "llm-icon-finder")
        foreach ($skill in $skills) {
-            $commands += "/plugin marketplace install daymade/claude-code-skills#$skill"
+            $commands += "claude plugin install $skill@daymade/claude-code-skills"
        }
    }
    "3" {
@@ -127,7 +127,7 @@ Claude Code will guide you through the skill creation process!

        foreach ($num in $selections) {
            if ($skillMap.ContainsKey($num)) {
-                $commands += "/plugin marketplace install daymade/claude-code-skills#$($skillMap[$num])"
+                $commands += "claude plugin install $($skillMap[$num])@daymade/claude-code-skills"
            }
        }
    }
--- a/scripts/install.sh
+++ b/scripts/install.sh
@@ -64,8 +64,8 @@ case $choice in
        echo ""
        echo "Run these commands in Claude Code:"
        echo ""
-        echo -e "${YELLOW}/plugin marketplace add daymade/claude-code-skills${NC}"
-        echo -e "${YELLOW}/plugin marketplace install daymade/claude-code-skills#skill-creator${NC}"
+        echo -e "${YELLOW}claude plugin marketplace add daymade/claude-code-skills${NC}"
+        echo -e "${YELLOW}claude plugin install skill-creator@daymade/claude-code-skills${NC}"
        echo ""
        echo -e "${GREEN}After installation, ask Claude Code:${NC}"
        echo "  \"Create a new skill called my-awesome-skill in ~/my-skills\""
@@ -80,10 +80,10 @@ case $choice in
        echo ""
        echo "Run these commands in Claude Code:"
        echo ""
-        echo -e "${YELLOW}/plugin marketplace add daymade/claude-code-skills${NC}"
+        echo -e "${YELLOW}claude plugin marketplace add daymade/claude-code-skills${NC}"
        echo ""
        for skill in skill-creator github-ops markdown-tools mermaid-tools statusline-generator teams-channel-post-writer repomix-unmixer llm-icon-finder; do
-            echo -e "${YELLOW}/plugin marketplace install daymade/claude-code-skills#${skill}${NC}"
+            echo -e "${YELLOW}claude plugin install ${skill}@daymade/claude-code-skills${NC}"
        done
        ;;
    3)
@@ -109,13 +109,13 @@ case $choice in
        echo ""
        echo "Run these commands in Claude Code:"
        echo ""
-        echo -e "${YELLOW}/plugin marketplace add daymade/claude-code-skills${NC}"
+        echo -e "${YELLOW}claude plugin marketplace add daymade/claude-code-skills${NC}"
        echo ""
        SKILLS=(skill-creator github-ops markdown-tools mermaid-tools statusline-generator teams-channel-post-writer repomix-unmixer llm-icon-finder)
        for num in $selections; do
            idx=$((num-1))
            if [ $idx -ge 0 ] && [ $idx -lt 8 ]; then
-                echo -e "${YELLOW}/plugin marketplace install daymade/claude-code-skills#${SKILLS[$idx]}${NC}"
+                echo -e "${YELLOW}claude plugin install ${SKILLS[$idx]}@daymade/claude-code-skills${NC}"
            fi
        done
        ;;