scenario-roblox-ui
Use when building or fixing Roblox game UI or input: HUD (health bar, currency, ability cooldowns), main menu, shop with a scrolling grid, settings screen, inventory, \"UI scales wrong on phone\", buttons hidden behind the jump button, UI too small on a tablet or TV, portrait and landscape, top bar…
Install / Use
npx skills add scenario-labs/skills --skill scenario-roblox-uiInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Tags
Our assessment of scenario-roblox-ui
scenario-roblox-ui scores 86/100 on our quality scale, 202nd of 354 Other skills we index.
Its SKILL.md is 21 KB long, well organised into 10 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-roblox-ui is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-roblox-ui compared with similar skills
All 4 of these similar skills score higher than scenario-roblox-ui; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-roblox-ui (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install scenario-roblox-ui?
- Run
npx skills add scenario-labs/skills --skill scenario-roblox-ui. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-roblox-ui work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-roblox-ui safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-roblox-ui still maintained?
- The repository was last updated 35 days ago, so scenario-roblox-ui is actively maintained.
Skill content
View source on GitHubname: scenario-roblox-ui description: "Use when building or fixing Roblox game UI or input: HUD (health bar, currency, ability cooldowns), main menu, shop with a scrolling grid, settings screen, inventory, "UI scales wrong on phone", buttons hidden behind the jump button, UI too small on a tablet or TV, portrait and landscape, top bar and safe area, Scale vs Offset, UIListLayout, UIGridLayout, UIFlexItem, StyleSheets and themes, gamepad or console menu navigation, the Input Action System (InputContext, InputAction, InputBinding), ContextActionService migration, PreferredInput, reduced motion and accessibility, localization and AutoLocalize, React, Fusion or Vide, the Device Simulator, and testing UI without a phone." license: MIT
Roblox UI and Input
Roblox Studio (October 2026 build) on macOS, driven through the scenario-roblox-expert toolkit.
Expert level here means one UI tree that reads the screen and the player's input at runtime, proven by numbers and captures on phones in both orientations, a tablet, PCs, a console and a handheld, without owning any of them. Build the UI as instances in Edit, keep the look in a StyleSheet and the controls in Input Action System (IAS) contexts, then measure it under Studio's device presets and drive it with real clicks and keys.
If a sibling skill named here is missing from your available skills, load it with skill_get
(Scenario MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install);
unattended, proceed from tool schemas and flag the gap.
REQUIRED BACKGROUND: scenario-roblox-expert (channels, review loop, toolkit, current-Roblox traps).
Stance (the expert delta)
- One tree, adapted by measurement. Never build per-device copies (Roblox mobile roundtable,
BsyU-SJ9L-c; RDC 2024 frameworks panel). Lay out by
GuiService.ViewportDisplaySizeand show prompts byUserInputService.PreferredInput(Roblox gamepad doc). Phones take controllers and laptops have touch screens (Roblox IAS Q&A, KnFJl6z5UN0 [00:10:42]), soTouchEnabledandIsTenFootInterfaceguess wrong. - Scale for the shell, Offset for what a thumb or an eye needs. Panels take Scale capped by a
UISizeConstraint; buttons and text take Offset so they stay legible on a phone (roundtable [00:11:15]). Constrain the outer container, not its children (Itz_FloppyFish, BLZl-0cl2DM [00:16:37]). AUIScaleon the whole ScreenGui "breaks everything" (boatbomber, RDC 2024 panel [00:38:15]). - The core touch controls and the top bar own their space. Place custom touch buttons relative
to the
JumpButton(Roblox position-and-size doc). The top bar inset measured 58 px on every preset in Studio 0.743, while the 2023 roundtable slide said 36 (BsyU-SJ9L-c [00:08:20]). UseScreenInsets.CoreUISafeInsetsand measure; never hard-code a margin. - The look lives in a StyleSheet. Tokens hold every repeated value, themes are sheets of
identically named tokens, and query selectors (
@ViewportDisplaySizeLarge,@PreferredInputTouch,@ReducedMotionEnabledFalse) adapt it (Roblox Style Editor video, _k1ea0OIKaU [00:03:52, 00:04:24]). A property set in code beats every StyleRule (StyleSheet doc; measured). A direct read returns the unstyled value: read withGetStyled. - Input is a set of contexts switched with the screen. Gameplay context at Priority 2000, menu
context at 3000 with
Sink, enabled only while the menu is open (IAS doc; derpmonster83, 8nqNw6kSKJ0 [00:08:26]). Priority and Sink live on the context, and equal priorities run in no fixed order (KnFJl6z5UN0 [00:17:26, 00:29:33]). Every action gets a key and a gamepad button. Touch needs aUIButtonbinding only where nothing on screen does the job (abilities, open menu, close); shortcuts for a control the player taps anyway (tab cycling, Confirm for Buy) need none, and UIAudit reports them asias-no-touchinfo. IAS draws no mobile buttons or prompts: you build them (KnFJl6z5UN0 [00:13:30]). - A persistent HUD is a direct child of StarterGui with
ResetOnSpawn = false. Nested in a Folder, the flag is ignored and the HUD resets (on-screen containers doc; measured). - Accessibility is a second channel. Never encode state by color alone (BitwiseAndrea,
accessibility roundtable K1pEI6LVJJA [00:29:24]). No chords, no F keys, WASD and arrows both
(same panel [00:43:15]). Honor
PreferredTransparency,ReducedMotionEnabledandPreferredTextSize(Roblox accessibility doc). Contrast 4.5:1, or 3:1 for text of 24 px and up [added, WCAG]. - Plain instances unless the project already runs a framework. Instances built in Edit are visible to the MCP tools, so audits, layout checks and captures run before Play. Choose React (jsdotlua), Fusion or Vide when many screens share fast-changing state and a team works in Rojo. Then keep game data outside the framework (Leif, Ezk3vEOvv8o [00:13:51]) and benchmark your own code, not stress tests (RDC 2024 panel [00:28:11]).
Establish first
| Input | Changes | Default if nobody says |
| --------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------- |
| Devices and orientations | cell sizes, safe area, StarterGui.ScreenOrientation | phones landscape and portrait, tablet, PC, console, handheld; Sensor |
| A UI framework in the project | where the tree is built and tested | none: instances plus StyleSheet |
| Workspace.PlayerScriptsUseInputActionSystem | default controls on IAS, jump sinkable by a menu | Enabled, set in the Rojo project (scripts cannot write it) |
| Languages | text room, AutoLocalize | English source; test German and +40% pseudo-localization |
| UI art | image slots, 9-slice margins | flat StyleSheet look, Scenario art later |
| Accessibility bar | contrast, motion, target size | 4.5:1, reduced motion honored, 44 px targets |
Procedure
Full code, test ids and results: references/procedures.md. Every stage
runs through scripts/rbx_ui.py and the lead's toolkit; L and O ids refer to
run_live.py.
- Build in Edit (P1).
rbx_ui.build(s)installs the catalog, the kit modules, the client controller (aScriptwith RunContext Client) and the shop server, then runs BuildMenuHud.luau. The HUD holds status top left (display only), the menu button top right and the ability buttons. The menu is aCanvasGrouppanel with tabs in the header and Home, Shop and Settings pages. The shop is aScrollingFramewithAutomaticCanvasSize = Yand aUIGridLayoutwhose cell size comes from the StyleSheet. Dynamic labels setAutoLocalize = false. Code never sets a property that a StyleRule owns. GATE: 30 items, 2 StyleLinks, 0 selector errors, both ScreenGuis direct children of StarterGui withResetOnSpawn = false. - Audit (P2).
rbx_ui.audit(s)runs UIAudit.luau (20 rules: resets, insets, constraints, canvas, strokes, selectors, selection, contrast, IAS coverage and conflicts, legacy input patterns) and the lead'sAudit.ui. The same module runs in Lune on a place file. GATE: 0 error and 0 warn; a fixture with one fault per rule fires every rule. - Layout matrix (P3).
rbx_ui.layout_matrix(pt, rbx_ui.DEVICES, scenes, out)sets nine presets throughStudioDeviceSimulatorServiceinside the playtest. UILayout.luaucheckthen flags offscreen, top bar, safe area, core touch control overlap, small targets, overlap, clipped and small text, and each state is captured. Drive scenes with Scriptable bindings, because a key or click switchesPreferredInputaway from Touch. GATE: 0 warn per device and scene; ability buttons above theJumpButtonon touch; at least one full row of shop cells; contact sheets read. - Mouse (P4).
pt.mousewithinstance_path"LocalPlayer.PlayerGui.Menu..."clicks the PlayerGui copy. AUIButtonbinding set in Edit follows the clone at runtime. GATE: each click changes exactly its attribute; a purchase spends coins on the server once. - Keyboard and contexts (P5).
pt.keyspresses through the IAS. GATE: the cooldown refuses a second use; with the menu open, Q, E and Space never reach gameplay or the jump. - Gamepad as far as Studio reaches (P6). Start selection with
GuiService:Select(grid), move with arrow keys, activate with Return, press gamepad buttons through Scriptable bindings, and read glyphs and sizes under thexboxpreset. GATE: focus moves down and right in the grid; selecting the last item scrolls the canvas; the xbox glyph reads "X". Thumbsticks, the D-pad, ButtonB and the Select button need a controller or the Controller Emulator (gui-paths). - Styles and themes (P7). Swap the theme at runtime with
UIStyle.setTheme, which repoints the design sheet'sStyleDerive. GATE: both themes 0low-contrast; a code-set Size survives every rule. - Preferences and motion (P8). Multiply decorative transparency by
PreferredTransparency; skip the fade when reduced motion is on. GATE: the panel is opaque on the first frame under reduced motion. Volume, camera shake, key rebinding and text size: player-settings.md withUISettings. - Respawn (P9). Kill the character on the server and compare marks on the HUD before and after. GATE: one HUD, state kept, health rebound to the new Humanoid.
- Localization (P10). Translate in place through
LocalizationService:GetTranslatorForLocaleAsync("de"), then add 40% to every localizable string, on the two smallest phones. GATE: 0text-clippedon every page in both passes. - Scenario UI art (P12). Item icons, frames and button skins come from scenario-game-assets as
transparent PNGs. Upload them only with the user's go, then set
Icon.Imageper cell andScaleType = SlicewithSliceCenterfor frames. Keep text out of the art.
Numbers
| Value | Relative to | Source |
| ---------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------------ |
| Top bar inset 58 px on every preset | GuiService.TopbarInset, Studio 0.743 | measured (2023 slide: 36) |
| iPhone 7 666x374, iPhone 14 749x388 (portrait 388x762), Galaxy A06 705x338 | viewport, simulator preset | measured |
| iPad 10th gen 1179x819, laptop 1365x768, 1080p and Xbox 1919x1079 | viewport, simulator preset | measured |
| Small: phones and handheld; Medium: iPad, laptop, 1080p; Large: Xbox | ViewportDisplaySize | measured |
| JumpButton 70 px at (1,-95, 1,-90) on phones; 120 px at (1,-170, 1,-210) on iPad | screen corner | measured |
Truncated for display — read the full file on GitHub.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
