release-notes

Create Unreleased changelog entries for Mozaiks release-impacting changes.

14|1|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/BlocUnited-LLC/mozaiks --skill release-notes-blocunited-llc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-notes
Source: https://github.com/BlocUnited-LLC/mozaiks/tree/main/.claude/skills/release-notes
Command: npx skills add https://github.com/BlocUnited-LLC/mozaiks --skill release-notes-blocunited-llc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents Mozaiks release notes from becoming incomplete or out of date by capturing user-visible changes while work is still fresh.

Core Features & Use Cases

  • Proactive changelog maintenance: Create an Unreleased entry for changes that affect CLI behavior, generated scaffolds, runtime/workflow/module contracts, packaging/release behavior, or public install/run/build docs.
  • Consistent user-focused writing: Write concise bullets from the user's point of view under the correct section (Added, Changed, Fixed, Removed, Security).
  • Release prep alignment: Follow the checklist for moving entries into versioned sections, resetting Unreleased, verifying the version tag, and summarizing into GitHub Release notes.

Quick Start

Update the Mozaiks release notes for a release-impacting change by completing the task: "Added a new CLI flag that changes the default output format for the quickstart command."

Frequently Asked Questions about release-notes

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

FAQPage Schema
How do I maintain changelog entries for CLI behavior changes?▼

Write release notes by placing concise, user-focused bullets under the correct section header, such as Added, Changed, Fixed, Removed, or Security. This ensures the changelog consistently reflects user-visible updates from their point of view.

When should I add an unreleased changelog entry for a new feature?▼

Add an unreleased changelog entry when changes affect CLI behavior, generated app scaffolds, runtime contracts, packaging, or public installation documentation. Capturing these user-visible updates immediately prevents release notes from becoming incomplete or out of date.

How do I prepare release notes for a new version tag and GitHub release?▼

Prepare release notes by following a checklist to move Unreleased entries into versioned sections, reset the Unreleased block, verify the version tag, and summarize the changes into GitHub Release notes for final publication.

Do I need a separate documentation tool to write release notes for PyPI packaging updates?▼

No separate documentation tool is needed to write release notes for PyPI packaging updates. Described changes are processed directly into a single concise bullet and appended to the correct changelog section under Unreleased.

What is the best way to document changes to generated app scaffolds and templates?▼

The best way to document changes to generated app scaffolds and templates is to generate a single concise bullet in the correct section style. This ensures the update is accurately captured in CHANGELOG.md under the Unreleased section.