# itch-publish

Скилл проводит сборку игры до страницы на itch.io: butler push в нужный канал, версии, обновление только изменённых файлов. Пригодится, когда пора выложить демо или релиз.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 5700 установок · ★ 4506
- Автор: gamedev-skills
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/workflows/itch-publish/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/itch-publish

## Что делает

Скилл ведёт от папки со сборкой до живой страницы на itch.io. Страницу создают в браузере на `itch.io/game/new`, а загрузка идёт через `butler` — консольную утилиту itch.io. Команда одна: `butler push <папка> <user>/<game>:<channel>`. Первый пуш отправляет всё целиком, следующие передают только различия с прошлой сборкой.

Имя канала задаёт тег платформы. Если внутри есть `win` или `windows`, ставится Windows; `osx` или `mac` дают macOS, `linux` и `android` работают по той же схеме. Тега для архитектуры процессора нет, поэтому при нескольких сборках канал называют руками вроде `windows-arm64`. Версию задают явно через `--userversion 1.2.0` или `--userversion-file build.txt`, а `butler push-preview` покажет, что изменится, ещё до отправки.

Главное, что стоит проверить заранее: пушить нужно папку с готовыми к запуску файлами, а не установщик и не сжатый архив. itch.io считает патчи по файлам, и оба варианта превращают каждое обновление в многомегабайтную передачу. Для браузерной игры нужен `index.html` в корне и лимиты площадки: до 1,000 файлов, 500 МБ в распакованном виде, 200 МБ на файл. Тип страницы HTML и тег «playable in browser» ставятся вручную после первого пуша.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill itch-publish -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/itch-publish/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/itch-publish/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill itch-publish -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/itch-publish/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill itch-publish -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/itch-publish/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gamedev-skills/awesome-gamedev-agent-skills itch-publish
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/itch-publish/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill itch-publish -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/gamedev-skills/awesome-gamedev-agent-skills --path skills/workflows/itch-publish
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/itch-publish/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill itch-publish -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/workflows/itch-publish/SKILL.md

## Когда брать
- создать страницу игры и залить первую сборку на itch.io
- разложить Windows, macOS и Linux по каналам с верными тегами
- обновить только изменившиеся файлы вместо перезаливки всего билда
- посмотреть, что изменится в сборке, до отправки
- выпустить демо для гейм-джема, не показывая канал раньше времени

## Примеры запросов агенту
- Залей `./build/windows` в канал `windows` для `leafy/my-game` через `butler push`.
- Прогони `butler push-preview` для `./build` и скажи, какие файлы уйдут в канал `linux`.
- Браузерная сборка открывается пустой страницей на itch.io — проверь `index.html` в корне и тип страницы.

## Похожие
- [roblox-publish-checklist](https://affpapa.org/nevibecode/skills/roblox-publish-checklist.md) — скилл · 1900 установок
- [container-publish](https://affpapa.org/nevibecode/skills/container-publish.md) — скилл · 2800 установок
- [godot-export-builds](https://affpapa.org/nevibecode/skills/godot-export-builds.md) — скилл · 422 установки
- [godot-testing-patterns](https://affpapa.org/nevibecode/skills/godot-testing-patterns.md) — скилл · 585 установок
- [publish-mod](https://affpapa.org/nevibecode/skills/publish-mod.md) — скилл · 1400 установок
- [google-agents-cli-publish](https://affpapa.org/nevibecode/skills/google-agents-cli-publish.md) — скилл · 511900 установок

Из того же набора: [gamedev-skills/awesome-gamedev-agent-skills](https://affpapa.org/nevibecode/by/gamedev-skills/awesome-gamedev-agent-skills.md) — 77 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md