# phaser-gamedev

This skill guides an agent building 2D games with Phaser 3, from scene structure to sprites and physics. Use it when adding gameplay systems or shaping a new game project.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 installs · ★ 37
- Author: chongdashu
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/chongdashu/phaserjs-tinyswords/tree/HEAD/.claude/skills/phaser-gamedev/SKILL.md
- Updated: 2026-01-16
- HTML: https://affpapa.org/en/nevibecode/skills/phaser-gamedev

## What it does

The skill covers structuring a game around scenes and passing state between them. Its guidance includes scene lifecycle methods, asset loading, game objects, animations, input, and tilemaps. That structure helps when gameplay logic needs to live in distinct parts of a project.

For collisions, it discusses Arcade and Matter physics. Arcade fits straightforward 2D interactions; Matter is aimed at more realistic behavior. The examples also cover physics groups, collisions, and overlap handling. Choose the physics system before writing collision logic, since that decision shapes how those interactions work.

The material also addresses frame-rate-independent updates and referencing loaded assets by key. Examples use JavaScript and the Phaser 3 API. This is guidance for an agent working on a game, not a finished game project.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill phaser-gamedev -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill phaser-gamedev -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill phaser-gamedev -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install chongdashu/phaserjs-tinyswords phaser-gamedev
```

2. **Manually: put the files in place**
- File: `.github/skills/phaser-gamedev/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill phaser-gamedev -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/chongdashu/phaserjs-tinyswords --path .claude/skills/phaser-gamedev
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add chongdashu/phaserjs-tinyswords --skill phaser-gamedev -a opencode
```

### 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/chongdashu/phaserjs-tinyswords/tree/HEAD/.claude/skills/phaser-gamedev/SKILL.md

## When to use it
- organize game logic into scenes
- add physics bodies and collisions to sprites
- pass data between scenes
- handle keyboard input in the game loop
- choose a physics system for 2D gameplay

## Example prompts
- Create menu, level, and game-over scenes for my Phaser 3 game.
- Give the player Arcade physics and add collisions with platforms.
- Pass the player's score to the game-over scene when the level ends.

## Similar
- [orbit-card](https://affpapa.org/en/nevibecode/skills/orbit-card.md) — skill · 10000 installs
- [cad](https://affpapa.org/en/nevibecode/skills/cad.md) — skill · 14000 installs
- [step-parts](https://affpapa.org/en/nevibecode/skills/step-parts.md) — skill · 11200 installs
- [sdf](https://affpapa.org/en/nevibecode/skills/sdf.md) — skill · 10500 installs
- [urdf](https://affpapa.org/en/nevibecode/skills/urdf.md) — skill · 10500 installs
- [hatch-pet](https://affpapa.org/en/nevibecode/skills/hatch-pet.md) — skill · 3300 installs

---
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