Agent skill

Changeset

by reactive in reactive/data-client

Create user-focused changesets (changelog entries) for semver bumps, release notes, breaking changes, and docs; prefer impact and code examples over implementation detail

Apache-2.0Auto-check passedDevelopment

Install Changeset

skills CLI
$ npx skills add reactive/data-client --skill changeset -a claude-code

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

GitHub CLI
$ gh skill install reactive/data-client changeset --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/reactive/data-client.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/changeset .claude/skills/changeset && 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
GitHub stars
2k
Token cost
~1.2k tokens
SKILL.md length
577 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Create user-focused changesets (changelog entries) for semver bumps, release notes, breaking changes, and docs; prefer impact and code examples over implementation detail

  • Works in 6 steps: Analyze changes → Determine affected packages → Run changesets → …
  • Tasks that involve Changelog and release notes
  • SKILL.md covers Overview, Steps, Writing perspective and Changeset body quality, plus 3 more sections
  • Calls yarn

What it does

Changeset is an agent skill from reactive/data-client. Create user-focused changesets (changelog entries) for semver bumps, release notes, breaking changes, and docs; prefer impact and code examples over implementation detail

Its SKILL.md is about 1.2k 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, covering Changelog and release notes. The repository describes itself as: Async State Management without the Management. REST, GraphQL, SSE, Websockets. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Changelog and release notes

Example prompts

  • “/changeset”

Workflow steps

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

  1. Analyze changes
  2. Determine affected packages
  3. Run changesets
  4. Update documentation
  5. Update release blog
  6. Update skills

What it can do on your machine

Read from SKILL.md and the folder at commit 6d35253. 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:

    • yarn

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

  • Network

    No URLs in SKILL.md. Its commands use yarn, 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 loads about 1.2k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 577 words of instructions outside code blocks.

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

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 reactive/data-client at commit 6d35253, republished under its Apache-2.0 licence (© reactive). 577 words, ~1,196 tokens.

Download SKILL.mdSave it as .claude/skills/changeset/SKILL.md (or your agent's skills folder).
name
changeset
description
Create user-focused changesets (changelog entries) for semver bumps, release notes, breaking changes, and docs; prefer impact and code examples over implementation detail
disable-model-invocation
true
metadata.internal
true

Create Changesets

Overview

Generate changesets, update documentation, draft blog entries, and update skills for user-facing changes.

Steps

  1. Analyze changes

    • Compare current branch to master to identify modified packages
    • Group changes by impact type (feature, fix, breaking)
    • Identify transitive dependencies that expose the change
    • Check for modified skills in .agents/skills/ and packages/*/.agents/skills/
  2. Determine affected packages

    • Include directly modified packages
    • Add transitive dependents when interfaces/behaviors are exposed:
      • @data-client/endpoint → also select @data-client/rest, @data-client/graphql
      • @data-client/core or @data-client/normalizr → also select @data-client/react, @data-client/vue
  3. Run changesets

    • Run yarn changeset once per distinct change
    • Select all affected packages (direct + transitive)
    • Choose appropriate version bump (patch/minor/major)
      • For packages under 1.0, use minor for breaking changes
    • When writing the markdown body, follow Changeset body quality below (user-visible outcome, code examples when helpful, no internal implementation narrative)
  4. Update documentation

    • Update primary docs in docs/ for any changed public APIs
    • Search for all usages of changed APIs across docs/, packages/*/README.md, and root README.md
    • Update all found references to reflect new behavior, signatures, or deprecations
    • For new exports: add to relevant API reference pages
  5. Update release blog

    • Find the latest draft blog post in website/blog/ (has draft: true in frontmatter)
    • Add the change following @website/blog/.cursor/rules/blog-posts.mdc:
      • Place in appropriate conceptual category section
      • Include code example if applicable
      • Link to PR/commit and relevant docs
      • For breaking changes: add to summary's Breaking Changes section with anchor link
  6. Update skills

    • If code changes affect workflows described in existing skills, update those skills to match
    • If new APIs or patterns are introduced that agents should know about, add them to the relevant skill
    • Skill changes don't need changesets — they are development tooling, not published packages

Writing perspective

All user-facing text (changesets, blog entries, docs) should be written from the library user's point of view. Answer: what did the user see go wrong, and what works for them now? Avoid internal names (conditional types, branch names, helper types like SoftPathArgs, file paths, PR numbers) unless the audience is maintainers reading a technical appendix — changeset bodies are for consumers reading the changelog.

Show full SKILL.md (239 more words)Show less

Changeset body quality

  1. Lead with impact — One short title line, then 1–3 sentences on behavior: errors gone, typings improved, new capability, migration note.
  2. User vocabulary — Name public APIs (RestEndpoint, resource(), hook names). Do not explain how the fix was implemented.
  3. When to add code — Prefer a minimal example when the change is TypeScript-only or subtle: show the pattern that was broken and now works (subclass, extend, option object). Skip examples for trivial renames or obvious one-line fixes.
  4. Examples — Realistic imports and types; omit unrelated options. For fixes, you can show one “now types correctly” snippet instead of a long before/after if the before state was “TypeScript error on …”.
  5. Breaking changes — Still say what the user must do; use Before/After sections with code when the migration is non-obvious. Before marking anything breaking, follow .cursor/rules/breaking-changes.mdc (ship a compatible version, recommend the future-proof form, track the cleanup).

Changeset format

  • First line: Action verb ("Add", "Fix", "Update", "Remove")
  • Breaking: Prefix with BREAKING CHANGE: or BREAKING:
  • Body: User outcome first; implementation almost never belongs here
  • New exports: Use "New exports:" with a bullet list

Code examples in changesets

  • Fixes: Optional // Before: / // After: comments in one block, or two small blocks — keep them copy-paste plausible
  • Breaking changes: Use #### Before and #### After headers with complete snippets
  • Multiple scenarios: Short intro line per scenario, or separate fenced blocks with a one-line label above each

Markdown Formatting

Follow @.cursor/rules/markdown-formatting.mdc for all markdown content.

© reactive, 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 of reactive/data-client.

Open the folder on GitHubat commit 6d35253

Compare with similar skills

Changeset 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Changeset this skillreactive/data-client2k—~1.2kAutomated safety check: PassApache-2.0
Simple Englishmoeru-ai/airi50k2 repos~4.6kAutomated safety check: PassMIT
StarRocks Release NotesStarRocks/starrocks12k—~1.9kAutomated safety check: NotesApache-2.0
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
React Router Release Notes Prepremix-run/react-router57k—~1.1kAutomated safety check: PassMIT
Mole CLI Release Flowtw93/Mole70k—~2.5kAutomated safety check: PassGPL-3.0

Similar skills

  • Simple English

    moeru-ai/airi

    Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.

    50k GitHub starsUsed in 2 repos~4.6k tokens
    DevelopmentAuto-check passed
  • StarRocks Release Notes

    StarRocks/starrocks

    Drafts English release notes for a StarRocks patch release from the PRs merged into its release branch, then opens a documentation PR and hands translation to /translate.

    12k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check: notes
  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed
  • React Router Release Notes Prep

    remix-run/react-router

    Polishes pending React Router change files before the versioning scripts run, and decides whether a long-form What's Changed section is warranted.

    57k GitHub stars~1.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Release

    PrefectHQ/fastmcp

    Cut a FastMCP release end to end. An agent skill from PrefectHQ/fastmcp.

    28k GitHub stars~2.9k tokensUpdated today
    DevelopmentAuto-check passed

More from reactive/data-client

All 17 skills in this repo
  • Data Client REST Setup

    reactive/data-client

    Set up and migrate to @data-client/rest for REST APIs. An agent skill from reactive/data-client.

    2k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Data Client Manager

    reactive/data-client

    Implement @data-client Managers for global/background side effects - websocket, SSE, polling, real-time updates, subscriptions, logging, analytics, metrics/timing, error reporting (Sentry), toast…

    2k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Data Client React

    reactive/data-client

    Use @data-client/react hooks for data fetching, mutations, and rendering - useSuspense, useFetch, useQuery, useCache, useLive, useDLE, useSubscription, useController, DataProvider, AsyncBoundary…

    2k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Data Client React Testing

    reactive/data-client

    Test @data-client/react with renderDataHook and mountDataClient - jest unit tests, fixtures, interceptors, MockResolver, mock responses, nock HTTP mocking, fake timers for polling/subscription…

    2k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Data Client REST

    reactive/data-client

    Define REST APIs with @data-client/rest - resource(), RestEndpoint, CRUD (GET/POST/PUT/PATCH/DELETE), HTTP fetch, normalize, cache, urlPrefix, path-to-regexp parameters, searchParams, pagination…

    2k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Data Client Schema

    reactive/data-client

    Model data with @data-client schemas (Entity, EntityMixin, Collection, Union, Query, Values, All, Invalidate, Lazy, Scalar) for atomic, consistent, referentially-equal async data via normalization…

    2k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Categories

Questions about Changeset

What does Changeset do?

Create user-focused changesets (changelog entries) for semver bumps, release notes, breaking changes, and docs; prefer impact and code examples over implementation detail. Changeset is an agent skill from reactive/data-client.

When should I use Changeset?

Changeset fits situations like: tasks that involve Changelog and release notes.

How do I install Changeset in Claude Code?

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

How do I install Changeset in Codex?

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

Can I use Changeset 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 reactive/data-client --skill changeset -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, .gemini/skills/changeset, .github/skills/changeset and .opencode/skills/changeset in your project.

What does Changeset need to run?

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

Does Changeset access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Changeset 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 use?

Changeset 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 use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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?

Skills that share tags, products or a category with Changeset: Simple English (moeru-ai/airi, 50k stars), StarRocks Release Notes (StarRocks/starrocks, 12k stars), Cutting A Release (TriliumNext/Trilium, 38k stars) and React Router Release Notes Prep (remix-run/react-router, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Changeset?

reactive (a GitHub organization) maintains it in reactive/data-client, which has 2,037 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 8, 2026.

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