Versions-Skills
An AI-native toolkit for version numbers — parse, compare, sort, group, and check constraints in Go
Built for the agentic era: every capability is reachable through 🤖 Claude Code Skills and 🔌 MCP so that AI agents can call them directly, with a 📦 Go SDK and 💻 CLI underneath. Works natively with Claude Code, Codex, Cursor, Windsurf, Cline, and VS Code Copilot.
Features
- 🔄 Wide version support — standard semver (
1.2.3), prefixed (v1.2.3), prerelease (1.2.3-beta1), and custom formats - 🧩 Flexible parsing — auto-detects prefix, numeric segments, suffix, and metadata; configurable delimiters
- 📊 Semantic comparison — suffix-weight ordering (
dev < alpha < beta < rc < stable), not lexicographic - 📋 npm-style constraints —
>=,^,~,1.x,||combinations, three-level grammar - 🌳 Grouping & visualization — group by major/minor, Unicode tree rendering of version hierarchies
- 🚀 Zero dependencies — core library has no external dependencies; immutable operations
Quick Start
go get github.com/scagogogo/versions-skills
v1 := versions.NewVersion("1.2.3")
v2 := versions.NewVersion("v1.3.0-beta")
v1.IsOlderThan(v2) // true
v2.IsPrerelease() // true
v2.PreReleaseType() // "beta"
v1.Diff(v2).IsUpgrade() // true
Documentation
👉 https://scagogogo.github.io/versions-skills/
The website covers everything: concepts, tutorials, recipes, the algorithm reference, and full API docs for the Go SDK / CLI / MCP / Skills.
License
MIT License — Copyright © 2023-2026 scagogogo