Agent skill

Changeset Resolve

by udecode in udecode/kitcn

Repair an unreleased .changeset/.md file so it matches the real branch delta against main.

Apache-2.0Auto-check passedDevelopment

Install Changeset Resolve

skills CLI
$ npx skills add udecode/kitcn --skill changeset-resolve -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install udecode/kitcn changeset-resolve --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/udecode/kitcn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/changeset-resolve .claude/skills/changeset-resolve && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
changeset-resolve
GitHub stars
450
Token cost
~922 tokens
SKILL.md length
352 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
Apache-2.0

At a glance

Repair an unreleased .changeset/.md file so it matches the real branch delta against main.

  • Works in 7 steps: Resolve the active changeset → Audit the real branch delta against main → Audit the likely-missed public seams → …
  • A changeset was edited iteratively during debugging
  • SKILL.md covers Goal, Hard Rules, Mandatory Sequence and Sanity Heuristics, plus 1 more section
  • Calls git and bun

What it does

Changeset Resolve is an agent skill from udecode/kitcn. Repair an unreleased .changeset/.md file so it matches the real branch delta against main. Use when a changeset was edited iteratively during debugging, when bullets may reflect turn-by-turn history instead of main...HEAD, when "removed/gone/renamed" claims need proof, or when you need to audit whether a changeset is actually lossless before commit.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: Convex + Better Auth + tRPC + Drizzle + TanStack Query + shadcn. The licence is Apache-2.0.

When your agent uses it

  • A changeset was edited iteratively during debugging
  • Bullets may reflect turn-by-turn history instead of main...HEAD
  • Removed/gone/renamed claims need proof
  • You need to audit whether a changeset is actually lossless before commit

Example prompts

  • “removed/gone/renamed”
  • “/changeset-resolve”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Resolve the active changeset
  2. Audit the real branch delta against main
  3. Audit the likely-missed public seams
  4. Prove every breaking bullet
  5. Classify honestly
  6. Rewrite from scratch
  7. Run one final anti-lie pass

What it can do on your machine

Read from SKILL.md and the folder at commit c6010f5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • bun

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Changeset Resolve loads about 922 tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 352 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~922

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from udecode/kitcn at commit c6010f5, republished under its Apache-2.0 licence (© udecode). 352 words, ~922 tokens.

Download SKILL.mdSave it as .claude/skills/changeset-resolve/SKILL.md (or your agent's skills folder).
name
changeset-resolve
description
Repair an unreleased `.changeset/*.md` file so it matches the real branch delta against `main`. Use when a changeset was edited iteratively during debugging, when bullets may reflect turn-by-turn history instead of `main...HEAD`, when "removed/gone/renamed" claims need proof, or when you need to audit whether a changeset is actually lossless before commit.

Changeset Resolve

Use the companion changeset skill for structure and versioning. This skill owns the diff audit and the bullshit detector pass.

Goal

Rewrite the active unreleased changeset so it describes the package-level, user-facing branch delta against main, not the local iteration history.

Hard Rules

  • Diff against main...HEAD. Never diff against the current changeset draft.
  • Reuse the existing unreleased changeset file. Do not create another one.
  • Keep the release surface package-first:
    • packages/kitcn
    • packages/resend
    • root and example manifests/scripts when user-facing
    • docs only when they reveal public API shape
  • Ignore repo noise unless it changes real user behavior:
    • .claude
    • .agents
    • tests
    • internal tooling churn
  • If a bullet says something is gone, removed, renamed, or replaced, prove the old surface existed on main first.
  • If it did not exist on main, it is not a breaking change. Rewrite it as a feature or delete it.
  • Do not call a changeset lossless unless you actually audited the package surface. If unsure, say so.
Show full SKILL.md (193 more words)Show less

Mandatory Sequence

  1. Resolve the active changeset:

    • list .changeset/*.md excluding .changeset/README.md
    • reuse the existing unreleased file
  2. Audit the real branch delta against main:

bash
git diff --stat main...HEAD -- packages/kitcn packages/resend package.json example/package.json www/content/docs
git diff --name-only main...HEAD -- packages/kitcn packages/resend package.json example/package.json www/content/docs
git diff main...HEAD -- packages/kitcn/package.json packages/resend/package.json package.json example/package.json
  1. Audit the likely-missed public seams:

    • package exports
    • package bin
    • package files
    • peer dependency/support matrix
    • new packages
    • public CLI commands and flags
  2. Prove every breaking bullet:

bash
git show main:packages/kitcn/package.json
git show main:packages/kitcn/src/cli/config.ts
git grep -n "claim-you-are-making" main -- packages/kitcn packages/resend www/content/docs example
  1. Classify honestly:

    • existed on main and changed incompatibly: ## Breaking changes
    • new user-facing capability: ## Features
    • same surface, better behavior or safer output: ## Patches
    • test-only, docs-only, or internal churn: omit
  2. Rewrite from scratch:

    • keep ## Breaking changes, ## Features, ## Patches
    • user-facing only
    • no file paths
    • no implementation gossip
  3. Run one final anti-lie pass:

    • re-check every breaking snippet against main and HEAD
    • scan manifests/exports one more time
    • if something still smells off, say it is not fully lossless yet

Sanity Heuristics

  • New command on this branch only: feature, not deprecation.
  • New package on this branch only: feature.
  • Tightened peer dependency support matrix: usually breaking.
  • Moved import paths with old path removed: breaking.
  • Renamed flag with old flag removed: breaking.
  • Scenario/fixture proof improvements: patch only if users feel it.
  • Docs sync alone: omit unless it reveals a real new surface.

Exit Gate

Before done, run:

bash
bun lint:fix

© udecode, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/changeset-resolve of udecode/kitcn.

Open the folder on GitHubat commit c6010f5

Compare with similar skills

Changeset Resolve next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Changeset Resolve compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Changeset Resolve this skilludecode/kitcn450—~922Automated safety check: PassApache-2.0
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k24 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 24 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Guidelines

    akash-network/node

    Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.

    1.1k GitHub starsUsed in 22 repos~577 tokens
    DevelopmentAuto-check passed

More from udecode/kitcn

All 33 skills in this repo
  • Walkthrough

    udecode/kitcn

    Create a short annotated visual walkthrough from real final-state screenshots or rendered artifacts.

    450 GitHub stars~1.6k tokensUpdated 6 days ago
    Auto-check passed
  • Avoid Feature Creep

    udecode/kitcn

    Prevent feature creep when building software, apps, and AI-powered products.

    450 GitHub stars~2.7k tokensUpdated 6 days ago
    Auto-check passed
  • Audit newer Convex npm releases against kitcn. An agent skill from udecode/kitcn.

    450 GitHub stars~1.8k tokensUpdated 6 days ago
    Auto-check passed
  • Jotai X

    udecode/kitcn

    A skill your agent uses when working with Jotai X stores (createAtomStore), accessing state in components or callbacks, persisting state to cookies or localStorage

    450 GitHub stars~3.7k tokensUpdated 6 days ago
    Auto-check passed
  • Linear Backlog

    udecode/kitcn

    Run a scoped Linear backlog autonomously as a sequence of maximal safe parallel batches by composing orchestrator, autogoal, and task.

    450 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check passed
  • Nextjs

    udecode/kitcn

    Next.js routing with typed routes, PageProps, LayoutProps helpers, and nuqs for URL state.

    450 GitHub stars~1.4k tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Changeset Resolve

What does Changeset Resolve do?

Repair an unreleased .changeset/.md file so it matches the real branch delta against main. Changeset Resolve is an agent skill from udecode/kitcn.md file so it matches the real branch delta against main.

When should I use Changeset Resolve?

Changeset Resolve fits situations like: A changeset was edited iteratively during debugging; bullets may reflect turn-by-turn history instead of main...HEAD; removed/gone/renamed claims need proof; you need to audit whether a changeset is actually lossless before commit.

How do I install Changeset Resolve in Claude Code?

Run `npx skills add udecode/kitcn --skill changeset-resolve -a claude-code`. Or copy the skill folder (.agents/skills/changeset-resolve in udecode/kitcn) into .claude/skills/changeset-resolve in your project. Claude Code loads it when a task matches its description.

How do I install Changeset Resolve in Codex?

Run `npx skills add udecode/kitcn --skill changeset-resolve -a codex`. Or copy the skill folder (.agents/skills/changeset-resolve in udecode/kitcn) into .agents/skills/changeset-resolve in your project. Codex loads it when a task matches its description.

Can I use Changeset Resolve in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add udecode/kitcn --skill changeset-resolve -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/changeset-resolve, .gemini/skills/changeset-resolve, .github/skills/changeset-resolve and .opencode/skills/changeset-resolve in your project.

What does Changeset Resolve need to run?

Going by SKILL.md and its folder, Changeset Resolve needs the command-line tools its instructions call (git and bun).

Does Changeset Resolve access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Changeset Resolve safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Changeset Resolve use?

Changeset Resolve is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Changeset Resolve use?

About 922 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Changeset Resolve?

Skills that share tags, products or a category with Changeset Resolve: Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars) and Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Changeset Resolve?

udecode (a GitHub organization) maintains it in udecode/kitcn, which has 450 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 1, 2026.

Source: udecode/kitcn on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.