К основному содержанию
скилл CX Codex

changesets — скилл для Claude Code: версии и установка

Скилл changesets помогает вести версии и changelog пакетов в монорепозитории. Он пригодится для согласованных релизов и публикации пакетов в npm.

MIT 154 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill changesets -a claude-code
Открыть на GitHub

Что делает changesets

Участники добавляют файлы изменений в .changeset/: в них перечисляют затронутые пакеты, тип повышения версии и краткое описание для changelog. Команда version учитывает накопленные файлы, обновляет версии и changelog, а также диапазоны внутренних зависимостей.

Команда publish отправляет обновлённые пакеты в npm и создаёт Git-теги. Её нужно запускать сразу после version, без промежуточных коммитов. Скилл также описывает prerelease- и snapshot-релизы; для публикации нужен npm.

Какие задачи решает

  • зафиксировать затронутые пакеты и тип повышения версии
  • собрать changelog по файлам изменений
  • обновить версии пакетов и внутренних зависимостей
  • опубликовать пакеты в npm с Git-тегами

Примеры запросов агенту

  • Подготовь файл изменения для пакета pkg-a с повышением patch и кратким описанием.
  • Обнови версии пакетов и changelog по накопленным файлам в .changeset/.
  • Опубликуй обновлённые пакеты в npm после обновления версий.

Как установить changesets

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill changesets -a claude-code

2Вручную: положить файлы

~/.claude/skills/changesets/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/changesets/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о changesets

Как установить changesets в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill changesets -a claude-code. Файл скилла находится по пути ~/.claude/skills/changesets/SKILL.md.

Что делает скилл changesets?

Он помогает собирать файлы изменений, обновлять версии и changelog пакетов монорепозитория, а затем публиковать их в npm.

Нужно ли запускать publish сразу после version?

Да. Между version и publish не должно быть коммитов.

Исходный текст

SKILL.md · MIT
---
name: changesets
description: 'Changesets for versioning and changelog management in monorepos. Use when managing package versions, generating changelogs, or publishing packages. Use for changesets, versioning, changelog, semver, monorepo-versioning, release, publish, bump.'
license: MIT
metadata:
  author: oakoss
  version: '1.2'
  source: 'https://github.com/changesets/changesets'
user-invocable: false
---

# Changesets

## Overview

Changesets is a versioning and changelog management tool focused on multi-package repositories. Contributors declare the semver impact of each change (major/minor/patch) via changeset files, then Changesets aggregates them to bump versions, update changelogs, and publish packages in a single coordinated release.

**When to use:** Monorepo versioning, automated changelog generation, coordinated multi-package releases, CI-driven publishing, prerelease/snapshot workflows.

**When NOT to use:** Single-file projects with no npm publishing, projects using commit-message-based versioning (semantic-release), manual version management without an npm registry, projects where a single maintainer controls all releases without PR collaboration.

### How It Works

1. A contributor adds a changeset file declaring affected packages, bump types, and a summary
2. The changeset file is committed alongside the code change in the PR
3. When ready to release, `changeset version` consumes all pending changesets and updates versions and changelogs
4. `changeset publish` publishes the updated packages to npm and creates git tags
5. In CI, the official GitHub Action automates steps 3-4 via an auto-maintained "Version Packages" PR

## Key Concepts

- **Changeset file** — A markdown file in `.changeset/` declaring which packages are affected, their bump type (major/minor/patch), and a human-readable summary that appears in the changelog
- **Version command** — Consumes all pending changeset files, calculates final version bumps, updates `package.json` versions, generates `CHANGELOG.md` entries, and bumps internal dependency ranges
- **Publish command** — Publishes updated packages to npm and creates git tags; must run immediately after `version` with no commits in between
- **Linked packages** — Packages that share the highest bump type within a release but maintain independent version numbers
- **Fixed packages** — Packages that always share the exact same version number across the group
- **Prerelease mode** — A mode where `version` produces prerelease versions (e.g., `1.0.0-beta.0`) for testing before stable release
- **Snapshot releases** — Temporary `0.0.0-timestamp` versions for ad-hoc testing without affecting the main release line

## Configuration Quick Reference

| Option                       | Default                         | Description                                                   |
| ---------------------------- | ------------------------------- | ------------------------------------------------------------- |
| `changelog`                  | `"@changesets/cli/changelog"`   | Changelog generator package or `false` to disable             |
| `commit`                     | `false`                         | Auto-commit on `version` and `add` commands                   |
| `access`                     | `"restricted"`                  | npm publish access; set `"public"` for public scoped packages |
| `baseBranch`                 | `"main"`                        | Branch used for change detection                              |
| `linked`                     | `[]`                            | Groups of packages that share highest bump type               |
| `fixed`                      | `[]`                            | Groups of packages that share exact version                   |
| `ignore`                     | `[]`                            | Packages excluded from changeset versioning                   |
| `updateInternalDependencies` | `"patch"`                       | When to bump dependents: `"patch"` or `"minor"`               |
| `privatePackages`            | `{ version: true, tag: false }` | Version/tag behavior for `"private": true` packages           |

## Quick Reference

| Pattern             | Command / Config                                        | Key Points                                                   |
| ------------------- | ------------------------------------------------------- | ------------------------------------------------------------ |
| Initialize          | `npx @changesets/cli init`                              | Creates `.changeset/` folder with config                     |
| Add changeset       | `npx @changesets/cli add`                               | Interactive prompt for packages and bump type                |
| Add empty changeset | `npx @changesets/cli add --empty`                       | Declares no packages need versioning (satisfies CI)          |
| Version packages    | `npx @changesets/cli version`                           | Consumes changesets, bumps versions, updates changelogs      |
| Publish packages    | `npx @changesets/cli publish`                           | Publishes to npm, creates git tags                           |
| Check status        | `npx @changesets/cli status`                            | Lists pending changesets; exits 1 if changes lack changesets |
| Status since branch | `npx @changesets/cli status --since=main`               | Only checks changes since diverging from main                |
| Enter prerelease    | `npx @changesets/cli pre enter <tag>`                   | Enables prerelease mode (beta, alpha, rc, next)              |
| Exit prerelease     | `npx @changesets/cli pre exit`                          | Returns to normal versioning mode                            |
| Snapshot version    | `npx @changesets/cli version --snapshot`                | Creates 0.0.0-timestamp versions for testing                 |
| Snapshot publish    | `npx @changesets/cli publish --tag canary --no-git-tag` | Publishes snapshot without overwriting latest dist-tag       |
| Link packages       | `"linked": [["pkg-a", "pkg-b"]]` in config              | Packages share the highest version bump type                 |
| Fix packages        | `"fixed": [["pkg-*"]]` in config                        | Packages share the exact same version number                 |
| Ignore packages     | `"ignore": ["pkg-internal"]` in config                  | Excludes packages from changeset versioning                  |
| Public access       | `"access": "public"` in config                          | Required for publishing public scoped packages               |
| GitHub changelog    | `"changelog": ["@changesets/changelog-github", ...]`    | Adds PR links and contributor attribution                    |
| Auto-commit         | `"commit": true` in config                              | Version and add commands auto-commit changes                 |
| Internal deps       | `"updateInternalDependencies": "patch"` in config       | Controls when internal dependents get bumped                 |

## Common Mistakes

| Mistake                                                | Correct Pattern                                                           |
| ------------------------------------------------------ | ------------------------------------------------------------------------- |
| Committing between `version` and `publish`             | Run `publish` immediately after `version` with no commits in between      |
| Forgetting `--empty` for PRs with no package changes   | Use `npx @changesets/cli add --empty` to satisfy CI checks                |
| Using `linked` when packages must share exact versions | Use `fixed` for identical versions; `linked` only shares bump magnitude   |
| Setting `access: "restricted"` for public packages     | Set `access: "public"` in config for public npm packages                  |
| Not including `fetch-depth: 0` in CI checkout          | Full git history is needed for changeset detection                        |
| Running `publish` without building first               | Always run build step before `changeset publish`                          |
| Entering prerelease mode on main branch                | Use a dedicated branch for prereleases to avoid blocking normal releases  |
| Ignoring packages that others depend on                | Ignored packages skip bumps, breaking dependents — use sparingly          |
| Publishing snapshots with default tag                  | Always use `--tag` flag to avoid overwriting `latest` dist-tag            |
| Not setting `NPM_TOKEN` in CI environment              | Both `GITHUB_TOKEN` and `NPM_TOKEN` are required for automated publishing |
| Using `changeset publish` in CI without the action     | The official `changesets/action` handles the two-mode workflow correctly  |
| Manually editing generated `CHANGELOG.md`              | Edit changeset files instead; changelogs are regenerated on `version`     |

## Delegation

- **CI pipeline debugging**: Use `Explore` agent for repository-specific workflow discovery
- **npm publishing issues**: Use `Task` agent for debugging publish and registry authentication failures

> If the `turborepo` skill is available, delegate build orchestration, task caching, and CI optimization to it.
> If the `pnpm-workspace` skill is available, delegate workspace setup, dependency linking, catalogs, and Docker deployment to it. See its monorepo integration reference for the end-to-end release pipeline.

## References

- [Basic workflow: adding changesets, versioning, publishing, CI integration](references/basic-workflow.md)
- [Monorepo setup: configuration, linked packages, fixed versioning, ignore patterns](references/monorepo-setup.md)
- [CI automation: GitHub Actions, automated PRs, snapshot releases, prerelease channels](references/ci-automation.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
scaffold-cli mblode Скилл scaffold-cli для Claude Code создаёт каркас TypeScript CLI и npm-пакета. Запускается по просьбе начать CLI или новый npm-пакет. CX Codex +1 784установок autoship vercel-labs Скилл autoship для Claude Code, Codex, Cursor, GitHub Copilot и Gemini CLI, который берёт на себя весь цикл changeset-релиза. Анализирует коммиты, генерирует описание изменений через AI и публикует пакет в npm без ручных шагов. CX Codex +1 747установок release-automation-builder patricio0312rev Скилл release-automation-builder для Claude Code настраивает автоматические релизы и публикацию пакетов. Запускается по запросам о версиях, журнале изменений или выпуске пакета. CX Codex +1 265установок monorepo-navigator Alireza Rezvani Скилл monorepo-navigator для Claude Code, который добавляет агенту понимание структуры монорепозитория: Turborepo, Nx, pnpm workspaces и Lerna. CX Codex +1 591установок monorepo-management curiositech Скилл monorepo-management помогает спроектировать workspace для JavaScript и TypeScript, настроить задачи Turborepo или Nx и разобраться с зависимостями пакетов. Пригодится при создании монорепозитория или переносе проекта. CX Codex +1 147установок npm-git-install akillness Скилл npm-git-install для Claude Code выбирает безопасный способ поставить Node-пакет из ветки, коммита, форка или приватного репозитория. Закрывает выбор между Git-мостом, tarball и публикацией в реестр. CX Codex +1 351установок

Из того же набора106

Весь набор →
zustand Скилл помогает настроить Zustand v5 в React: от типизированных хранилищ и middleware до SSR, тестов и миграции с Redux или Context. CX Codex +1 158установок tanstack-start По TanStack Start описывает серверные функции, SSR со стримингом, middleware и деплой. CX Codex +1 156установок pglite Скилл по PGlite: подсказывает агенту, как поднять сборку PostgreSQL 17.4 на WASM в браузере или Node.js, выбрать хранилище и настроить live-запросы. CX Codex +1 156установок tanstack-table Настраивает headless-таблицы TanStack Table v8 в React: серверная пагинация, фильтры и сортировка без циклических ререндеров. CX Codex +1 155установок opentofu Помогает писать и проверять конфигурации OpenTofu и Pulumi. Помогает управлять инфраструктурой, состоянием и окружениями из кода. CX Codex +1 153установок arktype-validation Скилл arktype-validation для Claude Code описывает схемы ArkType строками в синтаксисе TypeScript, включая морфы и рантайм-валидацию данных и переменных окружения через ArkEnv. CX Codex +1 153установок tanstack-router Скилл tanstack-router настраивает типобезопасную файловую маршрутизацию в React через @tanstack/react-router. Помогает с лоадерами данных, валидацией параметров поиска и разделением кода. CX Codex +1 150установок api-testing Скилл api-testing для Claude Code помогает писать интеграционные тесты REST API и проверять ответы эндпоинтов. Включается при настройке HTTP-моков или тестировании ошибок. CX Codex +1 149установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой