navigate-summer

Opens Summer Engine editor surfaces and summerengine.com pages for the user via summer_open.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI agents working with Summer Engine need to decide when to open a visible surface for the user (billing, published games, the scene just built) versus acting silently through API tools, and need a reliable way to open the exact page or editor panel without guessing URLs. ## Core Features & Use Cases - Intent-based navigation: Resolves natural-language intents like "billing", "my games", or "res://player.gd" to the correct Studio web page or editor panel using summer_open. - Act-then-show workflow: Enforces the rule that mutations happen through Summer tools first, and surfaces open only afterward when the user asks to see the result. - Honest result handling: Covers every outcome — opened, login required, engine not running, unsupported op, ambiguous match, not found, open failed, blocked origin — so the agent never claims something opened when it did not. - Use Case: After adding a camera node to a scene, the agent runs the mutation, then calls summer_open with the scene target so the user sees the result in the running editor. ## Quick Start Ask the agent to show your billing page or open the scene it just built, and it will resolve the intent and open the correct Summer surface.

Frequently Asked Questions about navigate-summer

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

FAQPage Schema
How do I open the Summer Engine scene I just built?

Call summer_open with the scene target, for example summer_open({ target: "scene", params: { path: "res://levels/level_1.tscn" } }). The scene opens in the running editor; if the engine is not running, start it with summer run <project> and retry.

When should an agent open a page versus act through Summer tools?

Open a surface only when the user wants to see, check, or decide something, such as billing or their published games. When the user wants a change made, act through Summer mutation tools instead and never open the editor as a side effect.

How do I get a link instead of opening a browser with summer_open?

Call summer_open with open set to false, or use summer open --print in a shell. The tool returns the url or login_url without launching anything, which suits headless, remote, or CI sessions.

What happens if Summer Engine is not running when opening an editor target?

The tool returns action engine_not_running and nothing opens. Tell the user to start the engine with summer run <project> or open the project in the desktop app, then offer to retry rather than editing files directly.

Why does summer_open return unsupported for some editor targets?

An unsupported result with failure_reason engine_lacks_op means the installed Summer Engine build predates the Navigate op or does not advertise that target id. The user should update Summer Engine and open the surface manually in the meantime.