mcpField
R
roblox-to-prd

roblox-to-prd

github.com/ashexplainedDocuments3899 installsUpdated 17w ago
Repository

About roblox-to-prd

A skill for converting an already-decided Roblox game concept into a concise, buildable PRD. It defines systems, player flows, persistence, UI, mobile expectations, and risks, then publishes the document for issue breakdown and playtesting.

Key features

  1. 01Synthesizes existing concept and project state
  2. 02Lists server and client systems
  3. 03Documents player flows and economy
  4. 04Covers persistence, UI, and mobile targets
  5. 05Publishes PRD for issue breakdown

Use cases

  1. 01Preparing a buildable Roblox game brief
  2. 02Defining authoritative systems and valuable state
  3. 03Handing a PRD into playtestable task planning

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ashexplained/roblox-skills --skill roblox-to-prd

After installing, type/roblox-to-prdin Claude Code to confirm it loaded.

Details

From the project README

Roblox → PRD

Turn what is already decided into a concise, buildable game design brief (PRD). Do NOT interview the user from scratch — synthesize the concept, conversation, and place state you already have. If the concept has not been pressure-tested yet, run roblox-game-ideas (grilling mode) first.

The tracker location and label vocabulary should have been provided to you in CLAUDE.md / docs/agents/. If not, run setup-roblox-skills.

Why this exists

The single biggest failure mode in AI-built Roblox games is trying to build the whole game in one pass, which leaves everything half-working. A PRD is the contract that a later step (roblox-to-issues) slices into small, independently playtestable pieces. Keep it tight: enough to slice, not a novel.

Process

  1. Read the current state. Connect through roblox-studio-workflow if a place exists. Read ROADMAP.md if present. Use the game's own vocabulary consistently (currency names, entity names, zone names).

  2. Sketch the systems, not the whole game. List the major server-authoritative systems and client controllers this concept needs (core loop, economy, save/load, progression, social, UI surfaces). Flag which hold valuable state (currency, inventory, purchases, rewards, progression) — those must be server-authoritative. Confirm the system list matches the user's expectation before writing.

  3. Handle UI up front. If the concept has meaningful UI, note whether a Roblox UI design artifact exists yet (see roblox-game-ux). If not, record an explicit design step rather than treating UI as ready to build.

  4. Write the PRD using the template, then publish it to the tracker with the needs-triage label/status so it enters the normal flow.

Player Promise

What the player gets, in their words. One or two sentences.

Core Loop

The single repeating loop, start to reward to next goal. Name the first fun action and how fast it happens (target: 10–30 seconds).

First Session

What the first 30–60 seconds look like: spawn, first action, first reward, first visible goal.

Systems To Build

A list of the server-authoritative systems and client controllers. For each: one line on what it does and whether it holds valuable state (server-authoritative) or is client-side presentation.

Player Stories

A numbered list, format: "As a player, I want , so that ." Cover the core loop, progression, social, monetization, and mobile paths. Extensive but plain.

Economy & Monetization

Currency sources and sinks, what is sold (passes, developer products, cosmetics), and the anti-pay-to-win rule for this game. Write "None yet" if pre-monetization.

Persistence

What must survive rejoin/shutdown (currency, inventory, progression, settings) and what is session-only.

UI & Design

Which surfaces need a UI design artifact (HUD, shop, reward, menus) and whether that artifact exists and is approved. For non-UI PRDs, write "No UI design step required."

Mobile & Performance Targets

Mobile-first expectations (touch targets, readability, safe areas) and any frame-rate/instance budgets.

Out Of Scope

What this PRD deliberately does not cover, so slicing stays focused.

Risks

The top 1–3 risks and how each is checked (usually a Studio playtest).

Next

Hand the published PRD to roblox-to-issues to break it into small, playtestable vertical slices. If the PRD flagged UI work, run roblox-game-ux to produce and approve the UI design artifact before UI slices become buildable.

Comments

Markdown supported