# Install "Free Game Stack (pick from 12 free open-source repos, wire them, ship to itch.io)"

A GameSkill original that turns the popular "12 free GitHub repos, a game studio for $0" list into a plan: one engine and at most one tool per need, chosen from Godot, Phaser, Babylon.js, Kaplay, PixiJS, Matter.js, LDtk, Piskel, Howler.js, ink, Colyseus and butler, with licences checked and a reason for every tool left out. Ships a picker, an ink compiler step, a pack step and a pre-upload check, and Lantern Courier, a tested example using Kaplay, ink, Matter.js and a Colyseus room.

- Source: GameSkill original, hosted only on https://gameskill.dev/skills/free-game-stack
- Based on (ideas only, code is ours): 12 free GitHub repos for a game studio (list only) https://x.com/iiiichigo_chan/status/2116513425144606925 by @iiiichigo_chan (public post, tool names and links only; descriptions, rules, picker and example are our own)
- License: MIT
- By: GameSkill
- Works with: Claude Code, Codex, Cursor, OpenCode
- Engines: Web (Phaser / Three.js), Godot

## Prerequisites

- Node 18+ (pick-stack and check-ship use built-ins only)
- For the example: npm ci (kaplay, inkjs, matter-js, Colyseus, puppeteer-core) and Chrome or Chromium

## Install GameSkill's tested copy (recommended)

GameSkill wrote this skill for gameskill.dev and hosts it here (MIT). The ZIP holds SKILL.md, SKILL.zh.md, scripts, a runnable example, tests, CHECKLIST.md, LICENSE, CREDITS.md, ATTRIBUTION.md and a `gameskill/` folder (test report, self-check list, Chinese guide).

- ZIP: https://gameskill.dev/dl/skills/free-game-stack.zip (73 KB, sha256 119db7e65bb4c77542c261237040be560a3e43d25b6bead9e2f8212fefdb883b)
- Version: 1.0.0 (2026-11-03). Latest version and changes: https://gameskill.dev/skills/free-game-stack/version.json
- Tested by GameSkill on Node (picker, ink, Matter.js, Colyseus, ship check) + Chrome headless (packed game), 2026-11-03: 27/27 checks passed. Report: https://gameskill.dev/dl/skills/free-game-stack/test-report.json

The ZIP holds one folder, `free-game-stack/`, with SKILL.md directly inside it.

Pick the block for the agent you are and run it from the root of the user’s project, then restart the agent.

### Claude Code (`.claude/skills/free-game-stack/`)

```bash
mkdir -p .claude/skills
curl -fsSL https://gameskill.dev/dl/skills/free-game-stack.zip -o /tmp/gameskill-free-game-stack.zip
unzip -oq /tmp/gameskill-free-game-stack.zip -d .claude/skills
rm /tmp/gameskill-free-game-stack.zip
```

### Codex, Gemini CLI, OpenCode (`.agents/skills/free-game-stack/`)

```bash
mkdir -p .agents/skills
curl -fsSL https://gameskill.dev/dl/skills/free-game-stack.zip -o /tmp/gameskill-free-game-stack.zip
unzip -oq /tmp/gameskill-free-game-stack.zip -d .agents/skills
rm /tmp/gameskill-free-game-stack.zip
```

### Cursor (`.cursor/skills/free-game-stack/`)

```bash
mkdir -p .cursor/skills
curl -fsSL https://gameskill.dev/dl/skills/free-game-stack.zip -o /tmp/gameskill-free-game-stack.zip
unzip -oq /tmp/gameskill-free-game-stack.zip -d .cursor/skills
rm /tmp/gameskill-free-game-stack.zip
```

### GitHub Copilot (`.github/skills/free-game-stack/`)

```bash
mkdir -p .github/skills
curl -fsSL https://gameskill.dev/dl/skills/free-game-stack.zip -o /tmp/gameskill-free-game-stack.zip
unzip -oq /tmp/gameskill-free-game-stack.zip -d .github/skills
rm /tmp/gameskill-free-game-stack.zip
```

### Windsurf (`.windsurf/skills/free-game-stack/`)

```bash
mkdir -p .windsurf/skills
curl -fsSL https://gameskill.dev/dl/skills/free-game-stack.zip -o /tmp/gameskill-free-game-stack.zip
unzip -oq /tmp/gameskill-free-game-stack.zip -d .windsurf/skills
rm /tmp/gameskill-free-game-stack.zip
```

### Self-check after using the skill

- 只选一个引擎 / One engine only
- 每个额外工具都对应 brief 里的一个需求 / Every extra tool answers a need in the brief
- 装之前先把选型结果给用户看 / Show the picked stack before installing anything
- 每块单独测完再拼 / Test each piece alone before joining them
- 上传前 check-ship 必须 PASS / check-ship must PASS before upload
- 密钥不进客户端，保留每个库的许可证 / No keys in the client; keep each library's licence

## Verify

- `free-game-stack/SKILL.md` exists in the skills folder above.
- Try a request like: "I want to make a tiny browser game with a short dialogue, online play for friends, and put it on itch.io. Use only free open-source tools, pick the smallest stack and show me why."
- Tell the user what you installed and where.

## Attribution

"Free Game Stack (pick from 12 free open-source repos, wire them, ship to itch.io)" is a GameSkill original (https://gameskill.dev/skills/free-game-stack), licensed under MIT. CREDITS.md in the ZIP lists the workflow inspiration, test assets and third-party libraries; keep LICENSE and CREDITS.md with any copy.