Sparehand

Releasing

Steps

  1. Change the plugin and add a section to plugin/CHANGELOG.md.
  2. Bump 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.
  3. Run claude plugin validate ., claude plugin validate plugin and python3 .github/scripts/validate_plugin.py.
  4. Open a pull request into main and merge it.

What CI checks

On every pull request (.github/workflows/validate.yml):

Building a ZIP

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.