releasing

Release Workflow

Execute semantic versioning releases or scaffold release infrastructure for projects.

Usage

This skill is invoked when:

• User runs /release command with a version argument
• User runs /release --setup to scaffold release infrastructure

Two Operation Modes

Mode 1: Release (/release <version>)

Validates, prepares, and triggers a GitHub release.

Mode 2: Setup (/release --setup)

Scaffolds release scripts and GitHub Actions workflow into the target project.

Supported Arguments

Parse arguments from user input:

• <version>: Version to release (e.g., 1.6.0 or v1.6.0)
• --setup: Scaffold release infrastructure into current project
• --skip-monitor: Trigger workflow but don't wait for completion

Prerequisites

• gh CLI installed and authenticated (gh auth status)
• Git configured with push access to remote
• CHANGELOG.md with a version entry (use /changelog to generate)
• .github/workflows/release.yml exists (use --setup to create)

Release Flow Steps

Step 1: Parse and Validate Version

VERSION="${1:-}"

# Strip 'v' prefix if present
VERSION="${VERSION#v}"

# Validate semver format
if ! [[ "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
    echo "Error: Invalid version format '$VERSION'"
    echo "Expected semantic version (e.g., 1.6.0)"
    exit 1
fi

echo "Releasing version: $VERSION"

Step 2: Pre-flight Checks

# Check CHANGELOG.md entry exists
if ! grep -qE "^## \[$VERSION\]" CHANGELOG.md; then
    echo "Error: No CHANGELOG entry found for version $VERSION"
    echo "Add entry with header: ## [$VERSION] - $(date +%Y-%m-%d)"
    echo "Tip: Use '/changelog' to generate the entry."
    exit 1
fi
echo "CHANGELOG entry found"

# Check release doesn't already exist
if gh release view "v$VERSION" &>/dev/null; then
    echo "Error: Release v$VERSION already exists"
    echo "Delete first: gh release delete v$VERSION --yes"
    exit 1
fi
echo "Release does not exist, proceeding"