# Create Changeset

> Create changesets for the ledger-live monorepo using @changesets/cli. Use when the user asks to add a changeset, prepare a release, or document package changes for a PR.

- Skill: `ledgerhq/create-changeset` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ledgerhq/create-changeset`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ledgerhq/create-changeset/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ledgerhq (https://skillmd.com/u/ledgerhq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ledgerhq/create-changeset

---


# Create Changeset

Create a `.changeset/<adjective-noun-verb>.md` file (human-readable random identifier, matching `@changesets/cli` convention) with this format:

```markdown
---
"package-name": minor
---

Short description of the change
```

## Package Names

Package names **must match exactly** what's in each `package.json`:

| App / Lib | Package name |
|-----------|-------------|
| Mobile app | `live-mobile` |
| Desktop app | `ledger-live-desktop` |
| Common lib | `@ledgerhq/live-common` |
| Coin modules | `@ledgerhq/coin-<name>` (e.g. `@ledgerhq/coin-sui`) |
| Other libs | Check the lib's `package.json` `name` field |

## Impact Levels

| Level | When to use |
|-------|-------------|
| `minor` | New features, bug fixes, non-breaking changes |
| `major` | Breaking changes (rare, requires discussion) |
| `patch` | Internal-only changes, dependency bumps |

## Description

- One line, concise but descriptive
- Format: `<verb> <what>` or conventional commit style
- Examples:
  - `Add portfolio analytics dashboard with performance metrics`
  - `Fix transaction signing issue on mobile`
  - `Flush mobile content card click analytics before opening links`

