Contributing

Contributions to the Cloud plugin marketplace are welcome. This guide covers plugin-specific requirements. For the full governance workflow (issues, branches, PRs, and merge rules), see CONTRIBUTING.md in the repository root.

Adding a plugin

Create the plugin

Every plugin repository must contain a valid .claude-plugin/plugin.json:

{
  "name": "your-plugin-name",
  "version": "1.0.0",
  "description": "What your plugin does",
  "author": {
    "name": "Your Name",
    "email": "you@example.com",
    "url": "https://github.com/yourusername"
  },
  "license": "MIT",
  "keywords": ["f5", "xc", "your-tags"],
  "commands": "./commands/",
  "skills": "./skills/"
}

Add a marketplace entry

Edit .claude-plugin/marketplace.json to register the plugin:

{
  "plugins": [
    {
      "name": "your-plugin-name",
      "description": "What your plugin does",
      "version": "1.0.0",
      "author": {
        "name": "Your Name",
        "url": "https://github.com/yourusername"
      },
      "source": {
        "source": "github",
        "repo": "yourusername/your-plugin-repo"
      },
      "category": "automation",
      "tags": ["f5", "xc", "your-tags"]
    }
  ]
}

Plugin requirements

Required files

File	Description
.claude-plugin/plugin.json	Plugin manifest with metadata
README.md	Plugin documentation
LICENSE	Open source license

Recommended directory structure

your-plugin/
├── .claude-plugin/
│   └── plugin.json
├── commands/
│   └── your-command.md
├── skills/
│   └── your-skill/
│       └── SKILL.md
├── README.md
├── LICENSE
└── CHANGELOG.md

Quality standards

• Plugin installs without errors
• Commands work as documented
• Source repository is publicly accessible
• License is clearly specified
• Documentation is clear and complete

Commit convention

This project uses Conventional Commits:

Type	Description	Version bump
feat:	New features	Minor
fix:	Bug fixes	Patch
docs:	Documentation	None
chore:	Maintenance	None
refactor:	Code restructuring	None
test:	Testing	None

Validation

Before submitting, verify changes pass validation:

# Validate marketplace.json syntax
python -m json.tool .claude-plugin/marketplace.json

# Check plugin sources are accessible
python scripts/generate-plugin-docs.py

Code of conduct

• Be respectful and inclusive
• Provide constructive feedback
• Help others learn and grow
• Focus on technical merits

Getting help

• Open an issue
• Start a discussion

License

By contributing, you agree that your contributions are licensed under the MIT License.