Versioning

Publish updates to your skills without breaking existing installs.

How it works

Every skill starts at version 1.0.0. When you publish an update, you specify a new semver version and optional changelog. The CLI installs the latest version by default.

Publishing a new version

curl -X POST https://skillshope.com/api/skills/<id>/versions \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "version": "1.1.0",
    "changelog": "Added support for CSV export",
    "files": [
      { "filename": "SKILL.md", "content": "..." }
    ]
  }'

Version rules

• Versions must be unique per skill
• Use semver format (e.g., 1.0.0, 1.1.0, 2.0.0)
• Each version can have its own set of files
• The skill's currentVersion updates automatically

Version history

The registry endpoint (GET /api/registry/<slug>) returns the 5 most recent versions with changelogs.