К основному содержанию
скилл CX Codex

release-management — скилл для Claude Code: как установить

Скилл release-management выпускает релизы на GitHub через gh release: подбирает версию по semver и собирает заметки из смёрдженных PR. Пригодится при тегировании и публикации changelog.

MIT 220 установок ★ 305 обновлён 2026-11-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yonatangross/orchestkit --skill release-management -a claude-code
Открыть на GitHub

Что делает release-management

Скилл ведёт релиз на GitHub через gh release. Он выбирает следующую версию вида MAJOR.MINOR.PATCH, собирает заметки из смёрдженных PR и создаёт релиз. Релиз можно сделать черновиком (--draft) или пререлизом (--prerelease). Заметки генерируются автоматически, а свои передаются через --notes или --notes-file, например из RELEASE_NOTES.md.

Перед началом агент заводит задачи через TaskCreate: одну основную и три этапа. Это версия с changelog, создание релиза, проверка с анонсом. Этапы идут по очереди. Длинные инструкции лежат в references/: порядок обычного и hotfix-релиза, шаблоны changelog, workflow для GitHub Actions по тегу, скрипт повышения версии. Агент читает эти файлы только по необходимости.

Без gh CLI скилл не заработает, а для Claude Code заявлена версия 2.1.277+. Команда gh release verify проверяет аттестацию релиза и требует gh CLI 2.86.0+. Теги скилл советует ставить только на main, никогда на ветки фич.

Какие задачи решает

  • собрать заметки релиза из смёрдженных PR
  • выбрать следующую версию: patch, minor или major
  • выпустить бета-версию как пререлиз
  • создать черновик и проверить заметки до публикации
  • прикрепить к релизу архивы сборки

Примеры запросов агенту

  • Создай черновик релиза v1.2.0 с заметками из смёрдженных PR
  • Выпусти v1.2.0-beta.1 как пререлиз через gh release create
  • Подбери следующую версию по semver и прикрепи к релизу ./dist/app.zip

Как установить release-management

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill release-management -a claude-code

2Вручную: положить файлы

~/.claude/skills/release-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/release-management/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о release-management

Как установить release-management в Claude Code?

Выполните npx skills add yonatangross/orchestkit --skill release-management -a claude-code. Файл скилла будет лежать в ~/.claude/skills/release-management/SKILL.md.

Что делает release-management?

Создаёт релизы на GitHub через gh release: определяет версию по semver, генерирует заметки из PR, умеет черновики и пререлизы. Ещё он загружает файлы в релиз и проверяет его аттестацию.

Что нужно для работы release-management?

Установленный gh CLI и Claude Code версии 2.1.277+. Для gh release verify нужен gh CLI 2.86.0+.

Исходный текст

SKILL.md · MIT
---
name: release-management
license: MIT
compatibility: "Claude Code 2.1.277+. Requires gh CLI."
description: "Automates GitHub releases with semantic versioning, changelog generation from merged PRs, and gh CLI integration. Supports draft, prerelease, and standard release workflows with task-tracked multi-phase execution. Use when creating releases, tagging versions, or publishing changelogs."
context: inherit
user-invocable: false
disable-model-invocation: true
effort: low
model: haiku
metadata:
  archive-candidate: "pending an outside usage signal"
  category: document-asset-creation
  version: "1.0.0"
  author: "OrchestKit"
  complexity: "low"
  tags: "git, github, releases, versioning, changelog, automation"
allowed-tools: "Read Glob Grep Bash Write Edit TaskCreate TaskUpdate TaskList"
---

# Release Management

Automate releases with `gh release`, semantic versioning, and changelog generation.

> **CC ≥ 2.1.118 (M122):** `claude plugin tag <version>` validates the plugin manifest hierarchy (marketplace.json, plugin.json, package.json, version.txt) before tagging. Runs `--dry-run` in CI before release-please opens its release PR; catches manifest drift early. See `src/skills/chain-patterns/references/plugin-tag.md`.

## CRITICAL: Task Management is MANDATORY (CC 2.1.16)

**BEFORE doing ANYTHING else, create tasks to track progress:**

```python
# 1. Create main task IMMEDIATELY
TaskCreate(
  subject="Release: {version}",
  description="Creating release with semantic versioning and changelog",
  activeForm="Releasing {version}"
)

# 2. Create subtasks for each release phase
TaskCreate(subject="Version & changelog", activeForm="Determining version and generating changelog")
TaskCreate(subject="Create release", activeForm="Creating GitHub release")
TaskCreate(subject="Verify & announce", activeForm="Verifying release and announcing")

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])

# 4. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done
```

## Quick Reference

### Create Release

```bash
# Auto-generate notes from PRs
gh release create v1.2.0 --generate-notes

# With custom title
gh release create v1.2.0 --title "Version 1.2.0: Performance Update" --generate-notes

# Draft release (review before publishing)
gh release create v1.2.0 --draft --generate-notes

# Pre-release (beta, rc)
gh release create v1.2.0-beta.1 --prerelease --generate-notes

# With custom notes
gh release create v1.2.0 --notes "## Highlights
- New auth system
- 50% faster search"

# From notes file
gh release create v1.2.0 --notes-file RELEASE_NOTES.md
```

### List & View Releases

```bash
# List all releases
gh release list

# View specific release
gh release view v1.2.0

# View in browser
gh release view v1.2.0 --web

# JSON output
gh release list --json tagName,publishedAt,isPrerelease
```

### Verify Releases (gh CLI 2.86.0+)

```bash
# Verify release attestation (sigstore)
gh release verify v1.2.0

# Verify specific asset
gh release verify-asset v1.2.0 ./dist/app.zip

# Verify with custom trust policy
gh release verify v1.2.0 --owner myorg
```

### Manage Releases

```bash
# Edit release
gh release edit v1.2.0 --title "New Title" --notes "Updated notes"

# Delete release
gh release delete v1.2.0

# Upload assets
gh release upload v1.2.0 ./dist/app.zip ./dist/app.tar.gz
```

---

## Semantic Versioning

```text
MAJOR.MINOR.PATCH
  │     │     │
  │     │     └── Bug fixes (backwards compatible)
  │     └──────── New features (backwards compatible)
  └────────────── Breaking changes

Examples:
  1.0.0 → 1.0.1  (patch: bug fix)
  1.0.1 → 1.1.0  (minor: new feature)
  1.1.0 → 2.0.0  (major: breaking change)

Pre-release:
  2.0.0-alpha.1  (early testing)
  2.0.0-beta.1   (feature complete)
  2.0.0-rc.1     (release candidate)
```

---

## Release Workflows

Standard and hotfix release procedures using git tags and `gh release`.

Load Read("references/release-workflows.md") for step-by-step standard and hotfix release workflows.

---

## Changelog Generation

Auto-generated from PRs, custom `.github/release.yml` templates, and manual CHANGELOG.md format.

Load Read("references/changelog-generation.md") for changelog template examples and Keep-a-Changelog format.

---

## Release Automation & Checklist

GitHub Actions workflow for tag-triggered releases, version bumping script, and pre/post-release checklist.

Load Read("references/release-automation.md") for CI workflow, bump script, and release checklist.

---

## Best Practices

1. **Use semantic versioning** - Communicate change impact
2. **Draft releases first** - Review notes before publishing
3. **Generate notes from PRs** - Accurate, automatic history
4. **Close milestone on release** - Track completion
5. **Tag main only** - Never tag feature branches
6. **Announce breaking changes** - Prominent in release notes

## Related Skills

- `ork:github-operations`: Milestones, issues, and CLI reference
- `ork:github-operations`: Branch management and git operations

## References

Load on demand with `Read("references/<file>")`:

| File | Content |
|------|---------|
| `semver.md` | Semantic versioning rules and decision tree |
| `release-workflows.md` | Standard and hotfix release procedures |
| `changelog-generation.md` | Auto-generated, template, and manual changelog formats |
| `release-automation.md` | GitHub Actions workflow, bump script, and checklist |

© OrchestKit · MIT · yonatangross/orchestkit

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
update-infos-release FlorianBruniaux Команда update-infos-release для Claude Code синхронизирует данные о новых версиях инструмента по файлам гайда, лендинга и MCP-сервера. Шаг смены версии самого руководства опционален. CX Codex +1 ★ 6 529звёзд репо release-skills JimLiu Автоматизирует подготовку релизов, анализ коммитов и обновление версий в проектах на Node.js, Python или Rust. Сгенерирует ченджлог и создаст GitHub Release. CX Codex +1 26 100установок github-release официальный github Скилл github-release проводит релиз библиотеки в GitHub-репозитории: анализирует изменения, предлагает версию SemVer, готовит changelog и PR. CX Codex +1 741установок github-release-management ruvnet Скилл github-release-management для Claude Code координирует подготовку и выпуск GitHub-релизов. Он подключается к задачам с версиями, тестированием, публикацией и откатом. CX Codex +1 1 200установок release toss Скилл release автоматизирует подготовку релизов: сверяет ветку, обновляет версии в файлах, собирает чейнджлог через GitHub CLI и ставит тег. CX Codex +1 208установок release-manager rohitg00 Плагин release-manager для Claude Code, который автоматизирует процессы релизов и управление версиями по правилам Semantic Versioning. Помогает при публикации обновлений в репозитории. ★ 2 858звёзд репо

Из того же набора86

Весь набор →
storybook-testing Скилл storybook-testing для Claude Code помогает настраивать тестирование компонентов в Storybook 10. Он подключается при написании историй, настройке визуальных проверок и переносе проекта со Storybook 9. CX Codex +1 224установок explore Скилл explore для Claude Code запускает 3–5 агентов, чтобы исследовать структуру кода, потоки данных, архитектурные паттерны и здоровье проекта. Разбирает незнакомую кодовую базу и её архитектуру. CX Codex +1 224установок errors Скилл errors разбирает ошибки сессий Claude Code, группирует их по типам и ищет повторяющиеся случаи. Он подключается к задаче после сбоя команды, сети или инструмента. CX Codex +1 223установок issue-progress-tracking Скилл issue-progress-tracking регламентирует ведение задач на GitHub через утилиту gh CLI: переводит статусы, создаёт ветки под задачу, фиксирует прогресс и привязывает pull request. CX Codex +1 221установок llm-integration Скилл llm-integration для Claude Code содержит 20 правил для интеграции LLM: строгий вызов функций, SSE-стриминг, запуск в Ollama и дообучение LoRA. CX Codex +1 218установок fix-issue Скилл fix-issue разбирает GitHub issue, ищет корневую причину, вносит исправление с тестами и создаёт PR со ссылкой на issue. CX Codex +1 217установок review-pr Скилл review-pr для Claude Code проверяет pull request, ветку или диапазон diff с помощью параллельных агентов. Перед слиянием он выдаёт вердикт approve или request-changes. CX Codex +1 217установок i18n-date-patterns Скилл i18n-date-patterns для Claude Code задаёт агенту правила переводов и локального форматирования в React: языков, дат, валют и сложных форм множественного числа. CX Codex +1 216установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой