# Git Tag Changelog

> Use when the user asks to write changelogs, change logs, release notes, or summarize what changed between git tags. Especially useful when the user wants a changelog based on the latest two git tags or asks for a concise release summary from recent commits.

- Skill: `debugtheworldbot/git-tag-changelog` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add debugtheworldbot/git-tag-changelog`
- Raw SKILL.md: https://api.skillmd.com/api/skills/debugtheworldbot/git-tag-changelog/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: debugtheworldbot (https://skillmd.com/u/debugtheworldbot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/debugtheworldbot/git-tag-changelog

---


# Git Tag Changelog

Generate changelogs from git tags instead of guessing from memory.

## When To Use

- The user asks for a changelog or release notes
- The user mentions "Change Logs", "changelog", or "what changed"
- The user wants the summary based on git history, tags, or commits

## Default Workflow

1. Run `scripts/generate_git_tag_changelog.sh` from the skill directory.
2. If the user did not specify tags, compare the latest two version-like git tags.
3. Read the script output:
   - compared tags
   - commit subjects
   - changed files
4. Write a concise changelog from the actual diff.

## Output Rules

- Default to English unless the user asks for another language.
- Prefer short release-note language, not commit-by-commit narration.
- Group user-facing changes when the diff clearly separates platforms or surfaces such as `Mac`, `Windows`, `Docs`, or `Internal`.
- If one platform has no meaningful changes, omit that section.
- Do not invent details that are not supported by commit subjects or changed files.
- If the change is implementation-only and not user-facing, keep it out or compress it into one short internal note.

## Commands

Default:

```bash
bash .agents/skills/git-tag-changelog/scripts/generate_git_tag_changelog.sh
```

Specific tags:

```bash
bash .agents/skills/git-tag-changelog/scripts/generate_git_tag_changelog.sh v1.40 v1.41
```

