roblox-game-ux
Skill5 starsChanged 5 months agoMITView on GitHub
Design and critique Roblox game UX, HUDs, menus, onboarding, mobile controls, and progression surfaces. Use when making a Roblox experience feel clear, fast, touch-friendly, and retention-aware.
In this repository39 other files it gives its agents.
- handoffSkill
- roblox-admin-tools-observabilitySkill
- roblox-analytics-instrumentationSkill
- roblox-animation-audio-feedbackSkill
- roblox-asset-pipelineSkill
- roblox-code-maintenance-refactorSkill
- roblox-combat-systemsSkill
- roblox-community-opsSkill
- roblox-creator-store-security-auditSkill
- roblox-datastore-persistenceSkill
- roblox-debugging-bugfixSkill
- roblox-economy-balancingSkill
- roblox-game-development-lifecycleSkill
- roblox-game-ideasSkill
- roblox-genre-patternsSkill
- roblox-growth-marketingSkill
- roblox-liveops-roadmapSkill
- roblox-localization-accessibilitySkill
- roblox-luau-architectureSkill
- roblox-mobile-playtestSkill
- roblox-monetization-optimizationSkill
- roblox-performance-optimizationSkill
- roblox-playtest-qaSkill
- roblox-policy-complianceSkill
- roblox-publishing-discoverySkill
- roblox-quest-progression-systemsSkill
- roblox-release-operationsSkill
- roblox-retention-monetizationSkill
- roblox-security-economySkill
- roblox-social-systemsSkill
- roblox-studio-workflowSkill
- roblox-to-issuesSkill
- roblox-to-prdSkill
- roblox-triageSkill
- roblox-ui-implementationSkill
- roblox-world-level-designSkill
- setup-roblox-skillsSkill
- write-a-skillSkill
- zoom-outSkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 11 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈11
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Put the player into the core action within 10-30 seconds.
- Distinctive: line 12
Keep the first screen focused on play, not menus or exposition.
- Distinctive: line 18
Use large touch targets and generous spacing.
- Distinctive: line 19
Avoid controls that require precision dragging unless the whole game is built around it.
- Distinctive: line 20
Add auto-targeting, aim assist, snapping, or simplified actions where useful.
- Distinctive: line 21
Keep critical buttons away from screen edges and system gesture zones.
- Distinctive: line 27
Keep deep menus optional during the first session.
- Distinctive: line 28
Use clear iconography and consistent button placement.
- Distinctive: line 30
Avoid popups that interrupt core action, especially in the first five minutes.
- Distinctive: line 44
When reviewing a Roblox UX, report:
- Very specific: line 58
Create it under design/features/<feature-slug>/design.md (global patterns live in design/DESIGN.md.
- Distinctive: line 62
Every relevant state: default, empty, loading, error, and permission/locked.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Roblox Game UX
UX Principles
- Put the player into the core action within 10-30 seconds.
- Teach by doing, with objective markers and contextual prompts instead of instruction walls.
- Keep the first screen focused on play, not menus or exposition.
- Make rewards loud enough to understand but short enough to keep momentum.
- Design for phone screens first, then expand to desktop and tablet.
Mobile-First Controls
- Use large touch targets and generous spacing.
- Avoid controls that require precision dragging unless the whole game is built around it.
- Add auto-targeting, aim assist, snapping, or simplified actions where useful.
- Keep critical buttons away from screen edges and system gesture zones.
- Make HUD text readable on small screens and keep important information out of thumb-heavy areas.
HUD And Menus
- Surface current objective, currency, progress, health/energy, and next reward.
- Keep deep menus optional during the first session.
- Use clear iconography and consistent button placement.
- Make progress bars and collection meters visible during the loop.
- Avoid popups that interrupt core action, especially in the first five minutes.
Onboarding Flow
Recommended first-session order:
- Spawn facing the first interactable or objective.
- Prompt one action.
- Give immediate feedback and reward.
- Show the next short goal.
- Reveal social or progression context after the player has already acted.
UX Review Output
When reviewing a Roblox UX, report:
- First-action time.
- Friction points before gameplay.
- Mobile-control risks.
- Missing progression signals.
- Social visibility gaps.
- Monetization interruptions.
- Priority fixes ranked by retention impact.
Design The UI Before It Is Built
For any non-trivial UI surface, produce and get approval on a UI design artifact before roblox-ui-implementation builds it. This is the visual contract; it prevents Claude from improvising layout, states, and mobile behavior mid-build. Roblox UI is built in Studio, so the artifact is a markdown design brief (optionally with reference images/screenshots), not an HTML mockup.
Create it under design/features/<feature-slug>/design.md (global patterns live in design/DESIGN.md; see docs/agents/design.md). The brief must cover:
- User goal and which surface/flow this is (HUD, shop, reward, menu…).
- Layout and responsive behavior across mobile, tablet, and desktop, including safe areas and thumb zones.
- Every relevant state: default, empty, loading, error, and permission/locked.
- Interactions and copy rules.
- A
Status:line —draftuntil the user approves, thenapproved.
Iterate with the user until they approve, then set Status: approved. A UI slice cannot become ready-to-build (in roblox-to-issues / roblox-triage) until this artifact is approved.
Next
Once the design brief is approved, hand it to roblox-ui-implementation to build. If the UI is part of a larger feature, slice it with roblox-to-issues. Verify the built result with roblox-mobile-playtest and roblox-playtest-qa.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

