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

minecraft-ci-release — скилл для Claude Code

Скилл minecraft-ci-release собирает CI и релизы для модов Minecraft и плагинов Paper: workflow, артефакты, версии, теги и GitHub Release.

MIT 238 установок ★ 211 обновлён 2026-10-30

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

Что делает minecraft-ci-release

Скилл берёт на себя обвязку вокруг сборки: файлы workflow, артефакты, версии, теги. Игровой код и администрирование сервера он не трогает — для этого в наборе есть другие скиллы. Границы прописаны в самом SKILL.md, поэтому агент не уедет в реализацию механик, если попросить его настроить пайплайн.

Внутри два готовых workflow. build.yml гоняет матрицу neoforge и fabric на Java 25 плюс отдельную задачу с тестами, release.yml срабатывает на теги v* и собирает GitHub Release с двумя jar-файлами. Экшены прибиты к конкретным SHA, чтобы плавающий тег вроде actions/[email protected] не подменили. Проектам на 1.21.x скилл оставляет Java 21 и их собственные конвенции Gradle.

Версия артефакта идёт как {mod_version}+{mc_version}, а тег — без суффикса игры: v1.2.3. Workflow обязан сверить их до сборки. Подставлять версию из тега нельзя: расхождение тогда просто исчезнет из глаз. Токены публикаторов в закоммиченные файлы не кладутся, а Modrinth с CurseForge подключаются только если проект уже туда публикуется.

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

  • Собрать матрицу NeoForge и Fabric в одном workflow
  • Привязать экшены к неизменяемым SHA вместо плавающих тегов
  • Сверить тег v1.2.3 с mod_version до запуска сборки
  • Оставить Java 25 для 26.x и не тащить её в проекты на 1.21.x
  • Отрезать публикацию в Modrinth и CurseForge, если проект туда не льёт

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

  • Собери build.yml для NeoForge и Fabric на Java 25, экшены привяжи к SHA
  • Проверь, что тег v1.2.3 совпадает с mod_version, и не подставляй версию из тега
  • Сделай релизный workflow по тегам v*, который создаёт только GitHub Release

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

1Через Skills CLI (Vercel)

npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-ci-release -a claude-code

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

~/.claude/skills/minecraft-ci-release/SKILL.md

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

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

Вопросы о minecraft-ci-release

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

Выполните npx skills add Jahrome907/minecraft-agent-skills --skill minecraft-ci-release -a claude-code. Файл скилла окажется в ~/.claude/skills/minecraft-ci-release/SKILL.md.

Что делает minecraft-ci-release?

Помогает агенту писать и проверять CI для модов Minecraft и плагинов Paper: матрица сборки, публикация артефактов, версии и теги, GitHub Release по тегу.

Какая версия Java нужна для Minecraft 26.x?

Для 26.x скилл берёт Java 25 и просит указывать её в названиях задач и примерах. Проекты на 1.21.x остаются на Java 21.

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

SKILL.md · MIT
---
name: minecraft-ci-release
description: "Set up and review CI, artifact publishing, versioning, and release management for Minecraft 26.x or legacy 1.21.x mods and Paper plugins. Use for pipelines and releases, not gameplay implementation or server operations."
---

# Minecraft CI / Release Skill

## Routing Boundaries
- `Use when`: the task is CI/CD pipelines, artifact publishing, versioning, or release management.
- `Do not use when`: the task is gameplay or plugin implementation (`minecraft-modding`, `minecraft-plugin-dev`, or `minecraft-datapack`).
- `Do not use when`: the task is server runtime operations or infrastructure tuning (`minecraft-server-admin`).

---

## Release setup

Keep each repository's existing release destinations and approval policy. A tag can
build an artifact and create a GitHub Release without publishing to Modrinth or
CurseForge. Add a publisher only when the project already uses it or the user asks
for it. Never add tokens to committed files.

For Minecraft 26.x, use Java 25 and state that in workflow labels
and examples. Legacy Minecraft 1.21.x projects stay on Java 21; retain their own
loader and Gradle conventions instead of mechanically changing their version.

Use an immutable GitHub Action revision in a protected workflow. The following refs
were verified from the upstream tags on 2026-10-29; refresh them from the upstream
tag before intentionally upgrading an action:

```text
actions/[email protected]             3d3c42e5aac5ba805825da76410c181273ba90b1
actions/[email protected]           dd06d9cba3e5552c54d9f8ea23572deb30010f7c
gradle/actions/[email protected]  9c971963bec38e04b3d30dcc455b5382be2fdbfb
actions/[email protected]      043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
softprops/[email protected]  efb35369e0ad2afab669f228072c1b0d510eae64
```

## Version and Tag Convention

When the project uses a Minecraft-version suffix, follow `{mod_version}+{mc_version}`:

```
1.0.0+26.3  ← mod 1.0.0 for MC 26.3
1.2.3+26.3
2.0.0+26.3
```

Use a release version without the game suffix for the Git tag, and retain the
Minecraft version in the artifact version when the project uses that convention:

```text
mod_version: 1.2.3
project/artifact version: 1.2.3+26.3
tag: v1.2.3
```

The release workflow must verify that `v1.2.3` matches `mod_version=1.2.3` before
building. Do not override `mod_version` from the tag, because that hides a mismatch.
The Gradle task and safe changelog extraction are in
[the publishing reference](references/publishing-gradle.md).

---

## Core CI Workflow (NeoForge + Fabric)

This is a Minecraft 26.x / Java 25 example. Its displayed check names are
`Build / Build (fabric)`, `Build / Build (neoforge)`, and `Build / Test` after
the test job below is added. After the first successful pull request, copy the
exact names GitHub displays into branch protection; workflow or job renames
change the required-check context.

### `.github/workflows/build.yml`
```yaml
name: Build

on:
  push:
    branches: ["main", "develop"]
  pull_request:
    branches: ["main"]

permissions:
  contents: read

jobs:
  build:
    name: Build (${{ matrix.platform }})
    runs-on: ubuntu-latest
    strategy:
      matrix:
        platform: [neoforge, fabric]
      fail-fast: false

    steps:
      - name: Checkout
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1

      - name: Set up Java 25
        uses: actions/setup-java@dd06d9cba3e5552c54d9f8ea23572deb30010f7c
        with:
          java-version: "25"
          distribution: "temurin"

      - name: Setup Gradle
        uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb
        with:
          cache-read-only: ${{ github.event_name == 'pull_request' }}

      - name: Grant execute permission for gradlew
        run: chmod +x gradlew

      - name: Build (${{ matrix.platform }})
        run: ./gradlew :${{ matrix.platform }}:build --no-daemon

      - name: Upload artifacts
        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
        with:
          name: mod-${{ matrix.platform }}-${{ github.sha }}
          path: ${{ matrix.platform }}/build/libs/*.jar
          if-no-files-found: error

  test:
    name: Test
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
      - name: Set up Java 25
        uses: actions/setup-java@dd06d9cba3e5552c54d9f8ea23572deb30010f7c
        with:
          distribution: temurin
          java-version: "25"
      - name: Set up Gradle
        uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb
      - name: Run tests
        run: ./gradlew test --no-daemon
```

---

## Tagged GitHub Release

### `.github/workflows/release.yml`
```yaml
name: Release

on:
  push:
    tags:
      - "v*"

permissions:
  contents: write      # for creating GitHub releases

jobs:
  release:
    name: Release
    runs-on: ubuntu-latest

    steps:
      - name: Checkout tagged source
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1

      - name: Set up Java 25
        uses: actions/setup-java@dd06d9cba3e5552c54d9f8ea23572deb30010f7c
        with:
          java-version: "25"
          distribution: "temurin"

      - name: Setup Gradle
        uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb

      - name: Grant execute permission for gradlew
        run: chmod +x gradlew

      - name: Validate tag and build
        env:
          MOD_VERSION: ${{ github.ref_name }}
        run: |
          MOD_VERSION="${MOD_VERSION#v}"
          ./gradlew verifyReleaseVersion build --no-daemon \
            -PreleaseModVersion="$MOD_VERSION"

      - name: Select release artifacts
        env:
          RELEASE_TAG: ${{ github.ref_name }}
        run: |
          mkdir -p release-artifacts
          shopt -s nullglob
          select_primary() {
            local loader="$1"; shift
            local matches=( "$@" )
            if (( ${#matches[@]} != 1 )); then
              printf 'Expected one %s primary JAR, found %s: %s\n' \
                "$loader" "${#matches[@]}" "${matches[*]:-none}" >&2
              exit 1
            fi
            cp "${matches[0]}" "release-artifacts/${loader}-${RELEASE_TAG}.jar"
          }
          select_primary fabric fabric/build/libs/*-fabric.jar
          select_primary neoforge neoforge/build/libs/*-neoforge.jar

      - name: Create GitHub Release
        uses: softprops/action-gh-release@efb35369e0ad2afab669f228072c1b0d510eae64
        with:
          files: |
            release-artifacts/fabric-${{ github.ref_name }}.jar
            release-artifacts/neoforge-${{ github.ref_name }}.jar
          fail_on_unmatched_files: true
          generate_release_notes: true
          prerelease: ${{ contains(github.ref_name, '-alpha') || contains(github.ref_name, '-beta') || contains(github.ref_name, '-rc') }}
```

This workflow creates a GitHub Release only. It expects one primary Fabric JAR and
one primary NeoForge JAR with loader-distinct names. Configure those classifiers in
the project build, then change both patterns together if its naming convention differs.
The selection step fails for zero or multiple matches and copies to distinct release
names, preventing accidental overwrite or a partial release. Add a project-specific
publisher after version validation only when that destination is in scope.

---

## Paper Plugin CI

### `.github/workflows/build.yml` (plugin)
```yaml
name: Build

on:
  push:
    branches: ["main"]
  pull_request:

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
      - uses: actions/setup-java@dd06d9cba3e5552c54d9f8ea23572deb30010f7c
        with:
          java-version: "25"
          distribution: "temurin"
      - uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb
      - run: chmod +x gradlew
      - run: ./gradlew build --no-daemon
      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a
        with:
          name: plugin-${{ github.sha }}
          path: build/libs/*.jar
          if-no-files-found: error

  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
      - uses: actions/setup-java@dd06d9cba3e5552c54d9f8ea23572deb30010f7c
        with:
          java-version: "25"
          distribution: "temurin"
      - uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb
      - run: ./gradlew test --no-daemon
```

---

## Publishing and Changelog Details

Read [the publishing reference](references/publishing-gradle.md) only when the
project publishes to Modrinth or CurseForge. It includes current plugin versions,
26.x `jar` selection, explicit legacy Loom `remapJar` guidance, version verification,
and a parser that fails when the expected changelog heading is missing.

---

## `gradle.properties` Secrets Pattern

Never hardcode tokens. Read them from environment:

```properties
# gradle.properties (committed)
mod_id=mymod
mod_version=1.0.0
minecraft_version=26.3
modrinth_project_id=AABBCCDD
curseforge_project_id=123456

# DO NOT commit tokens
# Set these as GitHub repo secrets:
# MODRINTH_TOKEN, CURSEFORGE_TOKEN
```

---

## Semantic Versioning for Mods

| Change | Version bump |
|--------|-------------|
| New features, no breaking changes | Minor: `1.1.0` |
| Bug fixes only | Patch: `1.0.1` |
| API/config breaking changes | Major: `2.0.0` |
| Minecraft version update | Follow the project's version policy, update the game suffix when used, and create a new release tag |
| Pre-release | `1.0.0-beta.1`, `1.0.0-rc.1` |

---

## CHANGELOG.md Convention

```markdown
# Changelog

## [1.1.0] — 2026-10-01
### Added
- New `/kit` command
- PDC-based kill tracker

### Fixed
- Death message not appearing on Paper 26.3

## [1.0.0] — 2026-09-01
### Added
- Initial release
```

The publishing reference extracts this section by `mod_version` and fails clearly
when the expected heading is missing.

---

## Dependabot Configuration

### `.github/dependabot.yml`
```yaml
version: 2
updates:
  - package-ecosystem: "gradle"
    directory: "/"
    schedule:
      interval: "weekly"
    groups:
      gradle-plugins:
        patterns:
          - "com.gradleup.shadow"
          - "dev.architectury.loom"
          - "com.modrinth.minotaur"
          - "net.darkhax.curseforgegradle"

  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
```

---

## Build Caching Best Practices

```yaml
# In all workflow jobs:
- name: Setup Gradle
  uses: gradle/actions/setup-gradle@9c971963bec38e04b3d30dcc455b5382be2fdbfb
  with:
    # Read-only cache on PRs, read-write on main
    cache-read-only: ${{ github.event_name == 'pull_request' }}
```

---

## Branch Protection + Required Checks

Recommended GitHub branch protection for `main`:
- Require the observed checks: `Build / Build (fabric)`, `Build / Build (neoforge)`, and `Build / Test`
- Require linear history (squash/rebase merges)
- Require signed commits (optional but recommended for release workflows)

---

## Tag and Release Script

```bash
#!/usr/bin/env bash
# scripts/release.sh <mod-version>
set -euo pipefail

VERSION="${1:?Usage: release.sh <mod-version>}"
REMOTE="${RELEASE_REMOTE:-origin}"
BRANCH="${RELEASE_BRANCH:-main}"
EXPECTED_REMOTE_URL="${RELEASE_REMOTE_URL:?Set RELEASE_REMOTE_URL to the expected push URL}"
git diff --check
[[ -z "$(git status --porcelain=v1 --untracked-files=all)" ]] \
  || { echo "Working tree contains staged, unstaged, or untracked files." >&2; exit 1; }
[[ "$(git branch --show-current)" == "$BRANCH" ]] \
  || { echo "Release must start from branch $BRANCH." >&2; exit 1; }
mapfile -t PUSH_URLS < <(git remote get-url --push --all "$REMOTE")
[[ ${#PUSH_URLS[@]} -eq 1 && "${PUSH_URLS[0]}" == "$EXPECTED_REMOTE_URL" ]] \
  || { echo "Remote $REMOTE must have one expected push URL." >&2; exit 1; }
! git rev-parse --verify --quiet "refs/tags/v${VERSION}" >/dev/null \
  || { echo "Local tag v${VERSION} already exists." >&2; exit 1; }
set +e
git ls-remote --exit-code --tags "$EXPECTED_REMOTE_URL" "refs/tags/v${VERSION}" >/dev/null
REMOTE_TAG_STATUS=$?
set -e
case "$REMOTE_TAG_STATUS" in
  0) echo "Remote tag v${VERSION} already exists." >&2; exit 1 ;;
  2) ;;
  *) echo "Could not verify remote tag v${VERSION}." >&2; exit "$REMOTE_TAG_STATUS" ;;
esac
./gradlew verifyReleaseVersion --no-daemon -PreleaseModVersion="$VERSION"
git tag --annotate "v${VERSION}" --message "Release v${VERSION}"
git push "$REMOTE" "HEAD:refs/heads/${BRANCH}"
git push "$REMOTE" "refs/tags/v${VERSION}"
```

Update and verify version/changelog files before this script, then tag that release
commit. Set `RELEASE_BRANCH`, `RELEASE_REMOTE`, and `RELEASE_REMOTE_URL` for the
intended release branch and exact push URL. Do not force-push or retag a published
release without explicit authorization.

## Workflow Snippet Validator

Run the bundled validator from an installed `minecraft-ci-release` skill directory:

```bash
# Run from the installed skill directory:
./scripts/validate-workflow-snippets.sh --root .

# Strict mode treats warnings as failures:
./scripts/validate-workflow-snippets.sh --root . --strict
```

The validator is bundled and self-contained. Run it from a copied `.agents/`,
`.codex/`, or `.claude/` `minecraft-ci-release` skill directory without relying
on repo-root `node_modules`.

It validates workflow-shaped YAML, unresolved placeholders, workflow secret
documentation, and remote `uses:` references pinned to full commit SHAs. Local
actions (`./...`) and Docker actions (`docker://...`) are intentionally excluded from
the SHA requirement. It reads only this skill's `SKILL.md`: it does not validate a
project's `.github/workflows` files or Gradle tasks. Before a real release, inspect
the project's generated artifacts, run `verifyReleaseVersion`, and review the exact
workflow diff and configured release destination.

---

## References

- [GitHub Actions secure use](https://docs.github.com/en/actions/reference/security/secure-use)
- [GitHub branch protection](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)
- [Minotaur](https://github.com/modrinth/minotaur)
- [CurseForgeGradle](https://github.com/Darkhax/CurseForgeGradle)

© Jahrome907 · MIT · Jahrome907/minecraft-agent-skills

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

Все скиллы по теме «DevOps и инфраструктура» →
release cyrusagents Скилл release на Claude Code проводит релиз Cyrus CLI через trusted-publishing: подготовка, проверка, публикация и финал. Выпускает версию без ручной работы с пакетами. CX Codex +1 870установок goal-release dyoshikawa Скилл goal-release для Claude Code и Codex ведёт релиз целиком: открывает PR, ждёт зелёный CI, мержит и обновляет формулу Homebrew. Версия выходит одной командой. CX Codex +1 ★ 1 636звёзд репо release-kotlin-library chrisbanes Скилл release-kotlin-library автоматизирует подготовку, проверку и публикацию релизов библиотек на Kotlin. Помогает сверить список изменений, обновить снимки Metalava API и безопасно запустить публикацию. CX Codex +1 559установок minecraft-bukkit-pro Seth Hobson Субагент minecraft-bukkit-pro для Claude Code, Codex и Cursor. Разрабатывает серверные плагины Minecraft на Bukkit, Spigot и Paper: события, команды, GUI, оптимизация производительности. CX Codex ★ 42 780звёзд репо create-simulated-aeronautics-mod reason-machines Скилл create-simulated-aeronautics-mod для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode с экспертизой в Create Simulated — моде NeoForge, добавляющем в Minecraft физичные конструкции (самолёты, дирижабли, машины). CX Codex +1 398установок run-release alirezarezvani Команда run-release для Claude Code запускает workflow релиза по семантическому тегу версии. Автоматизирует создание аннотированного тега, черновика релиза и запрашивает одобрение перед публикацией. CX Codex +1 ★ 907звёзд репо

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

Весь набор →
minecraft-server-admin Скилл minecraft-server-admin для Claude Code ведёт Java-серверы Minecraft: Paper, Purpur, Folia, Velocity, Fabric и NeoForge. Разбирает падение TPS, отказ прокси и ошибки запуска версии. CX Codex +1 279установок minecraft-world-generation Скилл minecraft-world-generation для Claude Code помогает создавать и отлаживать генерацию мира Minecraft в датапаках и модах NeoForge или Fabric. Он подключается к задачам с биомами, измерениями, структурами и регистрацией worldgen-данных. CX Codex +1 269установок minecraft-plugin-dev Скилл minecraft-plugin-dev помогает создавать, менять и отлаживать серверные плагины для Paper и Bukkit-производных серверов. Пригодится при работе с JavaPlugin, событиями и командами. CX Codex +1 267установок minecraft-multiloader Скилл minecraft-multiloader настраивает моды Minecraft на базе Architectury для версий 26.x и 1.21.x с общей кодовой базой под NeoForge и Fabric. Включается при одновременной поддержке обоих загрузчиков. CX Codex +1 247установок minecraft-commands-scripting Скилл minecraft-commands-scripting генерирует и отлаживает команды Minecraft Java 26.x и 1.21.x, цепочки execute, скорборды и RCON-скрипты. Работает со строками команд без сборки структуры датапаков. CX Codex +1 241установок minecraft-imagegen Скилл minecraft-imagegen создаёт и редактирует растровые изображения для Minecraft: иконки паков, баннеры, текстурные концепты и макеты интерфейса. CX Codex +1 213установок minecraft-worldedit-ops Скилл minecraft-worldedit-ops задаёт безопасный порядок команд WorldEdit для Minecraft 26.x и 1.21.x: выделений, масок, схематики, кистей и рельефа. Разводит выделение, замену и вставку с предпросмотром и бэкапами. CX Codex +1 201установок minecraft-essentials-ops Скилл minecraft-essentials-ops помогает настраивать плагин EssentialsX на серверах Paper и Spigot для Minecraft 26.x и 1.21.x, от экономики до прав игроков. CX Codex +1 185установок

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

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