dev-release
Generic tool for bumping versions, generating changelogs, and tagging releases.
Install
mkdir -p .claude/skills/dev-release && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11970" && unzip -o skill.zip -d .claude/skills/dev-release && rm skill.zipInstalls to .claude/skills/dev-release
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Release preparation — changelog generation, version bump, tag creation. Generic version (not project-specific). For EvoNexus releases, use custom-release instead.Key capabilities
- →Generate changelogs from git logs
- →Bump version based on semver rules
- →Create git tags for releases
- →Verify clean working tree before release
- →Confirm bump type with the user
How it works
The skill performs release preparation by reading the current version, determining the bump type, generating a changelog from git commits, updating the manifest, and creating a git tag.
Inputs & outputs
When to use dev-release
- →Bumping package versions
- →Generating changelogs
- →Tagging releases
About this skill
Dev Release
Derived from oh-my-claudecode (MIT, Yeachan Heo). Adapted for the EvoNexus Engineering Layer.
Generic release preparation: changelog generation from git log, version bump, tag creation. For EvoNexus-specific releases, use custom-release (the existing skill that handles git-flow develop→main).
Use When
- Releasing a non-EvoNexus project (Evolution API, Evo AI, Evo Go, etc.)
- Generic semver bump on a library you're maintaining
Do Not Use When
- Releasing EvoNexus itself → use
custom-releaseinstead - Project has its own custom release process → follow that
Workflow
Phase 1 — Pre-flight
- Verify on the right branch (not
main/masterdirectly) - Verify clean working tree (no uncommitted changes)
- Verify CI is green on the target commit
- Verify tests pass locally (
dev-verify)
Phase 2 — Determine version
- Read current version from manifest (
package.json,Cargo.toml,go.mod,pyproject.toml) - Determine bump type: major / minor / patch (semver)
- Confirm with user
Phase 3 — Generate changelog
- Read commits since last tag:
git log {last-tag}..HEAD --oneline - Group by type (feat / fix / docs / etc.) if conventional commits
- Save to
CHANGELOG.mdwith new version section
Phase 4 — Bump version
- Update manifest file
- Update any version references in docs
Phase 5 — Commit and tag
git commit -m "chore(release): vX.Y.Z"git tag vX.Y.Zgit push origin vX.Y.Z(after user confirmation)
Phase 6 — Verify
@oath-verifierconfirms the release commit and tag are correct
Output
Save release notes to workspace/development/research/[C]release-{version}-{date}.md.
Pairs With
@flow-git(commits and tags)@oath-verifier(verification)@quill-writer(changelog formatting)dev-verify(pre-flight)
EvoNexus-Specific Note
EvoNexus has its own release skill (custom-release) that handles the git-flow develop→main workflow with EvoNexus-specific gates (CHANGELOG entry, version sync across files, GitHub release creation). Use custom-release for EvoNexus releases. Use dev-release only for projects in workspace/projects/ that have their own release lifecycle.
When not to use it
- →When releasing EvoNexus itself
- →When the project has its own custom release process
Limitations
- →Not for EvoNexus-specific releases
- →Assumes conventional commits for grouping changelog entries
- →Requires user confirmation for version bump and push
How it compares
This skill provides a generic, automated workflow for changelog generation, version bumping, and tag creation, unlike manual release steps.
Compared to similar skills
dev-release side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| dev-release (this skill) | 0 | 4mo | No flags | Intermediate |
| macos-spm-app-packaging | 1 | 5mo | Review | Intermediate |
| agent-release-manager | 0 | 6mo | Review | Intermediate |
| proof-of-work | 1 | 6mo | No flags | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by evolution-foundation
View all by evolution-foundation →You might also like
macos-spm-app-packaging
Dimillian
Scaffold, build, and package SwiftPM-based macOS apps without an Xcode project. Use when you need a from-scratch macOS app layout, SwiftPM targets/resources, a custom .app bundle assembly script, or signing/notarization/appcast steps outside Xcode.
agent-release-manager
ruvnet
Agent skill for release-manager - invoke with $agent-release-manager
proof-of-work
MadAppGang
Proof artifact generation patterns for task validation. Covers screenshots, test results, deployments, and confidence scoring.
release
mantaskazlauskas
Release workflow for ChattyLittleNpc addon. Bumps the .toc version, commits and pushes to GitHub, then runs release.py to create a GitHub release. Activates for: release, bump version, publish, ship, tag, new version, deploy addon, push release.
wa:deploy-release
jeremy-newhouse
Create release: git tag, changelog generation, and release notes.
start
diegosouzapw
Execute a task autonomously with real-time Telegram progress updates, automatic deployment, commit, and push. No user interaction required - makes all decisions independently.