remote-deploy

Deploy and debug game builds on physical devices via runnable export presets.

66|4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/SummerEngine/summer --skill remote-deploy-summerengine
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: remote-deploy
Source: https://github.com/SummerEngine/summer/tree/main/library/skills/remote-deploy
Command: npx skills add https://github.com/SummerEngine/summer --skill remote-deploy-summerengine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Testing a game only inside the editor hides real-device issues with input, performance, and screen behavior. This Skill guides you through running a debug build on an actual phone, tablet, or another computer while keeping the editor's debugger, console, and profiler connected. ## Core Features & Use Cases - Capability verification: Checks the exact engine build's export templates and platform toolchain before attempting any deploy, so you never chase a target the build cannot support. - Prerequisite orchestration: Walks through script-error checks, runnable export preset configuration in export_presets.cfg, main scene validation, and device detection in the correct order. - On-device debugging: Explains how the deployed debug build connects back to the editor so Output, breakpoints, and the profiler work exactly like a local run. - Use Case: A user says "run this on my Android phone" but the Remote Deploy button is greyed out. The Skill diagnoses that the preset is not marked Runnable, the device is unauthorized in adb, and walks through fixing each gate. ## Quick Start Ask the agent to check why the Remote Deploy button is greyed out and get the game running on your connected phone.

Frequently Asked Questions about remote-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run my game on a real phone or tablet?

Use the Remote Deploy button in the editor topnav, which exports a debug build, installs it on the device, and connects it back to the editor debugger. You first need a runnable export preset for the platform and a detected, authorized device.

Why is the Remote Deploy button greyed out?

The button is disabled when no runnable export preset exists or no device is detected for that platform. Check export_presets.cfg for a preset with runnable=true, then confirm the device is connected and authorized, for example via adb devices for Android.

What is the difference between Remote Deploy and exporting a release build?

Remote Deploy creates debug builds for on-device testing with live debugger access. Release builds for Steam, itch, or app stores are handled by the separate export-and-ship workflow, not Remote Deploy.

Can I deploy to Web or iOS from a stock Summer Mono build?

Web export is impossible on the stock Summer 4.6.1 Mono build, which ships only the macOS template. Android and iOS require matching export templates plus their toolchains, such as the Android SDK with adb or Xcode with a signing identity.

Why does my Android device not appear in the Remote Deploy dropdown?

The device is likely unauthorized or USB debugging is disabled. Enable Developer Options and USB debugging on the phone, reconnect it, accept the allow-debugging prompt, and confirm adb devices lists it as device rather than unauthorized.

Can Remote Deploy be triggered through an MCP tool or script?

No, there is no summer_* MCP tool that triggers Remote Deploy; it is a UI action only. The agent's role is to verify prerequisites like templates, presets, and devices, then direct the user to the button.