plugin/CHANGELOG.md.version in plugin/.claude-plugin/plugin.json, in plugin/gemini-extension.json (must match), and metadata.version in any changed skill. Without a new version number, people will not receive the change.claude plugin validate ., claude plugin validate plugin and python3 .github/scripts/validate_plugin.py.main and merge it.On every pull request (.github/workflows/validate.yml):
README.md and docs/ resolve.plugin/gemini-extension.json matches plugin.json (name, version, description).LICENSE exists, and plugin/.claude-plugin/icon.png is a square PNG between 512 and 2048 pixels..github/ISSUE_TEMPLATE/feedback.yml exists with its field ids and the feedback label.docs/skills/ with a Mermaid flow.plugin/skills/, plugin/CONNECTORS.md or plugin/guides/ (except the update-check prompt).main.TERMS.md and PRIVACY.md exist, link to each other, and are linked from README.md; the usage-ping recipes (identity.md, usage-ping.md) exist with the exact notice text, the uid snippet, and no reason; start, partner-event-finder and install-automation reference them, and share-feedback does not..github/ or docs/.For tools that take an upload instead of a marketplace. Python 3 only, any OS:
python3 scripts/build_zip.py
This writes dist/sparehand-plugin-<version>.zip (version read from plugin.json). It holds the contents of plugin/ (.claude-plugin/, gemini-extension.json, skills/, guides/, CHANGELOG.md, CONNECTORS.md) plus LICENSE and README.md at the ZIP root.
For portals that take one skill at a time:
python3 scripts/build_zip.py --skill partner-event-finder
This writes dist/partner-event-finder-<version>.zip with SKILL.md at the ZIP root. It warns if the skill points to files outside its own folder (../), because those would be missing.
dist/ is not committed.