cutting-a-release

Guides release candidate and final release workflows using just targets and GitHub CLI.

1|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/moolah-rocks/moolah-native --skill cutting-a-release-moolah-rocks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cutting-a-release
Source: https://github.com/moolah-rocks/moolah-native/tree/main/.claude/skills/cutting-a-release
Command: npx skills add https://github.com/moolah-rocks/moolah-native --skill cutting-a-release-moolah-rocks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cutting a release involves many error-prone manual steps: drafting user-facing release notes, running preflight checks, handling CloudKit schema deploy gates, and landing bot-authored baseline-schema PRs whose CI never triggers automatically. This Skill walks you through the documented release runbook step by step while handling the parts that benefit most from analysis and judgment. ## Core Features & Use Cases - Release notes drafting: Gathers merged PRs and commits since the notes base, separates user-facing changes from internal ones, and drafts notes following the brand voice guide. - Runbook-guided execution: Runs each release step via its named just target (preflight, create RC, wait, status, create final) and surfaces failures with recovery paths from the runbook. - Schema deploy gate handling: Detects when the workflow pauses on await-prod-deploy, directs you to approve the CloudKit Console deploy, and manages the follow-up baseline-schema PR. - Baseline-schema PR landing: Verifies the bot PR changes only schema-prod-baseline.ckdb, triggers CI by pushing the exact head commit to an mq-spec-* branch, enables auto-merge, and cleans up branches. - Use Case: You ask to ship version 1.4.0. The Skill drafts release notes from merged PRs, runs the RC pipeline, waits out the schema deploy gate, lands the baseline PR, and hands off TestFlight and Mac zip install instructions. ## Quick Start Ask the assistant to cut a release candidate for the next version and draft the release notes for your approval.

Frequently Asked Questions about cutting-a-release

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

FAQPage Schema
How do I cut a release candidate with this release workflow?▼

Run the documented runbook step by step, executing each named just target such as release-preflight and release-create-rc. Draft release notes first from merged PRs since the notes base, get user approval, then create the RC tag.

How do I write release notes from merged GitHub PRs?▼

Run just release-next-version to get the notes base, list merged PRs with gh pr list filtered by merge date, and read substantive PR bodies. Draft notes following the brand guide's voice rules, separating user-facing changes from internal ones.

Why does CI not run on the baseline-schema bot PR?▼

The bot pushes with GITHUB_TOKEN, and GitHub suppresses workflow triggers from token-authored pushes, so required checks never start. Push the PR's exact head commit to an mq-spec-* branch under your own credentials to trigger CI on the shared SHA.

What happens when the release workflow pauses on await-prod-deploy?▼

The pause means a CloudKit schema change must be deployed manually. Open the CloudKit Console, click Deploy to Production, then approve the GitHub workflow run. The gate cannot be bypassed programmatically.

What should I verify before merging the schema baseline PR?▼

Confirm the PR changes exactly one file, CloudKit/schema-prod-baseline.ckdb, and that its additions match the schema.ckdb shipped at the release tag. If it adds anything beyond the deployed schema, stop and do not merge.