git-release-workflow

Automate git release operations by staging changes, creating a formatted commit, and tagging.

Updated Dec 29, 2025
One-click install
npx skills add https://github.com/jayteealao/Aperture --skill git-release-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-release-workflow
Source: https://github.com/jayteealao/Aperture/tree/main/.claude/skills/git-release-workflow
Command: npx skills add https://github.com/jayteealao/Aperture --skill git-release-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the end-to-end git release process, eliminating manual steps when preparing a new version by handling staging, committing with a standardized message, tagging, and presenting the push plan.

Core Features & Use Cases

  • Staged Release Commit: automatically stage changed files and create a properly formatted commit with Co-Authored-By attribution.
  • Annotated Tagging: generate an annotated tag using configurable patterns and messages.
  • Preview Push Plan: display the remote, branch, and what will be pushed without performing the push.
  • Pre/Post Hooks: optional pre-release and post-release scripts for validation, tests, or deployment tasks.
  • Use Case: release a library in a monorepo by standardizing version tags and changelog updates across multiple packages.

Quick Start

Run /release to initiate the release workflow with the required inputs, then review the suggested push command and execute it when ready.

Frequently Asked Questions about git-release-workflow

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

FAQPage Schema
How do I automate git releases with standardized commit messages and tagging?

Automate git releases by staging changed files, creating a formatted commit using a template, and generating an annotated tag. This workflow handles pre-release hooks, commit message formatting, and tag patterns before previewing the final push command for execution.

Can I use pre-release and post-release hooks in an automated git workflow?

Yes, the automated git workflow supports optional pre-release and post-release hooks. These scripts execute validation, tests, or deployment tasks before staging files or after generating the annotated tag and push plan.

How do I standardize version tags and release commits across multiple packages in a monorepo?

Standardize monorepo releases by applying configuration-driven workflows with consistent tag patterns and commit message templates. The process stages changes, applies annotated tags, and previews the push command across software projects.

Does the automated git release process push commits and tags directly to the remote?

No, the automated git release process does not push directly. It stages files, creates the commit, generates an annotated tag, and previews the push plan displaying the remote and branch for manual execution.

What is the best way to configure tag patterns and commit message templates for a release?

Configure tag patterns and commit message templates through a configuration-driven setup. Specify tag_pattern, tag_message, and commit_message_template to automate staging, formatted commits with Co-Authored-By attribution, and annotated tagging.

What do I need to set up before running an automated git release workflow?

You need a git repository with changed files to stage and a configuration defining your commit_message_template, tag_pattern, and optional pre_release_hook. The workflow then automates the commit, annotated tag creation, and push plan preview.