firefrost-gaming/claude-code-skills-reference
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix: Update plugin installation commands to use correct CLI syntax

Browse Source 
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>
This commit is contained in:
daymade
2025-10-26 12:54:46 +08:00
parent acd4bb2dfc
commit 2d9dde15f7
7 changed files with 201 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files

161
CLAUDE.md
View File

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## Repository Overview ## 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. **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 iwr -useb https://raw.githubusercontent.com/daymade/claude-code-skills/main/scripts/install.ps1 | iex
# Manual installation # Manual installation
/plugin marketplace add daymade/claude-code-skills claude plugin marketplace add daymade/claude-code-skills
/plugin marketplace install daymade/claude-code-skills#skill-creator claude plugin install skill-creator@daymade/claude-code-skills
``` ```
### Skill Validation and Packaging ### Skill Validation and Packaging
@@ -61,10 +61,10 @@ skill-creator/scripts/init_skill.py <skill-name> --path <output-directory>
```bash ```bash
# Add local marketplace # 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) # 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 # Test by copying to user skills directory
cp -r skill-name ~/.claude/skills/ cp -r skill-name ~/.claude/skills/
@@ -118,10 +118,28 @@ Skills for public distribution must NOT contain:
## Marketplace Configuration ## Marketplace Configuration
The marketplace is configured in `.claude-plugin/marketplace.json`: 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 - Each plugin has: name, description, version, category, keywords, skills array
- Marketplace metadata: name, owner, version, homepage - 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 ## Available Skills
**Priority Order** (by importance): **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 9. **cli-demo-generator** - CLI demo and terminal recording with VHS
10. **cloudflare-troubleshooting** - API-driven Cloudflare diagnostics and debugging 10. **cloudflare-troubleshooting** - API-driven Cloudflare diagnostics and debugging
11. **ui-designer** - Design system extraction from UI mockups 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. **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. 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 ## Best Practices Reference
Always consult Anthropic's skill authoring best practices before creating or updating skills: Always consult Anthropic's skill authoring best practices before creating or updating skills:

12
QUICKSTART.md
View File

@@ -10,10 +10,10 @@ Get started with Claude Code Skills Marketplace in less than 2 minutes!
```bash ```bash
# Add the marketplace # Add the marketplace
/plugin marketplace add daymade/claude-code-skills claude plugin marketplace add daymade/claude-code-skills
# Install skill-creator # 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 ### Step 2: Initialize Your First Skill
@@ -102,11 +102,11 @@ Follow the interactive prompts to select skills.
```bash ```bash
# Step 1: Add the marketplace # 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 # Step 2: Install skills you need
/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
# ... add more as needed # ... add more as needed
# Step 3: Restart Claude Code # Step 3: Restart Claude Code
@@ -129,7 +129,7 @@ Follow the interactive prompts to select skills.
```bash ```bash
# Use the same install command to update # 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
``` ```
--- ---

12
QUICKSTART.zh-CN.md
View File

@@ -10,10 +10,10 @@
```bash ```bash
# 添加市场 # 添加市场
/plugin marketplace add daymade/claude-code-skills claude plugin marketplace add daymade/claude-code-skills
# 安装 skill-creator # 安装 skill-creator
/plugin marketplace install daymade/claude-code-skills#skill-creator claude plugin install skill-creator@daymade/claude-code-skills
``` ```
### 步骤 2：初始化你的第一个技能 ### 步骤 2：初始化你的第一个技能
@@ -102,11 +102,11 @@ iwr -useb https://raw.githubusercontent.com/daymade/claude-code-skills/main/scri
```bash ```bash
# 步骤 1：添加市场 # 步骤 1：添加市场
/plugin marketplace add daymade/claude-code-skills claude plugin marketplace add daymade/claude-code-skills
# 步骤 2：安装你需要的技能 # 步骤 2：安装你需要的技能
/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
# ... 根据需要添加更多 # ... 根据需要添加更多
# 步骤 3：重启 Claude Code # 步骤 3：重启 Claude Code
@@ -129,7 +129,7 @@ iwr -useb https://raw.githubusercontent.com/daymade/claude-code-skills/main/scri
```bash ```bash
# 使用相同的安装命令进行更新 # 使用相同的安装命令进行更新
/plugin marketplace install daymade/claude-code-skills#skill-name claude plugin install skill-name@daymade/claude-code-skills
``` ```
--- ---

24
README.md
View File

@@ -49,8 +49,8 @@ The `skill-creator` is the **meta-skill** that enables you to build, validate, a
### Quick Install ### Quick Install
```bash ```bash
/plugin marketplace add daymade/claude-code-skills claude plugin marketplace add daymade/claude-code-skills
/plugin marketplace install daymade/claude-code-skills#skill-creator claude plugin install skill-creator@daymade/claude-code-skills
``` ```
### What You Can Do ### What You Can Do
@@ -108,34 +108,34 @@ Add the marketplace:
**Essential Skill** (recommended first install): **Essential Skill** (recommended first install):
```bash ```bash
/plugin marketplace install daymade/claude-code-skills#skill-creator claude plugin install skill-creator@daymade/claude-code-skills
``` ```
**Install Other Skills:** **Install Other Skills:**
```bash ```bash
# GitHub operations # GitHub operations
/plugin marketplace install daymade/claude-code-skills#github-ops claude plugin install github-ops@daymade/claude-code-skills
# Document conversion # Document conversion
/plugin marketplace install daymade/claude-code-skills#markdown-tools claude plugin install markdown-tools@daymade/claude-code-skills
# Diagram generation # Diagram generation
/plugin marketplace install daymade/claude-code-skills#mermaid-tools claude plugin install mermaid-tools@daymade/claude-code-skills
# Statusline customization # Statusline customization
/plugin marketplace install daymade/claude-code-skills#statusline-generator claude plugin install statusline-generator@daymade/claude-code-skills
# Teams communication # 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 # Repomix extraction
/plugin marketplace install daymade/claude-code-skills#repomix-unmixer claude plugin install repomix-unmixer@daymade/claude-code-skills
# AI/LLM icons # 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 # 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! 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: Use the same install command to update:
```bash ```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? ### Can I contribute my own skill?

24
README.zh-CN.md
View File

@@ -49,8 +49,8 @@
### 快速安装 ### 快速安装
```bash ```bash
/plugin marketplace add daymade/claude-code-skills claude plugin marketplace add daymade/claude-code-skills
/plugin marketplace install daymade/claude-code-skills#skill-creator 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 ```bash
/plugin marketplace install daymade/claude-code-skills#skill-creator claude plugin install skill-creator@daymade/claude-code-skills
``` ```
**安装其他技能：** **安装其他技能：**
```bash ```bash
# GitHub 操作 # 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 通信 # Teams 通信
/plugin marketplace install daymade/claude-code-skills#teams-channel-post-writer claude plugin install teams-channel-post-writer@daymade/claude-code-skills
# Repomix 提取 # Repomix 提取
/plugin marketplace install daymade/claude-code-skills#repomix-unmixer claude plugin install repomix-unmixer@daymade/claude-code-skills
# AI/LLM 图标 # AI/LLM 图标
/plugin marketplace install daymade/claude-code-skills#llm-icon-finder claude plugin install llm-icon-finder@daymade/claude-code-skills
# CLI 演示生成 # 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 ```bash
/plugin marketplace install daymade/claude-code-skills#skill-name claude plugin install skill-name@daymade/claude-code-skills
``` ```
### 我可以贡献自己的技能吗？ ### 我可以贡献自己的技能吗？

8
scripts/install.ps1
View File

@@ -66,14 +66,14 @@ if ($isInteractive) {
} }
$commands = @() $commands = @()
$commands += "/plugin marketplace add daymade/claude-code-skills" $commands += "claude plugin marketplace add daymade/claude-code-skills"
switch ($choice) { switch ($choice) {
"1" { "1" {
Write-Host "" Write-Host ""
Write-Cyan "Installing skill-creator..." Write-Cyan "Installing skill-creator..."
Write-Host "" Write-Host ""
$commands += "/plugin marketplace install daymade/claude-code-skills#skill-creator" $commands += "claude plugin install skill-creator@daymade/claude-code-skills"
$afterInstall = @" $afterInstall = @"
After installation, ask Claude Code: 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", $skills = @("skill-creator", "github-ops", "markdown-tools", "mermaid-tools",
"statusline-generator", "teams-channel-post-writer", "repomix-unmixer", "llm-icon-finder") "statusline-generator", "teams-channel-post-writer", "repomix-unmixer", "llm-icon-finder")
foreach ($skill in $skills) { foreach ($skill in $skills) {
$commands += "/plugin marketplace install daymade/claude-code-skills#$skill" $commands += "claude plugin install $skill@daymade/claude-code-skills"
} }
} }
"3" { "3" {
@@ -127,7 +127,7 @@ Claude Code will guide you through the skill creation process!
foreach ($num in $selections) { foreach ($num in $selections) {
if ($skillMap.ContainsKey($num)) { if ($skillMap.ContainsKey($num)) {
$commands += "/plugin marketplace install daymade/claude-code-skills#$($skillMap[$num])" $commands += "claude plugin install $($skillMap[$num])@daymade/claude-code-skills"
} }
} }
} }

12
scripts/install.sh
View File

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