# Remix Submission Rules

> Validation and publish constraints for Remix game submissions

- Skill: `basezh/remix-submission-rules` (Agent Skill)
- Install (CLI): `npx skillmds@latest add basezh/remix-submission-rules`
- Raw SKILL.md: https://api.skillmd.com/api/skills/basezh/remix-submission-rules/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: basezh (https://skillmd.com/u/basezh)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/basezh/remix-submission-rules

---


# Submission Requirements

A version should be considered launch-ready only when all are true:

- Game code exists
- Game has name, icon, and >=1 category
- SDK hooks exist in code:
  - HTML `<head>` includes:
    - `<script src="https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js"></script>`
  - `window.RemixSDK.singlePlayer.actions.gameOver(...)`
  - `window.RemixSDK.onPlayAgain(...)`
  - `window.RemixSDK.onToggleMute(...)`

## Agent REST flow constraints

- Create a game draft via `POST /v1/games`.
- Update current version via `POST /v1/games/{gameId}/versions/{versionId}/code`.
- Do not create extra versions from agent REST (no create-version route).
- Do not submit from agent REST (no submit route).
- Never update a live version.

## Metadata requirements (current)

- Name: set via existing game metadata APIs.
- Category: add 1-3 categories via existing game metadata APIs.
- Icon: upload in Remix Studio/app flow (no dedicated agent REST icon route yet).
- Binary assets: upload in Remix Studio/app flow, then use `GET /v1/games/{gameId}/assets` to map hosted URLs into code.

Use `GET /v1/games/{gameId}/versions/{versionId}/validate` to confirm blockers.
Use `GET /v1/games/{gameId}/launch-readiness?versionId={versionId}` when you want an aggregate readiness signal (`valid` + `readyForSubmission`).

