nikumubeki

Sokoban — Development skill for Claude Code

Development community

A Claude Code created version of Sokoban, featuring the first four levels of the original game.

How to install Sokoban

This entry records only its repository, not the path inside it, so there is no exact command to give. Open nikumubeki/sokoban and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Sokoban does

A Claude Code created version of Sokoban, featuring the first four levels of the original game. No technical support provided, considering I have zero programming skills and asked a robot to make me all of this. The build_apk.py function for Android has not been tested by me, otherwise this seemed to work with Windows 11. README created by Claude.

Alternatives in Development

Contributing To Skill Seeker — First off, thank you for considering contributing to Skill Seeker 11.1k ★
Create Toolset — You are asked to build a new toolset 3.1k ★
Projects Created — List all projects created by the starter kit 335 ★

README

Sokoban

A classic box-pushing puzzle game. Maps are generated from plain text files, and all visuals are PNG image assets — both easy to edit without touching code.

Running it on Windows 11

**Install Python** (3.10 or newer) if you don't already have it:
- Get it from https://www.python.org/downloads/windows/
- During setup, tick "Add python.exe to PATH".
**Open a terminal in the game folder.**
- Unzip sokoban.zip somewhere, e.g. C:\Games\sokoban.
- In File Explorer, open that folder, click the address bar, type cmd, press Enter. (Or right-click inside the folder → "Open in Terminal".)
**Install the one dependency (pygame):**
```
pip install -r requirements.txt
```
**Run the game:**
```
python main.py
```

That's it — a window opens and you're playing. You can also just double-click `main.py` if `.py` files are associated with Python on your system, though running from a terminal is recommended so you can see any error messages.

The window opens at a fixed size (see "Window size" below) and stays that size for the whole session — each level is scaled to fit inside it and centered, rather than the window changing size as you move between levels.

Controls

Key	Action
Arrow keys / `W A S D`	Move / push boxes
Click a tile	Walk there (or push an adjacent box)
`R`	Restart the current level
`U` / `Backspace`	Undo the last move
`Space` / `Enter`	Advance once a level is solved
`N`	Skip to the next level
`L`	Open the level select menu
`F12`	Quick save (also a button in the top bar)
`F9`	Quick load (also a button in the top bar)
`Esc`	Close a menu, or quit