Agent skill

Gluj Versions

by vchelaru in vchelaru/FlatRedBall

A skill your agent uses when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a…

MITAuto-check passedGame Development

Install Gluj Versions

skills CLI
$ npx skills add vchelaru/FlatRedBall --skill gluj-versions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vchelaru/FlatRedBall gluj-versions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vchelaru/FlatRedBall.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/gluj-versions .claude/skills/gluj-versions && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gluj-versions
GitHub stars
578
Token cost
~1.4k tokens
SKILL.md length
732 words
Files
1
Skills in repo
32
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a…

  • Works in 4 steps: Add the new enum entry at the bottom of… → Update LatestVersion to point at the new… → Update the SyntaxVersionAttribute on… → …
  • Reasoning about Gluj/Glux file format versions
  • SKILL.md covers When adding a new version, Retroactively gating a missed…, Embedded code files: where… and Caveat: gating an added…, plus 2 more sections
  • Reaches docs.flatredball.com

What it does

Gluj Versions is an agent skill from vchelaru/FlatRedBall. Use when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a loaded Glue project.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Game Development. The repository describes itself as: Cross-platform 2D game engine focused on ultimate productivity built in .NET. The licence is MIT.

When your agent uses it

  • Reasoning about Gluj/Glux file format versions
  • The GluxVersions enum
  • FileVersion checks
  • Anything that gates behavior on the version of a loaded Glue project

Example prompts

  • “/gluj-versions”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Add the new enum entry at the bottom of GluxVersions with a dated comment describing what it represents.
  2. Update LatestVersion to point at the new entry.
  3. Update the SyntaxVersionAttribute on FlatRedBallServices so the runtime advertises the matching version.
  4. Update the docs (the local FlatRedBallDocs repo file above), adding a new ### Version N - section matching the existing entries' style.

What it can do on your machine

Read from SKILL.md and the folder at commit 94fbc62. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are csharp).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • docs.flatredball.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gluj Versions loads about 1.4k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 732 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vchelaru/FlatRedBall at commit 94fbc62, republished under its MIT licence (© vchelaru). 732 words, ~1,427 tokens.

Download SKILL.mdSave it as .claude/skills/gluj-versions/SKILL.md (or your agent's skills folder).
name
gluj-versions
description
Use when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a loaded Glue project.
version
1.0.0

Gluj Versions

Glue projects (.gluj/.glux) are versioned so that the editor and runtime can load older projects while still adding new features. Versions are tracked by the GluxVersions enum and LatestVersion constant in:

FRBDK/Glue/GlueCommon/SaveClasses/GlueProjectSave.cs

For background on what each version means and the historical context, see the official docs, published from https://docs.flatredball.com/flatredball/glue-reference/glujglux. That docs site is a GitBook synced from a separate sibling repo checked out locally, C:\Users\vchel\Documents\GitHub\FlatRedBallDocs (relative to this repo, same convention as the Gum sibling repo) — plain markdown, matching the site's URL structure. The glujglux page is glue-reference/glujglux.md in that repo. Edit the file directly rather than treating the docs as remote-only/unreachable.

When adding a new version

Adding a new entry to GluxVersions requires updating several places in lockstep. Miss one and projects will silently load with the wrong feature set.

  1. Add the new enum entry at the bottom of GluxVersions with a dated comment describing what it represents.
  2. Update LatestVersion to point at the new entry.
  3. Update the SyntaxVersionAttribute on FlatRedBallServices so the runtime advertises the matching version.
  4. Update the docs (the local FlatRedBallDocs repo file above), adding a new ### Version N - <title> section matching the existing entries' style.

Multiple enum entries can share the same integer value when several features land together — this is intentional and already common in the enum.

Retroactively gating a missed breaking change

Sometimes a breaking change ships without being gated behind a version, and the gap is only noticed after a later version has already been cut. In that case, do not invent a new version number. Instead, add a new enum entry at the same integer value as the most recent version that already shipped after the change, with a dated comment explaining the retroactive add. Upgrading to that version then pulls in both changes together.

Example: version 66 (GumHasGueVirtualIsPointInside, Jan 29 2026) was cut after a Jan 17 2026 change to PositionedNode.Tag that wasn't gated. The fix was to add PositionedNodeHasTag = 66 next to it, not to invent a 67.

When you do this, also gate the previously-ungated code in any embedded code files that reference the new API:

  • If the embedded file does not already have a $GLUE_VERSIONS$ token at the very top, add one. That token is what the code generator replaces with #define lines for each enum symbol whose value is <= FileVersion. Without it, no #if SymbolName guard in the file will ever evaluate true.
  • Wrap the new API usage in #if SymbolName || REFERENCES_FRB_SOURCE. The REFERENCES_FRB_SOURCE arm keeps the code live for projects that reference FRB as source rather than NuGet, where the symbol isn't defined but the API exists.
Show full SKILL.md (293 more words)Show less

Embedded code files: where they live and conventions

Embedded code files are templates that get copied into user projects by plugins. They live under FRBDK/Glue/<Plugin>/EmbeddedCodeFiles/*.cs and are registered for inclusion via CodeItemAdderManager (e.g. FRBDK/Glue/TileGraphicsPlugin/TileGraphicsPlugin/Managers/CodeItemAdderManager.cs).

For a known-good reference of the $GLUE_VERSIONS$ + #if SymbolName || REFERENCES_FRB_SOURCE pattern, see FRBDK/Glue/TileGraphicsPlugin/TileGraphicsPlugin/EmbeddedCodeFiles/CollidableListVsTileShapeCollectionRelationship.cs.

Style: these files target older language levels because they get compiled into a wide range of user projects. Do not introduce C# 8 nullable reference annotations (object?, string?, etc.) just because your editor accepts them — match the surrounding sibling files, which use plain object / string.

Caveat: gating an added optional parameter

Wrapping a newly added optional parameter in #if is the standard pattern but it has a sharp edge: the parameter visibly disappears from the method signature on projects below the gating version. Callers passing the argument by position simply don't compile (loud, easy to fix), but callers passing it by name (FillFromPredicate(..., tagForAddedNodes: x)) get a confusing "no such parameter" error rather than a version-mismatch hint.

This is the price of supporting projects that don't pull FRB as source — every embedded file in the codebase does it the same way. Mention this tradeoff if a user is on the fence about gating vs. raising the minimum version.

When gating behavior on a version

Compare FileVersion against a named GluxVersions member, never a magic number:

csharp
if (this.FileVersion < (int)GluxVersions.SomeFeature) { ... }

This keeps the intent readable and survives renumbering.

New-project FileVersion

A newly-created project's FileVersion is clamped to the referenced engine dll's syntax version when it's lower than LatestVersion — see GlueProjectSave.GetFileVersionForNewProject (GlueCommon/SaveClasses/GlueProjectSave.cs), called from ProjectLoader.LoadProject (Glue/IO/ProjectLoader.cs) only on the first-time-creation path (no existing .glux/.gluj found). Loading an existing project never goes through this — FileVersion comes straight from the file, so a user who manually raises it still hits GlueProjectFileVersionErrorViewModel's error as before.

© vchelaru, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/gluj-versions of vchelaru/FlatRedBall.

Open the folder on GitHubat commit 94fbc62

Compare with similar skills

Gluj Versions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gluj Versions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gluj Versions this skillvchelaru/FlatRedBall578—~1.4kAutomated safety check: PassMIT
Image to Three.js Modelimg2threejs/img2threejs18k1 repos~8.2kAutomated safety check: PassApache-2.0
Web CloneJane-xiaoer/claude-skill-web-clone1k1 repos~2.7kAutomated safety check: PassMIT
Threejs Game Directormajidmanzarpour/threejs-game-skills2.5k—~2.2kAutomated safety check: PassMIT
Game Asset Generatorhtdt/godogen7.1k—~2.8kAutomated safety check: PassMIT
Threejs Gameplay Systemsvalkor-ai/loom1.2k1 repos~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Image to Three.js Model

    img2threejs/img2threejs

    Rebuilds the object in a reference image as a procedural, animation-ready Three.js model written entirely in code, using staged sculpting with quality checks.

    18k GitHub starsUsed in 1 repo~8.2k tokens
    Game DevelopmentAuto-check passed
  • Web Clone

    Jane-xiaoer/claude-skill-web-clone

    网站复刻 / 克隆方法论。USE WHEN 用户说 复刻网站、克隆网站、clone website、抄个站、仿站、 照着这个站做一个、reproduce site、还原某个网页效果、把这个站搬下来改成我的、 复刻某个交互/WebGL/Canvas/Three.js 效果。提供「先拿真源码 → 判路径 → 逆向拆解 → 搭工程 → 替换内容」的可移植决策树,覆盖静态站 /…

    1k GitHub starsUsed in 1 repo~2.7k tokens
    Game DevelopmentAuto-check passed
  • Threejs Game Director

    majidmanzarpour/threejs-game-skills

    Entrypoint for building, upgrading, and finishing Three.js browser games.

    2.5k GitHub stars~2.2k tokensUpdated 13 days ago
    Game DevelopmentAuto-check passed
  • Generates game art from text prompts: PNG images, GLB 3D models, rigged characters, animations and sprites, with background removal.

    7.1k GitHub stars~2.8k tokensUpdated 9 days ago
    Game DevelopmentAuto-check passed
  • Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Game DevelopmentAuto-check passed
  • Uloop Execute Dynamic Code

    CyberAgentGameEntertainment/NovaShader

    Execute C with Unity APIs when existing uloop tools cannot inspect or edit enough.

    1.6k GitHub starsUsed in 1 repo~1.9k tokens
    Game DevelopmentAuto-check passed

More from vchelaru/FlatRedBall

All 32 skills in this repo
  • Glue Live Game Testing

    vchelaru/FlatRedBall

    Testing GlueControl's embedded runtime (CommandReceiver, GlueControlManager) against a real running game process.

    578 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Glue Unit Test Bootstrap

    vchelaru/FlatRedBall

    Bootstrapping GlueUnitTests that touch GlueState.Self/GlueCommands.Self/ProjectManager.

    578 GitHub stars~4.3k tokensUpdated today
    Auto-check passed
  • Gum Codegen

    vchelaru/FlatRedBall

    A skill your agent uses when working on Glue's Gum code generation — adding/removing/version-gating generated properties on Gum standard runtime types (NineSlice, Text, Container, Sprite, etc.), or…

    578 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Release

    vchelaru/FlatRedBall

    FRB1 (engine + Glue) release runbook — gh CLI sequence for Engine.yml/glue.yml, version scheme, release notes.

    578 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Release Notes

    vchelaru/FlatRedBall

    Drafts FRB1 release notes from commits/PRs since the last release.

    578 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Skills Writer

    vchelaru/FlatRedBall

    Creates and updates skill files (.claude/skills//SKILL.md). An agent skill from vchelaru/FlatRedBall.

    578 GitHub stars~2.7k tokensUpdated today
    Auto-check passed

Questions about Gluj Versions

What does Gluj Versions do?

A skill your agent uses when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a…. Gluj Versions is an agent skill from vchelaru/FlatRedBall. Use when adding, modifying, or reasoning about Gluj/Glux file format versions, the GluxVersions enum, FileVersion checks, or anything that gates behavior on the version of a loaded Glue project.

When should I use Gluj Versions?

Gluj Versions fits situations like: reasoning about Gluj/Glux file format versions; the GluxVersions enum; fileVersion checks; anything that gates behavior on the version of a loaded Glue project.

How do I install Gluj Versions in Claude Code?

Run `npx skills add vchelaru/FlatRedBall --skill gluj-versions -a claude-code`. Or copy the skill folder (.claude/skills/gluj-versions in vchelaru/FlatRedBall) into .claude/skills/gluj-versions in your project. Claude Code loads it when a task matches its description.

How do I install Gluj Versions in Codex?

Run `npx skills add vchelaru/FlatRedBall --skill gluj-versions -a codex`. Or copy the skill folder (.claude/skills/gluj-versions in vchelaru/FlatRedBall) into .agents/skills/gluj-versions in your project. Codex loads it when a task matches its description.

Can I use Gluj Versions in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vchelaru/FlatRedBall --skill gluj-versions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gluj-versions, .gemini/skills/gluj-versions, .github/skills/gluj-versions and .opencode/skills/gluj-versions in your project.

What does Gluj Versions need to run?

SKILL.md names no scripts, command-line tools or credentials: Gluj Versions is instructions for the agent only.

Does Gluj Versions access the network?

SKILL.md names 1 domain. In commands or code: docs.flatredball.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Gluj Versions safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gluj Versions use?

Gluj Versions is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gluj Versions use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gluj Versions?

Skills that share tags, products or a category with Gluj Versions: Image to Three.js Model (img2threejs/img2threejs, 18k stars), Web Clone (Jane-xiaoer/claude-skill-web-clone, 1k stars), Threejs Game Director (majidmanzarpour/threejs-game-skills, 2.5k stars) and Game Asset Generator (htdt/godogen, 7.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gluj Versions?

vchelaru (a GitHub user) maintains it in vchelaru/FlatRedBall, which has 578 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 10, 2026.

Source: vchelaru/FlatRedBall on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.