play

Runs a Summer Engine project and reports runtime errors, warnings, or clean status.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually launching a game project and checking whether it started cleanly is repetitive, and silent script compile errors or runtime crashes are easy to miss. This Skill runs the project in Summer Engine, waits for real frames to process, and reports a clear verdict: clean run, warnings, or a crash with file and line details. ## Core Features & Use Cases - Pre-flight compile check: Calls summer_get_script_errors on recently edited scripts (or summer_get_diagnostics project-wide) before playing, so compile failures surface before a noisy launch. - Controlled run and inspection: Clears the console, starts play with summer_play, waits about two seconds, then reads diagnostics and debugger errors for an accurate report. - Scene targeting and safe behavior: Supports launching a specific scene via a full res:// path, asks before restarting an already-running game, and never auto-stops the session. - Use Case: After editing player movement code, ask the agent to play the game; it verifies the script compiles, launches the project, and reports either a clean run or the exact crash location. ## Quick Start Ask the agent to play the game and tell you whether it runs cleanly or hits any errors.

Frequently Asked Questions about play

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

FAQPage Schema
How do I run and test a Summer Engine game project?

Ask the agent to play the game. It checks for script compile errors first, clears the console, starts the project with summer_play, waits about two seconds, then reports whether the run is clean, has warnings, or crashed.

How do I play a specific scene instead of the main scene?

Pass the scene directly, for example summer_play with scene set to res://scenes/boss_fight.tscn. The path must be a full res:// path, never a bare relative path.

Why does the skill wait before reporting errors?

It waits about two seconds so the engine processes at least one frame. A zero-frame snapshot is meaningless because many runtime errors only appear once the game actually starts executing.

What happens if the game is already running when I say play?

The skill checks with summer_is_running first and asks whether to stop and restart or leave it. It never unilaterally stops a running game, since you likely want it to keep playing.

Why use debugger errors instead of the console for crashes?

summer_get_debugger_errors contains stack traces with file and line numbers, while summer_get_console only holds print output and warnings. For diagnosing crashes, the debugger error stream is the correct source.