This skill helps an agent build and debug a LÖVE 11.5 game. It reads conf.lua first for the target version and save identity, loads assets once, simulates in fixed steps and wraps world drawing in push and pop with the HUD drawn after.
It includes a conf.lua error hook that prints errors and exits with a status for scripted runs, a frame-counted run that takes a screenshot, and a pixel-art canvas with integer scaling. A gotcha list covers blurry sprites, stack depth errors, missing save files and unseeded random numbers.
What You Get
- A five-step workflow from reading conf.lua to loading once, simulating in steps, drawing in layers and verifying
- A conf.lua pattern with a version, a save identity and an error handler for scripted runs
- A fixed-step accumulator with a frame-count check and screenshot, and a pixel-art canvas with integer scaling
- A gotcha list for blurry pixel art, push and pop errors, save locations, require spellings, seeding, colour ranges and key repeat
Common Use Cases
- Starting a LÖVE game with a correct loop and config
- Fixing blurry pixel art after scaling
- Debugging the blue error screen or speed that depends on frame rate
- Saving and loading game data with love.filesystem
What Makes It Unique
The skill gives a scripted run for a game that normally needs a person at the window: a frame budget, a screenshot written to the save folder and a clean exit code, with an error handler so a crash prints and exits. It also lists the 11.x behaviours that differ from older tutorials.
Under The Hood
The agent loads the SKILL.md and, when needed, a reference on a screen stack. It edits Lua files in your project and runs the love command under a timeout with a frame count and a screenshot name, then reads the output, exit code and the screenshot in the save directory. The game writes that screenshot and any save files to the LÖVE save folder. On a Linux machine without a display it suggests running under a virtual display. It fetches no web pages and calls no APIs; input feel and sound need a person to play and report.