# Pygame Minesweeper

> Classic Minesweeper game prototype built with Pygame. Use when asked to play Minesweeper, test the Minesweeper game, or debug the game logic. Supports Beginner (9x9, 10 mines), Intermediate (16x16, 40 mines), Expert (30x16, 99 mines), and Custom modes.

- Skill: `fnaith/pygame-minesweeper` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add fnaith/pygame-minesweeper`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fnaith/pygame-minesweeper/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-minesweeper

---


# Pygame Minesweeper

A minimal classic Minesweeper game prototype built with Pygame.

## When to Use

- Play a game of Minesweeper
- Test or debug the Minesweeper game logic
- Verify game rules: left-click reveal, right-click flag, number logic, flood fill, win/lose conditions

## Prerequisites

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

## Usage

```
python pygame-minesweeper.py [--beginner | --intermediate | --expert | --custom WIDTH HEIGHT MINES]
```

### Difficulty Modes

| Mode | Grid | Mines |
|------|------|-------|
| `--beginner` | 9x9 | 10 |
| `--intermediate` | 16x16 | 40 |
| `--expert` | 30x16 | 99 |
| `--custom W H M` | WxH | M |

### Controls

- **Left click**: Reveal a cell
- **Right click**: Toggle flag on a cell
- **R key**: Reset the game
- **Close window**: Exit

## Game Rules

- First click is always safe (mines placed after first click)
- Numbers show adjacent mine count
- Empty cells auto-reveal neighbors (flood fill)
- Revealing a mine ends the game
- Revealing all non-mine cells wins the game