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.

• 28 focused skills across Luau, architecture, 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

You can also copy an individual SKILL.md into .claude/skills/, .codex/skills/, .cursor/skills/, or another compatible skill directory.

Skills (28)

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-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 MCP servers

• Roblox Studio MCP: use the official server or a community fork with additional features.
• codebase-memory-mcp: local codebase memory and structural search, saves a lot of tokens.

Contributing

PRs are welcome. Useful contributions include:

• correcting an API reference or deprecated pattern;
• adding a focused 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 roblox-growth-design skill

License

MIT