command

add-to-changelog — Claude Code command: write to CHANGELOG.md

Q: How do I install add-to-changelog in Claude?

Run `npx claude-code-templates@latest --command project-management/add-to-changelog`. The command file lands at `.claude/commands/add-to-changelog.md`.

Q: What arguments does the command take?

Version, change type and message, for example `/add-to-changelog 1.1.0 added "text"`. You can pass `--added`, `--changed` or `--fixed` instead of a change type.

Adds an entry to CHANGELOG.md following Keep a Changelog: version, change type, message. Handy when a release is close and the file still has nothing for it.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --command project-management/add-to-changelog

Open on GitHub

What add-to-changelog does

The command takes three arguments: version, change type and message. Change type is one of added, changed, deprecated, removed, fixed, security. If CHANGELOG.md is missing, it gets created with a standard header. Then the command finds or creates the section for that version with today's date and drops the entry under the matching heading.

Short flags work too: --added, --changed, --fixed. Under the hood it reads CHANGELOG.md plus package.json or setup.py when those exist, so a new version also updates the package version file. Read, Write, Edit and Bash are the tools it is allowed to use.

Make sure the version you pass is the one you actually plan to ship, because that same number lands in package.json. The command does not restructure an existing changelog — if your file has its own layout, the entry follows the command's rules, not yours.

What it helps with

log a change in CHANGELOG.md without opening the file
bootstrap CHANGELOG.md in Keep a Changelog format
sort entries under added, changed, fixed and the rest
bump the version in package.json or setup.py along with the entry
stamp the release date on a version section

Example prompts for the agent

/add-to-changelog 1.1.0 added "New markdown to BlockDoc conversion"
/add-to-changelog 1.0.2 fixed "Bug in HTML renderer"
/add-to-changelog --changed "Rewrote the data access layer"

How to install add-to-changelog

1claude-code-templates

npx claude-code-templates@latest --command project-management/add-to-changelog

2Manually: put the files in place

.claude/commands/add-to-changelog.md

Call it with /add-to-changelog. For all projects use ~/.claude/commands/

Manually: put the files in place

~/.codex/prompts/add-to-changelog.md

Call it with /prompts:add-to-changelog. Codex marks this format deprecated in favour of skills

Manually: put the files in place

.github/prompts/add-to-changelog.prompt.md

Manually: put the files in place

.gemini/commands/add-to-changelog.toml

Gemini stores commands as TOML: the prompt text goes into the prompt field

Questions about add-to-changelog

How do I install add-to-changelog in Claude?

Run npx claude-code-templates@latest --command project-management/add-to-changelog. The command file lands at .claude/commands/add-to-changelog.md.

What does add-to-changelog do?

It adds an entry to CHANGELOG.md: creates the file if needed, finds or creates the version section with a date, and writes your text under the right change type.

What arguments does the command take?

Version, change type and message, for example /add-to-changelog 1.1.0 added "text". You can pass --added, --changed or --fixed instead of a change type.

Source text

add-to-changelog.md · MIT

---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[version] [change-type] [message] | --added | --changed | --fixed"
description: Add entry to project changelog following Keep a Changelog format
---

# Update Changelog

Add a new entry to the project's CHANGELOG.md file: **$ARGUMENTS**

## Usage Examples
- `/add-to-changelog 1.1.0 added "New markdown to BlockDoc conversion feature"`
- `/add-to-changelog 1.0.2 fixed "Bug in HTML renderer causing incorrect output"`

## Current Changelog State

- Existing changelog: @CHANGELOG.md (if exists)
- Project version files: @package.json or @setup.py (if exists)

## Task

Add the specified change entry to CHANGELOG.md:

**Arguments**: 
- Version: First argument (e.g., "1.1.0")
- Change Type: Second argument (added/changed/deprecated/removed/fixed/security)  
- Message: Third argument (description of the change)

**Requirements**:
1. Create CHANGELOG.md with standard header if it doesn't exist
2. Find or create version section with today's date
3. Add entry under appropriate change type section
4. Follow Keep a Changelog format and Semantic Versioning
5. Update package version files if this is a new version

The changelog should follow [Keep a Changelog](https://keepachangelog.com/) format.

Similar slash commands

All slash commands for Writing and docs →

Changelog Generator claude-office-skills Converts git commits and feature lists into clean release notes. Useful for engineering teams documenting new software versions. CX Codex +1 4,600installs changelog-generator Alireza Rezvani Builds release notes from Conventional Commits, suggests a SemVer bump, and lints commit messages. Use it for releases, CI, and hotfix work. 618installs changelog-writer patricio0312rev Turns git commits, PR titles and issue references into a CHANGELOG and release notes. Useful right before a release, when changes need sorting and a version number. CX Codex +1 615installs changelog-maintenance aj-geddes A skill that gets your agent to write and maintain CHANGELOG.md in Keep a Changelog format, with Added, Changed, Fixed and Security sections. CX Codex +1 495installs om-auto-update-changelog open-mercato Drafts a CHANGELOG.md entry for every PR merged since the last release, then hands the edit to om-auto-create-pr. Built for release time. CX Codex +1 3,100installs utility-pm-changelog-curator product-on-purpose Builds a CHANGELOG draft from git log between tags and applies the repo hygiene rules. Useful right before a release. CX Codex +1 597installs

From the same set205

The whole set →

exploratory-data-analysis A Claude skill that identifies a scientific file's format and writes a markdown report on its structure, quality and next analysis steps. 279installs env-file-protection This hook stops Write calls aimed at .env* files, so an agent cannot overwrite your secrets by accident. One command adds it to Claude settings. 279installs slack-notifications Posts a Slack message when Claude finishes working or a subagent completes its task. Useful when you step away from the terminal and want to know the run is done. 279installs frontend-to-backend-requirements A skill that helps a frontend developer tell backend what data a screen needs, without dictating the API shape. 278installs dependency-mapper Builds a dependency graph for code and tasks, detects cycles and calculates the critical path. Useful before sprint planning or a refactor. 274installs rag-engineer A skill for designing RAG systems: document chunking, embeddings, hybrid search and reranking. Useful when answer quality is capped by retrieval quality. 273installs business-scenario-explorer A slash command that maps out several business timelines — baseline, optimistic, pessimistic and disruption — and turns them into a decision matrix. 273installs rollback-deploy Walks an agent through rolling a deployment back to the previous version, with safety checks and database handling. 260installs