Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Changelog (Ratel release)

A release-time skill that updates a Ratel monorepo unit's CHANGELOG.md by drafting entries with git-cliff, letting you curate them, then writing the file.

Dev & CodingAdvanced★ 420⑂ 20AI score 7/10Last updated: Aug 11, 2026

What it does

  • Updates the CHANGELOG.md of one release unit (core, sdk-ts, sdk-py, telemetry-*, vercel-ai-sdk, mastra) before you tag a release.
  • Reads the unit's canonical version and tag prefix from scripts/release-units.mjs, then computes the diff range from that unit's own last tag to HEAD.
  • Generates a Keep-a-Changelog draft via .claude/skills/changelog/draft.sh (a git-cliff wrapper), has you curate the bullets, and edits only that unit's file — it never commits.
  • Branches on RC vs GA: RC prepends a new section; GA collapses all matching X.Y.Z-rc.* sections into a single X.Y.Z section with deduplicated bullets.

Who it's for

  • Maintainers who actually cut releases in the ratel-ai/ratel repository.
  • Teams running a monorepo with per-package tags/versions and a CI gate that verifies the CHANGELOG contains the tag version — useful as a design reference.

Examples

  1. "Prep sdk-ts 0.2.0-rc.3" → drafts entries and prepends ## [0.2.0-rc.3] - YYYY-MM-DD to src/sdk/ts/CHANGELOG.md.
  2. "Graduate core to GA 0.3.0" → merges the existing rc.1–rc.4 sections into one ## [0.3.0] section.
  3. "Which units are releasable?" → runs node scripts/releasable.mjs, picks a unit, and repeats the procedure per unit.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/ratel-ai/ratel/HEAD/.claude/skills/changelog/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the .claude/skills/changelog folder from the GitHub repo ratel-ai/ratel into my ~/.claude/skills/changelog/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/ratel-ai/ratel.git /tmp/ratel && mkdir -p ~/.claude/skills && cp -r /tmp/ratel/.claude/skills/changelog ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal and clone the repo: git clone https://github.com/ratel-ai/ratel.git
  2. Create the skills directory: mkdir -p ~/.claude/skills
  3. Copy the skill: cp -r ratel/.claude/skills/changelog ~/.claude/skills/
    • Note: it depends on the Ratel repo's scripts/ and bundled draft.sh, so in practice you should run Claude Code inside the Ratel repo.
  4. Install git-cliff: cargo install git-cliff (or brew install git-cliff); without it draft.sh exits with code 127.
  5. Start Claude Code at the repo root and ask: "use the changelog skill to prep the <unit> release".
  6. Review and edit the proposed entries, then approve. Only the CHANGELOG is modified — the release commit and tag remain your job.
View source on GitHub ↗License: MIT