# Update Changelog

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

- Skill: `tools-only/update-changelog-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/update-changelog-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/update-changelog-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/update-changelog-2

---


# 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.
