File contents /pre-release - Pre-Release Checklist
Comprehensive checklist before tagging and releasing a new version.
Usage
/pre-release patch # Prepare patch release (1.0.0 → 1.0.1)
/pre-release minor # Prepare minor release (1.0.0 → 1.1.0)
/pre-release major # Prepare major release (1.0.0 → 2.0.0)
/pre-release 1.2.3 # Prepare specific version
What This Skill Does
Version Bump - Update version in config files
Run Tests - Ensure all tests pass
Update Changelog - Add release notes
Check Documentation - README, API docs current
Verify CI - All checks passing
Generate Checklist - Pre-release verification
Pre-Release Checklist
# Pre-Release Checklist: v1.2.0
## Version Updates
- [ ] pyproject.toml version updated
- [ ] __version__ in __init__.py updated (if applicable)
- [ ] CHANGELOG.md updated with release date
## Quality Checks
- [ ] All tests passing (`pytest`)
- [ ] No lint errors (`ruff check .`)
- [ ] Type checks pass (`mypy`)
- [ ] Coverage meets threshold
## Documentation
- [ ] README.md is current
- [ ] CHANGELOG.md has this version's changes
- [ ] API documentation updated (if applicable)
- [ ] Migration guide written (if breaking changes)
## CI/CD
- [ ] All CI checks passing on main
- [ ] No pending dependabot PRs for security issues
## Git
- [ ] All changes committed
- [ ] Working directory clean
- [ ] On main/master branch
- [ ] Pulled latest changes
## Final Steps
- [ ] Create release commit: `git commit -m "chore: release v1.2.0"`
- [ ] Create tag: `git tag -a v1.2.0 -m "v1.2.0"`
- [ ] Push: `git push && git push --tags`
## Post-Release
- [ ] Verify GitHub release created
- [ ] Verify package published (PyPI/crates.io)
- [ ] Announce release (if applicable)
Version Bump Locations
Python (pyproject.toml)
[project]
version = "1.2.0"
Python (init .py)
__version__ = "1.2.0"
Rust (Cargo.toml)
[package]
version = "1.2.0"
Node (package.json)
{
"version": "1.2.0"
}
Instructions for Claude
When /pre-release is invoked:
Determine current version - Read from config files
Calculate new version - Based on bump type
Update version files - All locations consistently
Run tests - Ensure passing
Run lints - Ensure clean
Update CHANGELOG - Use /changelog skill
Generate checklist - Customized for project
Offer to commit - Stage and commit changes
Provide tag command - Don't auto-tag, let user confirm
1 --- 2 name: pre-release 3 description: Pre-Release Checklist 4 --- 5 6 # /pre-release - Pre-Release Checklist 7 8 Comprehensive checklist before tagging and releasing a new version. 9 10 ## Usage 11 ``` 12 /pre-release patch # Prepare patch release (1.0.0 → 1.0.1) 13 /pre-release minor # Prepare minor release (1.0.0 → 1.1.0) 14 /pre-release major # Prepare major release (1.0.0 → 2.0.0) 15 /pre-release 1.2.3 # Prepare specific version 16 ``` 17 18 ## What This Skill Does 19 20 1. **Version Bump** - Update version in config files 21 2. **Run Tests** - Ensure all tests pass 22 3. **Update Changelog** - Add release notes 23 4. **Check Documentation** - README, API docs current 24 5. **Verify CI** - All checks passing 25 6. **Generate Checklist** - Pre-release verification 26 27 ## Pre-Release Checklist 28 29 ```markdown 30 # Pre-Release Checklist: v1.2.0 31 32 ## Version Updates 33 - [ ] pyproject.toml version updated 34 - [ ] __version__ in __init__.py updated (if applicable) 35 - [ ] CHANGELOG.md updated with release date 36 37 ## Quality Checks 38 - [ ] All tests passing (`pytest`) 39 - [ ] No lint errors (`ruff check .`) 40 - [ ] Type checks pass (`mypy`) 41 - [ ] Coverage meets threshold 42 43 ## Documentation 44 - [ ] README.md is current 45 - [ ] CHANGELOG.md has this version's changes 46 - [ ] API documentation updated (if applicable) 47 - [ ] Migration guide written (if breaking changes) 48 49 ## CI/CD 50 - [ ] All CI checks passing on main 51 - [ ] No pending dependabot PRs for security issues 52 53 ## Git 54 - [ ] All changes committed 55 - [ ] Working directory clean 56 - [ ] On main/master branch 57 - [ ] Pulled latest changes 58 59 ## Final Steps 60 - [ ] Create release commit: `git commit -m "chore: release v1.2.0"` 61 - [ ] Create tag: `git tag -a v1.2.0 -m "v1.2.0"` 62 - [ ] Push: `git push && git push --tags` 63 64 ## Post-Release 65 - [ ] Verify GitHub release created 66 - [ ] Verify package published (PyPI/crates.io) 67 - [ ] Announce release (if applicable) 68 ``` 69 70 ## Version Bump Locations 71 72 ### Python (pyproject.toml) 73 ```toml 74 [project] 75 version = "1.2.0" 76 ``` 77 78 ### Python (__init__.py) 79 ```python 80 __version__ = "1.2.0" 81 ``` 82 83 ### Rust (Cargo.toml) 84 ```toml 85 [package] 86 version = "1.2.0" 87 ``` 88 89 ### Node (package.json) 90 ```json 91 { 92 "version": "1.2.0" 93 } 94 ``` 95 96 ## Instructions for Claude 97 98 When /pre-release is invoked: 99 100 1. **Determine current version** - Read from config files 101 2. **Calculate new version** - Based on bump type 102 3. **Update version files** - All locations consistently 103 4. **Run tests** - Ensure passing 104 5. **Run lints** - Ensure clean 105 6. **Update CHANGELOG** - Use /changelog skill 106 7. **Generate checklist** - Customized for project 107 8. **Offer to commit** - Stage and commit changes 108 9. **Provide tag command** - Don't auto-tag, let user confirm
AreteDriver/ai-skills/tree/main/personas/devops/pre-release commit 5fec6cf27f
Frequently asked questions How do I install the Pre Release skill? Run npx skillmds@latest add aretedriver/pre-release in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Pre Release skill do? Pre-Release Checklist It is listed under Coding & Dev Tools on SkillMD.
Is Pre Release safe to use? This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Pre Release? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Pre Release free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Pre Release? AreteDriver (@aretedriver) published this skill. Their other Agent Skills are listed on their SkillMD profile.