version-manager

Automate SEMO package semantic versioning with VERSION updates and Keep a Changelog compliance.

Updated Dec 11, 2025
One-click install
npx skills add https://github.com/semicolon-devteam/semo --skill version-manager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: version-manager
Source: https://github.com/semicolon-devteam/semo/tree/main/packages/meta/skills/version-manager
Command: npx skills add https://github.com/semicolon-devteam/semo --skill version-manager

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Bash, gh, git, curl, jq, and includes references (resource) components.

What problem does it solve?

This Skill automates the entire Semantic Versioning process for SEMO packages, from determining version type (MAJOR, MINOR, PATCH) to updating files, committing changes, pushing to Git, and sending mandatory Slack release notifications.

Core Features & Use Cases

  • Semantic Versioning: Automatically calculates new versions based on changes (MAJOR, MINOR, PATCH).
  • CHANGELOG Management: Updates VERSION files, creates new CHANGELOG/{version}.md files, and updates CHANGELOG/INDEX.md following "Keep a Changelog" format.
  • Git Automation: Handles staging, committing, and pushing versioning changes to the remote repository.
  • Mandatory Slack Notification: Ensures a release announcement is sent to Slack after successful versioning.
  • Feedback Loop: Optionally notifies original feedback providers on GitHub when their reported issues are addressed in a new release.
  • Use Case: After implementing a new feature in semo-meta, you can use this skill to "Release a new minor version for semo-meta" and it will handle all versioning, Git operations, and team notifications.

Quick Start

Release a new version: "버전 타입 결정 후 릴리스" Update VERSION and CHANGELOG: "VERSION 및 CHANGELOG 업데이트" Automate release process: "Agent/Skill/Command 변경 후 릴리스"

Frequently Asked Questions about version-manager

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate semantic versioning for my SEMO packages?

Semantic versioning automates version bumps (MAJOR, MINOR, PATCH) based on code changes, then updates VERSION files, generates CHANGELOG entries following Keep a Changelog format, commits changes, and pushes to Git. This Skill handles the entire workflow end-to-end, including Slack release notifications.

How do I generate and update CHANGELOG files automatically?

After changes to Agents, Skills, or Commands, this Skill creates versioned CHANGELOG/{version}.md files and updates CHANGELOG/INDEX.md in Keep a Changelog format. It infers the version type, calculates the new version number, and stages all changes for commit.

Can I automate Git commits and pushes for release workflows?

Yes. This Skill stages versioning changes, commits them with appropriate messages, and pushes to the remote repository. It integrates with Git automation to handle multi-repository environments and local semo-meta synchronization.

Does this Skill send release notifications to Slack?

Yes. Mandatory Slack notifications are sent after successful versioning to alert your team of the release. The Skill can also optionally notify GitHub users whose feedback was addressed in the new version.

What tools do I need to use this Skill?

This Skill requires Bash, Git, the GitHub CLI (gh), curl, and jq. It automates semantic versioning workflows for SEMO packages using these standard command-line tools.

When should I use semantic versioning for my releases?

Use semantic versioning when releasing changes to Agents, Skills, or Commands in SEMO packages. It clarifies the impact of each release (MAJOR for breaking changes, MINOR for features, PATCH for fixes) and maintains consistency across your codebase.