agentleFS
cwinvestmentscwinvestments/memstack/skills/development/changelog-generator/SKILL.md

memstack-development-changelog-generator

Skill425 starsChanged 5 months agoMITView on GitHub

Use when the user says 'generate changelog', 'update changelog', 'what changed', 'release notes', 'write changelog', or needs a formatted CHANGELOG.md from git commit history. Do NOT use for diary entries, git log viewing, or commit message writing.

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 7 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈7

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Do NOT use for session logging (that's Diary)

    line 22
  2. Distinctive:

    Do NOT use for commit message writing (that's a git workflow)

    line 23
  3. Distinctive:

    Do NOT use for PR descriptions (that's a git workflow)

    line 24
  4. Distinctive:

    Ask the user or infer from context:

    line 31
  5. Distinctive:

    Follow Keep a Changelog format:

    line 65
  6. Distinctive:

    If exists: prepend the new entry after the title line, before existing entries

    line 98
  7. Distinctive:

    If not exists: create with header:

    line 99

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Changelog Generator: Generating changelog...

Produces a formatted CHANGELOG.md from git commit history, grouped by type and ready for release.

Activation

TriggerStatus
User says "generate changelog" or "update changelog"ACTIVE
User says "what changed" or "release notes"ACTIVE
User says "write changelog" or "changelog since"ACTIVE
User wants to view git log onlyNOT this skill: use git commands directly
User wants a diary entryNOT this skill: use Diary

Context Guard

  • Do NOT use for session logging (that's Diary)
  • Do NOT use for commit message writing (that's a git workflow)
  • Do NOT use for PR descriptions (that's a git workflow)
  • This skill ONLY produces CHANGELOG.md content from existing commits

Steps

Step 1: Determine the range

Ask the user or infer from context:

ParameterDefaultExample
Since tag/dateLast tag or last 7 daysv3.3.0, 2026-03-01
UntilHEADv3.4.0, HEAD
FormatKeep a ChangelogConventional, custom
# Find the last tag
git describe --tags --abbrev=0 2>/dev/null || echo "No tags found"

# Get commits since last tag (or date)
git log --oneline --no-merges $(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~50")..HEAD

Step 2: Categorize commits

Parse each commit message and classify by prefix:

PrefixCategoryChangelog Section
feat: / feature:Features### Added
fix: / bugfix:Bug Fixes### Fixed
docs:Documentation### Changed
refactor:Refactoring### Changed
perf:Performance### Changed
test:Tests(omit unless user requests)
chore: / build: / ci:Maintenance(omit unless user requests)
BREAKING CHANGE or !:Breaking### Breaking Changes
No prefixUncategorized### Other

Step 3: Generate the changelog entry

Follow Keep a Changelog format:

## [version] - YYYY-MM-DD

### Breaking Changes
- Description of breaking change ([commit-hash])

### Added
- New feature description ([commit-hash])

### Fixed
- Bug fix description ([commit-hash])

### Changed
- Refactor/improvement description ([commit-hash])

Writing rules:

  1. Rewrite technical commit messages into user-facing language
  2. Group related commits into single entries where sensible
  3. Lead with the impact, not the implementation ("Users can now..." not "Added handler for...")
  4. Include short commit hash as reference
  5. Skip merge commits, version bumps, and trivial chores unless requested
  6. Order: Breaking Changes > Added > Fixed > Changed > Removed > Other

Step 4: Handle existing CHANGELOG.md

# Check if CHANGELOG.md exists
ls CHANGELOG.md 2>/dev/null
  • If exists: prepend the new entry after the title line, before existing entries
  • If not exists: create with header:
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/),
and this project adheres to [Semantic Versioning](https://semver.org/).

## [version] - YYYY-MM-DD
...

Step 5: Present for review

Changelog entry for [version] ([date]):
- [N] features added
- [N] bugs fixed
- [N] changes
- [N] breaking changes

Ready to write to CHANGELOG.md? (prepend / overwrite / clipboard only)

Disambiguation

  • "generate changelog" / "update changelog" / "release notes" = Changelog Generator
  • "save diary" / "log session" = Diary (not Changelog Generator)
  • "what did we do" / "last session" = Echo (not Changelog Generator)
  • "git log" / "show commits" = Direct git commands (not Changelog Generator)

Level History

  • Lv.1: Base: Git-to-changelog with Keep a Changelog format, commit categorization by conventional commits prefix, user-facing rewriting, existing file handling. (Origin: MemStack v3.5, Apr 2026)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.