release-to-main

Merge dev into main, calculate semantic versions, and publish GitHub releases.

1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/aberrantCode/llm_skills --skill release-to-main
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-to-main
Source: https://github.com/aberrantCode/llm_skills/tree/main/claude/skills/release-to-main
Command: npx skills add https://github.com/aberrantCode/llm_skills --skill release-to-main

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually merging the dev branch into main, rebasing, calculating semantic version numbers, creating tags, and publishing GitHub releases is error‑prone and time‑consuming. This Skill automates the entire release workflow, ensuring proper version bumping and branch synchronization.

Core Features & Use Cases

  • Automated assessment of branch divergence and required rebasing.
  • Semantic version calculation from conventional commits with user confirmation.
  • Safe merge of dev into main with divergence guards and optional push handling.
  • Git tag creation and GitHub Release publishing with validated notes.
  • Post‑release sync that rebases dev onto the updated main branch. Ideal for teams that ship production releases from a dev branch and need a repeatable, guarded process.

Quick Start

Run the release-to-main skill to merge dev into main, create a version tag, and publish a GitHub release.

Frequently Asked Questions about release-to-main

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

FAQPage Schema
How do I automate merging a dev branch into main with semantic versioning?

Automating a dev-to-main release requires assessing branch divergence, rebasing dev onto main, calculating the semantic version bump from conventional commits, and publishing a GitHub release. This workflow prevents manual errors and ensures branch synchronization.

What is the best way to calculate semantic versions from conventional commits for a release?

Calculating semantic versions from conventional commits involves parsing commit messages to determine the version bump. This Skill automates semantic version calculation and prompts for user confirmation before tagging and releasing.

Do I need the GitHub CLI to publish Git tags and releases from the command line?

Yes, you need the GitHub CLI (gh) installed and authenticated to publish releases. This Skill uses the Git CLI for local branch operations and the GitHub CLI to create GitHub tags and releases remotely.

How does a dev-to-main rebase workflow handle branch divergence during a release?

A dev-to-main rebase workflow handles divergence by assessing the branches before merging. This Skill includes divergence guards to ensure a safe merge and performs a post-release sync to rebase dev onto the updated main branch.

Can I automate GitHub release publishing with validated release notes?

Yes, GitHub release publishing can be automated with validated notes. This Skill creates Git tags and publishes GitHub releases, ensuring release notes are properly validated during the automated dev-to-main merge process.

When should I not use an automated Git branch merge for production releases?

You should not use an automated Git branch merge if your repository lacks separate dev and main branches or does not follow conventional commit standards. This Skill requires a specific remote Git repository structure to function correctly.