Do I need the GitHub CLI to use this skill?

The GitHub CLI (gh) is recommended but optional; it allows the skill to enrich entries with PR titles and descriptions for richer context.

How does this skill group the changelog entries?

It categorizes changes based on linked documentation: Proposals map to Features, Plans map to Improvements, and ADRs map to Decisions.

What documentation structure does it require?

It follows the principled pipeline (ADR-013), looking for documentation in docs/proposals, docs/plans, and docs/decisions.

Can I generate a changelog for a specific folder?

Yes, the --module argument allows you to scope the changelog specifically to changes within a specific directory or module path.

Principled Changelog Generator

Name: Principled Changelog Generator
Author: alexnodeland

byalexnodeland

•

内容管理

Generates specification-driven changelogs by mapping Git commits to proposals, plans, and architectural decisions.

The Principled Changelog Skill automates the creation of detailed, human-readable changelogs by analyzing your repository's pipeline documentation. It maps commit hashes to specific RFCs, Plans, and ADRs (Architectural Decision Records) since the last release, ensuring that your changelog reflects the actual architectural intent and product decisions rather than just raw code changes. By integrating with GitHub and local documentation paths, it organizes updates into logical sections like Features, Improvements, and Decisions, making it an essential tool for projects following specification-driven development patterns.

主要功能

01Maps commits directly to pipeline documents like RFCs, Plans, and ADRs

023 GitHub stars

03Integrates with GitHub CLI to enrich entries with PR context and titles

04Automatically groups changes into Features, Improvements, Decisions, and Fixes

05Uses Markdown templates to ensure consistent, professional release notes

06Supports scoped changelog generation for specific modules or paths

使用场景

01Managing complex changelogs in monorepos using the module-specific scoping flag

02Tracking architectural evolution by highlighting ADRs in every release

03Generating comprehensive release notes for projects using specification-driven development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alexnodeland/principled changelog

For use in Claude.ai and ChatGPT

Download Skill