ReddRadar
Agent skill
release-bump
Use when bumping ralph-orchestrator version for a new release, after fixes are committed and ready to publish
Install this agent skill to your Project
npx add-skill https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/release-bump
Metadata
Additional technical details for this skill
- internal
- YES
SKILL.md
Release Bump
Overview
Bump version and trigger release for ralph-orchestrator. All versions live in workspace Cargo.toml - individual crates inherit via version.workspace = true.
Confirm the new version with the user. Once the bump commit is pushed, track progress of the release.
Quick Reference
| Step | Command/Action |
|---|---|
| 1. Bump version | Edit Cargo.toml: replace all version = "X.Y.Z" (7 occurrences) |
| 2. Build | cargo build (updates Cargo.lock) |
| 3. Test | cargo test |
| 4. Commit | git add Cargo.toml Cargo.lock && git commit -m "chore: bump to vX.Y.Z" |
| 5. Push | git push origin main |
| 6. Tag | git tag vX.Y.Z && git push origin vX.Y.Z |
Version Locations (All in Cargo.toml)
# Line ~17 - workspace version
[workspace.package]
version = "X.Y.Z"
# Lines ~113-118 - internal crate dependencies
ralph-proto = { version = "X.Y.Z", path = "crates/ralph-proto" }
ralph-core = { version = "X.Y.Z", path = "crates/ralph-core" }
ralph-adapters = { version = "X.Y.Z", path = "crates/ralph-adapters" }
ralph-tui = { version = "X.Y.Z", path = "crates/ralph-tui" }
ralph-cli = { version = "X.Y.Z", path = "crates/ralph-cli" }
ralph-bench = { version = "X.Y.Z", path = "crates/ralph-bench" }
Tip: Use Edit tool with replace_all: true on version = "OLD" → version = "NEW" to update all 7 at once.
What CI Does Automatically
Once you push the tag, .github/workflows/release.yml triggers and:
- Creates the GitHub Release with auto-generated notes
- Builds binaries for macOS (arm64, x64) and Linux (arm64, x64)
- Uploads artifacts to the GitHub Release
- Publishes to crates.io (in dependency order)
- Publishes to npm as
@ralph-orchestrator/ralph
Common Mistakes
| Mistake | Fix |
|---|---|
| Only updating workspace.package.version | Must update all 7 occurrences including internal deps |
| Forgetting to run tests | Always cargo test before commit |
Creating release manually with gh release create |
Just push the tag - CI creates the release with artifacts |
| Pushing tag before main | Push main first, then push the tag |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mikeyobrien/ralph-orchestrator
complex-test-skill
A directory-style test skill for smoke testing
mikeyobrien/ralph-orchestrator
tui-debug-in-pane
Use when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.
mikeyobrien/ralph-orchestrator
test-driven-development
Unified TDD skill with three input modes — from spec, from task, or from description. Enforces test-first development using repository patterns, with proptest guidance and backpressure integration.
mikeyobrien/ralph-orchestrator
tmux-terminal
Interactive terminal control via tmux for TUI apps, prompts, and long-running CLI workflows.
mikeyobrien/ralph-orchestrator
pr-demo
Use when creating animated demos (GIFs) for pull requests or documentation. Covers terminal recording with asciinema and conversion to GIF/SVG for GitHub embedding.
mikeyobrien/ralph-orchestrator
pdd
Transforms a rough idea into a detailed design document with implementation plan. Follows Prompt-Driven Development — iterative requirements clarification, research, design, and planning.
Didn't find tool you were looking for?