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.