using-summer

Establishes session bootstrap rules for locating and invoking Summer skills and MCP tools.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding agents working on Summer Engine game projects often skip the right skill, edit scene files directly, or misuse MCP tools, causing broken scenes and inconsistent results. This Skill forces a session bootstrap that routes every request through the correct Summer skill or summer_* MCP tool before any response. ## Core Features & Use Cases - Skill routing discipline: Defines a mandatory check-then-invoke rule so the agent loads the relevant Summer skill (brainstorm-game, debug, fps-controller, gdscript-patterns, and more) before acting. - MCP usage guidance: Explains how to drive the running Summer Engine via summer_* tools on localhost:6550 instead of hand-editing .tscn files, plus recovery steps when the engine is not running. - Library discovery: Shows how to query summer_search_library and summer_read_library to find the right skill, tool, template, or reference for a task. - Use Case: A user asks their agent to add an FPS controller; the agent first loads scene-composition and fps-controller skills, then uses summer_add_node and summer_set_prop against the live engine rather than editing files. ## Quick Start Start a conversation in a Summer Engine project and let the agent load this bootstrap skill before answering any game-development request.

Frequently Asked Questions about using-summer

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

FAQPage Schema
How do I use Summer skills in Claude Code or Cursor?

Use the Skill tool to invoke a Summer skill by its slug, such as brainstorm-game or fps-controller, and its content loads into context. Never read the skill file directly; Gemini CLI uses activate_skill and OpenCode uses its native skill mechanism.

How do I find the right Summer skill or MCP tool for a task?

Call summer_search_library with the task in plain words, then summer_read_library with the chosen id to get the entry body and metadata. From a shell, use summer tool search-library and summer tool read-library, which work without the engine running.

Can I edit .tscn scene files directly instead of using MCP tools?

No. The Summer Engine holds in-memory state that diverges from disk, so saving from the editor overwrites manual file edits. Use summer_get_scene_tree, summer_inspect_node, summer_add_node, and summer_set_prop against the running engine instead.

What happens if the Summer Engine is not running when I call an MCP tool?

The tool returns an error directing you to run summer run or open the project in Summer Engine. The MCP server lazy-reconnects on the next call, so you can do non-MCP work like drafting GDScript while waiting.

Should I write game code in GDScript or C# with Summer?

GDScript is the default and best supported by Summer skills like gdscript-patterns. C# is supported via the shipped Mono build, but confirm with the user first since lifecycle, signals, and export attributes differ from GDScript idioms.

How do I fix stale Summer skills or missing MCP tools?

Run summer doctor to check auth, engine, port, and skill state. If it reports stale versions, run npx clear-npx-cache followed by npx -y summer-engine@latest setup <agent> --yes --force, then restart the agent session.