# atb-game-package

atb-game-package is a Claude Code skill that packages HTML5 Canvas games as offline standalone files or portable folders. It runs during game distribution packaging.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 369 repo stars
- Author: ATBPort Team
- License: GPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/atbfun/ATBGamePort/tree/HEAD/skills/atb-game-package/SKILL.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/atb-game-package

## What it does

atb-game-package turns an HTML5 Canvas game into `<game>-standalone.html` with bundled assets, an embedded VFS, and a runtime interception shim. It places local CSS and JavaScript inside the page, converts CSS asset references to Data URIs, and routes file access through `fetch`, `XMLHttpRequest`, `Image.src`, and `Audio.src`.

The portable build gets a materialized asset tree under `dist/<game>-portable/`, plus `Play-macOS.command`, `Play-Windows.bat`, `README-PLAY.txt`, and `<game>-release.zip`. `scripts/verify-package.py` checks pure `file:///` execution, console errors, snapshot pixel color coverage, and Unix `0755` permissions in the archive. Packaging requires the Python 3 standard library and Chrome, Chromium, Microsoft Edge, or Brave for headless checks; an existing project Conda environment uses `conda activate ATBPort`. The headless check cannot run without a browser.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add atbfun/ATBGamePort
```
In the agent chat (not a shell):
```text
/plugin install atb-game-porting@atbfun
```
This installs the whole atb-game-porting plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add atbfun/ATBGamePort --skill atb-game-package -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/atb-game-package/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/atb-game-package/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add atbfun/ATBGamePort --skill atb-game-package -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/atb-game-package/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add atbfun/ATBGamePort --skill atb-game-package -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/atb-game-package/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install atbfun/ATBGamePort skills/atb-game-package
```

2. **Manually: put the files in place**
- File: `.github/skills/atb-game-package/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add atbfun/ATBGamePort --skill atb-game-package -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/atbfun/ATBGamePort --path skills/atb-game-package
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/atb-game-package/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/atbfun/ATBGamePort/tree/HEAD/skills/atb-game-package/SKILL.md

## When to use it
- package an HTML5 Canvas game as a standalone offline file
- embed CSS, JavaScript, and game assets into one HTML page
- prepare a portable folder with macOS and Windows launchers
- build a ZIP release while retaining macOS executable permissions
- verify a game launched through `file:///` without console errors

## Example prompts
- Package the game in `target/<game>/` as a standalone file and portable release.
- Build `<game>-standalone.html`, both launchers, and `dist/<game>-release.zip`.
- Run `scripts/verify-package.py` against the files in `dist/`.

## Similar
- [openai-develop-web-game](https://affpapa.org/en/nevibecode/skills/openai-develop-web-game.md) — skill · ★ 540 repo stars
- [python-pypi-package-builder](https://affpapa.org/en/nevibecode/skills/python-pypi-package-builder.md) — skill · 943 installs
- [game-engine](https://affpapa.org/en/nevibecode/skills/game-engine.md) — skill · 13140 installs
- [mpc-plugin-package](https://affpapa.org/en/nevibecode/skills/mpc-plugin-package.md) — skill · ★ 200 repo stars
- [canvas-performance-optimization](https://affpapa.org/en/nevibecode/skills/canvas-performance-optimization.md) — skill · ★ 51 repo stars
- [nuget-package-publishing](https://affpapa.org/en/nevibecode/rules/nuget-package-publishing.md) — rule · ★ 138 repo stars

From the same set: [atbfun/atbgameport](https://affpapa.org/en/nevibecode/by/atbfun/atbgameport.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
