gum-integration

gum-integration is a skill for Claude Code, Codex from vchelaru/FlatRedBall2. It costs 84 tokens per session (6,534 once invoked), scanned A, original, MIT.

A guide for building user interfaces in FlatRedBall2 with Gum, its interface system for controls such as buttons, labels, panels, and menus.

In plain words
What is it for?
Use it when adding or troubleshooting game menus, heads-up displays, forms, text, layouts, or screen-space and world-space interface elements.
Why use it?
It explains which UI setup to use and prevents code from trying to make all visual layout decisions that are better handled in the Gum editor.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when adding or troubleshooting game menus, heads-up displays, forms, text, layouts, or screen-space and world-space interface elements.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/vchelaru/flatredball2/gum-integration
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add vchelaru/FlatRedBall2 --skill gum-integration
Clone the repo
git clone --depth 1 https://github.com/vchelaru/FlatRedBall2

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for gum-integration

README.md
[![agentmods](https://agentmods.dev/badge/skills/vchelaru/flatredball2/gum-integration/github.svg)](https://agentmods.dev/skills/vchelaru/flatredball2/gum-integration)
Your own site
<a href="https://agentmods.dev/skills/vchelaru/flatredball2/gum-integration"><img src="https://agentmods.dev/badge/skills/vchelaru/flatredball2/gum-integration/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for gum-integration

Your own site · 80×15
<a href="https://agentmods.dev/skills/vchelaru/flatredball2/gum-integration"><img src="https://agentmods.dev/badge/skills/vchelaru/flatredball2/gum-integration.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 84 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,534 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Excessive Agency · line 184
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00084 $0.06534
Opus 5.5 $0.00034 $0.02614
Sonnet 5.5 $0.00017 $0.01307
Haiku 4.5 $0.00008 $0.00653

Measured 17d ago against content hash 292d3b698ce5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

gum-integration scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 17d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

frb-skills/gum-integration/SKILL.md · 405 lines

How it starts

The opening of the file, as written. The whole thing — 405 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Gum Integration in FlatRedBall2

UI composition is a human task — AI should scaffold named controls in a flat list and let the human compose the layout in the Gum Tool. Do not try to hand-author a polished visual hierarchy in code.

Gum is FlatRedBall2's UI system, backed by the Gum.KNI NuGet package. It is automatically initialized by FlatRedBallService.Initialize — no setup required. Gum also bundles Gum.Shapes (dashed strokes, gradients, drop shadows) and can render in world space, not only screen-space UI — so it's the home for advanced shape visuals that FRB's AARect/Circle/Polygon don't provide (see shapes).

Three Gum Usage Modes

Choose the mode that matches the project setup (see gumcli skill for how to create the project):

Mode Description When to use
Code-only No .gumx file. All controls created in C# with new Button() etc. Prototypes, no Gum editor needed
Project + dynamic access .gumx loaded; retrieve named elements at runtime via GetFrameworkElementByName<T>() Editor integration, no codegen
Project + codegen .gumx loaded + gumcli generates strongly-typed C# classes; instantiate and use typed properties directly Best DX; recommended for new projects

Two Levels of Gum API

Forms Controls — interactive UI (Gum.Forms.Controls)

High-level controls with built-in click, hover, focus, and Tab/accessibility keyboard navigation:

Control Use for
Button Clickable buttons
Label Display-only text
TextBox Text input
CheckBox Toggle on/off
StackPanel Vertical/horizontal layout container
Panel Free-layout container

Use Forms controls for menus, buttons, and any interactive element. Label is also the right choice for simple score/status text.

Visual Types — non-interactive rendering (Gum.GueDeriving)

Raw visual objects with no built-in input handling. Use these for non-interactive HUD elements — health bars, icons, solid-color shapes — when no Forms control fits:

Read the full file on GitHub · 405 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 17d ago Changed · +6 lines 292d3b698ce5
  2. 19d ago Changed efabe2918a51
  3. 20d ago Changed · +5 lines 27ecfce844b2
  4. 22d ago Changed · -1 lines 78da11a98118
  5. 29d ago Changed · +2 lines 6a8918e538f6
  6. 1mo ago Changed · +2 lines 3785e9c6ba14
  7. 2mo ago First seen · 391 lines · 84 tokens per session scan A f221507a0a90

Subscribe to this mod's changes

gum-integration is a skill published in the GitHub repository vchelaru/FlatRedBall2 (15 stars, last pushed yesterday), licensed MIT. It adds 84 tokens to every session and 6,534 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-04.

Related

gum-integration compared with skills from other repositories

gum-integration next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
gum-integrationvchelaru/FlatRedBall2Skill15yesterdayMITA84Claude Code, Codex
playtest-reportDonchitos/Claude-Code-Game-StudiosSkill36k19d agoMITA20Claude Code
godot-signals-groupsgamedev-skills/awesome-gamedev-agent-skillsSkill6.9k10d agoApache-2.0A95Claude Code
scenario-unreal-gameplayscenario-labs/skillsSkill3.2kyesterdayMITA121Claude Code
motionOpenDCAI/GameFactory-3ASkill1.0k8d agoApache-2.0A0Claude Code, Codex
unity-addressablesBesty0728/Unity-SkillsSkill1.9kyesterdayMITA25Claude Code, Codex
unity-manual-componentBesty0728/Unity-SkillsSkill1.9kyesterdayMITA36Claude Code, Codex