skillhub/document/docs/03-user-guide/publishing/versioning.md
2026-07-23 12:23:22 +08:00

1.1 KiB

title sidebar_position description
Version Management 3 Skill version and tag management

Version Management

Semantic Versioning

SkillHub uses Semantic Versioning: MAJOR.MINOR.PATCH

  • MAJOR: Incompatible API changes
  • MINOR: Backward compatible feature additions
  • PATCH: Backward compatible bug fixes

Examples: 1.0.0, 1.1.0, 2.0.0

latest Tag

latest is a system reserved tag that automatically follows the latest published version and cannot be manually moved.

Custom Tags

You can create custom tags for version channel management:

  • beta - Beta version
  • stable - Stable version
  • stable-2026q1 - Quarterly stable version

Create/Move Tag

clawhub tag set @team/my-skill beta 1.2.0

Delete Tag

clawhub tag delete @team/my-skill beta

Version Withdrawal

Published versions with issues can be withdrawn:

  1. Go to skill detail page
  2. Find target version
  3. Click "Withdraw Version"
  4. Confirm withdrawal

Withdrawn versions remain visible but are marked as not recommended for use.

Next Steps