semantic-release-tagger

Automate semantic versioning and GitHub releases for monorepos using conventional commits.

7|3|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/cskiro/annex --skill semantic-release-tagger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semantic-release-tagger
Source: https://github.com/cskiro/annex/tree/main/skills/semantic-release-tagger
Command: npx skills add https://github.com/cskiro/annex --skill semantic-release-tagger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the release tagging workflow, analyzes repository state, computes version bumps from conventional commits, and creates tags and optional releases.

Core Features & Use Cases

  • Auto-Analysis: Detects conventions, latest versions, and commits since last tag.
  • Version Calculation: Applies SemVer rules to propose MAJOR, MINOR, or PATCH bumps.
  • Tag & Release: Creates annotated tags and optional GitHub releases with changelog notes.

Quick Start

Use this Skill to manage release tagging for a monorepo or multi-component project.

Frequently Asked Questions about semantic-release-tagger

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

FAQPage Schema
How do I automate semantic versioning and tagging for a monorepo?

Semantic versioning automation analyzes conventional commits (feat, fix, BREAKING) to compute version bumps, then creates annotated tags following npm-style @, slash-based, or flat v conventions. This Skill detects your repository structure, calculates MAJOR.MINOR.PATCH increments, and generates tags with optional GitHub releases—eliminating manual tagging errors across multi-component projects.

Can I use semantic versioning with different tag naming conventions in the same repository?

Yes. This Skill supports multiple tag conventions—npm-style namespacing (@org/package), slash-based paths, and flat v-prefixed tags—allowing you to apply consistent SemVer rules across components regardless of their naming scheme. It auto-detects which convention your repository uses.

How does conventional commit parsing work for version calculation?

Conventional commit parsing scans commit messages for feat, fix, and BREAKING keywords to determine version increments. Feat commits trigger MINOR bumps, fix commits trigger PATCH bumps, and BREAKING changes trigger MAJOR bumps. This follows SemVer rules to automatically compute the next version number.

What happens with optional GitHub releases—do I need to enable them?

GitHub release generation is optional and requires your confirmation. After version calculation and tag creation, you can choose to generate a changelog-driven release on GitHub. The Skill creates annotated tags regardless; releases are an additional step you opt into.

Does this work with CI/CD pipelines?

Yes. This Skill integrates with CI/CD by automating tag creation, enforcing annotated tags, and pushing to remote—all steps that fit into workflow automation. You configure it to run in your pipeline after commit analysis, eliminating manual intervention in release tagging.

What's the difference between this approach and manual tagging?

Manual tagging is error-prone and inconsistent across team members. Automated semantic versioning applies consistent SemVer rules, detects version bumps from commit history, and creates tags deterministically. This eliminates human error and ensures every release follows the same versioning logic.