basher83/release-workflow
.claude/skills/release-workflow/SKILL.md
Release conventions and changelog configuration for lunar-claude, covering version bumping, changelog generation via git-cliff, and release tagging.
$ install --global
skillsauthnpx skillsauth add basher83/lunar-claude release-workflowInstall 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 16, 2026, 9:12 AM16.3s1 file scanned
SKILL.md
- name:
- release-workflow
- description:
- >
- when_to_use:
- >
Release Workflow
Project-specific release conventions for lunar-claude. For the interactive
release workflow, use the /generate-changelog command from the git-workflow
plugin.
Current Release State
- Latest tag: !
git describe --tags --abbrev=0 2>/dev/null || echo "No tags yet" - Marketplace version: !
jq -r '.metadata.version' .claude-plugin/marketplace.json - Unreleased commits: !
git log --oneline $(git describe --tags --abbrev=0 2>/dev/null)..HEAD 2>/dev/null | wc -l | tr -d ' '
Version Scheme
- Semantic versioning:
MAJOR.MINOR.PATCH - Tag format:
v0.x.y(prefixed withv) - Marketplace and plugin manifests track versions independently
Version Bump Decision
| Commit types present | Bump level |
|---------------------|------------|
| BREAKING CHANGE: in footer or ! after type | Major |
| feat: (new features) | Minor |
| fix:, docs:, refactor:, perf:, test:, chore: only | Patch |
Commit → Changelog Group Mapping
git-cliff (cliff.toml) maps conventional commits to changelog groups:
| Commit prefix | Changelog group |
|---------------|----------------|
| feat | 🚀 Features |
| fix | 🐛 Bug Fixes |
| refactor | 🚜 Refactor |
| doc | 📚 Documentation |
| perf | ⚡ Performance |
| style | 🎨 Styling |
| test | 🧪 Testing |
| chore, ci | ⚙️ Miscellaneous Tasks |
| body contains "security" | 🛡️ Security |
| revert | ◀️ Revert |
Auto-Skipped Commits
These are filtered out of the changelog automatically:
chore(release): prepare for— release prep commitschore(deps*)— dependency updates (Renovate/Dependabot)chore(pr)/chore(pull)— PR merge housekeeping
Files to Update on Release
- CHANGELOG.md — Generated by
git-cliff --tag vX.Y.Z -o CHANGELOG.md .claude-plugin/marketplace.json— Updatemetadata.version- Plugin manifests — Update
versionin each changed plugin'splugins/<cat>/<name>/.claude-plugin/plugin.json(only if that plugin changed)
Release Commit & Tag
$ git add CHANGELOG.md .claude-plugin/marketplace.json
$ git commit -m "docs: update changelog for vX.Y.Z"
$ git tag -a vX.Y.Z -m "Release vX.Y.Z"
$ git push && git push --tags
GitHub Actions (release.yml) automatically creates the GitHub release from
the tag, generating release notes via git-cliff.
Gotchas
- Push tags separately:
git pushdoes not push tags — always follow withgit push --tags - Marketplace version: Easy to forget updating
.claude-plugin/marketplace.jsonalongside CHANGELOG.md - Plugin versions are independent: Only bump a plugin's version if that plugin had changes — not every release bumps every plugin
- Pre-release tags: Tags containing
rc,beta, oralphaare marked as pre-release in GitHub automatically - Dependency commits vanish: Renovate/Dependabot commits are auto-skipped in the changelog — this is intentional, not a bug
Related Skills
basher83/claude-md-improver
testing
VerifiedTrustedCommunity
Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".
19SKILL.mdUpdated May 10, 2026
basher83/omni-talos
tools
VerifiedTrustedCommunity
Operational tooling for Talos Linux Kubernetes clusters via Sidero Omni with Proxmox infrastructure provider, covering machine classes, CEL storage selectors, and provider lifecycle management.
19SKILL.mdUpdated Apr 16, 2026
basher83/git-workflow
tools
VerifiedTrustedCommunity
Best practices for git workflow automation including atomic commits, branch naming, conventional commit format, and changelog generation.
19SKILL.mdUpdated Apr 16, 2026
basher83/git-status
tools
VerifiedTrustedCommunity
Summarize the current state of the git repository
19SKILL.mdUpdated Apr 16, 2026