release-prep
Use when preparing a production release or release candidate - provides a checklist-driven workflow for validation, versioning, build optimization, documentation updates, and deployment readiness.
When & Why to Use This Skill
This Claude skill streamlines the software release lifecycle by providing a comprehensive, checklist-driven workflow for production readiness. It ensures that versioning, documentation, security checks, and rollback strategies are meticulously handled to minimize deployment risks, prevent common shipping errors, and maintain high software quality standards.
Use Cases
- Production Release Validation: Systematically verifying quality, security, and performance metrics to ensure a stable release candidate.
- Automated Documentation & Versioning: Synchronizing changelogs, version increments, and technical documentation to maintain consistency across the codebase.
- Deployment Risk Management: Creating structured deployment plans and rollback strategies to ensure smooth production rollouts and rapid incident recovery.
| name | release-prep |
|---|---|
| description | Use when preparing a production release or release candidate - provides a checklist-driven workflow for validation, versioning, build optimization, documentation updates, and deployment readiness. |
Release Prep
Overview
Standardize release preparation with a safety-first checklist: validate quality and security, update versions and docs, build production artifacts, and prepare rollout/rollback plans.
When to Use
- Preparing a release candidate or production deploy
- Coordinating pre-release validation and documentation
- Ensuring versioning, changelog, and build steps are consistent
Avoid when:
- You only need a quick version bump or doc update
- The release process is owned by a separate automation pipeline
Quick Reference
| Task | Load reference |
|---|---|
| Release preparation | skills/release-prep/references/prepare-release.md |
Workflow
- Confirm release scope and version.
- Load the release preparation reference.
- Run pre-release validation (tests, security, performance).
- Update versions, changelog, and docs.
- Build production artifacts and validate.
- Produce deployment checklist and rollback plan.
Output
- Release readiness checklist
- Validation results and blockers
- Deployment plan with rollback steps
Common Mistakes
- Skipping security or performance checks
- Shipping without updating changelog or docs
- Building artifacts without validating environment parity