.github/skills/changelog-update/SKILL.md
Update CHANGELOG.md with a new entry under the correct section. Parses existing structure, adds entries under [Unreleased], and assesses semver impact. Triggers on: after resource changes, bug fixes, documentation updates, or any notable project change.
npx skillsauth add aztfmod/terraform-provider-azurecaf changelog-updateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
head -80 CHANGELOG.md
Identify the ## [Unreleased] section and its subsections (### Added, ### Changed, ### Fixed, ### Removed, ### Deprecated).
| Change type | Section | Semver impact |
|-------------|---------|---------------|
| New resource type added | ### Added | Minor |
| New feature or capability | ### Added | Minor |
| Updated resource constraints (slug, regex, length) | ### Changed | Patch |
| Bug fix | ### Fixed | Patch |
| Removed resource or feature | ### Removed | Major |
| Deprecated resource or feature | ### Deprecated | Minor |
Use these templates based on change type:
New resource:
- **RESOURCE**: Added `<resource_name>` (<official display name>) -- slug: `<slug>`, length: <min>-<max>, scope: <scope>, dashes <allowed|not allowed>, <lowercase|mixed case>
- Impact: <Low|Medium|High> -- <brief justification>
Updated resource:
- **RESOURCE**: Updated `<resource_name>` -- <describe field changes>
- Impact: <Low|Medium|High> -- <brief justification>
Bug fix:
- **<Component>**: <Brief description of fix>
- <Detail of what was fixed and why>
- Impact: <Low|Medium|High> -- <brief justification>
Multiple resources (batch):
- **RESOURCE**: Added support for <category> resource types
- Added `<resource_1>` with slug `<slug_1>`
- Added `<resource_2>` with slug `<slug_2>`
- <Summary of shared characteristics>
- Impact: <Low|Medium|High> -- <brief justification>
Insert the new entry under the appropriate subsection within ## [Unreleased].
### Added) does not exist, create it under ## [Unreleased].After inserting, summarize the semver impact:
development
Analyze test failure output to identify root cause and suggest fixes. Use when build or test failures occur. Triggers on: test failures, build errors, CI failures.
development
Validate a resource definition end-to-end using terraform test with mock_provider azurerm. Proves the CAF-generated name is accepted by the azurerm provider schema without Azure credentials. Use after provider-build-test succeeds to run the mocked azurerm integration test.
documentation
Analyze changes since the last release tag and determine the appropriate semantic version bump (patch/minor/major) based on CHANGELOG entries and commit types. Triggers on: release preparation, version planning.
testing
Compare two versions of resourceDefinition.json (e.g., branch vs main) and produce a structured change summary. Triggers on: PR review, audit, before/after comparison.