A zero-dependency Python utility for parsing, validating, and manipulating Semantic Versioning 2.0.0 strings.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install semver-toolkit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install semver-toolkit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SemVer Toolkit?
The SemVer Toolkit is a robust utility designed to handle the complexities of Semantic Versioning (SemVer 2.0.0) within automated environments. As a featured part of the Openclaw Skills ecosystem, it provides developers and CI/CD pipelines with a reliable way to manage software versioning without the overhead of external dependencies.
By adhering strictly to the SemVer specification, this skill ensures that versioning logic—including prerelease precedence and build metadata—is applied consistently across your projects. Whether you are automating a release flow or validating user input, this toolkit provides the precision required for modern software development.
SemVer Toolkit Use Cases
- Automating version bumps in CI/CD pipelines for major, minor, or patch releases.
- Validating git tags or user-provided version strings against the SemVer 2.0.0 specification.
- Programmatically comparing version numbers to determine upgrade paths or compatibility.
- Sorting large lists of version strings for changelog generation or manifest updates.
How SemVer Toolkit Works
- Input Reception: The tool accepts one or more version strings via CLI, optionally handling the common 'v' prefix.
- Component Parsing: The internal logic breaks the string into its constituent parts: Major, Minor, Patch, Prerelease, and Build metadata.
- Logic Execution: Based on the command (bump, compare, sort), the tool applies SemVer-specific rules, such as identifying that 1.0.0-alpha is less than 1.0.0.
- Structured Output: The results are returned to the console or as a JSON object for integration with other Openclaw Skills.
SemVer Toolkit Setup
Since this tool relies solely on the Python 3 standard library, setup is instantaneous. Ensure you have the script in your local environment:
# Ensure you have Python 3 installed
python3 --version
# Make the script executable
chmod +x scripts/semver_toolkit.py
# Run a test validation
python3 scripts/semver_toolkit.py validate 1.0.0
SemVer Toolkit Data Schema & Taxonomy
The toolkit organizes version data into five primary segments. When using the -f json flag, the data is returned in a structured format:
| Key | Description | Example |
|---|---|---|
major |
Breaking change increment | 1 |
minor |
New feature increment | 2 |
patch |
Bug fix increment | 3 |
prerelease |
Pre-release identifiers | beta.1 |
build |
Build metadata | build.42 |
All commands support the --format json flag to facilitate machine-readability within larger Openclaw Skills workflows.
SemVer Toolkit Advanced Features
- Prerelease Tagging: Support for custom pre-release tags like
rc,alpha, orbetaduring the bump process. - Machine-Readable JSON: Integration-ready JSON output mode available for every command.
- Reverse Sorting: High-performance sorting algorithms with a reverse flag for descending order releases.
- Zero-Dependency Architecture: Designed to run in minimal environments like Alpine Linux or restricted CI runners.
SKILL.md
Loading
Related Openclaw Skills
HPC ElmerFEM
A specialized agent skill for building, debugging, and automating complex ElmerFEM multiphysics simulation workflows and HPC execution.
DeepSync
An AI-powered matching engine that connects people based on core psychological traits and decision-making styles rather than superficial interests.
pepper-oil-scraper
A specialized Python-based scraper designed to aggregate market intelligence, pricing, and supply chain data for the Sichuan pepper and prickly ash oil industry.
3-Body Movement Simulator
A sophisticated guide and computational framework for architecting numerical simulators to solve the chaotic three-body gravitational problem.
Agent Spectrum
A standardized six-axis scoring framework designed for AI agents to evaluate their own capabilities or those of other agents with visual profiling.
API Test Automation
A professional-grade API testing suite supporting REST and GraphQL with integrated performance, contract testing, and mock services.
Featured*
