Agent skill
git-release
Create consistent releases with changelogs and version bumping
Install this agent skill to your Project
npx add-skill https://github.com/48Nauts-Operator/opencode-baseline/tree/main/.opencode/skill/git-release
Metadata
Additional technical details for this skill
- audience
- maintainers
- workflow
- github
SKILL.md
What I Do
- Analyze commits since last tag to generate release notes
- Determine appropriate version bump (major/minor/patch) based on conventional commits
- Generate a changelog entry
- Provide copy-pasteable commands for creating the release
When to Use Me
Use this skill when:
- Preparing a new release
- Creating a changelog
- Deciding on version numbers
Release Process
1. Analyze Changes
# Get commits since last tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline
# Check existing tags
git tag --sort=-v:refname | head -5
2. Version Bump Rules
| Commit Type | Version Bump | Example |
|---|---|---|
feat!: or BREAKING CHANGE: |
Major (1.0.0 → 2.0.0) | Breaking API change |
feat: |
Minor (1.0.0 → 1.1.0) | New feature |
fix: |
Patch (1.0.0 → 1.0.1) | Bug fix |
docs:, chore:, refactor: |
Patch | Maintenance |
3. Changelog Format
## [X.Y.Z] - YYYY-MM-DD
### Added
- New features
### Changed
- Changes in existing functionality
### Fixed
- Bug fixes
### Removed
- Removed features
4. Create Release
# Tag the release
git tag -a vX.Y.Z -m "Release vX.Y.Z"
git push origin vX.Y.Z
# Or use GitHub CLI
gh release create vX.Y.Z --generate-notes --title "vX.Y.Z"
Ask Clarifying Questions If
- Versioning scheme is unclear (semver vs calver vs other)
- Pre-release versions are needed (alpha, beta, rc)
- Multiple release branches exist
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
file-organizer
Organize files and folders intelligently with duplicate detection
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.
auth-implementation-patterns
Master authentication and authorization patterns including JWT, OAuth2, session management, and RBAC to build secure, scalable access control systems. Use when implementing auth systems, securing APIs, or debugging security issues.
sql-optimization-patterns
Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database schemas, or optimizing application performance.
monorepo-management
Master monorepo management with Turborepo, Nx, and pnpm workspaces to build efficient, scalable multi-package repositories with optimized builds and dependency management. Use when setting up monorepos, optimizing builds, or managing shared dependencies.
git-advanced-workflows
Master advanced Git workflows including rebasing, cherry-picking, bisect, worktrees, and reflog to maintain clean history and recover from any situation. Use when managing complex Git histories, collaborating on feature branches, or troubleshooting repository issues.
Didn't find tool you were looking for?