gh-bradleyboehmke-brads-marketplace-marketplace-dev/skills/marketplace-registration.md

title, description, tags

title	description	tags
Marketplace Registration Standards	Plugin registration, versioning, tagging, and quality gates for marketplace	registration versioning quality marketplace

Marketplace Registration Standards

Metadata

Purpose: Define registration process and quality standards for marketplace plugins Applies to: All Personal marketplace plugins Version: 1.0.0

---

Instructions

Marketplace Registration

marketplace.json Entry:

{
  "name": "brads-marketplace",
  "description": "Personal Custom Claude Plugins",
  "owner": {
    "name": "Personal Team"
  },
  "plugins": [
    {
      "name": "plugin-name",
      "source": "./plugin-name",
      "description": "Plugin description from plugin.json"
    }
  ]
}

Registration Process:

1. Create plugin in its own directory
2. Add entry to root marketplace.json
3. Description should match plugin.json
4. Source is relative path from marketplace root

Documentation Standards

Plugin README (if plugin is complex):

• Purpose and use cases
• Installation instructions
• Command reference
• Examples

Root CLAUDE.md (marketplace-level):

• Update with new plugin info
• Add example commands
• Note any cross-plugin workflows

Version Management

Semantic Versioning:

• 1.0.0 - Initial release
• 1.1.0 - New commands/features (minor)
• 1.0.1 - Bug fixes (patch)
• 2.0.0 - Breaking changes (major)

What triggers major version:

• Removing commands
• Changing command parameters (breaking)
• Restructuring that affects users

What triggers minor version:

• Adding new commands
• Adding new skills
• Adding new agents
• New features (non-breaking)

What triggers patch version:

• Bug fixes
• Documentation updates
• Performance improvements
• Refactoring (no user-facing changes)

Quality Gates

Before adding plugin to marketplace:

• plugin.json with all required fields
• All files have proper frontmatter
• Commands follow output parameter standards
• Purpose describable in 5-10 words
• Entry added to marketplace.json
• CLAUDE.md updated with examples
• Tested with claude plugins install ./plugin-name

Additional quality checks:

• No duplicate knowledge across components
• Skills use progressive disclosure (if applicable)
• Component sizes within guidelines (agents <500, skills <400, commands <600 lines)
• Clear separation of concerns (agent vs skill vs command)

Personal Tags

Use these tags in plugin.json for discoverability:

Domain Tags:

• standards - Validation/compliance plugins
• investigation - Analysis/discovery plugins
• development - Dev tool plugins
• documentation - Doc generation/validation

Function Tags:

• validation - Checks compliance
• analysis - Analyzes code/architecture
• generation - Creates artifacts
• orchestration - Coordinates workflows

Context Tags:

• labs - Labs-specific
• python - Python projects
• data-science - ML/DS projects
• architecture - System design

Technology Tags:

• mlflow - MLflow integration
• databricks - Databricks integration
• spark - Apache Spark
• pytest - Testing with pytest
• poetry - Poetry package management

Plugin Lifecycle

Development Phase:

• Version: 0.x.x
• Status: Experimental
• Can make breaking changes frequently
• Not recommended for production use

Stable Phase:

• Version: 1.x.x+
• Status: Stable
• Follow semantic versioning strictly
• Breaking changes only in major versions

Deprecated Phase:

• Mark in plugin.json: "deprecated": true
• Document migration path in README
• Provide timeline for removal
• Suggest alternative plugins

---

Resources

Complete marketplace.json Example

{
  "name": "brads-marketplace",
  "description": "Personal Custom Claude Plugins",
  "version": "1.0.0",
  "owner": {
    "name": "Personal Team",
    "url": "https://github.com/USERNAME"
  },
  "plugins": [
    {
      "name": "validator",
      "source": "./validator",
      "description": "Standards validator for personal use projects",
      "tags": ["standards", "validation", "personal"]
    },
    {
      "name": "repo-investigator",
      "source": "./repo-investigator",
      "description": "Repository analysis and investigation tools",
      "tags": ["investigation", "analysis", "personal"]
    },
    {
      "name": "document-generator",
      "source": "./document-generator",
      "description": "Architecture documentation generation tools",
      "tags": ["documentation", "generation", "personal"]
    },
    {
      "name": "marketplace-dev",
      "source": "./marketplace-dev",
      "description": "Plugin development and architecture tools",
      "tags": ["development", "architecture", "personal"]
    }
  ]
}

Plugin Release Checklist

Before 1.0.0 Release:

• All features implemented and tested
• Documentation complete
• Examples provided
• Quality gates passed
• Peer review completed
• Breaking changes documented
• Migration guide (if replacing existing plugin)

For Minor Version Release (1.x.0):

• New features tested
• Documentation updated
• Backward compatibility verified
• Examples updated
• CHANGELOG.md updated

For Patch Version Release (1.0.x):

• Bug fixes tested
• No breaking changes
• Documentation updated (if needed)
• CHANGELOG.md updated

Deprecation Notice Template

Add to plugin README.md:

## ⚠️ Deprecation Notice

This plugin is deprecated as of [date] and will be removed in [future date].

**Reason**: [Why this plugin is being deprecated]

**Migration Path**:
- Use [alternative-plugin] instead
- Migration guide: [link or instructions]
- Support timeline: [when support ends]

**Questions**: Contact Personal team

Version History Template

Add to plugin README.md or CHANGELOG.md:

## Version History

### v2.0.0 (2024-01-15)
**Breaking Changes**:
- Removed deprecated command `/old-command`
- Changed parameter format for `/main-command`

**New Features**:
- Added `/new-command` for improved workflow
- New skill: `advanced-analysis.md`

**Migration Guide**:
- Replace `/old-command` with `/new-command --mode=legacy`
- Update parameter: `--old-param` → `--new-param`

### v1.2.0 (2024-01-01)
**New Features**:
- Added support for Python 3.12
- New skill: `python-312-features.md`

**Bug Fixes**:
- Fixed issue with virtual environment detection

### v1.1.0 (2023-12-15)
**New Features**:
- Added `/quick-check` command
- Performance improvements

### v1.0.0 (2023-12-01)
**Initial stable release**
- Core validation features
- Documentation generation
- CLI integration