render-loop

Iterates on game visuals by rendering single scenes headlessly and comparing before-after diffs.

5|Updated May 5, 2026
One-click install
npx skills add https://github.com/ababup1192/flix_game_engine --skill render-loop-ababup1192
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: render-loop
Source: https://github.com/ababup1192/flix_game_engine/tree/main/.claude/skills/render-loop
Command: npx skills add https://github.com/ababup1192/flix_game_engine --skill render-loop-ababup1192

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Fixing game visuals without a structured loop wastes tokens on repeated full-scene renders and manual eyeballing, and makes it easy to break unrelated scenes while fixing one. This Skill defines a disciplined render-critique-fix cycle for a Flix 2D game engine where every change is verified by machine comparison. ## Core Features & Use Cases - Cost-Filtered Review: Runs reference hash checks first, then image digests (diff pixel ratio, changed regions, color counts), reserving visual inspection for one final confirmation. - Single-Scene Rendering: Renders only the touched scene via make render SHOT=<name> or changed templates via make render-changed, avoiding full 150-second re-renders during iteration. - One-Fix-at-a-Time Discipline: Presents at most 3 candidate fixes for a human to pick, then shows before/after images side by side with make diff. - Use Case: A user says "the title screen looks off" — the Skill renders just that shot, proposes three fixes, applies the chosen one, and shows a left/right diff for approval. ## Quick Start Ask the AI to fix the look of a specific game scene, for example: "The battle scene looks wrong, render it and show me what to fix."

Frequently Asked Questions about render-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render a single game scene for visual review?

Run `make render SHOT=<scene-name>` inside the game template directory to render only that scene into the debug folder. Plain `make render` prints usage and fails, so always specify which scene you want to inspect.

How do I compare game screenshots before and after a change?

Run `make diff DIR=<game>` to generate side-by-side images in debug/diff with the old version on the left and the new one on the right. For numeric comparison without opening images, use `bin/fge digest old.png new.png` to get diff pixel ratio and changed regions.

When should I run make render-all instead of single-scene rendering?

Run `make render-all` only right before hash comparison with reference images, before releases, or after engine changes for regression detection. During an active fix loop it wastes time recompiling and rendering unrelated scenes.

How do I verify a looping GIF has no visible seam?

Run `make lint-loop` or `bin/fge loop <frames-directory>` to mechanically check that the transition from the last frame back to frame zero is clean. This applies only to effects intended to loop perfectly, not fades or wipes.

How are reference images used for regression testing?

Reference images in the reference/ directory are compared byte-for-byte against gallery/ output via `make reference-check`, which matches SHA256 hashes. Update references intentionally with `make reference-update` after an approved visual change.