release-tagging-plan

Plan software releases with semantic versioning and changelog documentation.

1|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/mcj-coder/development-skills --skill release-tagging-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-tagging-plan
Source: https://github.com/mcj-coder/development-skills/tree/main/skills/release-tagging-plan
Command: npx skills add https://github.com/mcj-coder/development-skills --skill release-tagging-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured approach to planning and executing software releases, ensuring clear versioning, consistent changelogs, and predictable release cadences.

Core Features & Use Cases

  • Semantic Versioning: Enforces MAJOR.MINOR.PATCH principles for clear release impact.
  • Release Planning: Guides through classifying changes, determining version bumps, and planning pre-release phases.
  • Hotfix Management: Provides a clear workflow for addressing critical production issues without disrupting the main development line.
  • Changelog Generation: Facilitates creating comprehensive changelogs in the Keep a Changelog format.
  • Use Case: When preparing to release a new version of a software library, this Skill helps determine if it should be a patch, minor, or major release based on the changes, and guides the creation of the git tag and changelog entry.

Quick Start

Use the release-tagging-plan skill to plan the next release version for your project.

Frequently Asked Questions about release-tagging-plan

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

FAQPage Schema
How do I determine if my next software release should be a major, minor, or patch version bump?

Semantic versioning determines your release version bump by classifying changes: major for incompatible API changes, minor for backward-compatible features, and patch for backward-compatible fixes. This Skill guides you through classifying changes to plan the correct version increment.

What is the best way to generate a changelog for a new git release tag?

The best way to generate a changelog for a git release tag is using the Keep a Changelog format. This Skill facilitates creating comprehensive changelog documentation alongside your release tags to maintain clear release history.

How do I manage a hotfix workflow without disrupting the main development branch?

Managing a hotfix workflow without disrupting development requires a dedicated branching strategy. This Skill provides a clear hotfix management workflow to address critical production issues and create release tags independently of the main development line.

How do I plan pre-release phases for predictable software delivery?

Planning pre-release phases involves defining a release cadence and structuring pre-release versions. This Skill supports pre-release management and release cadence planning to ensure predictable software delivery schedules.

When should I use semantic versioning for my software library releases?

You should use semantic versioning for software library releases whenever you need to clearly communicate the impact of changes to users. This Skill enforces MAJOR.MINOR.PATCH principles to provide clear release impact signaling for your project.