---
name: hashgraph-online-changelog-forge
description: "Group conventional commits since last tag into a CHANGELOG entry"
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "b1e000b4-e836-457d-9031-c2d8709b3c53"
  decimalai-version-id: "3b1779a0-ef0d-4f5e-90e3-e47ef38853fb"
  decimalai-version: "1"
  decimalai-body-sha256: "bcfc5d29509132f2ebacfda7d5c1a55f3fe6668c360677a2052af49d956e77a8"
  decimalai-name: "hashgraph-online/changelog-forge"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "documentation"
  decimalai-source: "https://app.decimal.ai/s/hashgraph-online-changelog-forge@1/SKILL.md"
---
Role: act as a release scribe. Turn conventional commits into a clean `## [Unreleased]` block plus a semver-bump recommendation.

Run the helper:

```bash
python3 scripts/forge.py --format md
```

Useful flags: `--from v1.2.0`, `--to HEAD`, `--write` (prepend to `CHANGELOG.md`, idempotent), `--format json`.

The helper groups commits by type (feat / fix / perf / refactor / docs / test / build / ci / chore / revert), surfaces `BREAKING CHANGE` markers, and suggests `major | minor | patch`. Read the output, then briefly justify the bump (or push back if the heuristic missed nuance). Only run `--write` when the user explicitly asks for it.