Agent skill

changelog

Understand auto-generated changelogs via semantic-release. Use when viewing release history, understanding changelog format, or debugging missing changelog entries.

View SKILL.md on GitHub Repository
Stars 20
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/sgcarstrends/sgcarstrends/tree/main/.claude/skills/changelog

SKILL.md

Changelog Skill

Changelogs are auto-generated by @semantic-release/changelog on each release.

How It Works

  1. semantic-release runs on push to main
  2. @semantic-release/release-notes-generator generates notes from commits (conventionalcommits preset)
  3. @semantic-release/changelog prepends notes to CHANGELOG.md
  4. @semantic-release/git commits the updated changelog

Changelog Sections

Commit types map to changelog sections:

Commit Type Changelog Section
feat Features
fix Bug Fixes
perf Performance Improvements
revert Reverts
feat! / BREAKING CHANGE BREAKING CHANGES

Types chore, docs, refactor, test, ci do not appear in the changelog.

Viewing Changelog

bash
# View the changelog file
cat CHANGELOG.md

# View a specific GitHub release's notes
gh release view v4.46.0

# List recent releases with dates
gh release list --limit 10

Missing Changelog Entry?

If a commit does not appear in the changelog:

  1. Check the commit type — only feat, fix, perf, revert generate entries
  2. Verify the commit landed on main (not a feature branch)
  3. Check if semantic-release ran: gh run list --workflow=release.yml
  4. Ensure commit message follows conventional format

File Location

  • Changelog: CHANGELOG.md (root of repository)
  • Config: .releaserc.json → @semantic-release/changelog plugin

Related

  • See conventional-commits skill for commit message format
  • See release-management skill for release workflow

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

sgcarstrends/sgcarstrends

component-tester

Run Vitest tests for a specific component with coverage. Use when making changes to React components to ensure tests pass and coverage is maintained.

20 1
Explore
sgcarstrends/sgcarstrends

cache-components

Ensure 'use cache' is used strategically to minimize CPU usage and ISR writes. Use when creating/modifying queries to verify caching decisions align with data update patterns and cost optimization.

20 1
Explore
sgcarstrends/sgcarstrends

ui-design-system

Enforce modern dashboard UI patterns with pill-shaped design, professional colour scheme, and typography standards. Use when building or reviewing UI components for the web application.

20 1
Explore
sgcarstrends/sgcarstrends

typography-spacing-enforcer

Enforce Typography system and modern spacing conventions. Use when implementing new UI components to ensure design consistency with project standards.

20 1
Explore
sgcarstrends/sgcarstrends

conventional-commits

Format commit messages following project conventions with commitlint validation. Use when committing changes, writing PR descriptions, or preparing releases.

20 1
Explore
sgcarstrends/sgcarstrends

dependency-upgrade

Upgrade dependencies safely using pnpm catalog, checking for breaking changes, and testing upgrades. Use when updating packages, applying security patches, upgrading major versions, resolving dependency conflicts, or modernizing tech stack.

20 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results