# Changeset > Create a changeset entry to document a version bump and changelog for the current changes Use when this capability is needed. - Skill: `tomevault-io/changeset-5` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/changeset-5` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/changeset-5/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/changeset-5 --- Create a changeset entry for the current branch's changes. ## Instructions 1. Run `git diff main...HEAD --stat` and `git log main..HEAD --oneline` to understand what changed on this branch. 2. If no argument was provided, analyze the changes to determine: - **Bump type**: `patch` for fixes, `minor` for new features, `major` for breaking changes - **Summary**: A concise description of the change for the changelog 3. If `$ARGUMENTS` was provided, parse it as `[bump] [description]` (e.g., `minor Add changeset-based release workflow`). 4. Create a new markdown file in `.changeset/` with a random lowercase-kebab-case name (e.g., `.changeset/cool-birds-fly.md`) using this exact format: ``` --- "@alchemy/mcp-server": --- ``` Where `` is `patch`, `minor`, or `major` and `` is the changelog entry. 5. Show the user the created changeset file and ask if they'd like to adjust anything. --- > Source: [alchemyplatform/alchemy-mcp-server](https://github.com/alchemyplatform/alchemy-mcp-server) — distributed by [TomeVault](https://tomevault.io).