Versions-Skills

An AI-native toolkit for version numbers — parse, compare, sort, group, and check constraints in Go

📚 Full documentation → · 简体中文

---

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