skillsFirst-partyReview first Safety · Privacy ·
Git-Cliff Release Changelog Capability Pack Skill
Expert release-changelog capability pack for git-cliff with conventional commits, deterministic release notes, and low-maintenance versioning.
by JSONbored·added 2026-04-11·
Claude CodeCodexWindsurfGeminiCursorCLI
HarnessClaude CodeCodexWindsurfGeminiCursorCLI
Level:expertType:capability-packVerified:validated
Review first — review before installing
Open the source and read safety notes before installing.
Prerequisites
- Conventional commit policy
- Git tags access
- Release workflow ownership
Schema details
- Install type
- package
- Reading time
- 8 min
- Difficulty score
- 84
- Troubleshooting
- Yes
- Breaking changes
- No
Package metadata
- Package verified
- Yes
- SHA-256
- 88297534195c8e594486b5e5c230f5c99b1053118e534e7dbf598514e79a4741
Skill and platform metadata
- Skill type
- capability-pack
- Skill level
- expert
- Verification
- validated
- Verified at
- 2026-04-11
Retrieval sources
https://git-cliff.org/docs/https://www.conventionalcommits.org/en/v1.0.0/https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases
Tested platforms
ClaudeCodexOpenClawCursorWindsurfGemini
| Platform | Support | Install path |
|---|---|---|
| claude-code | Native | .claude/skills/<skill-name>/SKILL.md |
| codex | Native | .agents/skills/<skill-name>/SKILL.md |
| windsurf | Native | .windsurf/skills/<skill-name>/SKILL.md |
| gemini | Native | .gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md |
| cursor | Adapter | .cursor/rules/<skill-name>.mdc |
| cli | Manual | AGENTS.md or tool-specific context file |
Full copyable content
# Trigger
"Apply the git-cliff release changelog capability pack for this release."
# Required output
1) Conventional commit compliance report
2) Proposed release version and rationale
3) Generated changelog sections
4) Tag/release execution checklistAbout this resource
Knowledge Freshness
This capability pack is pinned to documentation verified on 2026-04-11.
Retrieval Sources
- https://git-cliff.org/docs/
- https://www.conventionalcommits.org/en/v1.0.0/
- https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases
Core Workflow
- Validate commit history quality against conventional commit policy.
- Determine next version from merged change scope.
- Generate changelog draft and remove low-signal noise.
- Stage release commit/tag plan with rollback path.
- Publish release and verify changelog consistency.
Overview
This skill gives agents a deterministic release process that produces readable changelogs without manual rewrite churn.
Capability Scope
- Commit history normalization
- Semver recommendation logic
- Changelog generation and section tuning
- Release tagging and publication checks
- Post-release verification and correction
Compatibility
Native
- Claude Code / Claude: native skill usage via
SKILL.md. - Codex/OpenAI workflows: compatible with Agent Skills-style
SKILL.mdcontent as reusable workflow instructions.
Manual Adaptation
- Gemini CLI: native skill usage via
.gemini/skills/<skill-name>/SKILL.mdor.agents/skills/<skill-name>/SKILL.mdwhere supported. - Cursor: use the generated
.cursor/rules/*.mdcadapter for project rules. - OpenClaw and similar agents: use the same skill content as a reusable prompt/workflow file when native skill import is unavailable.
Production Rules
- Enforce conventional commits before changelog generation.
- Keep release source-of-truth tied to tags on protected branches.
- Exclude bot-only and merge-noise commits from user-facing notes.
- Require human review before publishing release artifacts.
Troubleshooting
Issue: Changelog section grouping is noisy
Fix: tighten commit scopes and skip bots/merge-only commits.
Issue: Wrong version bump recommendation
Fix: map feat/fix/breaking conventions explicitly in config.
Issue: Release notes differ from changelog
Fix: derive both from same generated artifact path.
Output Contract
- Proposed version with justification.
- Clean changelog text ready for merge.
- Tag/release command sequence.
- Verification notes and fallback steps.
Content outline
#git-cliff#changelog#releases#conventional-commits#capability-pack
Source citations
Signals
Loading live community signals…
More like this, weekly
A short, calm digest of reviewed Claude resources. Unsubscribe any time.