skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
farworld-labs/remix-skills59 installs

remix-upload-game

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.

How do I install this agent skill?

npx skills add https://github.com/farworld-labs/remix-skills --skill remix-upload-game
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill facilitates uploading HTML games to the Remix platform using a CLI or REST API. It performs structural validation on the code before upload. It handles API keys through environment variables and interacts with the platform's official endpoints. The main security consideration is the processing of user-provided HTML files which could potentially contain indirect prompt injections.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    1/1 file flagged

What does this agent skill do?

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 login
    • remix 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:

  1. Has <!DOCTYPE html> declaration
  2. Has <meta name="viewport" ...> tag
  3. Has RemixSDK script tag: <script src="https://cdn.jsdelivr.net/npm/@remix-gg/sdk@latest/dist/index.min.js"></script>
  4. No legacy @farcade/game-sdk script tag
  5. Calls singlePlayer.actions.gameOver( OR multiplayer.actions.gameOver( (not both)
  6. Registers .onPlayAgain( callback
  7. Registers .onToggleMute( callback
  8. No localStorage or sessionStorage usage
  9. No inline event handlers (onclick=, onload=, etc.)

Fix any reported issues before proceeding.

3. Create the Game (if needed)

First, use gameId and versionId from task context or prior tool results when available.

Otherwise, check the nearest .remix-cli.json. Older projects may still use .remix-mcp.json. If either already contains gameId and versionId, skip creation and proceed to step 4.

If none of those sources provide 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-cli.json:

{
  "gameId": "<returned game ID>",
  "versionId": "<returned version ID>",
  "name": "<game name>"
}

4. Upload the Code

Read gameId and versionId from task context, prior tool results, .remix-cli.json, or legacy .remix-mcp.json.

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 get and remix games versions thread get are useful post-upload inspection commands.
  • If you need a fresh draft, create a new game entry rather than inventing a version-create route.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/farworld-labs/remix-skills/remix-upload-game">View remix-upload-game on skillZs</a>