# Skill 041

> Edit changelog using git commit history via script.

- Skill: `legendtkl/skill-041` (Agent Skill)
- Install (CLI): `npx skillmds@latest add legendtkl/skill-041`
- Raw SKILL.md: https://api.skillmd.com/api/skills/legendtkl/skill-041/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: legendtkl (https://skillmd.com/u/legendtkl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/legendtkl/skill-041

---


# Edit changelog

**`GOAL`**: generate changelog entries from git history and update
`CHANGELOG.md`.

**`WHEN`**: the agent needs to update the changelog with recent commits.

**`NOTE`**: requires `CHANGELOG.md` and `.last-aggregated-commit`
(auto-initialized).

## Efficiency directives

- Optimize all operations for token and context efficiency
- Batch operations on file groups, avoid individual file processing
- Target only relevant files
- Reduce token usage

## Workflow

- Run `scripts/edit-changelog.sh`
- Capture status from first line of output
- Handle the status:
  - If `ERROR`: Stop and report to user
  - If `WARN`: Report no changes needed
  - If `SUCCESS`: Report success with entry count
- **`DONE`**

## Output

**Files modified:**

- `CHANGELOG.md` - Unreleased section updated
- `.last-aggregated-commit` - Updated to `HEAD`

**Status communication:**

First line of output indicates status:

- `SUCCESS: [message]` - Operation completed with changes
- `WARN: [message]` - Operation completed but no changes needed
- `ERROR: [message]` - Operation failed

## References

The following reference files serve as strict guidelines:

- **`references/keep-a-changelog-spec.md`**: Format specification
- **`references/changelog-templates.md`**: Template variations
- **`references/changelog-structure.md`**: Structure documentation
- **`references/aggregation-patterns.md`**: Aggregation patterns