Changelog
Update per-package CHANGELOG.md files for a Ratel release.
Install
npx skills add ratel-ai/ratel --skill changelog -g -a claude-code -y- Repository
- ratel-ai/ratel547
- Category
- Git and review
- Updated
- 4d ago
- License
- MIT
- Context cost
- Mediumabout 1,508 tokens
- Runs scripts
- Yes, review before use
What it does
Update per-package CHANGELOG.md files for a Ratel release. Drafts entries with git-cliff (scoped per package), lets you curate, then writes the CHANGELOGs. Handles both RC entries and GA-graduation collapse (merging X.Y.Z-rc.* sections into a single X.Y.Z section). Invoke before tagging a release.
/changelog
Updates a release unit's CHANGELOG.md in preparation for tagging it. Ratel releases
per unit (ADR-0008): each unit ships on its own tag (<prefix>-v*) at its own version.
For workflow-wired units, .github/workflows/release.yml rejects a tag whose unit CHANGELOG
doesn't contain the version being released. vercel-ai-sdk is temporarily published
manually via scripts/publish-rc.sh; still run this skill before its tag even though the
workflow gate does not cover it yet.
Run it once per unit you're releasing.
Release units it touches
The units and their manifests/CHANGELOGs live in one registry, scripts/release-units.mjs, which every release tool reads. Run node scripts/release-units.mjs --list
for the authoritative set; the current ten units are:
| Unit | Registry | CHANGELOG path |
|---|---|---|
core | ratel-ai-core (crates.io) | src/core/CHANGELOG.md |
sdk-ts | @ratel-ai/sdk (npm) | src/sdk/ts/CHANGELOG.md |
sdk-py | ratel-ai (PyPI) | src/sdk/python/CHANGELOG.md |
telemetry-core | ratel-ai-telemetry (crates.io) | src/telemetry/core/CHANGELOG.md |
telemetry-ts | @ratel-ai/telemetry (npm) | src/telemetry/ts/CHANGELOG.md |
telemetry-py | ratel-ai-telemetry (PyPI) | src/telemetry/python/CHANGELOG.md |
vercel-ai-sdk | @ratel-ai/vercel-ai-sdk (npm) | src/adapters/ts-vercel-ai-sdk/CHANGELOG.md |
mastra | @ratel-ai/mastra (npm) | src/adapters/ts-mastra/CHANGELOG.md |
rankers-ts | @ratel-ai/rankers-plugin (npm) | src/rankers/ts/CHANGELOG.md |
rankers-py | ratel-ai-rankers-plugin (PyPI) | src/rankers/python/CHANGELOG.md |
@ratel-ai/mcp-server lives in ratel-ai/ratel-mcp and maintains its own CHANGELOG there.
