add-template

Guides adding and updating game starter templates in the Flix game engine templates directory.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Adding or updating a starter template in the Flix game engine's templates/ directory involves seven interdependent steps, and missing any one causes the Studio editor to fail with symptoms like missing genre cards, blank thumbnails, or games that cannot be created. This Skill provides the complete checklist so nothing is forgotten. ## Core Features & Use Cases - Seven-step checklist: Covers template creation, reference title image, palette linting, Doc conventions, art style declaration, Studio registration, and jar swapping. - Two template styles: Distinguishes concrete-value templates (rpg, novel, tetris) that build in-repo from token-based templates (game-starter) that only work after make new-game substitution. - Use Case: When creating a new genre template for the Studio editor, follow the checklist to generate reference/title.png, pass make lint-palette, register the starter in Genesis.flix, and run make swap-jar so the genre card appears correctly. ## Quick Start Ask the AI to add a new genre starter template to the templates directory and register it with Studio following the add-template checklist.

Frequently Asked Questions about add-template

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

FAQPage Schema
How do I add a new game template to the Flix game engine?

Create a directory under templates/ modeled on rpg-starter, add a reference/title.png, pass make lint-palette, follow Doc conventions, declare the art style, register the starter in Studio's Genesis.flix families, then run make swap-jar and restart Studio.

Why is my genre card thumbnail blank in Flix Studio?

The Studio genre card thumbnail is served from reference/title.png via GET /genesis/title. If that file is missing, the card renders empty, so generate a title scene and update reference images with make reference-update.

What is the difference between concrete-value and token-based templates?

Concrete-value templates like rpg-starter build and test in-repo with reference images. Token-based templates like game-starter contain placeholders such as __NAME__ and __W__ and only work after make new-game substitutes the values.

Why does make jar not update the running Studio app?

Running make jar alone does not affect the already-running .app bundle. Use make swap-jar to replace the bundled jar inside the live app and re-sign it, then quit Studio with Cmd+Q and reopen it.

Why does make reference-check fail after cloning the repository?

The check fails with a message that reference images are not yet created when reference/SHA256SUMS.txt is missing. Run make reference-update to regenerate the checksum list, which is the only reference artifact committed to git alongside title.png.