python-changelog-fragments
Installation
SKILL.md
Python changelog fragments
Create and validate changelog fragments for Python projects that use antsibull-changelog (Ansible collections), towncrier, or scriv (most other Python packages). All three solve the same problem, a PR-scoped snippet that gets collected into the real changelog at release time, but they use different file formats, config sections, and directory conventions.
1. Identify the tool in use
Check for these markers before doing anything else, they determine which reference file and commands apply:
| Marker | Tool |
|---|---|
changelogs/config.yaml or changelogs/fragments/ |
antsibull-changelog |
pyproject.toml has a [tool.towncrier] section |
towncrier |
pyproject.toml has a [tool.scriv] section, or setup.cfg/tox.ini has a [scriv] section |
scriv |
towncrier and scriv both commonly use a directory literally named changelog.d/, so disambiguate by the config section name, not the directory. If neither marker exists, ask which tool the project uses rather than guessing, the fragment format and directory are not interchangeable.