Agent-Skills.md

Agent Skills: Update Changelog

Update changelog files following Keep a Changelog conventions. Use for project changelogs or skill changelogs. Handles version sections, change type groupings, and skill-specific metadata updates.

UncategorizedID: nweii/agent-stuff/update-changelog

Repository

nweii/agent-stuff
nweiiLicense: MIT

Install this agent skill to your local

pnpm dlx add-skill https://github.com/nweii/agent-stuff/tree/HEAD/skills/update-changelog

Skill Files

Browse the full folder contents for update-changelog.

Download Skill

Loading file tree…

skills/update-changelog/SKILL.md

Skill Metadata

Name
update-changelog
Description
"Update changelog files following Keep a Changelog conventions. Use for project changelogs or skill changelogs. Handles version sections, change type groupings, and skill-specific metadata updates."

Update Changelog

Update changelog files following Keep a Changelog conventions.

Usage

/update-changelog <version> <change_type> <message>
/update-changelog <skill_path> <version> <change_type> <message>

Parameters

  • <version>: Version number (e.g., "1.1.0")
  • <change_type>: One of: "added", "changed", "deprecated", "removed", "fixed", "security"
  • <message>: Description of the change
  • <skill_path> (optional): Path to skill folder for skill changelogs

Process

  1. Check for existing changelog (CHANGELOG.md or changelog.md), create if missing
  2. Find or create section for the specified version with today's date
  3. Add the new entry under the appropriate change type heading
  4. Format according to Keep a Changelog conventions
  5. Write the updated changelog back to file

Format Conventions

  • Group changes by type (Added, Changed, Deprecated, Removed, Fixed, Security)
  • List changes as bullet points
  • Include date for version sections (YYYY-MM-DD)
  • Keep entries concise but descriptive
  • No emojis

Example Output

## [1.2.0] - 2025-01-24

### Added
- New markdown to BlockDoc conversion feature

### Fixed
- Bug in HTML renderer causing incorrect output

Skill & Plugin Changelogs

For skill-specific conventions (updating metadata.version in SKILL.md) or plugin changelog formats, see skill-plugin-conventions.md.