# Pygame Piano Tiles

> Minimal Piano Tiles game prototype built with Pygame. Use when asked to play Piano Tiles, test the game, or debug tile-falling mechanics. Supports configurable lanes, speed, mouse click input, and score tracking.

- Skill: `fnaith/pygame-piano-tiles` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add fnaith/pygame-piano-tiles`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fnaith/pygame-piano-tiles/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fnaith (https://skillmd.com/u/fnaith)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fnaith/pygame-piano-tiles

---


# Pygame Piano Tiles

A minimal Piano Tiles game prototype built with Pygame.

## When to Use

- Play a game of Piano Tiles
- Test or debug the Piano Tiles game logic
- Verify game rules: timed tapping, lane scrolling, miss detection, score tracking, speed increases

## Prerequisites

- Python 3.10+
- Pygame (see requirements.txt)

## Usage

```
python pygame_piano_tiles.py [--lanes N] [--speed PX_PER_SEC] [--speed-increment PX_PER_SEC]
```

### Options

| Option | Default | Description |
|--------|---------|-------------|
| `--lanes` | 4 | Number of lanes |
| `--speed` | 300 | Initial tile fall speed in px/s |
| `--speed-increment` | 15 | Speed increase per successful tap in px/s |

### Controls

- **Mouse click**: Tap a tile in the hit zone to score
- **R key**: Restart after game over
- **ESC / Close window**: Exit

## Game Rules

- Black tiles scroll down from the top in multiple lanes
- Click a tile while it is inside the gray hit zone to score
- Missing a tile or clicking an empty lane ends the game
- Speed increases with each successful tap
- Minimalist black-and-white aesthetic