{"skill":{"slug":"roblox-cli","displayName":"Roblox","summary":"Manage Roblox game passes and developer products via Open Cloud API.","description":"---\nname: roblox-cli\ndescription: Manage Roblox game passes and developer products via Open Cloud API.\nmetadata: {\"clawdbot\":{\"requires\":{\"env\":[\"ROBLOX_API_KEY\"]},\"primaryEnv\":\"ROBLOX_API_KEY\",\"emoji\":\"🎮\",\"homepage\":\"https://create.roblox.com/docs/cloud\",\"source\":\"https://github.com/ingalls-ltd/RobloxCliSkillOpenClaw\"}}\n---\n\n# Roblox CLI\n\nManage Roblox game passes and developer products via the Open Cloud API.\n\n## Features\n\n- List games owned by your API key\n- Manage game passes (list, get, create, update)\n- Manage developer products (list, get, create, update)\n- JSON output for easy parsing\n- Automatic pagination\n- Rate limit handling with exponential backoff\n\n## Setup\n\n1. Create a Roblox API key in [Creator Hub](https://create.roblox.com/dashboard/credentials)\n   - If you land on the OAuth 2.0 Apps page, click \"All Tools\" then \"API Keys\"\n2. Add the required access permissions:\n   - `game-pass:read` and `game-pass:write` for game passes\n   - `developer-product:read` and `developer-product:write` for products\n3. Optionally restrict access to specific experiences\n4. Set the `ROBLOX_API_KEY` environment variable\n\n## Usage\n\nThe skill is invoked via:\n```bash\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts [command] [subcommand] [args] [options]\n```\n\n### Commands\n\n**Games**\n```bash\n# List all games owned by API key holder\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts games list\n```\n\n**Game Passes**\n```bash\n# List all game passes for a universe\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts passes list <universeId>\n\n# Get specific game pass details\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts passes get <universeId> <passId>\n\n# Create new game pass\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts passes create <universeId> --name \"VIP Pass\" --price 100 --for-sale true\n\n# Update game pass\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts passes update <universeId> <passId> --price 50\n```\n\n**Developer Products**\n```bash\n# List all developer products for a universe\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts products list <universeId>\n\n# Get specific product details\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts products get <universeId> <productId>\n\n# Create new product\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts products create <universeId> --name \"Gold Coins\" --price 25 --for-sale true\n\n# Update product\nnpx -y bun ${SKILL_DIR}/scripts/cli.ts products update <universeId> <productId> --price 30\n```\n\n## Options\n\n**Create/Update Flags:**\n- `--name <name>` - Name of the pass/product (required for create)\n- `--description <desc>` - Description text (optional)\n- `--price <robux>` - Price in Robux (required for create)\n- `--for-sale <true|false>` - Whether item is for sale (default: true)\n\n## Output Format\n\nAll commands return JSON:\n\n**Success:**\n```json\n{\n  \"success\": true,\n  \"data\": [...]\n}\n```\n\n**Error:**\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ERROR_CODE\",\n    \"message\": \"Error description\"\n  }\n}\n```\n\n**Error Codes:**\n- `MISSING_API_KEY` - ROBLOX_API_KEY environment variable not set\n- `INVALID_API_KEY` - API key could not be parsed\n- `INVALID_ARGS` - Missing required arguments or invalid flag values\n- `NOT_FOUND` - Requested resource not found\n- `API_ERROR` - Roblox API returned an error\n- `RATE_LIMITED` - Max retries exceeded on 429 responses\n- `NETWORK_ERROR` - Network request failed\n\n## Environment Variables\n\n- `ROBLOX_API_KEY` (required) - Your Roblox Open Cloud API key from Creator Hub\n\n## API Permissions\n\nYour API key must have the following permissions:\n\n| Feature | Required Permission |\n|---------|---------------------|\n| Game Passes - Read | `game-pass:read` |\n| Game Passes - Write | `game-pass:write` |\n| Developer Products - Read | `developer-product:read` |\n| Developer Products - Write | `developer-product:write` |\n\n## Notes\n\n- Game passes automatically get a placeholder icon (150x150 green PNG)\n- All list commands fetch all pages automatically\n- Rate limiting is handled with exponential backoff (max 3 retries)\n- Delete operations are not supported (Roblox API limitation)\n- To disable an item, use `--for-sale false` in update command\n\n## Testing\n\nRun unit tests:\n```bash\nbun test skills/roblox-cli/scripts/__tests__\n```\n\n## References\n\n- [Roblox Open Cloud API Documentation](https://create.roblox.com/docs/cloud)\n- [Game Passes API](https://create.roblox.com/docs/cloud/reference/features/game-passes)\n- [Developer Products API](https://create.roblox.com/docs/cloud/reference/features/developer-products)\n- [API Keys Guide](https://create.roblox.com/docs/cloud/auth/api-keys)\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":672,"installsAllTime":25,"installsCurrent":1,"stars":1,"versions":1},"createdAt":1773323996527,"updatedAt":1778491857969},"latestVersion":{"version":"1.0.0","createdAt":1773323996527,"changelog":"Initial release of roblox-cli.\n\n- Manage Roblox game passes and developer products via the Open Cloud API.\n- Supports listing universes.\n- Supports listing, creating, updating, and retrieving game passes and developer products.\n- Automatic pagination, JSON output, and built-in rate limit handling.\n- Requires a Roblox Open Cloud API key with appropriate permissions.\n- CLI accessible using Bun; includes detailed usage instructions and error reporting.","license":"MIT-0"},"metadata":{"setup":[{"key":"ROBLOX_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"teddyengel","userId":"s177qxyhd1f08zj0h49f6crt0d8854f7","displayName":"TeddyEngel","image":"https://avatars.githubusercontent.com/u/5671969?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089858971}}