release-skills · freestylefly — Claude Code skill: what it does, how to install
Automates release versioning and multi-language changelog updates based on Git history. Works with Node.js, Python, Rust, and generic codebases.
npx skills add freestylefly/canghe-skills --skill release-skills -a claude-codeWhat release-skills does
The skill inspects Git history since the previous tag to determine the next semantic version bump from Conventional Commits. It supports overrides via a .releaserc.yml configuration file. If it encounters breaking changes, it alerts you to cut a major release.
It scans for version manifests such as package.json, pyproject.toml, Cargo.toml, or VERSION. The tool also discovers localized changelogs matching patterns like CHANGELOG*.md and updates headings per language code. Contributor attribution relies on the gh command-line tool, so missing GitHub CLI authentication will prevent tagging external pull request authors.
You can preview all modifications before execution using --dry-run. Explicit flags --major, --minor, and --patch override automatic semver calculations.
What it helps with
- calculate semantic version bumps from conventional commits
- update localized changelogs across multiple languages
- attribute external PR contributors using the GitHub CLI
- preview release changes safely via dry-run mode
Example prompts for the agent
- /release-skills --dry-run
- /release-skills --patch
- Prepare a new release for this repository
How to install release-skills
1Skills CLI (Vercel)
npx skills add freestylefly/canghe-skills --skill release-skills -a claude-code2Manually: put the files in place
~/.claude/skills/release-skills/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/release-skills/
1Skills CLI (Vercel)
npx skills add freestylefly/canghe-skills --skill release-skills -a codex2Manually: put the files in place
.agents/skills/release-skills/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add freestylefly/canghe-skills --skill release-skills -a cursor2Manually: put the files in place
.cursor/skills/release-skills/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install freestylefly/canghe-skills release-skills2Manually: put the files in place
.github/skills/release-skills/SKILL.md1Skills CLI (Vercel)
npx skills add freestylefly/canghe-skills --skill release-skills -a gemini-cli2Platform CLI
gemini skills install https://github.com/freestylefly/canghe-skills --path .claude/skills/release-skillsManually: put the files in place
.devin/skills/release-skills/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add freestylefly/canghe-skills --skill release-skills -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about release-skills
How to install release-skills in Claude Code?
Run npx skills add freestylefly/canghe-skills --skill release-skills -a claude-code.
What does release-skills do?
It analyzes Git commits since the last tag, calculates the new version bump, updates project manifest files, and prepends formatted release notes to changelogs.
Which version files does the skill detect?
It automatically scans for package.json, pyproject.toml, Cargo.toml, marketplace.json for Claude plugins, as well as plain VERSION or version.txt files.
Similar skills
All skills for Git and GitHub →release-skills by other authors comes first.
