Przejdź do treści
Biblioteka skilli
DevOps i chmura · Automatyzacja

release

/release

Wydaje claudish-to-english: wybiera wersję, przenosi Unreleased do changeloga, otwiera PR i tworzy release na GitHubie.

Licencja
MIT
Ostatnia zmiana repozytorium
09.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
2
Przestarzałość

Brak sygnałów. Repozytorium zmienione 09.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wydaje claudish-to-english: wybiera wersję, przenosi Unreleased do changeloga, otwiera PR i tworzy release na GitHubie.

Wyzwalacze z opisu

## [Unreleased]
Oryginalny opis (EN)

Cut a claudish-to-english release — pick the version, move the CHANGELOG's Unreleased section under it, bump plugin.json, open the release PR, then tag the merge commit and create the GitHub release. Use when asked to cut, ship, or publish a release, bump the version, or when changes are sitting under "## [Unreleased]" and need releasing.

Jak działa

  1. Phase 1 — prepare
  2. Phase 2 — after the merge
  3. Notes
Sekcje z nagłówków SKILL.md, w oryginale · 157 linii, 831 słów
Podgląd SKILL.md
---
name: release
description: Cut a claudish-to-english release — pick the version, move the CHANGELOG's Unreleased section under it, bump plugin.json, open the release PR, then tag the merge commit and create the GitHub release. Use when asked to cut, ship, or publish a release, bump the version, or when changes are sitting under "## [Unreleased]" and need releasing.
---

# Cut a release

Two phases. **Phase 1** prepares the release and opens a PR. Then you STOP: the
maintainer reviews and merges. **Phase 2** tags and publishes, and can only run
after the merge because the tag must point at the merge commit.

If `$1` is a version (`0.9.0`, `v0.9.0` — strip any leading `v`), use it. If not,
derive it and confirm before writing anything.

## Phase 1 — prepare

### 1. Check the ground

```bash
git switch main && git pull --ff-only
git status --short
jq -r .version .claude-plugin/plugin.json
sed -n '1,40p' CHANGELOG.md
```

Stop and report if: the tree is dirty, `main` is not current, or `CHANGELOG.md`
has no `## [Unreleased]` section with real entries under it. An empty Unreleased
section means there is nothing to release — say so rather than cutting an empty
version.

### 2. Pick the version

SemVer at `0.x`, based on what is actually under `## [Unreleased]`:

- **MINOR** (`0.8.0` → `0.9.0`) if there is anything under `### Added`, or a
  `### Changed` entry that alters behaviour users rely on. New style preset, new
  provider, new env var.
- **PATCH** (`0.8.0` → `0.8.1`) only if every entry is under `### Fixed`.

Never hide a feature in a patch. State the version and the reason in one line
before proceeding.

### 3. Edit the two files

Only these two carry a version. `marketplace.json` does not pin one — leave it.

**`CHANGELOG.md`** — three edits:

1. `## [Unreleased]` → `## [<version>] - <today, YYYY-MM-DD>`.
   Get today's date with `date +%F`; do not guess it.
2. Add a comparison link ref in the block at the bottom, directly above the
   previous version's line:
   `[<version>]: https://github.com/gvzdv/claudish-to-english/compare/v<previous>...v<version>`
3. Repoint the Unreleased ref:
   `[Unreleased]: https://github.com/gvzdv/claudish-to-english/compare/v<version>...HEAD`

Leave the `[Unreleased]` *ref* in place but do **not** re-add an empty
`## [Unreleased]` heading — this repo adds that heading only when there is
something to put under it.

While you are in the file, tidy the prose of the entries if they read like PR
descriptions rather than changelog entries, but do not change their meaning or
drop anything.

**`.claude-plugin/plugin.json`** — bump `"version"`. Edit the string in place so
key order and formatting survive; do not round-trip the file through a JSON
serialiser.

### 4. Verify before committing

```bash
jq empty .claude-plugin/plugin.json && jq -r .version .claude-plugin/plugin.json
for f in *.sh; do bash -n "$f" || echo "FAIL $f"; done
```

Then confirm every `## [x]` heading has a matching `[x]:` ref and there are no
orphans:

```bash
python3 - <<'PY'
import re, io
s = io.open('CHANGELOG.md', encoding='utf-8').read()
heads = re.findall(r'^## \[([^\]]+)\]', s, re.M)
refs  = re.findall(r'^\[([^\]]+)\]:', s, re.M)
print("headings without a ref:", [h for h in heads if h not in refs] or "none")
print("orphaned refs:", [r for r in refs if r not in heads and r != 'Unreleased'] or "none")
PY
```

`jq -r .version` must equal the new heading. Show the full `git diff` — it should
touch exactly two files.

### 5. Branch, commit, PR

```bash
git switch -c release/<version> origin/main
git commit -am "chore: v<version> — <one-line summary of what ships>"
git push -u origin release/<version>
gh pr create --base main \
  --title "chore: v<version> — <summary>" \
  --body-file <a file you write>
```

The PR body should state why MINOR or PATCH, list the two changed files, and
summarise what the release ships (drawn from the changelog section).

### 6. Stop

Report the PR URL and say the tag comes after the merge, since it must point at
the merge commit. **Do not merge the PR yourself** unless the maintainer
explicitly asks.

## Phase 2 — after the merge

Only once the release PR is merged.

```bash
git switch main && git pull --ff-only
git log --oneline -3
```

Identify the **merge commit** (`Merge pull request #N from gvzdv/release/<version>`).
Tag that, *not* the `chore:` bump commit — tagging the bump leaves the release
branch's commits dangling inside `compare/v<version>...HEAD` next cycle.

```bash
git tag v<version> <merge-commit-sha>
git push origin v<version>
```

Verify the tag lands on the right tree before moving on:

```bash
git log -1 --format='%h %s' v<version>
git show v<version>:.claude-plugin/plugin.json | jq -r .version   # == <version>
```

Then create the GitHub release, with notes taken from the CHANGELOG section
rather than auto-generated — the hand-written entries are the point:

```bash
gh release create v<version> \
  --title "v<version> — <summary>" \
  --notes-file <the extracted CHANGELOG section>
```

Extract the section by slicing from `## [<version>]` to the next `## [` line.

Report the tag and release URLs.

## Notes

- Tags here are **lightweight** and sit at the release merge commit. `v0.3.0` is
  the exception (it predates the convention and sits on a bump commit); do not
  "fix" it.
- Tags for `v0.4.0`–`v0.7.1` were backfilled, so those releases have tags but no
  GitHub release objects. That is expected; do not backfill releases unless
  asked.
- If a tag already exists for the target version, stop and report it. Never
  force-move a published tag.

Wersje

RepozytoriumWynikLicencja
Ta strona · gvzdv/claudish-to-english100MIT
josephfung/curia100MIT
max-sixty/worktrunk100MIT
gtapps/hermitd100MIT
gtapps/hermitd100MIT
anthony-chaudhary/fak100Apache-2.0
tractorjuice/arc-kit100MIT
drvoss/everything-copilot-cli100MIT
sma1lboy/rove100MIT

Migawka bazy z 13.11.2026 · wersja paczki 1e7458e41c37 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100cut-release
    Przygotowuje wydanie pięciu pakietów npm i pakietu Flutter: propozycja wersji z Unreleased, równoległe podbicie wersji, PR wydania, a po scaleniu GitHub release uruchamiający publikację, tylko po wyraźnym potwierdzeniu.
  • 100releasing
    Prowadzi pełny cykl wydania: podniesienie wersji, CHANGELOG, rozbudowane notatki do wydania, tag i publikację.
  • 100release-plugin
    Wydaje to repozytorium: dobiera wzrost wersji ze zmian, aktualizuje changelog i stopkę canvasu, taguje i publikuje wydanie na GitHub.
  • 100nvidia-nemoclaw-maintainer-cut-release-tag
    Wydaje nową wersję semver: podbija numery wersji skryptem bump-version.ts, otwiera pull request wydania, a po scaleniu taguje main i wypycha tag.
  • 100ship-release
    Wydaje nową wersję projektu: podbija manifesty, aktualizuje CHANGELOG, taguje, tworzy release na GitHub i publikuje na npm.
  • 100release-this
    Obsługuje pełne wydanie wtyczki powerball-harness: build, walidację, podniesienie wersji, CHANGELOG, tag i GitHub Release.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.