Claude Code Migration Guide

install.sh → Plugin Marketplace

This guide helps you migrate from the old install.sh script to the new plugin-based marketplace system.

Why Migrate?

Old Way

Old Way (File-Based)

curl -fsSL https://raw.githubusercontent.com/rhpds/rhdp-skills-marketplace/main/install.sh | bash
  • ✗ Manual updates required
  • ✗ No version management
  • ✗ Hard to share with team
  • ✗ Skills in ~/.claude/skills/
New Way

New Way (Plugin-Based)

/plugin marketplace add rhpds/rhdp-skills-marketplace
/plugin install showroom@rhdp-marketplace
  • ✓ Automatic update notifications
  • ✓ Version management and rollback
  • ✓ Easy team distribution
  • ✓ Standard package management

Prerequisites

ℹ️

Before migrating, ensure you have Claude Code installed:

  1. If you don't have Claude Code yet, install it from https://claude.com/claude-code
  2. Verify installation: claude --version in your terminal

VS Code users: Install the Claude extension from the VS Code marketplace instead.

Migration Steps

  1. Backup Your Installation

    In your terminal, back up any customized skills:

    cp -r ~/.claude/skills ~/.claude/skills-backup
cp -r ~/.claude/docs ~/.claude/docs-backup

  2. Remove Old Installation

    In your terminal, clean up the old file-based installation:

    rm -rf ~/.claude/skills/create-lab
rm -rf ~/.claude/skills/create-demo
rm -rf ~/.claude/skills/blog-generate
rm -rf ~/.claude/skills/verify-content
rm -rf ~/.claude/skills/agnosticv-catalog-builder
rm -rf ~/.claude/skills/agnosticv-validator
rm -rf ~/.claude/skills/deployment-health-checker
rm -rf ~/.claude/docs

  3. Start Claude Code

    In your terminal, start Claude Code:

    claude

    This opens the Claude Code interactive chat where you'll run the next commands.

  4. Add Marketplace

    In Claude Code chat (NOT in terminal), add the RHDP marketplace:

    # If you have SSH keys configured
/plugin marketplace add rhpds/rhdp-skills-marketplace

# If you don't have SSH configured
/plugin marketplace add https://github.com/rhpds/rhdp-skills-marketplace

  5. Install Plugins

    In Claude Code chat, install the plugins you need:

    # For workshop/demo creation (most users)
/plugin install showroom@rhdp-marketplace

# For AgnosticV catalogs (RHDP internal)
/plugin install agnosticv@rhdp-marketplace

# For deployment health checks (RHDP internal)
/plugin install health@rhdp-marketplace
/plugin install ftl@rhdp-marketplace
/plugin install ftl@rhdp-marketplace

  6. Restart Claude Code

    Exit Claude Code completely and restart it to load the new plugins.

  7. Verify Installation

    In Claude Code chat, check that skills are available:

    /skills
    ✅
    You should see:
    • /showroom:create-lab
    • /showroom:create-demo
    • /showroom:blog-generate
    • /showroom:verify-content
    • /agnosticv:catalog-builder
    • /agnosticv:validator
    • /health:deployment-validator

What Changed?

Skill Names

ℹ️
Skills now include namespace prefixes to show which plugin provides them:
Old Name New Name
/create-lab /showroom:create-lab
/create-demo /showroom:create-demo
/blog-generate /showroom:blog-generate
/verify-content /showroom:verify-content
/agnosticv-catalog-builder /agnosticv:catalog-builder
/agnosticv-validator /agnosticv:validator
/deployment-health-checker /health:deployment-validator

Directory Structure

Click to see directory structure comparison

Old file-based installation:

~/.claude/
├── skills/
│   ├── create-lab/
│   │   └── SKILL.md
│   ├── create-demo/
│   │   └── SKILL.md
│   ├── agnosticv-catalog-builder/
│   │   └── SKILL.md
│   └── ...
├── docs/
│   └── (documentation files)
└── skills/.rhdp-marketplace-version

New plugin-based installation:

~/.claude/
└── plugins/
    ├── cache/
    │   └── rhdp-marketplace/
    │       ├── showroom/
    │       │   └── 1.0.0/
    │       │       └── skills/
    │       │           ├── create-lab/SKILL.md
    │       │           ├── create-demo/SKILL.md
    │       │           ├── blog-generate/SKILL.md
    │       │           └── verify-content/SKILL.md
    │       ├── agnosticv/
    │       │   └── 2.2.0/
    │       │       └── skills/
    │       │           ├── catalog-builder/SKILL.md
    │       │           └── validator/SKILL.md
    │       └── health/
    │           └── 1.0.0/
    │               └── skills/
    │                   └── deployment-validator/SKILL.md
    ├── marketplaces/
    │   └── rhdp-marketplace/
    │       └── (full marketplace repo)
    ├── installed_plugins.json
    └── known_marketplaces.json

Key Differences:

Aspect Old Location New Location
Skills ~/.claude/skills/create-lab/ ~/.claude/plugins/cache/rhdp-marketplace/showroom/1.0.0/skills/create-lab/
Documentation ~/.claude/docs/ Embedded in plugin directories
Version tracking .rhdp-marketplace-version Built into plugin system with versioned directories
Updates Manual (run update.sh) Automatic (/plugin update)
Management Manual file copies Plugin system

Updating Plugins

ℹ️

Step 1: Update Marketplace

/plugin marketplace update

This opens an interactive UI:

  1. Select the marketplace
  2. Press u to update it
  3. Press Esc to go back

This refreshes the marketplace cache with the latest plugin versions.

Step 2: Update Plugins

/plugin update showroom@rhdp-marketplace

This opens an interactive UI:

  1. Navigate with ctrl+p or arrow keys
  2. Select "Update now" and press Enter
  3. Press Esc to go back
ℹ️
Note: Both commands are interactive - you must use the UI to perform updates. After updating, restart Claude Code to load the new versions.

Troubleshooting

⚠️

See the Troubleshooting Guide for common migration issues.

Rollback (If Needed)

Click to see rollback instructions

If you need to rollback to the old file-based installation:

# Restore from backup
cp -r ~/.claude/skills-backup ~/.claude/skills
cp -r ~/.claude/docs-backup ~/.claude/docs

# Remove plugins
/plugin uninstall showroom@rhdp-marketplace
/plugin uninstall agnosticv@rhdp-marketplace
/plugin uninstall health@rhdp-marketplace
/plugin marketplace remove rhdp-marketplace

Claude Code Setup Guide

Full setup guide for Claude Code

Troubleshooting

Common issues and solutions

Quick Reference

Commands at a glance