{"manifest":{"name":"Changelog Generator","version":"1.0.0","description":"Transform raw git commit history into a polished CHANGELOG entry in Keep a Changelog format. Categorizes, rewrites, and suggests the correct semver bump.","tags":["git","release","documentation","workflow","changelog"],"standard":"agentskills.io","standard_version":"1.0","content_checksum":"090169648b267e64a6d263afebfdca2180592f8faa31048cba3c8be803042b11","bundle_checksum":null,"metadata":{},"files":[]},"files":{"SKILL.md":"# Changelog Generator\n\n> **Purpose:** Transform raw git commit history into a human-readable, user-facing CHANGELOG entry in Keep a Changelog format. Categorizes commits, rewrites them in plain language, and recommends the correct semver version bump.\n\n---\n\n## Invocation\n\n```\n/changelog [since-tag]\n```\n\nInternally runs:\n```bash\ngit log $(git describe --tags --abbrev=0)..HEAD --format=\"%H %s\" --no-merges\n```\n\nIf `since-tag` is provided, uses that as the baseline instead of auto-detecting the last tag.\n\n---\n\n## Process\n\n### Step 1: Collect Commits\n\n```bash\ngit log [since-tag]..HEAD --format=\"%H|||%s|||%b\" --no-merges\n```\n\nIf no commits found: output \"No changes since last release.\"\n\n---\n\n### Step 2: Categorize by Conventional Commit Prefix\n\n| Prefix | Changelog Section |\n|--------|-------------------|\n| `feat:` / `feature:` | ### Added |\n| `fix:` / `bugfix:` | ### Fixed |\n| `perf:` | ### Changed |\n| `refactor:` | ### Changed |\n| `docs:` | ### Changed |\n| `remove:` / `deprecate:` | ### Removed |\n| `security:` | ### Security |\n| `BREAKING CHANGE` in body | ### Breaking Changes |\n| `chore:` / `test:` / `ci:` | **omit** (internal, not user-facing) |\n\nNon-conventional commits: use judgment based on commit message content.\n\n---\n\n### Step 3: Rewrite for Humans\n\nTransform commit messages into user-facing language:\n- `fix(auth): resolve JWT expiry edge case` → \"Fixed a login session expiry bug that logged users out unexpectedly\"\n- `feat(dashboard): add export button` → \"Added CSV export to the analytics dashboard\"\n- Group related commits into a single entry if they're part of the same feature\n\n---\n\n### Step 4: Recommend Version Bump\n\n| Condition | Bump |\n|-----------|------|\n| Only `fix:` commits | Patch (1.0.X) |\n| Any `feat:` commit | Minor (1.X.0) |\n| Any `BREAKING CHANGE` | Major (X.0.0) |\n\n---\n\n## Output Format\n\n```markdown\n## [VERSION] — YYYY-MM-DD\n\n### Breaking Changes\n> ⚠️ Migration required: [what users need to change]\n- [Breaking change with migration guide]\n\n### Added\n- [New feature in plain language] (#PR or commit hash)\n\n### Fixed\n- [Bug fixed and user impact explained]\n\n### Changed\n- [Improvement with context]\n\n### Removed\n- [What was removed and what to use instead]\n\n### Security\n- [Vulnerability addressed — always list, never omit]\n```\n\n---\n\n## Rules\n\n- Security section must always be listed if any security commit exists — never bury it\n- Breaking changes section comes first, always\n- Omit `chore:`, `test:`, `ci:` commits — they are not user-facing\n- Every entry should explain user impact, not just code change\n- If a breaking change has no migration guide: write \"Migration guide: [TODO]\" — don't omit the section\n- Suggest the version number explicitly in the output header\n"}}