playspec gives your coding agent what it needs to build real 2D games in the Godot engine, and to prove they work. You bring a sketch and the rules. The agent builds the game, playspec checks every step, and you play it as it grows.

What you get

• Any 2D game you can describe. Platformers, top-down adventures, puzzles, card games. Your rules, in your words: "collect every coin to open the exit".
• Levels proved finishable. playspec plays each level in the engine and records a winning run. Change a level and you know in seconds whether it can still be finished.
• Feel that is measured. Ask for a jump four tiles high, and the engine jumps and measures it.
• Your sketch, read back first. "These circles are coins? This triangle is a spike?" Nothing is built until you say yes.
• Playable at every step. Each stage ends with something to play and one question for you.
• Ready for any screen. One command builds it for the web. It plays in any browser and on phones and tablets, with touch controls, and installs to the home screen like an app.

Install

You need Node 22+, Godot 4.3+ and a coding agent: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, or any other that reads agent skills.

npm i -g playspec
playspec setup

setup gives your agent the playspec skill and checks that it can find Godot. If Godot is not on your PATH, set PLAYSPEC_GODOT to it. For any other agent, point it at ~/.agents/skills/make-a-game/SKILL.md.

Update with npm update -g playspec.

Make a game

Open your agent in an empty folder and ask:

Make me a platformer. Here's a sketch of the first level: level-1.jpg. Collect every coin to open the exit.

It asks a few questions, shows you what it read from the sketch, then builds the game stage by stage, stopping for you to play.

Share it

playspec doctor --install-templates   # once per machine: Godot's web templates
playspec export web                   # the game in build/web, and a zip of it
playspec serve                        # play it in your browser

Put build/web on any web host, like itch.io, Netlify, GitHub Pages or your own site, and send the link.

playspec --help lists every command, if you want to drive it yourself.

Contributing

Issues and pull requests are welcome.

git clone https://github.com/TahaSh/playspec && cd playspec
npm install
npm run verify

The file formats and contracts are in docs/.

License

MIT © Taha Shashtari. Art packs a game downloads keep their own licenses.