mikeyobrien/release-bump
.claude/skills/release-bump/SKILL.md
Use when bumping ralph-orchestrator version for a new release, after fixes are committed and ready to publish
$ install --global
skillsauthnpx skillsauth add mikeyobrien/ralph-orchestrator release-bumpInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 10, 2026, 2:18 AM4.8s1 file scanned
SKILL.md
- name:
- release-bump
- description:
- Use when bumping ralph-orchestrator version for a new release, after fixes are committed and ready to publish
- internal:
- true
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 |
Related Skills
mikeyobrien/ralph-docs
development
VerifiedTrustedCommunity
Introspect, explain, and improve Ralph Orchestrator using its published llms.txt doc map. Use this skill whenever the user asks questions about Ralph's behavior, wants to understand how a Ralph internal works (event loop, hats, memories, tasks, backends, presets), debug an unfamiliar failure mode, or propose a code change to the ralph-orchestrator repo. The skill teaches the agent to discover authoritative answers from the live docs via llms.txt before guessing, and to scope improvements through the published architecture rather than the local checkout alone.
2,840SKILL.mdUpdated May 9, 2026
mikeyobrien/ralph-loop
development
VerifiedTrustedCommunity
Run, monitor, resume, merge, and debug Ralph loops. Use this skill whenever the user asks to operate `ralph run` or `ralph loops`, inspect loop state, recover suspended loops, analyze diagnostics, or unblock merge queue issues.
2,489SKILL.mdUpdated Apr 10, 2026
mikeyobrien/ralph-hats
development
VerifiedTrustedCommunity
Create, inspect, validate, explain, and improve Ralph hat collections. Use this skill whenever the user asks to make or refine a `.ralph/hats/*.yml` workflow, debug hat routing, explain event topology, or tune a multi-hat Ralph run.
2,489SKILL.mdUpdated Apr 10, 2026
mikeyobrien/complex-test-skill
testing
VerifiedTrustedCommunity
A directory-style test skill for smoke testing
2,489SKILL.mdUpdated Apr 10, 2026