agent-playtesting

Playtest live games by driving deterministic launches, frame-stamped probes, and scripted input.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that a gameplay feature actually works requires playing the running game, not just reading code or trusting that an action call succeeded. This Skill gives an AI agent a disciplined loop for driving the live Summer Engine game — launching deterministically, probing state and screenshots before and after each action, stepping exact frames, and asserting real changes with frame-number evidence. ## Core Features & Use Cases - Deterministic launches: Start the main game or up to three offscreen instances with pinned seeds and fixed frame rates for reproducible runs and side-by-side A/B comparisons. - Frame-stamped evidence: Use summer_game_probe to capture the live node tree, property values, and a screenshot atomically per frame, then compare before/after probes to prove motion, spawning, or state changes. - Scripted and recorded input: Drive the game with timed synthetic input scripts, or record real input to res://.summer/replays/ and replay it on a deterministic instance for regression checks. - Use Case: After implementing a jump feature, launch an offscreen deterministic instance, probe the player's position at frame N, script a jump input, step exactly 30 physics frames, probe again at frame N+30, and assert the vertical velocity changed — citing both frame numbers as proof. ## Quick Start Playtest the current game by launching a deterministic offscreen instance, probing the player state before and after a scripted move_right input, and report the frame-stamped position change.

Frequently Asked Questions about agent-playtesting

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

FAQPage Schema
How do I verify a game feature works by playing the live game?

Launch the game with summer_play, probe the relevant node properties with summer_game_probe, perform one action, then probe again and compare the two frame-stamped results. Only a before/after probe pair with cited frame numbers proves a change actually happened.

How do I make a game run deterministic for reproducible playtests?

Launch an offscreen instance with summer_play using instance, mode offscreen, and deterministic true, which applies a fixed frame rate, seed, and dummy audio driver. Note the seed pins only the global RNG, not RandomNumberGenerator instances or scripts calling randomize().

What is the difference between scripted input and recorded input replay?

Scripted input is hand-written timed events with exact frame placement, ideal for golden paths and regression checks. Recorded input captures real gameplay into res://.summer/replays/ and replays it verbatim, best for reproducing exactly what a user did or A/B testing two builds.

Why does summer_runtime_set report applied but the game did not change?

An applied result only confirms the write was honoured, not that the game state visibly changed. A script may rewrite the value the same frame, so always probe the frame after the action and compare it with the frame before to confirm the effect.

What happens if the engine build lacks the runtime-control tools?

Engines older than Summer Engine 0.5.66 return engine_lacks_op naming a fallback. Record that as the expected outcome and use the RunVerification probe loop from the playtesting-a-feature skill instead of claiming a runtime playtest.