farworld-labs/remix-upload-game
skills/remix-upload-game/SKILL.md
Upload and validate HTML game code for Remix. Use when creating or updating a draft version through the CLI, MCP tools, or direct REST calls.
$ install --global
skillsauthnpx skillsauth add farworld-labs/remix-skills remix-upload-gameInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 4, 2026, 8:59 PM367.7s1 file scanned
SKILL.md
- name:
- remix-upload-game
- description:
- Upload and validate HTML game code for Remix. Use when creating or updating a draft version through the CLI, MCP tools, or direct REST calls.
Upload Game Workflow
Overview
This skill guides you through uploading a completed HTML game to the Remix platform. It covers creating the game entry (if needed) and uploading the code.
Prerequisites
- A completed HTML game file, ready for upload.
- Prefer the official CLI for terminal workflows:
remix loginremix games create --name "..."remix games versions code update --code-path ./game.html
Steps
1. Locate the Game File
Find the path to the HTML file to upload. It should be a single self-contained HTML document with inline CSS and JS.
2. Validate
Read the HTML file and verify:
- Has
<!DOCTYPE html>declaration - Has
<meta name="viewport" ...>tag - Has RemixSDK script tag:
<script src="https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js"></script> - No legacy
@farcade/game-sdkscript tag - Calls
singlePlayer.actions.gameOver(ORmultiplayer.actions.gameOver((not both) - Registers
.onPlayAgain(callback - Registers
.onToggleMute(callback - No
localStorageorsessionStorageusage - No inline event handlers (
onclick=,onload=, etc.)
Fix any reported issues before proceeding.
3. Create the Game (if needed)
First, check for a .remix-settings.json file in the project root. If it
exists and contains gameId and versionId, skip creation and proceed to
step 4.
If no settings file exists (or it lacks these IDs), create the game via CLI or REST.
CLI:
remix games create --name "My Game"
REST:
POST https://api.remix.gg/v1/games
Authorization: Bearer $REMIX_API_KEY
Content-Type: application/json
{ "name": "<game name>" }
The response returns the game ID and version ID.
After creation succeeds, write the returned IDs to .remix-settings.json:
{
"gameId": "<returned game ID>",
"versionId": "<returned version ID>",
"name": "<game name>"
}
4. Upload the Code
Read gameId and versionId from .remix-settings.json (or use the values
just obtained from creation).
Preferred CLI path:
remix games versions code update --code-path ./game.html
remix games versions validate get
remix games launch-readiness get
Read the HTML file and pass its content as the code field in the request body:
POST https://api.remix.gg/v1/games/{gameId}/versions/{versionId}/code
Authorization: Bearer $REMIX_API_KEY
Content-Type: application/json
{ "code": "<HTML file contents>" }
The response returns a confirmation with the game ID, version ID, and thread ID.
Tips
- Always validate before uploading to catch issues early.
- You can re-upload code to the same version as many times as needed.
remix games versions status getandremix games versions thread getare useful post-upload inspection commands.- If you need a fresh draft, create a new game entry rather than inventing a version-create route.
Related Skills
farworld-labs/remix-add-image
content-media
VerifiedTrustedCommunity
Generate and add images to a Remix game
9SKILL.mdUpdated Apr 4, 2026
farworld-labs/threejs-lite
development
VerifiedTrustedCommunity
Build lightweight mobile-friendly 3D browser games with Three.js
7SKILL.mdUpdated Apr 4, 2026
farworld-labs/remix-upload-asset
data-ai
VerifiedTrustedCommunity
Upload images, audio, or 3D models as hosted game assets
7SKILL.mdUpdated Apr 4, 2026
farworld-labs/remix-submission-rules
data-ai
VerifiedTrustedCommunity
Validation and publish constraints for Remix game submissions
7SKILL.mdUpdated Apr 4, 2026