Phaser 2D GameDev (Oak Woods Platformer) + Agent Skills

This repo is the companion project for the YouTube build: “Vibe Coding 2D Games with Claude Code & Agent Skills (Full Tutorial)” (watch on YouTube)

It includes:

• A small Phaser 3 + TypeScript + Vite platformer scene (parallax background, infinite ground, movement/jump/attack).
• The Agent Skills used in the video (Claude Code + Codex CLI).

Want more?

If you want the all-in-one workflow kit I use across Claude Code, Codex CLI, and Cursor—including ready-to-run agents/skills/rules and full source from my YouTube builds—check out BuilderPack.ai.

Quickstart

1. Install deps:

npm install

2. Add the Oak Woods art pack (required — not included in this repo). See Assets (Required) below.

3. Run:

npm run dev

Controls:

• Arrow keys: move + jump
• X: attack

Included Agent Skills

This repo ships two skills, each packaged for both tools (so 4 copies total):

• Phaser game dev
  • Claude Code: .claude/skills/phaser-gamedev/SKILL.md
  • Codex CLI: .codex/skills/phaser-gamedev/SKILL.md
• Playwright testing (including canvas/Phaser testing patterns)
  • Claude Code: .claude/skills/playwright-testing/SKILL.md
  • Codex CLI: .codex/skills/playwright-testing/SKILL.md

Each SKILL.md contains its triggers, workflow, and reference docs.

Assets (Required)

This repository does not include the Oak Woods art assets (we can’t redistribute them).

1. Get the pack from:

• Oak Woods (itch.io)

2. Extract/copy the assets into: public/assets/oakwoods/

The game expects this structure (filenames and folders must match):

public/assets/oakwoods/
  assets.json
  oak_woods_tileset.png
  background/
    background_layer_1.png
    background_layer_2.png
    background_layer_3.png
  character/
    char_blue.png
  decorations/
    fence_1.png
    fence_2.png
    grass_1.png
    grass_2.png
    grass_3.png
    lamp.png
    rock_1.png
    rock_2.png
    rock_3.png
    shop.png
    shop_anim.png
    sign.png

Notes:

• public/assets/oakwoods/assets.json is included here as a manifest/index.
• Only the manifest is tracked; the extracted art is ignored by git.

Credits (Oak Woods)

Oak Woods asset pack by brullov:

• Oak Woods (itch.io)
• @brullov_art (X)