One-click install
npx skills add https://github.com/guardiatechnology/design-system --skill kata-tag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kata-tag
Source: https://github.com/guardiatechnology/design-system/tree/main/.claude/skills/kata-tag
Command: npx skills add https://github.com/guardiatechnology/design-system --skill kata-tag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the risk of releasing with malformed version identifiers or unsigned/lightweight tags by guiding you through producing a SemVer-compliant, annotated, GPG-signed Git tag that matches the repository’s lex rules.

Core Features & Use Cases

  • Checks repository state: verifies a clean working tree and resolves the correct target commit (HEAD by default or a user-specified commit/message).
  • Determines the next version: suggests or uses a specific MAJOR.MINOR.PATCH identifier by analyzing changes since the latest SemVer tag and applying lex-semantic-version rules.
  • Validates before tagging: confirms the version format and ensures the tag does not already exist.
  • Creates the correct tag type: creates an annotated and signed tag using git tag -s with a release message tied to the resolved commit.
  • Performs final verification: confirms existence and GPG signature validity, then instructs how to publish the tag to the remote.

Use case example: You need to cut a new release after merging multiple changes, and you want the tag to be automatically derived from commit types while guaranteeing that it is signed and pushable without violating lex-annotated-tags.

Quick Start

Tell the AI: “Create an annotated and GPG-signed release tag for the next Semantic Version at HEAD using lex-semantic-version rules, and verify that the tag is signed before telling me what to push.”

Frequently Asked Questions about kata-tag

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

FAQPage Schema
How do I create a GPG-signed Git tag for a Semantic Versioning release?

To create a GPG-signed Git tag, resolve a target commit, compute the next SemVer 2.0 version from history, verify a clean repository state, and execute `git tag -s <version> <target> -m "<message>"` followed by signature validation.

What is the difference between annotated and lightweight Git tags in release automation?

Annotated Git tags store metadata like the tagger's name, date, and a release message, and can be GPG-signed using `git tag -s`. Lightweight tags are simple pointers without metadata or cryptographic signatures, making annotated tags necessary for compliant release workflows.

How do I automatically determine the next SemVer version from commit history before tagging?

You can determine the next SemVer version by analyzing commit changes since the latest SemVer tag and applying lex-semantic-version rules to calculate the correct MAJOR.MINOR.PATCH increment before creating the annotated Git tag.

Do I need a clean working tree to create a signed release tag?

Yes, you need a clean working tree to create a signed release tag. The process requires clean repository state validation to ensure the target commit is stable before executing `git tag -s` and verifying the GPG signature.

Can I validate that a Git tag is GPG-signed after creating it?

Yes, you can validate a GPG-signed Git tag by performing post-creation verification via tag listing and signature validation commands to confirm both the tag's existence and the cryptographic signature's integrity before pushing to the remote.

What happens if I try to create a Git tag that already exists?

Creating a Git tag that already exists will fail. The tagging process validates before execution by confirming the version format and checking existing tags to avoid duplicates, ensuring your release workflow does not overwrite previous Semantic Versioning releases.