Versions-Skills

Versions-Skills

---

Access Methods

🤖 Skills (Claude Code) — Recommended for AI-powered workflows

One-click install for Claude Code:

claude marketplace add versions https://github.com/scagogogo/versions-skills

Then use slash commands in Claude Code: /version-parsing, /version-comparison, /version-sorting, /version-grouping, /version-constraints, /version-range-query, /version-visualization, /version-file-operations, /version-check, /version-mutation, /version-properties, /cli-operations, /mcp-operations

📦 Go SDK — Recommended for Go developers

go get github.com/scagogogo/versions-skills

import "github.com/scagogogo/versions-skills"

v := versions.NewVersion("v1.2.3-beta1")
fmt.Println(v.Major())    // 1
fmt.Println(v.IsValid())  // true

💻 CLI — Recommended for scripts and CI/CD

# Download from GitHub Releases (recommended)
# https://github.com/scagogogo/versions-skills/releases/latest

# Or install via Go
go install github.com/scagogogo/versions-skills/cmd/versions@latest

# Usage
versions parse v1.2.3-beta1
versions compare 1.0.0 2.0.0
versions sort 3.0.0 1.0.0 2.0.0

🔌 MCP Server — Recommended for AI tool integration

go install github.com/scagogogo/versions-skills/cmd/versions-mcp@latest

Configure in Claude Code settings.json:

{
  "mcpServers": {
    "versions": {
      "command": "versions-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

---

Features

• 🔄 Comprehensive version support — Standard semver (1.2.3), prefixed (v1.2.3), pre-release (1.2.3-beta1), and custom formats
• 🧩 Flexible parsing — Auto-detect prefix, numbers, suffix, and metadata with customizable delimiters
• 📊 Version comparison — Semantic-aware comparison with suffix weight ordering (dev < alpha < beta < rc < stable)
• 📦 Grouping & sorting — Group by major/minor version, sort with stable pre-release ordering
• 🔍 Range queries — Query versions within ranges with flexible boundary policies
• 📋 Constraint expressions — Full npm-style constraints: >=1.0.0, ^1.2.3, ~1.2, 1.x, >=1.0.0,<2.0.0 || >=3.0.0
• 🏷️ Semver compliance — IsSemver(), ValidateSemver() for strict SemVer 2.0.0 validation
• 📁 File I/O — Read/write version lists from files with comment support
• 🌳 Visualization — Unicode tree-based version hierarchy display
• 🔧 Immutable mutations — With* methods and Bump* operations that never modify the original
• 🔗 Serialization — JSON, Text, SQL Scanner/Valuer out of the box
• 🚀 Zero dependencies — Core library has no external dependencies

---

Quick Start

Parse & Compare

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

Sort & Group

list := versions.NewVersions("2.0.0", "1.0.0", "1.10.0", "1.5.0-beta")

// Sort
sorted := versions.SortVersionSlice(list)
// → [1.0.0, 1.5.0-beta, 1.10.0, 2.0.0]

// Group by major version
groups := versions.GroupByMajor(list)
// → {1: [1.0.0, 1.5.0-beta, 1.10.0], 2: [2.0.0]}

Constraints

v := versions.NewVersion("1.5.0")

// Check single constraint
c, _ := versions.ParseConstraint(">=1.0.0")
v.Satisfies(c)  // true

// Check constraint expression
ok, _ := v.Matches(">=1.0.0,<2.0.0")  // true

// Negate a constraint
neg := versions.NegateConstraint(c)  // <1.0.0

Range Queries

low := versions.NewVersion("1.0.0")
high := versions.NewVersion("2.0.0")

r := versions.NewClosedRange(low, high)
r.Contains(versions.NewVersion("1.5.0"))  // true
r.Contains(versions.NewVersion("2.1.0"))  // false

Extract from Strings

v := versions.Coerce("program-1.2.3-linux-amd64")
fmt.Println(v.Raw)  // "1.2.3"

---

API Overview

Core Types