Create a Roblox API key in Creator Hub
- If you land on the OAuth 2.0 Apps page, click "All Tools" then "API Keys"
Add the required access permissions:
- game-pass:read and game-pass:write for game passes
- developer-product:read and developer-product:write for products
Optionally restrict access to specific experiences
Set the ROBLOX_API_KEY environment variable

Usage

The skill is invoked via:

npx -y bun ${SKILL_DIR}/scripts/cli.ts [command] [subcommand] [args] [options]

Commands

Games

# List all games owned by API key holder
npx -y bun ${SKILL_DIR}/scripts/cli.ts games list

Game Passes

# List all game passes for a universe
npx -y bun ${SKILL_DIR}/scripts/cli.ts passes list <universeId>

# Get specific game pass details
npx -y bun ${SKILL_DIR}/scripts/cli.ts passes get <universeId> <passId>

# Create new game pass
npx -y bun ${SKILL_DIR}/scripts/cli.ts passes create <universeId> --name "VIP Pass" --price 100 --for-sale true

# Update game pass
npx -y bun ${SKILL_DIR}/scripts/cli.ts passes update <universeId> <passId> --price 50

Developer Products

# List all developer products for a universe
npx -y bun ${SKILL_DIR}/scripts/cli.ts products list <universeId>

# Get specific product details
npx -y bun ${SKILL_DIR}/scripts/cli.ts products get <universeId> <productId>

# Create new product
npx -y bun ${SKILL_DIR}/scripts/cli.ts products create <universeId> --name "Gold Coins" --price 25 --for-sale true

# Update product
npx -y bun ${SKILL_DIR}/scripts/cli.ts products update <universeId> <productId> --price 30

Options

Create/Update Flags:

--name <name> - Name of the pass/product (required for create)
--description <desc> - Description text (optional)
--price <robux> - Price in Robux (required for create)
--for-sale <true|false> - Whether item is for sale (default: true)

Output Format

All commands return JSON:

Success:

{
  "success": true,
  "data": [...]
}

Error:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Error description"
  }
}

Error Codes:

MISSING_API_KEY - ROBLOX_API_KEY environment variable not set
INVALID_API_KEY - API key could not be parsed
INVALID_ARGS - Missing required arguments or invalid flag values
NOT_FOUND - Requested resource not found
API_ERROR - Roblox API returned an error
RATE_LIMITED - Max retries exceeded on 429 responses
NETWORK_ERROR - Network request failed

Environment Variables

ROBLOX_API_KEY (required) - Your Roblox Open Cloud API key from Creator Hub

API Permissions

Your API key must have the following permissions:

Feature	Required Permission
Game Passes - Read	`game-pass:read`
Game Passes - Write	`game-pass:write`
Developer Products - Read	`developer-product:read`
Developer Products - Write	`developer-product:write`

Notes

Game passes automatically get a placeholder icon (150x150 green PNG)
All list commands fetch all pages automatically
Rate limiting is handled with exponential backoff (max 3 retries)
Delete operations are not supported (Roblox API limitation)
To disable an item, use --for-sale false in update command

Testing

Run unit tests:

bun test skills/roblox-cli/scripts/__tests__

roblox-cli

Roblox CLI

Features

Setup