Publish a plugin to the marketplace
Validate and publish Claude Code plugins to the marketplace with security scanning and manifest validation. Use --validate to check only, --register for new accounts, or --update to release new versions.
/plugin marketplace add Lobbi-Docs/claude-2/plugin install lobbi-docs-plugin-marketplace@Lobbi-Docs/claude-2[path/to/plugin] [--validate] [--register]Publish a Claude Code plugin to the marketplace.
Publish plugin based on: $ARGUMENTS
Extract from $ARGUMENTS:
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)
Check plugin.json:
{
"name": "my-plugin", // ā
Valid name format
"description": "...", // ā
Under 200 chars
"version": "1.0.0", // ā
Valid semver
"author": "Your Name" // ā
Author specified
}
Check for security issues:
š Security scan...
ā
No hardcoded secrets detected
ā
No suspicious file access
ā
No network calls to unknown hosts
ā
Dependencies are safe
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?
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
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
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
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
ā 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:
Errors:
⢠Missing required file: LICENSE
⢠Invalid manifest: "version" must be semver format
Please fix these issues before publishing.
ā Authentication required.
Please register or log in:
/plugin-marketplace:publish --register