Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

changeset

/changeset

Tworzy changeset dla zmian w gałęzi i pisze noty wydania dla zmienionych pakietów.

Repozytorium
components ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
26.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 26.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Tworzy changeset dla zmian w gałęzi i pisze noty wydania dla zmienionych pakietów.

Oryginalny opis (EN)

Create a changeset for the changes in a branch. Use when: the user asks to create a changeset, add a changeset, generate a changeset, or write release notes for changed packages.

Jak działa

  1. Purpose
  2. When to Use
  3. When Not to Use
  4. Procedure
Sekcje z nagłówków SKILL.md, w oryginale · 133 linii, 612 słów
Podgląd SKILL.md
---
name: changeset
description: 'Create a changeset for the changes in a branch. Use when: the user asks to create a changeset, add a changeset, generate a changeset, or write release notes for changed packages.'
---

# Create Changeset

## Purpose

Create a changeset file for the changes on the current branch compared to the `main` branch. Changesets are used by `@changesets/cli` to version packages and generate changelogs in this monorepo.

## When to Use

- When the user asks to create, add, or generate a changeset
- When the user asks to write release notes for changes
- After completing a feature or bug fix that needs a version bump

## When Not to Use

- Do not use if there are no changes to _published_ packages (e.g. only changes to root config files, scripts, tools)

## Procedure

### 1. Determine Changed Packages

Use the terminal to get the list of changed files compared to `main`:

```bash
git diff --name-only main...HEAD
```

Map each changed file to its package by looking at the closest `package.json` in the directory hierarchy. For example:

- `packages/angular/` → `@sl-design-system/angular`
- `packages/components/<name>/` → `@sl-design-system/<name>`
- `packages/locales/` → `@sl-design-system/locales`
- `packages/themes/<name>` → `@sl-design-system/<name>`
- `tools/eslint-config/` → `@sl-design-system/eslint-config`

### 2. Filter Out Ignored Packages

The following packages are **excluded** from changesets (configured in `.changeset/config.json`):

- `@sl-design-system/chromatic`
- `@sl-design-system/example-data`
- `@sl-design-system/lit-examples`
- `@sl-design-system/scripts`
- `@sl-design-system/website`

Also exclude changes to files outside of packages (e.g. root config files, scripts, tools).

If no packages remain after filtering, inform the user that no changeset is needed.

### 3. Determine number of changesets needed

Changesets can include multiple packages with different bump types, but if there are many unrelated changes it may be better to create multiple changesets. Prompt the user if they want to create one changeset for all changes or separate changesets for different groups of changes, unless it's obvious.

### 4. Determine the Bump Type

Summarize the changes found and prompt the user what kind of version bump is appropriate, unless the context makes it obvious:

- **patch**: Bug fixes, minor improvements, documentation updates, accessibility improvements
- **minor**: New features, new components, new public API methods/properties
- **major**: Breaking changes (removed/renamed public API, changed behavior)

Different packages in the same changeset can have different bump types.

### 5. Write the Summary

Write a clear, concise summary of the changes. Follow these guidelines:

- First line: Brief one-line description of the change
- Additional lines (optional): More detail if the change is complex
- Write from the user's perspective (what changed, not how it was implemented)
- Use imperative mood ("Add support for..." not "Added support for...")

Study the git diff (use `git diff main...HEAD`) to understand the actual changes and write an accurate summary.

#### Examples

Simple patch:

```
Fix field not growing when it has an explicit width
```

Feature with description:

```
Add `getSelectedItems()` method to ArrayListDataSource

This is a utility method that will return the raw data objects of all currently selected items.
```

Accessibility improvement:

```
Accessibility improvements:
- Moved the clear button from `sl-select-button` to `sl-select`, the clear button is now focusable on its own,
- Added `aria-keyshortcuts` attribute to announce Backspace/Delete shortcuts to assistive technology.
```

### 5. Generate the Changeset File

Create the changeset file at `.changeset/<random-name>.md` with this format:

```markdown
---
'<package-name>': <bump-type>
---

<summary>
```

For the filename, generate a random name using the pattern `<adjective>-<noun>-<verb>` (all lowercase, separated by hyphens). Examples: `eighty-bats-camp`, `spotty-trams-rush`, `smooth-eggs-follow`. Keep iterating until you find a name that doesn't already exist in the `.changeset` directory.

#### Multiple packages example:

```markdown
---
'@sl-design-system/button': minor
'@sl-design-system/shared': patch
---

Add support for the invoker API in button components
```

### 6. Confirm with the User

After creating the changeset, show the user:

- Which packages are included
- The bump type for each
- The summary text

Prompt if they want to adjust anything (yes/no).

Wersje

RepozytoriumWynikLicencja
Ta strona · sl-design-system/components100Apache-2.0
withastro/astro100MIT
yamcodes/arkenv100MIT
ShepardVasNormandy/claude-skills100MIT
modem-dev/ossrules100MIT
tuanductran/hr-skills100MIT
stormix/transcripts-mcp100MIT
udecode/kitcn96Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 3014ad8b983e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100changesets
    Tworzy lub odświeża plik .changeset/<slug>.md dla bieżącej gałęzi albo stwierdza, że changeset nie jest wymagany, zwłaszcza przy zmianach w packages/**.
  • 100changeset-pr
    Tworzy lub poprawia plik .changeset/*.md dla bieżącej gałęzi lub PR, dobiera zakres pakietu i typ wydania oraz sprawdza wynik względem konfiguracji Changesets repozytorium.
  • 100add-changeset
    Pisze changeset dla agentic-seo-check jako plik, bez pytań interaktywnych, w stylu changelogu.
  • 100changeset-generator
    Generuje pliki changeset na podstawie zmian, na prośbę użytkownika albo na końcu implementacji funkcji, gdy trzeba domknąć i sfinalizować zmiany.
  • 100pr-changeset
    Tworzy changesety dla zmian w pakietach w pull requestach, bo bez nich pipeline wydania nie wie, co i jak wersjonować.
  • 100pr-changeset
    Tworzy changesety dla zmian w pakietach w PR, przy każdej modyfikacji plików w packages/*, żeby potok wydań wiedział, co się zmieniło i jak nadać wersję.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.