release-changeset

Detect commits lacking Changeset coverage and generate semver bump entries.

23|4|Updated May 7, 2025
One-click install
npx skills add https://github.com/Stack-and-Flow/design-system --skill release-changeset
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-changeset
Source: https://github.com/Stack-and-Flow/design-system/tree/main/.atl/skills/release-changeset
Command: npx skills add https://github.com/Stack-and-Flow/design-system --skill release-changeset

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents releases from being blocked or inaccurately versioned by ensuring every user-visible change in the Stack-and-Flow Design System has an appropriate Changeset entry.

Core Features & Use Cases

  • Detects uncovered commits by comparing Conventional Commits history against existing files in .changeset/ to identify work that needs a Changeset.
  • Generates consumer-facing Changeset files by selecting the correct semver bump type (patch/minor/major) from breaking-change indicators and feat/fix intent.
  • Supports delegated release workflow by allowing sdd-archive to trigger only the detect + generate phases when the repo is already initialized.

Quick Start

Ask an AI to guide you through creating a Changeset for the latest commit set and returning the exact bump type, slugged Changeset filename, and the consumer-facing entry text in English.

Frequently Asked Questions about release-changeset

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

FAQPage Schema
How do I generate changeset files from conventional commits history?

To generate changeset files from conventional commits, the Skill compares git history against existing `.changeset/` entries to detect uncovered commits and creates new consumer-facing files with the correct semver bump type derived from breaking-change indicators.

How does semver bump detection work for breaking changes in feature commits?

Semver bump detection analyzes conventional commit types like `feat` and `fix` alongside breaking-change indicators to infer the correct version increment, automatically applying a major bump for breaking changes, minor for features, and patch for fixes.

How do I find commits missing changeset coverage before an npm release?

You can find uncovered commits by comparing your conventional commits history against existing files in the `.changeset/` directory, identifying user-visible changes that lack the required changeset entries to prevent blocked or inaccurately versioned releases.

Does this changeset workflow require an initialized changeset directory?

The changeset workflow supports delegated release phases where `sdd-archive` triggers detect and generate actions, allowing operation when the repository is already initialized with the `.changeset/` directory structure.

What is the correct format for a changeset file with YAML frontmatter?

A correct changeset file uses YAML frontmatter to specify the semver bump type and package name, followed by English consumer-perspective phrasing that clearly describes the user-visible changes rather than internal implementation details.

Why do npm releases get blocked by missing changeset entries?

Releases get blocked because user-visible changes in the design-system repository lack appropriate changeset coverage, preventing the release workflow from accurately determining and applying the correct semantic versioning bumps.