Official agent skill

Changeset

by withastro in withastro/astro

Create a changeset for the Astro monorepo. An agent skill from withastro/astro.

OfficialCustom licenceAuto-check passedDevelopment

Install Changeset

skills CLI
$ npx skills add withastro/astro --skill changeset -a claude-code

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

GitHub CLI
$ gh skill install withastro/astro 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/withastro/astro.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
63k
Token cost
~1.1k tokens
SKILL.md length
359 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

Create a changeset for the Astro monorepo. An agent skill from withastro/astro.

  • You need to add a changeset file to a PR
  • SKILL.md covers Creating the File, Format and Writing the Message
  • Calls pnpm
  • Write a changelog entry

What it does

Changeset is an agent skill from withastro/astro, published by the product's own GitHub organization. Create a changeset for the Astro monorepo. Use this skill whenever you need to add a changeset file to a PR, write a changelog entry, or document a package version bump. Also trigger when the user says "add a changeset", "write a changeset", "create a changeset", or when another skill instructs you to create a changeset.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/evals.json`).

It sits in Development, covering Static sites and blogs, Monorepo tooling and Changelog and release notes. It works with Astro. The repository describes itself as: The web framework for content-driven websites.

When your agent uses it

  • You need to add a changeset file to a PR
  • Write a changelog entry
  • Document a package version bump
  • The user says add a changeset

Example prompts

  • “add a changeset”
  • “write a changeset”
  • “create a changeset”
  • “/changeset”

What it can do on your machine

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

    • pnpm

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

  • Network

    Links to these hosts (documentation or services it may open):

    • contribute.docs.astro.build

    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.1k tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 359 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 359 words (~1,112 tokens).

“Create changeset files for the Astro monorepo. Changesets declare which packages changed, the semver bump type, and a user-facing message that becomes the CHANGELOG entry.”

— opening of SKILL.md by withastro, Custom licence
name
changeset

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in .agents/skills/changeset of withastro/astro.

  • SKILL.md
  • evals/evals.json

Open the folder on GitHubat commit 1f891d8

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 skillwithastro/astro63k—~1.1kAutomated safety check: PassCustom licence
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
Fern Navigationai-dynamo/dynamo8.2k—~2.2kAutomated safety check: PassApache-2.0
Create Manifestmindfold-ai/Trellis15k—~2.5kAutomated safety check: PassAGPL-3.0
Bumpy Add Changezap-studio/monorepo1721 repos~1.4kAutomated safety check: NotesMIT
Releasehyhmrright/brooks-lint1.5k—~1.2kAutomated safety check: PassMIT

Similar skills

  • 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
  • Fern Navigation

    ai-dynamo/dynamo

    Knowledge of Fern's site-level navigation and structure configuration — how a docs site is organized in docs.yml (and product/version .yml files) using sections, pages, folders, tabs, tab variants…

    8.2k GitHub stars~2.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Create Manifest

    mindfold-ai/Trellis

    Create a Trellis migration manifest and matching docs-site changelogs for a target release by analyzing commits since the previous release.

    15k GitHub stars~2.5k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Bumpy Add Change

    zap-studio/monorepo

    Create a bumpy bump file describing which packages changed and how, for version bumping and changelog generation.

    172 GitHub starsUsed in 1 repo~1.4k tokens
    DevelopmentAuto-check: notes
  • Release

    hyhmrright/brooks-lint

    Cut a brooks-lint release: set the version in package.json, propagate it across all four plugin manifests and every version-bearing text file (README badges, docs site metadata), write the CHANGELOG…

    1.5k GitHub stars~1.2k tokensUpdated 2 days ago
    DevelopmentAuto-check passed
  • Changesets Pull Request to Main

    breaking-brake/cc-wf-studio

    Opens a pull request to main in a pnpm and Changesets monorepo, after working out which packages changed and making sure a changeset file exists.

    5.4k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from withastro/astro

All 10 skills in this repo
  • Official

    Analyze recent GitHub Actions workflow runs to identify patterns, mistakes, and improvements.

    63k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Astro Developer

    withastro/astro

    Official

    Comprehensive guide for developing in the Astro monorepo. An agent skill from withastro/astro.

    63k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Astro PR Writer

    withastro/astro

    Official

    Write and update Astro pull requests with reviewer-friendly titles and high-signal bodies.

    63k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Writing Comments

    withastro/astro

    Official

    How to write JSDoc (/ /) and inline (//) comments in the Astro codebase, for contributors reading the source — not end users.

    63k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Astro Code Review

    withastro/astro

    Official

    Perform a static, read-only code review of an Astro pull request or of a local branch, commit range, diff, patch, or working tree being prepared as a pull request.

    63k GitHub stars~7.6k tokensUpdated today
    Auto-check passed
  • Official

    Takes a bug report for the triagebot-action GitHub Action through reproduction, root-cause diagnosis, an intended-behavior check and a fix attempt.

    63k GitHub stars~639 tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Changeset

What does Changeset do?

Create a changeset for the Astro monorepo. An agent skill from withastro/astro. Changeset is an agent skill from withastro/astro, published by the product's own GitHub organization. Create a changeset for the Astro monorepo.

When should I use Changeset?

Changeset fits situations like: you need to add a changeset file to a PR; write a changelog entry; document a package version bump; the user says add a changeset.

How do I install Changeset in Claude Code?

Run `npx skills add withastro/astro --skill changeset -a claude-code`. Or copy the skill folder (.agents/skills/changeset in withastro/astro) 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 withastro/astro --skill changeset -a codex`. Or copy the skill folder (.agents/skills/changeset in withastro/astro) 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 withastro/astro --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 (pnpm).

Does Changeset access the network?

SKILL.md names 1 domain. As links in the text: contribute.docs.astro.build. 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 has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Changeset use?

About 1.1k tokens (SKILL.md is roughly 4.4k 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: Cutting A Release (TriliumNext/Trilium, 38k stars), Fern Navigation (ai-dynamo/dynamo, 8.2k stars), Create Manifest (mindfold-ai/Trellis, 15k stars) and Bumpy Add Change (zap-studio/monorepo, 172 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Changeset?

withastro (a GitHub organization, an official publisher) maintains it in withastro/astro, which has 63,085 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 7, 2026.

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