# Deploy To Marketplace

> Use when user wants to deploy/publish a skill to saurun-marketplace, says "deploy [skill] to marketplace", or asks to publish a skill to the plugin marketplace.

- Skill: `majiayu000/deploy-to-marketplace` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/deploy-to-marketplace`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/deploy-to-marketplace/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/deploy-to-marketplace

---


# Deploy to Marketplace

Deploy skills from `~/.claude/skills/` to the saurun-marketplace plugin repository.

## Workflow

```dot
digraph deploy_flow {
    "User request" [shape=doublecircle];
    "Validate skill structure" [shape=box];
    "Check marketplace state" [shape=box];
    "Conflict?" [shape=diamond];
    "Show diff + warn" [shape=box];
    "User confirms?" [shape=diamond];
    "Copy skill files" [shape=box];
    "Call /publish-plugin bump" [shape=box];
    "Complete" [shape=doublecircle];
    "Abort" [shape=doublecircle];

    "User request" -> "Validate skill structure";
    "Validate skill structure" -> "Check marketplace state";
    "Check marketplace state" -> "Conflict?";
    "Conflict?" -> "Show diff + warn" [label="yes"];
    "Conflict?" -> "Copy skill files" [label="no"];
    "Show diff + warn" -> "User confirms?";
    "User confirms?" -> "Copy skill files" [label="yes"];
    "User confirms?" -> "Abort" [label="no"];
    "Copy skill files" -> "Call /publish-plugin bump";
    "Call /publish-plugin bump" -> "Complete";
}
```

## Steps

### 1. Validate Skill Structure

Check source skill:
```bash
SKILL_NAME="skill-name"
SOURCE="$HOME/.claude/skills/$SKILL_NAME"

# Verify exists
test -f "$SOURCE/SKILL.md" || { echo "Error: SKILL.md not found"; exit 1; }

# Verify frontmatter
grep -q "^name:" "$SOURCE/SKILL.md" || { echo "Error: Missing 'name' in frontmatter"; exit 1; }
grep -q "^description:" "$SOURCE/SKILL.md" || { echo "Error: Missing 'description' in frontmatter"; exit 1; }
```

### 2. Check Marketplace State

```bash
MARKETPLACE="$HOME/repos/saurun-marketplace"
TARGET="$MARKETPLACE/plugins/saurun/skills/$SKILL_NAME"

# Check if skill exists
if [ -d "$TARGET" ]; then
    # Compare modification times
    LOCAL_TIME=$(stat -f %m "$SOURCE/SKILL.md" 2>/dev/null || stat -c %Y "$SOURCE/SKILL.md")
    MARKET_TIME=$(stat -f %m "$TARGET/SKILL.md" 2>/dev/null || stat -c %Y "$TARGET/SKILL.md")

    if [ "$MARKET_TIME" -gt "$LOCAL_TIME" ]; then
        echo "⚠️  WARNING: Marketplace version is NEWER than local"
        echo "Local:       $(date -r $LOCAL_TIME)"
        echo "Marketplace: $(date -r $MARKET_TIME)"

        # Show diff
        diff -u "$TARGET/SKILL.md" "$SOURCE/SKILL.md" || true

        # Ask user
        echo ""
        echo "Options:"
        echo "  1. ABORT - Don't deploy"
        echo "  2. REVERSE - Copy marketplace → local"
        echo "  3. FORCE - Overwrite marketplace (use with caution)"
        # Wait for user decision
    fi
fi

# Check git state
cd "$MARKETPLACE"
if ! git diff --quiet; then
    echo "⚠️  WARNING: Marketplace has uncommitted changes"
    git status --short
    # Ask user to commit or continue
fi
```

### 3. Copy Skill Files

**Platform detection:**
```bash
# Detect platform
case "$(uname -s)" in
    Darwin|Linux)  PLATFORM="unix" ;;
    MINGW*|MSYS*)  PLATFORM="windows" ;;
    *)             PLATFORM="unix" ;;
esac
```

**Copy command:**
```bash
if [ "$PLATFORM" = "unix" ]; then
    # Mac/Linux: Use rsync
    rsync -av --delete "$SOURCE/" "$TARGET/"
else
    # Windows: Use robocopy or cp
    cp -r "$SOURCE"/* "$TARGET/"
fi
```

### 4. Call `/publish-plugin bump`

This command handles:
- Version bumping (both plugin.json and marketplace.json)
- Git commit with standardized message
- Git push to origin

```bash
# Just invoke the command
/publish-plugin bump
```

**The command will:**
- Increment version: `1.0.16` → `1.0.17`
- Update both JSON files
- Commit: `chore(plugin): publish plugin v1.0.17`
- Push to GitHub

## Quick Reference

**Deploy skill:**
```bash
# Example: Deploy web-design-wizard
SKILL="web-design-wizard"
rsync -av --delete ~/.claude/skills/$SKILL/ \
    ~/repos/saurun-marketplace/plugins/saurun/skills/$SKILL/

cd ~/repos/saurun-marketplace
/publish-plugin bump
```

## Common Issues

| Issue | Solution |
|-------|----------|
| "SKILL.md not found" | Verify skill exists in ~/.claude/skills/ |
| "Missing frontmatter" | Add name and description to ---...--- block |
| "Marketplace is newer" | Show diff, ask user to confirm overwrite |
| "Uncommitted changes" | Ask user to commit or stash first |
| "Git push fails" | Check network, credentials, conflicts |

## Supporting Files

The workflow automatically copies entire skill directory, including:
- `SKILL.md` (required)
- `references/` (optional)
- `scripts/` (optional)
- Any other supporting files

## Safety Checks (Always Performed)

- ✅ Validate SKILL.md exists
- ✅ Validate frontmatter present
- ✅ Check marketplace git state
- ✅ Compare modification times
- ✅ Show diff if overwriting
- ✅ Ask user confirmation on conflicts

**Never skip these checks, even under time pressure.**