changelog
Maintains CHANGELOG.md in the project root using git commit history. Use when the user invokes /changelog, asks to "update the changelog", "generate a changelog", or wants to record what changed before merging a branch. Creates the file from scratch if it doesn't exist (all commits grouped by date); otherwise appends only commits newer than the last recorded date.
Source facts
- Repository
- https-deeplearning-ai/sc-spec-driven-development-files
- Last source activity
- April 13, 2026 at 21:04
- Detected SKILL.md language
- English
- Stars
- 285
- Forks
- 275
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
2 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- changelog
- description
- Maintains CHANGELOG.md in the project root using git commit history. Use when the user invokes /changelog, asks to "update the changelog", "generate a changelog", or wants to record what changed before merging a branch. Creates the file from scratch if it doesn't exist (all commits grouped by date); otherwise appends only commits newer than the last recorded date.
# Changelog Skill
## Workflow
1. Run the script from the project root:
```bash
python3 <skill-dir>/scripts/changelog.py
```
Where `<skill-dir>` is the directory containing this skill. Claude Code exposes the skill path — use it directly.
2. The script handles both cases automatically:
- **No CHANGELOG.md**: reads full git history, writes the file with all dates
- **CHANGELOG.md exists**: finds the newest `## YYYY-MM-DD` heading, fetches commits after that date, prepends new sections
3. Review the output, edit bullet wording if needed, then commit `CHANGELOG.md` as part of the merge commit.
## Format
```markdown
# Changelog
## 2026-03-31
- Add responsive design to layout and CSS
- Add Vitest test suite for components and routes
## 2026-03-30
- Initial project scaffold
```
- One `# Changelog` title at the top
- Date headings as `## YYYY-MM-DD`, newest first
- Each commit is one bullet; wording may be cleaned up manually after generation
## Notes
- Run from the **project root** (same directory as `.git/`)
- Commit subjects come directly from `git log`; clean them up manually if needed
- The script is idempotent: re-running when nothing is new prints a message and exits without modifying the file
View on GitHub