remix-agent-publish
Build and publish Remix games with the current Remix toolchain. Use when work touches the official Remix CLI, MCP server, REST publishing APIs, or the @remix-gg/sdk game runtime.
Best use case
remix-agent-publish is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Build and publish Remix games with the current Remix toolchain. Use when work touches the official Remix CLI, MCP server, REST publishing APIs, or the @remix-gg/sdk game runtime.
Teams using remix-agent-publish should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/remix-agent-publish/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How remix-agent-publish Compares
| Feature / Agent | remix-agent-publish | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Build and publish Remix games with the current Remix toolchain. Use when work touches the official Remix CLI, MCP server, REST publishing APIs, or the @remix-gg/sdk game runtime.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
## When to use Use this skill when users want to create, upload, validate, or inspect Remix games from an agent, terminal workflow, or external service. ## How to use - Prefer the `remix-cli` skill for terminal-based auth, config, upload, and analytics flows. - Use the `remix-mcp-quickstart` skill when the user is working through an MCP client. - Read the `remix-api-auth` skill for authentication setup. - Fetch OpenAPI spec at `https://api.remix.gg/docs/json` before generating API calls. - Use the `remix-api-reference` skill for workflow guardrails (not as the method/path source of truth). - For Phaser builds, use the `phaser-2d-arcade` skill. - For lightweight 3D builds, use the `threejs-lite` skill. - Use the `remix-game-sdk` skill when generating or fixing game code. - Apply the `remix-submission-rules` skill for validation requirements. - Follow the `remix-game-best-practices` skill for mobile-first and SDK-safe implementation. - Use the `remix-rest-snippets` skill for client integration examples. - Use the `remix-mcp-quickstart` skill for assistant workflows. ## Available Workflows - `remix-game-creation` - Create a new game draft - `remix-upload-game` - Upload version code - `remix-add-image` - Generate and add images to a game - `remix-add-sprite` - Generate and add sprites to a game - `remix-shop-items` - Create and manage in-game shop items - `remix-multiplayer` - Enable multiplayer support - `remix-save-game` - Add save/load game state - `remix-upload-asset` - Upload images, audio, or 3D models as hosted game assets ## Game Settings Current config files: - task context or prior tool results first - `.remix-cli.json` for project-local config (`gameId`, `versionId`) - legacy `.remix-mcp.json` for older projects - `~/.config/remix/credentials.json` for CLI credentials that MCP can also reuse Reuse existing IDs instead of inventing new ones or blindly calling `createGame`. Some upstream MCP docs still mention `.remix-settings.json`; prefer the current packaged MCP skills and package source when those conflict. ## Inline Validation Before uploading code, run through the validation checklist in the `remix-submission-rules` skill to catch blockers early. ## REST API Workflow All game management is done through REST API calls to `https://api.remix.gg`. The general pattern is: 1. Fetch the OpenAPI spec at `https://api.remix.gg/docs/json` 2. Use the spec to determine exact methods, paths, and schemas 3. Make authenticated REST calls with your API key 4. Check responses for success/error envelopes See the `remix-rest-snippets` and `remix-api-reference` skills for details. ## Source of truth When docs and runtime behavior disagree, defer to the server API source and OpenAPI docs: - `https://api.remix.gg/docs` - `https://api.remix.gg/docs/json` - `packages/cli/src/index.ts` - `packages/mcp/src/core/tool-defs.ts` - `packages/mcp/skills/SKILL.md` - `packages/mcp/skills/workflows/*.md` - `apps/server-api/routes/device-auth.ts` - `@remix-gg/sdk` (NPM package)
Related Skills
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.
remix-upload-asset
Upload images, audio, or 3D models as hosted game assets
remix-submission-rules
Validation and publish constraints for Remix game submissions
remix-shop-items
Create, update, delete, and integrate Remix shop items. Use when a game needs Bits items, consumables, one-time unlocks, tier unlocks, store icons, or purchase handling in @remix-gg/sdk code.
remix-save-game
Add save and load game state functionality via RemixSDK
remix-rest-snippets
REST client snippets for Remix agent publishing
remix-open-game
Open a game in the Remix Studio browser for preview and editing
remix-multiplayer
Enable multiplayer support for a Remix game
remix-game-sdk
Reference for the current @remix-gg/sdk runtime. Use when generating or repairing Remix game code, shop item integrations, save-state flows, multiplayer hooks, or host-safe mobile UI behavior.
remix-game-creation
Create a new game draft via the Remix API
remix-game-best-practices
Mobile-first game creation best practices for Remix
remix-cli
Use the official Remix CLI for authentication, config inspection, game creation, uploads, and analytics. Trigger this skill when a task involves `remix login`, `remix whoami`, `.remix-cli.json`, `REMIX_API_KEY`, or terminal-based game management on Remix.