Agent skill

Update Changelog

Read this skill before updating changelogs. An agent skill from mitsuhiko/agent-stuff.

Apache-2.0Auto-check passedDevelopment

Install Update Changelog

skills CLI

$ npx skills add mitsuhiko/agent-stuff --skill update-changelog -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install mitsuhiko/agent-stuff update-changelog --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/mitsuhiko/agent-stuff.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/update-changelog .claude/skills/update-changelog && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "update-changelog" agent skill from https://github.com/mitsuhiko/agent-stuff/tree/main/skills/update-changelog into .claude/skills/update-changelog/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-changelog", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/mitsuhiko/agent-stuff/tree/main/skills/update-changelog

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add mitsuhiko/agent-stuff --skill update-changelog -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install mitsuhiko/agent-stuff update-changelog --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mitsuhiko/agent-stuff.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/update-changelog .agents/skills/update-changelog && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "update-changelog" agent skill from https://github.com/mitsuhiko/agent-stuff/tree/main/skills/update-changelog into .agents/skills/update-changelog/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-changelog", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mitsuhiko/agent-stuff --skill update-changelog -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install mitsuhiko/agent-stuff update-changelog --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mitsuhiko/agent-stuff.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/update-changelog .cursor/skills/update-changelog && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "update-changelog" agent skill from https://github.com/mitsuhiko/agent-stuff/tree/main/skills/update-changelog into .cursor/skills/update-changelog/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-changelog", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/mitsuhiko/agent-stuff.git --path skills/update-changelog

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add mitsuhiko/agent-stuff --skill update-changelog -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install mitsuhiko/agent-stuff update-changelog --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mitsuhiko/agent-stuff.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/update-changelog .gemini/skills/update-changelog && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "update-changelog" agent skill from https://github.com/mitsuhiko/agent-stuff/tree/main/skills/update-changelog into .gemini/skills/update-changelog/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-changelog", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install mitsuhiko/agent-stuff update-changelog

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add mitsuhiko/agent-stuff --skill update-changelog -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/mitsuhiko/agent-stuff.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/update-changelog .github/skills/update-changelog && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "update-changelog" agent skill from https://github.com/mitsuhiko/agent-stuff/tree/main/skills/update-changelog into .github/skills/update-changelog/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-changelog", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add mitsuhiko/agent-stuff --skill update-changelog -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install mitsuhiko/agent-stuff update-changelog --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/mitsuhiko/agent-stuff.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/update-changelog .opencode/skills/update-changelog && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "update-changelog" agent skill from https://github.com/mitsuhiko/agent-stuff/tree/main/skills/update-changelog into .opencode/skills/update-changelog/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "update-changelog", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: update-changelog
GitHub stars: 3.2k
Token cost: ~815 tokens
SKILL.md length: 352 words
Files: 1
Skills in repo: 16
Repo updated: Sep 27, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Read this skill before updating changelogs. An agent skill from mitsuhiko/agent-stuff.

Works in 3 steps: Determine baseline version → Find the commits from git → Update the changelog
Tasks that involve Changelog and release notes
SKILL.md covers Step-by-Step Process, Ground Rules When Writing… and Notes
Calls git

What it does

Update Changelog is an agent skill from mitsuhiko/agent-stuff. Read this skill before updating changelogs

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Changelog and release notes. It works with Git. The repository describes itself as: These are commands I use with agents, mostly Claude. The licence is Apache-2.0.

When your agent uses it

Tasks that involve Changelog and release notes

Example prompts

“/update-changelog”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Determine baseline version
Find the commits from git
Update the changelog

What it can do on your machine

Read from SKILL.md and the folder at commit 0865c84. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Update Changelog loads about 815 tokens when it runs. Until then it costs about 15 tokens; SKILL.md has 352 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~15
When it runs · the whole SKILL.md, loaded when a task matches: ~815

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from mitsuhiko/agent-stuff at commit 0865c84, republished under its Apache-2.0 licence (© mitsuhiko). 352 words, ~815 tokens.

Download SKILL.mdSave it as .claude/skills/update-changelog/SKILL.md (or your agent's skills folder).

name: update-changelog
description: Read this skill before updating changelogs

Update the repository changelog with changes between the last release and the current version (main) that are not yet incorporated. If CHANGELOG.md does not exist, use CHANGELOG instead.

Step-by-Step Process

1. Determine baseline version

If no baseline version is provided, use the most recent git tag. You can find it with git describe --tags --abbrev=0.

2. Find the commits from git

Use the following commands to gather commit information:

bash

# Get the baseline version (if not provided)
git describe --tags --abbrev=0

# Get all commits since the baseline version
git log <baseline-version>..HEAD

3. Update the changelog

Read the existing changelog file (CHANGELOG.md, or CHANGELOG if missing) and check if there are changes not yet incorporated, then add them. Always add them to the "Unreleased" section only. If there is none yet, add it at the top in the same style as the existing changelog (for example, ## Unreleased vs ## [Unreleased]).

Ground Rules When Writing Changelogs

Content Guidelines

Focus on notable changes that affect users (features, fixes, breaking changes)
Mention pull requests (#NUMBER) when available, but not raw commit hashes
Ignore insignificant changes (typo fixes, internal refactoring, minor documentation updates)
Group related changes together when appropriate
Order entries by importance: breaking changes first, then features, then fixes

Style Guidelines

Use valid markdown syntax
Start each entry with a past-tense verb or descriptive phrase
Keep entries concise but descriptive enough to understand the change
Use bullet points (* or -) for individual changes
Format code references with backticks (e.g., `foo.cleanup`)

Show full SKILL.md (130 more words)Show less

Example Format

markdown

## 2.13.0

* Added multi-key support to the `|sort` filter.  #827
* Fix `not undefined` with strict undefined behavior.  #838
* Added support for free threading Python.  #841

## 2.12.0

* Item or attribute lookup will no longer swallow all errors in Python.  #814
* Added `|zip` filter.  #818
* Fix `break_on_hyphens` for the `|wordwrap` filter.  #823
* Prefer error message from `unknown_method_callback`.  #824
* Ignore `.jinja` and `.jinja2` as extensions in auto escape.  #832

Good vs. Bad Examples

Good:

Fixed an issue with the TypeScript SDK which caused an incorrect config for CJS.
Added support for claim timeout extension on checkpoint writes.
Improved error reporting when task claim expires.

Bad:

Fixed bug (too vague)
Updated dependencies (insignificant unless it fixes a security issue)
Refactored internal code structure (internal change, not user-facing)
Fixed typo in comment (insignificant)

Notes

If the current changelog already has an "Unreleased" section with content, append to it rather than replacing it
Preserve the existing changelog style and formatting (headings, bullet style, ordering, and spacing)
If the repo uses a different default branch name, treat that as the "current version" instead of main
When in doubt about whether a change is significant, err on the side of including it

Files

Just SKILL.md in skills/update-changelog of mitsuhiko/agent-stuff.

Open the folder on GitHubat commit 0865c84

Compare with similar skills

Update Changelog next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Update Changelog compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Update Changelog this skillmitsuhiko/agent-stuff	3.2k	—	~815	Automated safety check: Pass	Apache-2.0	13 days ago
React Router Release Notes Prepremix-run/react-router	57k	—	~1.1k	Automated safety check: Pass	MIT	yesterday
Draft Release Notesjamiepine/voicebox	57k	—	~941	Automated safety check: Pass	MIT	3 days ago
Mole Release Notes Publishertw93/Mole	70k	—	~1.9k	Automated safety check: Pass	GPL-3.0	today
Release Bumpjamiepine/voicebox	57k	—	~1.1k	Automated safety check: Pass	MIT	3 days ago
Git Workflow and Versioningaddyosmani/agent-skills	104k	2 repos	~3.5k	Automated safety check: Notes	MIT	7 days ago

Similar skills

React Router Release Notes Prep
remix-run/react-router
Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.
57k GitHub stars~1.1k tokensUpdated yesterday
DevelopmentAuto-check passed
Draft Release Notes
jamiepine/voicebox
Writes or refreshes the Unreleased section of CHANGELOG.md as a themed narrative built from the commits, PRs and diff since the last version tag.
57k GitHub stars~941 tokensUpdated 3 days ago
DevelopmentAuto-check passed
Mole Release Notes Publisher
tw93/Mole
Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.
70k GitHub stars~1.9k tokensUpdated today
DevelopmentAuto-check passed
Release Bump
jamiepine/voicebox
Ends a release cycle by moving the Unreleased changelog notes under a dated version heading, bumping version files with bumpversion and tagging the commit.
57k GitHub stars~1.1k tokensUpdated 3 days ago
DevelopmentAuto-check passed
Git Workflow and Versioning
addyosmani/agent-skills
Sets git habits for every change: short-lived branches, atomic commits with descriptive messages, clean pull requests, plus versioning, tagging and changelogs for releases.
104k GitHub starsUsed in 2 repos~3.5k tokens
DevelopmentAuto-check: notes
Verdaccio Pull Request Workflow
verdaccio/verdaccio
Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.
18k GitHub stars~1.9k tokensUpdated 2 days ago
DevelopmentAuto-check passed

More from mitsuhiko/agent-stuff

All 16 skills in this repo

Anachb
mitsuhiko/agent-stuff
Austrian public transport (VOR AnachB) for all of Austria. An agent skill from mitsuhiko/agent-stuff.
3.2k GitHub starsUsed in 2 repos~1.2k tokens
Auto-check passed
Librarian
mitsuhiko/agent-stuff
Cache and refresh remote git repositories under ~/.cache/checkouts/<host/<org/<repo so future references can reuse a local copy.
3.2k GitHub starsUsed in 1 repo~519 tokens
Auto-check passed
Web Browser
mitsuhiko/agent-stuff
Automate and interact with web pages through Chrome or Chromium using the Chrome DevTools Protocol (CDP): navigate, click, fill forms, inspect content, take screenshots, and debug console or network…
3.2k GitHub stars~1.5k tokensUpdated 13 days ago
Auto-check: warnings
Google Workspace
mitsuhiko/agent-stuff
Access Google Workspace APIs (Drive, Docs, Calendar, Gmail, Sheets, Slides, Chat, People) via local helper scripts without MCP.
3.2k GitHub stars~919 tokensUpdated 13 days ago
Auto-check passed
Oebb Scotty
mitsuhiko/agent-stuff
Austrian rail travel planner (ÖBB Scotty). An agent skill from mitsuhiko/agent-stuff.
3.2k GitHub stars~2.4k tokensUpdated 13 days ago
Auto-check passed
Sentry
mitsuhiko/agent-stuff
Fetch and analyze Sentry issues, events, transactions, and logs.
3.2k GitHub stars~1.8k tokensUpdated 13 days ago
Auto-check passed

Works with

Questions about Update Changelog

What does Update Changelog do?

Read this skill before updating changelogs. An agent skill from mitsuhiko/agent-stuff. Update Changelog is an agent skill from mitsuhiko/agent-stuff.

When should I use Update Changelog?

Update Changelog fits situations like: tasks that involve Changelog and release notes.

How do I install Update Changelog in Claude Code?

Run `npx skills add mitsuhiko/agent-stuff --skill update-changelog -a claude-code`. Or copy the skill folder (skills/update-changelog in mitsuhiko/agent-stuff) into .claude/skills/update-changelog in your project. Claude Code loads it when a task matches its description.

How do I install Update Changelog in Codex?

Run `npx skills add mitsuhiko/agent-stuff --skill update-changelog -a codex`. Or copy the skill folder (skills/update-changelog in mitsuhiko/agent-stuff) into .agents/skills/update-changelog in your project. Codex loads it when a task matches its description.

Can I use Update Changelog in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add mitsuhiko/agent-stuff --skill update-changelog -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-changelog, .gemini/skills/update-changelog, .github/skills/update-changelog and .opencode/skills/update-changelog in your project.

What does Update Changelog need to run?

Going by SKILL.md and its folder, Update Changelog needs the command-line tools its instructions call (git).

Does Update Changelog access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Update Changelog safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Update Changelog use?

Update Changelog is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Changelog use?

About 815 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Update Changelog?

Skills that share tags, products or a category with Update Changelog: React Router Release Notes Prep (remix-run/react-router, 57k stars), Draft Release Notes (jamiepine/voicebox, 57k stars), Mole Release Notes Publisher (tw93/Mole, 70k stars) and Release Bump (jamiepine/voicebox, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Changelog?

mitsuhiko (a GitHub user) maintains it in mitsuhiko/agent-stuff, which has 3,181 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on September 27, 2026.

Source: mitsuhiko/agent-stuff on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Update Changelog

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Step-by-Step Process

1. Determine baseline version

2. Find the commits from git

3. Update the changelog

Ground Rules When Writing Changelogs

Content Guidelines

Style Guidelines

Example Format

Good vs. Bad Examples

Notes

Files

Compare with similar skills

Similar skills

More from mitsuhiko/agent-stuff

Related

Questions about Update Changelog