release

Orchestrate semantic releases from develop to main with approval gates.

Updated May 13, 2026
One-click install
npx skills add https://github.com/usetheodev/theo-ui --skill release-usetheodev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/usetheodev/theo-ui/tree/main/.claude/skills/release
Command: npx skills add https://github.com/usetheodev/theo-ui --skill release-usetheodev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The Release skill automates the end-to-end release workflow from development to production by deriving semantic versions from CHANGELOG sections, rewriting release notes, and orchestrating PRs and annotated tags with a mandatory human approval gate.

Core Features & Use Cases

  • Auto-derives the next version from CHANGELOG's Unreleased sections using Keep-a-Changelog rules.
  • Rewrites the Unreleased section under the new version header and leaves a fresh Unreleased at the top.
  • Opens a PR from develop to main containing rendered release notes and waits for human approval before tagging.
  • On merge, creates an annotated tag and a GitHub release and records the release metadata.

Quick Start

Run the release workflow after /review returns READY_TO_MERGE to initiate the cycle and follow the prompts.

Frequently Asked Questions about release

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

FAQPage Schema
How do I automate semantic releases with a required human approval gate in Git?

To automate semantic releases with a human approval gate, this Skill orchestrates a full cycle from develop to main, opening a PR with rendered release notes and waiting for manual merge before creating an annotated tag and GitHub release.

How does deriving the next version from a CHANGELOG work for release automation?

Deriving the next version from a CHANGELOG works by reading the Unreleased section using Keep-a-Changelog rules, calculating the semantic version bump, and rewriting the Unreleased section under the new version header with a fresh Unreleased section at the top.

Can I use PR-based governance to manage semantic versioning across develop and main branches?

Yes, you can use PR-based governance for semantic versioning across develop and main branches, as this Skill opens a release PR containing rendered notes and only creates the annotated tag and GitHub release upon human approval and merge.

What is the best way to generate release notes and record metadata for a new Git tag?

The best way to generate release notes and record metadata is to automatically render the Unreleased CHANGELOG entries into the release PR, then create an annotated tag and GitHub release on merge to permanently record the release metadata.

Do I need a specific Git workflow structure to automate CHANGELOG-driven semantic releases?

Yes, you need a Git workflow relying on develop and main branches with a CHANGELOG file to automate semantic releases, as the Skill derives versions from Unreleased sections and promotes code via PRs across this specific branch structure.

When should I not use an automated semantic release cycle for my Git workflow?

You should not use an automated semantic release cycle if your Git workflow lacks a CHANGELOG file, does not follow develop-to-main branch promotion, or requires fully continuous deployment without a mandatory human approval gate.