skills.rest
amauryconstant
amauryconstantCOMMUNITY
Explore all skills by this author →
GitHub

osx-generate-changelog

Generate a CHANGELOG.md from archived OpenSpec changes using Keep a Changelog format.

6|1|Updated Feb 12, 2026
Search Tags:#automation#changelog#parsing#openspec#proposal#release-notes#archived-changes
One-click install
npx skills add https://github.com/amauryconstant/openspec-extended --skill osx-generate-changelog
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: osx-generate-changelog
Source: https://github.com/amauryconstant/openspec-extended/tree/main/resources/claude/skills/osx-generate-changelog
Command: npx skills add https://github.com/amauryconstant/openspec-extended --skill osx-generate-changelog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automatically generates a Keep a Changelog–formatted CHANGELOG.md from archived OpenSpec changes, consolidating summaries and proposals into structured release notes.

Core Features & Use Cases

  • Discover archived changes in openspec/changes/archive and identify eligible entries
  • Read proposal.md, or fallback to design.md or tasks.md to extract summaries and proposed changes
  • Categorize changes into Added, Changed, Fixed, Security, Breaking, etc., and assemble an Unreleased section
  • Update or create CHANGELOG.md while preserving existing history and versioning notes

Quick Start

Run the changelog generator to process archived changes and update CHANGELOG.md.

Frequently Asked Questions about osx-generate-changelog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a changelog from archived OpenSpec proposals automatically?▼

To generate a changelog from OpenSpec proposals, this Skill reads archived changes from openspec/changes/archive, parses proposal.md files, and consolidates summaries into structured release notes formatted under Unreleased.

What is the best way to format release notes using Keep a Changelog standards?▼

Keep a Changelog formatting is applied by categorizing parsed OpenSpec proposal entries into Added, Changed, Fixed, Security, or Breaking sections, assembling them into an Unreleased block within CHANGELOG.md.

Can I update CHANGELOG.md without losing existing version history?▼

You can update CHANGELOG.md without losing existing history because the generator preserves prior versioning notes and entries while appending newly categorized changes under the Unreleased section.

Does the changelog generator work if proposal.md is missing from the archive?▼

The changelog generator works if proposal.md is missing by falling back to read design.md or tasks.md files within the archived OpenSpec changes to extract summaries and proposed changes for categorization.

When do I need to run a changelog generator for release documentation?▼

You need to run a changelog generator before publishing releases or during documentation workflows to consolidate archived OpenSpec design notes and proposals into structured release notes.

Related Skills

Explore More Software Engineering Skills→
jankneumannjankneumann
4

openspec-onboard

Guide users through the OpenSpec workflow cycle with CLI commands.

Community
Intermediate
utkudarilmazutkudarilmaz
3

changelog

Generate CHANGELOG.md and release notes from git history.

Community
Intermediate
remiverdiesenremiverdiesen
6

openspec-onboard

Guides step-by-step OpenSpec workflow cycles for creating, implementing, and archiving changes.

Community
Advanced
jchildreejchildree
1

memory-to-vault

Convert Codex persisted memory into a structured outline saved as an Obsidian vault note.

Community
Intermediate