developing-release

Automate release workflows with preflight checks, semantic version bumps, changelogs, and git tags.

Updated Dec 30, 2025
One-click install
npx skills add https://github.com/k2works/grokking-concurrency-exercise --skill developing-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: developing-release
Source: https://github.com/k2works/grokking-concurrency-exercise/tree/main/.claude/skills/developing-release
Command: npx skills add https://github.com/k2works/grokking-concurrency-exercise --skill developing-release

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps teams and maintainers execute reliable, repeatable releases by automating quality gates, semantic version bumps, changelog generation, and git commit/tag operations to reduce human error and ensure consistent release metadata.

Core Features & Use Cases

  • Preflight quality gates: runs working-tree checks, linters, unit tests, builds, and E2E tests before release.
  • Semantic versioning and bumping: supports patch, minor, and major bumps with monorepo synchronization options.
  • CHANGELOG generation: creates changelog entries from Conventional Commits and appends them to CHANGELOG.md.
  • Atomic commit and tagging: stages changes, creates a release commit and a vX.X.X tag, and optionally pushes to remote and deploys.
  • Use Case: perform a dry-run to preview CHANGELOG and computed version, then run a preflight and publish a patch release with automated commit and tag creation.

Quick Start

Run a dry run to preview the generated CHANGELOG and the computed semantic version without creating commits or tags.

Frequently Asked Questions about developing-release

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

FAQPage Schema
How do I automate semantic version bumps and changelog generation from git commits?

Automating semantic version bumps and changelog generation involves parsing Conventional Commits to compute patch, minor, or major version increments and appending formatted entries to CHANGELOG.md. This reduces human error and ensures consistent release metadata across repository deployments.

What is a dry-run release preview and when do I need it?

A dry-run release preview simulates the release workflow to display the computed semantic version and generated changelog without creating git commits or tags. You need it to validate release metadata and verify Conventional Commits parsing before executing an actual deployment.

How do I run preflight checks before creating a git release tag?

Running preflight checks before creating a git release tag requires executing working-tree validation, linters, unit tests, builds, and E2E tests as quality gates. This ensures repository stability and prevents broken deployments before staging changes and applying version bump commits.

Can I synchronize semantic version bumps across multiple packages in a monorepo?

You can synchronize semantic version bumps across multiple packages in a monorepo using coordinated versioning options. This applies the same patch, minor, or major version increment across all workspace packages while generating a unified changelog and atomic git tag.

Does this release workflow support automated git commits and remote deployment?

The release workflow supports automated git commits and remote deployment by staging version bump changes, creating a release commit, applying a vX.X.X tag, and optionally pushing to the remote repository with a deploy flag to trigger downstream publishing.

What are the limitations of using Conventional Commits for changelog generation?

Using Conventional Commits for changelog generation limits changelog accuracy to commit message formatting compliance. Non-standard commit messages will be parsed incorrectly or omitted, requiring strict repository commit hygiene to ensure valid semantic version bump computation and proper changelog entries.