release

Generates a release dossier with changelog, risks, migrations, rollback plan, and approvals for deployment gating.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/karenrebecag/spec-driven-standards --skill release-karenrebecag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/karenrebecag/spec-driven-standards/tree/main/plugins/delivery/skills/release
Command: npx skills add https://github.com/karenrebecag/spec-driven-standards --skill release-karenrebecag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deploying to production without a documented release plan leads to unreviewed migrations, missing rollback paths, and unclear ownership when something breaks. This Skill produces a structured release dossier (.release-approval.json) that a PreToolUse release-gate hook requires before allowing commands like vercel --prod or supabase db push. ## Core Features & Use Cases - Release dossier generation: Captures the exact HEAD SHA, changelog, risk assessment, blast radius, and CI status for the commit being exposed. - Migration and exposure control: Classifies data migrations as none, additive, or destructive, and records feature flags or canary strategies. - Rollback and accountability: Requires a concrete rollback plan, smoke test list, observability target, and an on-call owner before the gate will pass. - Use Case: Before running a production deploy, invoke the skill to walk through the eight-step checklist, get QA/security/release sign-off on the current SHA, and write the approval file the release-gate hook validates. ## Quick Start Ask the assistant to run the release skill to prepare the deployment dossier for the current commit before pushing to production.

Frequently Asked Questions about release

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

FAQPage Schema
How do I gate production deployments behind a release checklist?

Run the release skill before deploying: it walks through changelog, risks, migrations, feature flags, smoke tests, and rollback, then writes .release-approval.json. A PreToolUse release-gate hook blocks commands like vercel --prod unless a valid dossier exists for the current HEAD.

What should a release approval file contain before deploying?

It should record the deployed SHA, CI green status, QA/security/release approvals, a concrete rollback plan, migration state (none, additive, or destructive), the on-call owner, feature flag, and observability target. This skill writes exactly that schema to .release-approval.json.

Does this skill deploy the application itself?

No. The skill only prepares and enables the release by producing the dossier; it explicitly does not deploy. The actual deploy is run by the human owner, and the release-gate hook allows it only when the dossier is complete and current.

How are destructive database migrations handled before a release?

Destructive migrations must not ship together with the code that needs them. The skill requires them to be deployed first in a backward-compatible way, and the migration state is recorded in the dossier as none, additive, or destructive.

Why does the release-gate hook deny my deployment command?

The hook denies deployment when no valid .release-approval.json exists for the current HEAD, or when approvals, rollback plan, or CI status are missing. Re-run the release skill on the exact commit you intend to deploy and obtain the required sign-offs.