Publish Plugin

Publish a Claude Code plugin to the marketplace.

Your Task

Publish plugin based on: $ARGUMENTS

Process

1. Parse Arguments

Extract from $ARGUMENTS:

• Path: Plugin directory (default: current directory)
• --validate: Only validate, don't publish
• --register: Register new publisher account
• --update: Update existing plugin

2. Validate Plugin Structure

Check required files exist:

📋 Validating plugin structure...

✅ .claude-plugin/plugin.json - Valid manifest
✅ README.md - Documentation present
✅ LICENSE - License file found (MIT)
✅ commands/ - 3 command files found
✅ skills/ - 2 skills found
⚠️ No hooks defined (optional)
⚠️ No agents defined (optional)

3. Validate Manifest

Check plugin.json:

{
  "name": "my-plugin",           // ✅ Valid name format
  "description": "...",          // ✅ Under 200 chars
  "version": "1.0.0",            // ✅ Valid semver
  "author": "Your Name"          // ✅ Author specified
}

4. Security Scan

Check for security issues:

🔒 Security scan...

✅ No hardcoded secrets detected
✅ No suspicious file access
✅ No network calls to unknown hosts
✅ Dependencies are safe

5. Pre-Publish Summary

Show what will be published:

📦 Ready to publish:

Plugin:       @username/my-plugin
Version:      1.0.0
Size:         124 KB
Category:     productivity

Components:
  • 3 commands
  • 2 skills
  • 1 hook

Files to upload:
  • .claude-plugin/plugin.json
  • README.md
  • LICENSE
  • commands/command1.md
  • commands/command2.md
  • commands/command3.md
  • skills/skill1/SKILL.md
  • skills/skill2/SKILL.md
  • hooks/hooks.json

Excluded (won't be uploaded):
  • node_modules/
  • .git/
  • *.local.md

Proceed with publish?

6. Publish

Execute publication:

📤 Publishing @username/my-plugin v1.0.0...

[1/4] Authenticating with registry...     ✅
[2/4] Uploading plugin package...         ✅
[3/4] Processing and validating...        ✅
[4/4] Publishing to marketplace...        ✅

🎉 Plugin published successfully!

Your plugin is now available:
  Install: /plugin-marketplace:install @username/my-plugin
  View:    https://marketplace.claude.ai/plugins/@username/my-plugin

Next steps:
  • Share the install command
  • Apply for verified status
  • Monitor for issues and feedback

Validate Only (--validate)

When --validate is specified:

📋 Validation Results for my-plugin

✅ Structure: Valid
✅ Manifest: Valid
✅ README: Present and formatted
✅ LICENSE: MIT detected
✅ Security: No issues found

⚠️ Suggestions:
  • Add keywords to manifest for discoverability
  • Include screenshots in README
  • Add usage examples

Ready to publish: /plugin-marketplace:publish

Register Publisher (--register)

For first-time publishers:

👤 Publisher Registration

To publish plugins, you need a publisher account.

Please provide:
  • Publisher name (your username or org)
  • Email address
  • Agree to terms of service

After registration:
  • You can publish under @your-name scope
  • Plugins are reviewed before being listed
  • Apply for verification after publishing

Update Existing (--update)

When updating a published plugin:

📦 Updating @username/my-plugin

Current version: 1.0.0
New version:     1.1.0

Changes detected:
  + Added: commands/new-command.md
  ~ Modified: skills/main-skill/SKILL.md
  - Removed: (nothing)

Changelog required. Please describe changes:
> Added new-command for better workflow support

Publishing update...
✅ Updated to v1.1.0

Error Handling

Name Taken

❌ Plugin name "my-plugin" is already taken.

Suggestions:
  • Use a scoped name: @username/my-plugin
  • Choose a different name
  • Check if you own the existing plugin

Validation Failed

❌ Validation failed:

Errors:
  • Missing required file: LICENSE
  • Invalid manifest: "version" must be semver format

Please fix these issues before publishing.

Not Authenticated

❌ Authentication required.

Please register or log in:
  /plugin-marketplace:publish --register