What this is

roblox-brain gives an AI coding agent focused Roblox Studio knowledge without forcing every task through one framework. Each skill starts small and expands only when the task needs deeper examples or API details.

• 29 focused skills across Luau, architecture, collaboration behavior, game design, networking, UI, physics, data, monetization, localization, tooling, and publishing.
• Guidance grounded in Roblox Creator Hub documentation, compatible external tools, and original synthesis.

Install

# install the full library
npx skills add TabooHarmony/roblox-brain

# install one skill
npx skills add TabooHarmony/roblox-brain --skill roblox-building

To install manually, copy the whole skill directory, not just the file. A SKILL.md is an entry point, not the whole skill: skills link references/full.md for depth and examples, and a file-only copy loses that material.

# whole directory, references included
cp -r skills/roblox-growth-design ~/.claude/skills/

Works the same for .codex/skills/, .cursor/skills/, and other compatible skill directories. A directory copy is self-contained: everything the entry point links ships with it. If an agent hits a link to a references/full.md that was not copied, the right response is to say the reference is missing and ask the user to copy that skill's whole directory from this repo. Never summarize reference material that is not there, and never present it as loaded.

Skills (29)

Core language and architecture

Skill	What it covers
roblox-luau-core	Luau syntax, tables, control flow, string patterns, scope, closures, idioms, and language traps
roblox-luau-types	Types, generics, narrowing, inference, sealed/unsealed tables, exports, and Roblox-aware typing
roblox-luau-patterns	Module boundaries, object lifecycles, signals, scheduling, fallible calls, and cleanup
roblox-architecture	Feature ownership, runtime location, dependencies, startup, and client/server authority

Game design and growth

Skill	What it covers
roblox-growth-design	Discovery, positioning, onboarding, retention, experiments, packaging, LiveOps, and growth diagnosis

Monetization

Skill	What it covers
roblox-monetization	Game Passes, Developer Products, receipts, subscriptions, policy checks, and purchase recovery

Systems and networking

Skill	What it covers
roblox-networking	Server-authoritative networking, remote validation, rate limits, and exploit resistance
roblox-security	Anti-exploit design, movement, remote, economy, and data hardening
roblox-data	Player persistence, schemas, migrations, retries, and session ownership
roblox-server-data	OrderedDataStore, MessagingService, global state, and cross-server coordination
roblox-analytics	Custom events, economy tracking, funnels, rate limits, and event taxonomy
roblox-npc-ai	Pathfinding, state machines, detection, spawning, and network ownership

Performance and runtime

Skill	What it covers
roblox-performance	Profiling, optimization, pooling, streaming, mobile performance, and budgets

Building and UI

Skill	What it covers
roblox-building	Roblox geometry, maps, props, generated assets, MCP workflows, and acceptance gates
roblox-physics	Constraints, vehicles, ragdolls, projectiles, elevators, and network ownership
roblox-gui	Screen, surface, and world UI; layout, responsiveness, input, and UI state
roblox-ui-design	Content-led visual systems, existing-style inheritance, optional simulator styling, composition, and hierarchy
roblox-animation-vfx	Animations, particles, beams, trails, tweens, camera feedback, and cleanup
roblox-lighting	Lighting, atmosphere, post-processing, mood presets, and day/night cycles
roblox-audio	SoundService, spatial audio, music systems, SFX, ambient layers, and volume management
roblox-input	UserInputService, ContextActionService, keyboard, mouse, gamepad, and touch
roblox-camera	Camera types, CFrame math, custom controllers, cutscenes, and screen shake

MCP and cloud

Skill	What it covers
roblox-studio-mcp	Studio MCP capabilities, bridge-neutral routing, reliability, building, and testing workflows
roblox-cloud	Open Cloud REST APIs, API keys, OAuth 2.0, PKCE, webhooks, HttpService, and token lifecycle

Workflow and tooling

Skill	What it covers
roblox-collaboration-mode	Peer vs autonomous working mode, risk-scaled initiative, and surfacing uncertainty before domain work
roblox-code-review	Reviews through security, performance, correctness, and monetization lenses
roblox-publish-checklist	Change-scoped release gates, evidence, dashboard checks, and rollback readiness
roblox-tooling	Rojo, Wally, Selene, StyLua, Lune, Aftman, sourcemaps, and CI
roblox-localization	LocalizationService, translation tables, locale handling, and auto-translation

How the content is organized

Skills use progressive disclosure so an agent can start with a small context window and load detail only when needed:

skills/roblox-gui/
├── SKILL.md              # quick reference
└── references/
    └── full.md           # examples, API notes, and edge cases

1. Discovery: the host reads skill names and descriptions from SKILL.md frontmatter.
2. Quick reference: the selected SKILL.md gives default rules and routing.
3. Full reference: linked references/full.md material is loaded only when the task needs it.

Recommended tooling

• chrrxs/robloxstudio-mcp: the recommended Studio MCP server. Open source (MIT), and adds runtime debugging, multiplayer playtests, profiling, per-instance routing, and more. The official Roblox Studio MCP built into Studio works fine as well if you prefer the built-in option.

Contributing

PRs are welcome. Useful contributions include:

• correcting an API reference or deprecated pattern;
• adding a focused, widely applicable production pattern;
• expanding examples from a compatible license, explicit permission, or original work;
• keeping skills small, non-overlapping, and practical.

Before opening a PR, run:

python3 validate_skills.py
python3 -m unittest discover -s tests -p 'test_*.py'
python3 verify_api_drift.py
python3 verify_source_urls.py
python3 verify_version_pins.py

Contributors

• MrFearTick: code references, networking, and monetization expansion
• eeyq: content and references for the roblox-growth-design skill

License

MIT