Skip to content
Skills Library
DevOps & cloud · Automation

release

/release

Release procedure for agent-skills-vrc-udon: sync main into dev, bump the five version fields, open and merge the release PR, rewrite the Release Drafter notes, and publish to npm. Use when asked to cut, prepare, or publish a release, to bump the version, or to sync main into dev. Maintainer-only; not distributed.

Licence
MIT
Last repository change
11.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
2
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 2 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/bump-version.sh, scripts/sync-main-into-dev.sh

What it does and when to use it

Release procedure for agent-skills-vrc-udon: sync main into dev, bump the five version fields, open and merge the release PR, rewrite the Release Drafter notes, and publish to npm. Use when asked to cut, prepare, or publish a release, to bump the version, or to sync main into dev. Maintainer-only; not distributed.

Original author description

Release procedure for agent-skills-vrc-udon: sync main into dev, bump the five version fields, open and merge the release PR, rewrite the Release Drafter notes, and publish to npm. Use when asked to cut, prepare, or publish a release, to bump the version, or to sync main into dev. Maintainer-only; not distributed.

How it works

  1. Step 1: Synchronize main into dev when needed
  2. Step 2: Bump the version fields on dev
  3. Step 3: Create the release PR from dev to main
  4. Step 4: Merge the release PR
  5. Step 5: Publish the GitHub Release draft
  6. Version resolution (label-driven)
  7. What NOT to do
Original SKILL.md headings · 119 lines, 1,024 words
SKILL.md preview
---
name: release
description: >-
    Release procedure for agent-skills-vrc-udon: sync main into dev, bump the five version fields,
    open and merge the release PR, rewrite the Release Drafter notes, and publish to npm. Use when
    asked to cut, prepare, or publish a release, to bump the version, or to sync main into dev.
    Maintainer-only; not distributed.
metadata:
    internal: true
---

# Release

```
main ──sync PR──> dev (when the ancestry check fails)
dev ──version-bump PR──> dev ──release PR──> main ──Release Drafter draft──> publish ──> npm
```

GitHub Release notes are drafted by Release Drafter, and GitHub Releases are the canonical release history. `CHANGELOG.md` is a historical archive through v1.2.0; later releases are not backfilled.

Version numbers must be bumped by hand on `dev` before the release PR is opened (Step 2). `publish.yml` does run `npm version "$VERSION" --no-git-tag-version` in the CI runner as a safety net, but those edits are not committed back, so the git tree has to be kept current by hand.

## Step 1: Synchronize `main` into `dev` when needed

```bash
bash .claude/skills/release/scripts/sync-main-into-dev.sh
```

The script fetches both branches and checks that `dev` contains the current `main` history. If it does not, it opens a sync PR from a new `chore/sync-main-into-dev-<timestamp>` branch, waits for the seven required checks (Symlink Integrity, Hook Scripts, Documentation Smoke Tests, Markdown Links, npm Pack Test, EditorConfig, Version Sync), merges with a merge commit, and repeats the ancestry check. Do not continue until that final check succeeds.

## Step 2: Bump the version fields on `dev`

Decide the target version vX.Y.Z from the labels on the PRs merged into `dev` since the last release (see [Version resolution](#version-resolution-label-driven)). From this point until the release PR is merged, merge nothing else into `dev`. If another PR does land, resolve the version again before continuing. Then:

```bash
set -e   # stop at the first failing command
git checkout dev && git pull
git checkout -b chore/release-vX.Y.Z

bash .claude/skills/release/scripts/bump-version.sh X.Y.Z

git commit -am "chore(version): bump to vX.Y.Z"
git push -u origin chore/release-vX.Y.Z
gh pr create --base dev --label "release: maintenance" \
  --title "chore(version): bump to vX.Y.Z" \
  --body "Pre-release version bump for Step 3 of the release flow."
```

The script moves these five fields together and stops unless exactly those five lines changed:

- `package.json` → `.version`
- `.claude-plugin/marketplace.json` → `.metadata.version`
- `skills/unity-vrc-udon-sharp/SKILL.md` → frontmatter `metadata.version`
- `skills/unity-vrc-world-sdk-3/SKILL.md` → frontmatter `metadata.version`
- `.claude/skills/unity-vrc-skills-renovator/SKILL.md` → frontmatter `metadata.version`

Wait for all seven required CI checks. Version Sync verifies that the five fields agree. Merge the bump PR into `dev` (squash is fine here; it is a single-purpose commit). CodeRabbit review is optional on this PR.

## Step 3: Create the release PR from `dev` to `main`

```bash
gh pr create --base main --head dev \
  --title "Release vX.Y.Z" \
  --body "Merge dev into main for release"
```

The title must include the version that matches `package.json#version` on `dev` after Step 2. The body can follow `.github/PULL_REQUEST_TEMPLATE/release.md`. Wait for CI to pass. CodeRabbit approval is not required for release PRs: they are mechanical merges of commits that were already reviewed.

## Step 4: Merge the release PR

Merge with a merge commit. Do NOT squash: Release Drafter needs each underlying PR commit. The merge triggers Release Drafter to update the draft release on `main`.

## Step 5: Publish the GitHub Release draft

```bash
# List draft releases
gh release list --exclude-drafts=false

# Rewrite the auto-generated notes, then publish
gh release edit vX.Y.Z --notes "$(cat <<'NOTES'
## What's New in vX.Y.Z
...

## vX.Y.Z の変更点
...
NOTES
)"

# Publishing triggers publish.yml → npm publish
gh release edit vX.Y.Z --draft=false
```

Always rewrite the notes before publishing:

- Remove the "Release vX.Y.Z (#N)" self-reference line.
- Replace bare PR titles with user-facing prose.
- Use a bilingual structure: English release notes first, then a Japanese version of the same user-facing content.
- Add a contributor acknowledgement section when a bundled PR closed an externally reported Issue. Name the Issue number and the reporter, keep it respectful, and mirror the reporter's language when possible.

The `published` event triggers `publish.yml`, which validates the tag, runs `npm version "$VERSION" --allow-same-version` (a no-op when Step 2 was done), syncs `SKILL.md` and `marketplace.json` again as a safety net, and runs `npm publish`. It authenticates with npm trusted publishing (OIDC) instead of a stored token, runs in the `npm-publish` environment, and npm adds provenance automatically.

If the Publish step fails with an authentication error (`ENEEDAUTH`, `E401`, or `E404` on `PUT`), check the trusted publisher on npmjs.com (package Settings, Trusted Publisher). Every field is case-sensitive and npm does not validate them on save: user `niaka3dayo`, repository `agent-skills-vrc-udon`, workflow filename `publish.yml`, environment `npm-publish`, and `npm publish` allowed (not only `npm stage publish`). Also confirm the job still has `id-token: write` and the workflow still uses Node 24 or later (npm 11.5.1 or later). After correcting the configuration, re-run the failed Publish job from the Actions tab; do not create a second release.

A newly created trusted publisher expires unless the first publish succeeds within two days, so create or recreate one right before a release, not in advance.

Afterwards, `npm view agent-skills-vrc-udon version` should return the new version.

## Version resolution (label-driven)

Count the labels on the PRs merged into `dev` since the last release:

| Label | Bump |
|-------|------|
| `release: breaking` | major |
| `release: feature` | minor |
| `release: fix` | patch |
| `release: docs` | patch |
| `release: maintenance` | patch |

The highest bump wins. If no label matches, default to **patch**. Release Drafter resolves the same labels for the draft body, so the draft and `package.json` agree as long as the manual bump matches.

## What NOT to do

- Do NOT skip Step 2. `publish.yml` changes the version only inside the runner and does not commit it back, so a missed bump leaves the git tree frozen. Version Sync passes when all five fields agree on the wrong value; this drifted for five release cycles before it was caught (PR #169).
- Do NOT create tags manually. Release Drafter creates the tag when the release is published.
- Do NOT delete a release or a tag. Published versions may be referenced by tag (`git clone --branch vX.Y.Z`), and deleting a tag breaks every user who pinned it (Issue #290).
- Do NOT push directly to `dev` or `main`. Branch protection blocks it; use the PR flows above.
- Do NOT merge feature branches directly to `main`. Always go through `dev`.
Files in this package (3)
  • SKILL.md 7 KB
  • scripts/bump-version.sh 2 KB
  • scripts/sync-main-into-dev.sh 2 KB

Versions

RepositoryScoreLicence
This page · niaka3dayo/agent-skills-vrc-udon100MIT
josephfung/curia100MIT
max-sixty/worktrunk100MIT
gtapps/hermitd100MIT
gtapps/hermitd100MIT
anthony-chaudhary/fak100Apache-2.0
tractorjuice/arc-kit100MIT
drvoss/everything-copilot-cli100MIT
sma1lboy/rove100MIT

Database snapshot: 13.11.2026 · package version 82823bdbd588 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100publish
    Prepare a version bump through a feature branch and pull request; merging to main auto-tags and publishes the release. Triggers on 'publish', 'release', 'bump version'.
  • 100publish-npm-version
    Cuts the next minor release of Prisma Next: bumps the root package.json version, propagates it to every workspace package, and opens a PR titled "chore(release): bump to <next-version>". When the maintainer merges the PR, the `Publish to npm` workflow runs automatically and…
  • 100publish
    Publish the Octop Python package: cut a release branch from develop, bump version, update CHANGELOG, open a PR to main; after merge, Actions tag on main (PyPI / Docker Hub + GHCR) and sync main into develop. Use when the user asks to publish, release, bump version, cut a release, or run /publish.
  • 100nf-core-pipeline-release
    Run the full nf-core pipeline release procedure: pre-release checks, version bump, release lint, CHANGELOG finalisation, dev→main release PR, the GitHub release, and the post-release bump back to the next dev version. Use when releasing or preparing to release a pipeline version.
  • 91nacl-tl-release
    Full release pipeline: merge verified PRs to main, wait for production CI, health check, version bump, git tag, changelog, GitHub release, YouGile notification. Use when: create release, bump version, merge and release, generate release notes, tag version, or the user says "/nacl-tl-release".
  • 100nvidia-nemoclaw-maintainer-cut-release-tag
    Cut a new semver release — bump all version strings via bump-version.ts, open a release PR, and after merge tag main and push. Use when cutting a release, tagging a version, shipping a build, or preparing a deployment. Trigger keywords - cut tag, release tag, new tag, cut…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.