diff --git a/CLAUDE.md b/CLAUDE.md index ddca123..2acc9a4 100644 --- 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 --path ```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: diff --git a/QUICKSTART.md b/QUICKSTART.md index 4091e6e..bb6bef0 100644 --- 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 ``` --- diff --git a/QUICKSTART.zh-CN.md b/QUICKSTART.zh-CN.md index 4e347f8..e788448 100644 --- 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 ``` --- diff --git a/README.md b/README.md index 2b3408f..76ae6ad 100644 --- 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? diff --git a/README.zh-CN.md b/README.zh-CN.md index 379142d..0f797a4 100644 --- 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 ``` ### 我可以贡献自己的技能吗? diff --git a/scripts/install.ps1 b/scripts/install.ps1 index ad6ee44..ea676bd 100755 --- 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" } } } diff --git a/scripts/install.sh b/scripts/install.sh index 1c1fd40..03a9b97 100755 --- 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 ;;