What is this skill for?

Manage changelogs using Changie—from initialization to merging notes into CHANGELOG.md.

Yes. This skill relies on the Changie CLI being installed to run the commands.

How do I add a fragment from the last commit?

Use the helper script add-from-last-commit.sh to create a fragment from the latest commit message, or run changie new with a descriptive body.

manage-changelog

Scanned

npx machina-cli add skill yu-iskw/coding-agent-fabric/manage-changelog --openclaw

Files (1)

SKILL.md

1.6 KB

Manage Changelog Skill

This skill enables the agent to manage project changelogs efficiently using Changie. It supports the full lifecycle from initialization to release.

When to Use

When you need to initialize a changelog for a new project.
When you want to record a change (feature, bug fix, etc.) after completing a task.
When preparing for a new release and batching unreleased changes.

Instructions

1. Initialization

If the project doesn't have changie set up, run the initialization script:

.claude/skills/manage-changelog/scripts/init-changie.sh

This will create .changie.yaml with standard workspace settings.

2. Adding Changes

To add a new change fragment:

changie new --kind <kind> --body "<description>"

Kinds: Typically feat, fix, docs, refactor, test, chore.
Helper Script: Alternatively, use .claude/skills/manage-changelog/scripts/add-from-last-commit.sh to create a fragment from the last commit message.

3. Batching a Release

When you are ready to create a new version:

# Preview next version
changie next auto

# Batch unreleased changes into a version
changie batch auto

4. Merging into CHANGELOG.md

To update the main CHANGELOG.md file:

changie merge

References

Changie Documentation

Source

git clone https://github.com/yu-iskw/coding-agent-fabric/blob/main/.claude/skills/manage-changelog/SKILL.mdView on GitHub

Overview

This skill enables efficient changelog management with Changie, covering initialization, adding change fragments, batching releases, and merging notes into CHANGELOG.md. It guides you through setup, recording changes, and preparing releases, all while ensuring changelog consistency.

How This Skill Works

The agent runs a setup script to create .changie.yaml, then uses Changie commands to add fragments and batch/release versions, and finally merges the notes into the main CHANGELOG.md to reflect the release.

When to Use It

Initialize a changelog for a new project
Record a change after completing a task
Create a fragment from the last commit message using the helper script
Prepare for a new release and batch unreleased changes
Merge changes into the main CHANGELOG.md before release

Quick Start

Step 1: Run .claude/skills/manage-changelog/scripts/init-changie.sh to initialize changie and create .changie.yaml
Step 2: Add changes with changie new --kind <kind> --body "<description>", or use add-from-last-commit.sh to use the last commit message
Step 3: Prepare a release with changie next auto, then changie batch auto, and finally changie merge to update CHANGELOG.md

Best Practices

Run the initialization script .claude/skills/manage-changelog/scripts/init-changie.sh to set up .changie.yaml
Use changie new --kind <kind> --body "<description>" with standard kinds like feat, fix, docs, refactor, test, chore
Optionally use .claude/skills/manage-changelog/scripts/add-from-last-commit.sh to create fragments from the last commit
Batch unreleased changes with changie batch auto before releasing to minimize final edits
Review the merged CHANGELOG.md for formatting and accuracy prior to pushing the release

Example Use Cases

Initialize changelog for a new project, then add a feat fragment describing the new feature
Record a bug fix after completing a task using changie new with kind fix
Create a fragment from the latest commit using the helper script
Batch unreleased changes to prepare version 1.2.0
Run changie merge to update CHANGELOG.md before merging to main

Frequently Asked Questions

Add this skill to your agents