version-release

Automate release pre-flight checks, document updates, and Git operations.

1|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/tarrragon/claude --skill version-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: version-release
Source: https://github.com/tarrragon/claude/tree/main/skills/version-release
Command: npx skills add https://github.com/tarrragon/claude --skill version-release

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

Version Release Skill automates end-to-end software release workflows, ensuring worklog completion, TD tracking, and version synchronization across files, branches, and tags.

Core Features & Use Cases

  • Pre-flight checks: verify worklog, technical debt status, and repository health before releasing.
  • Document updates: auto-update CHANGELOG.md and todolist.md and ensure pubspec.yaml version consistency.
  • Git operations: merge, tag, push, and cleanup with a safe, auditable workflow.
  • Use Case: release a new product version in a multi-team project with strict governance.

Quick Start

Use the version-release script to check readiness, preview a release with --dry-run, or perform a full release.

Frequently Asked Questions about version-release

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

FAQPage Schema
How do I automate end-to-end software release processes with strict governance?

Automating end-to-end software release processes involves running pre-flight checks, updating documents like CHANGELOG.md, and executing Git operations. This ensures worklog validation, TD tracking, and version synchronization across pubspec.yaml, branches, and tags.

Can I preview a version release before merging and tagging branches?

Yes, you can preview a version release using the --dry-run mode. This allows you to validate worklog completion, technical debt status, and repository health before performing actual Git merge, tag, and push operations.

What is the best way to synchronize pubspec.yaml versions during a Git release workflow?

The best way to synchronize pubspec.yaml versions during a Git release workflow is to use an automated script that performs document updates. It ensures version consistency across files while simultaneously handling branch merging and tag creation.

Do I need PyYAML to run Python scripts for release automation and technical debt tracking?

Yes, you need PyYAML because the release automation tool is implemented as a Python UV Single-File script. PyYAML is required to parse configuration files and validate technical debt tracking data during pre-flight checks.

How does pre-flight check validation work for technical debt and worklogs before a release?

Pre-flight check validation works by verifying worklog completion and technical debt status before allowing a release. It runs a check command to ensure repository health and strict release governance criteria are fully satisfied.

What are the limitations of using a single-file Python script for version release automation?

Using a single-file Python script for version release automation limits complex multi-file orchestration but provides a lightweight, auditable workflow. It focuses strictly on document updates, Git operations, and pre-flight checks without extensive CI/CD pipeline integrations.