Install Plugin

Install a Claude Code plugin from the marketplace.

Your Task

Install the plugin specified: $ARGUMENTS

Process

1. Parse Arguments

Extract from $ARGUMENTS:

• Plugin name: Required, format @scope/plugin-name
• Version: Optional --version x.x.x, defaults to latest
• Scope: Optional --project for project-local install

2. Validate Plugin Exists

Check if the plugin exists in the registry. If not found:

• Suggest similar plugin names
• Check if it's a git URL instead
• Offer to search the marketplace

3. Check Compatibility

Verify:

• Plugin is compatible with current Claude Code version
• No conflicting plugins installed
• Required dependencies are available

4. Review Permissions

Show the user what permissions the plugin requires:

📋 Permissions requested by @scope/plugin-name:

| Permission | Risk | Description |
|------------|------|-------------|
| filesystem:read | Medium | Read files from your project |
| execute | High | Run shell commands |

⚠️ This plugin requests elevated permissions.
Proceed with installation? (Explain what you'll use it for)

5. Install Plugin

Determine installation location:

• User scope (default): ~/.claude/plugins/plugin-name/
• Project scope (--project): .claude/plugins/plugin-name/

Execute installation:

# Clone/download the plugin
git clone https://registry.example.com/scope/plugin-name.git <target-path>

6. Verify Installation

After installation:

1. Verify plugin structure is valid
2. List available commands
3. List available skills
4. Check for required configuration

7. Post-Install Instructions

Show the user:

• How to use the plugin
• Any required configuration
• Quick start example

Example Output

📦 Installing @claude/git-assistant v1.5.2...

✅ Downloaded from registry
✅ Verified plugin signature
✅ Installed to ~/.claude/plugins/git-assistant/

📋 Plugin Contents:
- Commands: /git-assistant:commit, /git-assistant:pr, /git-assistant:review
- Skills: commit-message-generation, pr-description
- Hooks: pre-commit validation

⚙️ Configuration:
Create ~/.claude/git-assistant.local.md to customize settings.

🚀 Quick Start:
Try: /git-assistant:commit to generate a commit message

Installation complete!

Error Handling

Plugin Not Found

❌ Plugin @scope/unknown-plugin not found.

Did you mean:
- @scope/known-plugin
- @other/similar-plugin

Search marketplace: /plugin-marketplace:browse <query>

Already Installed

⚠️ @scope/plugin-name is already installed (v1.2.0).

Options:
- Update to latest: /plugin-marketplace:update @scope/plugin-name
- Reinstall: /plugin-marketplace:install @scope/plugin-name --force

Permission Denied

❌ Cannot write to ~/.claude/plugins/

Solutions:
- Check directory permissions
- Use --project flag for local install
- Run with appropriate permissions