summer-engine 3.4.1 → 3.5.0

package/dist/mcp/tools/creator-tools.js

@@ -40,7 +40,7 @@ async function creatorResult(operation) {
     }
 }
 export function registerCreatorTools(server) {
-    server.tool("summer_export_game", "Export the game in the exact file the Summer Games store takes, with the installed Summer Engine headless (no window). format \"bundle\" (default): the summer.games .zip the Summer apps run on iPhone, Android, macOS and Windows; targets picks the platforms (a game without a server: ios and android only); upload it with summer_publish_build. format \"download\" with one target: web (an HTML5 .zip on Summer's WebGPU Forward+ web template, played on summer.games), macos (.app zip, macos-universal) or windows (.exe zip, windows-x64); these need the export template from summer_export_templates and are uploaded as store versions. Needs Summer Engine 0.7.0 or newer: an older engine is refused before anything is written (code engine_too_old). Works without the editor running. Returns path, sha256, size, the manifest or store platform, and warnings.", {
+    server.tool("summer_export_game", "Export the game in the exact file the Summer Games store takes, with the installed Summer Engine headless (no window). format \"bundle\" (default): the summer.games .zip the Summer apps run on iPhone, Android, macOS and Windows; targets picks the platforms (a game without a server: ios and android only); upload it with summer_publish_build. format \"download\" with one target: web (an HTML5 .zip on Summer's WebGPU Forward+ web template, played on summer.games), macos (.app zip, macos-universal) or windows (.exe zip, windows-x64); these need the export template from summer_export_templates and are uploaded as store versions. Needs Summer Engine 0.7.0 or newer: an older engine is refused before anything is written (code engine_too_old). A target the installed engine cannot build (android needs 0.7.1) is left out: the other targets export, and skippedTargets plus a warning name it. A game with a server declares its platforms in summer.build.json; when they differ from the exported targets a warning says so (summer_publish_build would be refused), and alignDeclaration:true aligns them. Works without the editor running. Returns path, sha256, size, the manifest or store platform, and warnings.", {
         project: z.string().optional().describe("Project folder with project.godot. Defaults to the MCP's bound project, then the working directory."),
         out: z.string().optional().describe("Output .zip path. Defaults to <project>/.summer/exports/."),
         targets: z
@@ -53,7 +53,11 @@ export function registerCreatorTools(server) {
             .describe("bundle (default): the summer.games store build. download: a web build or native download; the default when targets is [\"web\"]."),
         debug: z.boolean().default(false).describe("Export a debug build (--export-debug)."),
         timeoutSeconds: z.number().int().min(10).max(7200).optional().describe("Stop the engine after this many seconds (default 900; a first export imports every asset)."),
-    }, async ({ project, out, targets, format, debug, timeoutSeconds }) => creatorResult(() => exportGame({ project, out, targets, format, debug, ...(timeoutSeconds ? { timeoutMs: timeoutSeconds * 1000 } : {}) })));
+        alignDeclaration: z
+            .boolean()
+            .optional()
+            .describe("A game with a server: set summer.build.json targetPlatforms to targets before exporting. The store refuses an upload whose declaration differs from the exported platforms (declaration_mismatch) and that spends the version."),
+    }, async ({ project, out, targets, format, debug, timeoutSeconds, alignDeclaration }) => creatorResult(() => exportGame({ project, out, targets, format, debug, alignDeclaration, ...(timeoutSeconds ? { timeoutMs: timeoutSeconds * 1000 } : {}) })));
     server.tool("summer_export_templates", "List, download and install Summer Engine export templates from Summer's CDN into the folder the installed engine reads, checking each file's sha256. Needed only for summer_export_game format \"download\": web (Summer's WebGPU Forward+ template), macos, windows. Store bundles (format \"bundle\") need no template. action list shows what is installed and published; action install fetches the platforms asked (default web).", {
         action: z.enum(["list", "install"]).describe("list: installed and published templates. install: download and install."),
         platforms: z
@@ -66,7 +70,7 @@ export function registerCreatorTools(server) {
             .optional()
             .describe("The installed Summer Engine version (Help > About, e.g. 0.7.1). Read automatically on macOS; needed on Windows and Linux."),
     }, async ({ action, platforms, includeDebug, summerVersion }) => creatorResult(() => exportTemplates({ action, platforms, includeDebug, summerVersion })));
-    server.tool("summer_capture_gameplay", "Capture real gameplay frames without a running editor: starts the game in Summer Engine's offscreen verify instance (a real renderer, a window parked offscreen with no focus, never on screen), lets it run waitSeconds, and saves PNG frames of what the game draws, HUD included. Use for store screenshots (1920x1080 landscape or 1080x1920 portrait). With an editor open, summer_screenshot target game also works. Returns each frame's path, width and height; look at them before using them.", {
+    server.tool("summer_capture_gameplay", "Capture real gameplay frames without a running editor: starts the game in Summer Engine's offscreen verify instance (--summer-offscreen: a real renderer, a window parked offscreen with no focus, never on screen), lets it run waitSeconds, runs steps, and saves PNG frames of what the game draws, HUD included. Use for store screenshots (1920x1080 landscape or 1080x1920 portrait). The main scene is often a title menu: pass the game's own flags in args (after \"--\", e.g. [\"--autostart\"]), a gameplay scene, or steps that play like a player: [{press:\"Play\"}, {wait:3000}, {key:\"Space\"}, {action:\"jump\"}, {click:[960,540]}, {drag:{from:[400,800],to:[1400,800]}}, {shot:true}]. With a shot step, only shot steps save frames; without one, frames are saved after the steps. A step that cannot run (no such button, key or action) becomes a warning. With an editor open, summer_screenshot target game also works. Returns each frame's path, width and height; look at them before using them.", {
         project: z.string().optional().describe("Project folder with project.godot. Defaults to the MCP's bound project, then the working directory."),
         scene: z.string().optional().describe("Scene to start (res://... or uid://...). Default: the project's main scene, which is often a title menu; pass the gameplay scene for gameplay frames."),
         resolution: z.string().optional().describe("Window size WIDTHxHEIGHT (default 1920x1080; 1080x1920 for portrait)."),
@@ -74,6 +78,31 @@ export function registerCreatorTools(server) {
         waitSeconds: z.number().min(0).max(120).optional().describe("Seconds the game runs before the first frame (default 3)."),
         intervalSeconds: z.number().min(0.1).max(60).optional().describe("Seconds between frames (default 1)."),
         out: z.string().optional().describe("Output folder. Defaults to <project>/.summer/captures/<time>/ (ignored by git)."),
+        args: z
+            .array(z.string())
+            .max(32)
+            .optional()
+            .describe('The game\'s own command-line flags, passed after "--" (OS.get_cmdline_user_args()), e.g. ["--autostart", "--solo"] to skip the title screen.'),
+        steps: z
+            .array(z
+            .object({
+            press: z.string().optional().describe("Press the visible button with this text (or node name); waits up to timeoutSeconds (default 10) for it."),
+            timeoutSeconds: z.number().min(0).max(60).optional(),
+            key: z.string().optional().describe("Press a key by Godot name: Space, Enter, Escape, A, Up."),
+            action: z.string().optional().describe("Press an input action from the project's InputMap, e.g. jump."),
+            holdMs: z.number().min(0).max(10000).optional().describe("How long key or action is held (default 100)."),
+            click: z.tuple([z.number(), z.number()]).optional().describe("Left-click at [x, y] in frame pixels."),
+            drag: z
+                .object({ from: z.tuple([z.number(), z.number()]), to: z.tuple([z.number(), z.number()]), ms: z.number().min(0).max(10000).optional() })
+                .optional()
+                .describe("Drag with the left button from [x, y] to [x, y] over ms (default 300)."),
+            wait: z.number().min(0).max(60000).optional().describe("Wait this many milliseconds."),
+            shot: z.boolean().optional().describe("true: save a frame now."),
+        })
+            .strict())
+            .max(50)
+            .optional()
+            .describe("What to do after waitSeconds, in order; exactly one of press, key, action, click, drag, wait, shot per step."),
     }, async (args) => creatorResult(() => captureGameplay(args)));
     server.tool("summer_publish_build", "Upload an export from summer_export_game to the creator's game on summer.games, through the same store upload Studio uses, straight from disk. A store bundle (format bundle): declare, upload parts, seal, wait until Summer makes the Build, name its client pack, and with publish=true approve it. A web build or native download (format download): upload it as the game's store version for its platform (web, macos-universal, windows-x64, linux-x64; read from the last export) and wait until Summer has checked it. First call with confirm=false: it checks that the game exists for this account and warns when its store page does not list the export's platforms, then returns the target (game name and id, file, digest, size, version) to show the user; set confirm only after they approve. Needs \"summer login --store\". A retry with the same file and clientVersion continues the same upload. Nothing here makes a game live: the owner approves publishing (summer_store_submit).", {
         gameId: z.string().optional().describe("The store game id (from summer_store_list_games, or the Studio store page URL). Without it the call fails with game_required and lists your store games, or says why the store did not list them."),

package/dist/mcp/tools/generate-tools.js

@@ -1,10 +1,7 @@
 import { z } from "zod";
 import { BOARD_ENDPOINT, boardArgsSchema, boardContent, boardQuery } from "../../core/capabilities/board.js";
-import { imageGenerationArgsSchema } from "../../core/capabilities/image-generation.js";
+import { IMAGE_GENERATION_TIMEOUT_MS, imageGenerationArgsSchema, saveGeneratedImage } from "../../core/capabilities/image-generation.js";
 import { buildMotionRequestBody, motionErrorHint, motionGenerationArgsSchema, motionJobFailureHint, } from "../../core/capabilities/motion-generation.js";
-import { writeFile, mkdir } from "fs/promises";
-import { tmpdir } from "os";
-import { join } from "path";
 import { getAuthToken } from "../../core/auth.js";
 import { resolveGatewayUrl } from "../../core/config.js";
 import { readJsonResponse } from "../../core/util/http.js";
@@ -151,26 +148,6 @@ async function mcpGet(endpoint, searchParams, timeoutMs = 30_000) {
     }
     return { data, status: res.status };
 }
-/**
- * Download an image URL to a temp file so the AI can Read it and show the user.
- */
-async function downloadToTemp(url, prefix, ext = "png") {
-    try {
-        const dir = join(tmpdir(), "summer-gen");
-        await mkdir(dir, { recursive: true });
-        const filename = `${prefix}-${Date.now()}.${ext}`;
-        const filepath = join(dir, filename);
-        const res = await fetch(url, { signal: AbortSignal.timeout(30_000) });
-        if (!res.ok)
-            return null;
-        const buffer = Buffer.from(await res.arrayBuffer());
-        await writeFile(filepath, buffer);
-        return filepath;
-    }
-    catch {
-        return null;
-    }
-}
 /**
  * Poll a job until completed, failed, or timeout.
  * Returns the final job status object.
@@ -281,7 +258,8 @@ Requires authentication: run 'npx -y summer-engine@latest login' first.`, boardA
     server.tool("summer_generate_image", `Generate an image using AI models via Summer Engine Studio.
 
 Known models:
-  - "nano-banana-2" (default) — High quality, supports txt2img and img2img
+  - "nano-banana-2" — High quality, supports txt2img and img2img (used when no
+    model and no size is asked)
   - "gemini-flash" — Google Gemini 2.5 Flash, fast
   - "flux-2" — FLUX.2, good for specific styles
 
@@ -300,17 +278,20 @@ guarantee transparency; background removal runs server-side after generation.
 Size: aspectRatio (1:1, 16:9, 9:16, 4:3, 3:4, ...) or width + height (the
 smallest size you need). For store art ask width 1920 height 1080 (key art)
 or width 1080 height 1920 (tall cover): the server picks a model that reaches
-that size, or refuses a named model that cannot, before anything is spent.
+that size when model is omitted, or refuses a named model that cannot, before
+anything is spent. Larger models can take over a minute; the call waits up to
+3 minutes.
 Each result reports the real width and height and the model that ran.
 
 'options' carries extra model params (seed, negative_prompt, ...); the result
 lists any the server did not use in ignoredOptions.
 
-Returns the asset with fileUrl (hosted) and localPath (temp file on disk).
+Returns the asset with fileUrl (hosted) and localPath: the file on disk, in
+'out' (a folder, or a .png/.jpg/.webp path) or else <TMPDIR>/summer-gen/.
 Use the Read tool on localPath to show the image to the user for approval.
 
 Cloud tool — runs on Summer's servers and works WITHOUT the Summer Engine app open.
-Requires authentication: run 'npx -y summer-engine@latest login' first.`, imageGenerationArgsSchema.shape, async ({ prompt, model, style, referenceImageUrl, removeBackground, aspectRatio, width, height, options }) => {
+Requires authentication: run 'npx -y summer-engine@latest login' first.`, imageGenerationArgsSchema.shape, async ({ prompt, model, style, referenceImageUrl, removeBackground, aspectRatio, width, height, options, out }) => {
         const result = await mcpGenerate("/api/mcp/generate/image", {
             prompt,
             model,
@@ -321,7 +302,7 @@ Requires authentication: run 'npx -y summer-engine@latest login' first.`, imageG
             width,
             height,
             options,
-        });
+        }, IMAGE_GENERATION_TIMEOUT_MS);
         if (result.error) {
             return errorResult(result.error, result.data);
         }
@@ -329,7 +310,7 @@ Requires authentication: run 'npx -y summer-engine@latest login' first.`, imageG
         const imageUrl = result.data?.asset?.fileUrl || result.data?.asset?.thumbnailUrl;
         let localPath = null;
         if (imageUrl) {
-            localPath = await downloadToTemp(imageUrl, "img");
+            localPath = await saveGeneratedImage(imageUrl, out);
         }
         return successResult({
             ...result.data,

package/dist/mcp/tools/library-tools.d.ts

@@ -3,7 +3,8 @@
  * librarian. Behavior lives in src/core/library-search.ts and
  * src/core/library-read.ts; `summer tool search-library|read-library`
  * (src/core/capabilities/tool-dispatch.ts) calls the same functions.
- * Engine-free: both read the library shipped with this package.
+ * Engine-free: both read the library shipped with this package; a hosted
+ * skill's body comes from the hosted Summer Engine MCP when signed in.
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare const SEARCH_LIBRARY_DESCRIPTION: string;

package/dist/mcp/tools/library-tools.js

@@ -15,6 +15,7 @@ export const READ_LIBRARY_DESCRIPTION = "Load one library entry by id (<kind>/<s
     "Skills: the SKILL.md body plus metadata (status, use_when, related) and how to invoke the skill in your host (bare slug). " +
     "Tools: how to call it (MCP name, `summer tool <slug> --args`, engine requirement, authority) plus the descriptor. " +
     "Templates: the pinned repo @ commit and tree digest (or built-in) and the `summer create <slug>` command. References: the markdown body. " +
+    "Hosted skills (publish-your-game, store-listing, store-art, grow-analytics; also by their summer://skills/<slug> URI): the current text from the hosted Summer Engine MCP with the store sign-in, else the local summary plus why and how to load the rest. " +
     "Linked files: a body ends with its relative links and the id that loads each; a file an entry links loads by <entry id>/<link as written> " +
     "(e.g. skill/spatial-placement/references/kit-placement-tools.md), by the relative path alone when one entry ships it, inside library/ only. " +
     "part: 'skill' = body only, 'resource' = the resource.yaml descriptor only, 'all' (default) = both. " +

package/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/gemini — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Agent tooling for Summer Engine: MCP bridge, context primer, and game-dev skills. Use with the npm CLI for skill files on disk.",
   "contextFileName": "GEMINI.md",
   "mcpServers": {
@@ -68,6 +68,7 @@
     "./library/skills/gdscript-patterns/",
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
+    "./library/skills/grow-analytics/",
     "./library/skills/headless-scripting/",
     "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
@@ -90,6 +91,7 @@
     "./library/skills/procedural-animation/",
     "./library/skills/prop-model/",
     "./library/skills/psx-retro-rendering/",
+    "./library/skills/publish-your-game/",
     "./library/skills/realtime-wet-surfaces/",
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
@@ -107,6 +109,8 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/store-art/",
+    "./library/skills/store-listing/",
     "./library/skills/summer-analytics/",
     "./library/skills/summer-friends/",
     "./library/skills/summer-leaderboards/",

package/library/references/mcp-tools-reference/mcp-tools-reference.md

@@ -248,7 +248,7 @@ Preview. One fast, read-only call that walks every node of a 3D scene and lists
 | `summer_creator_publish` | **Deprecated** (use the two tools above). Compute the exact `.pck` digest and size, require user confirmation, then run versioned prepare → write-once upload → finalize. The server independently verifies `publish` scope, ownership, bytes, and review state. |
 | `summer_creator_releases` | **Deprecated.** Lists releases on the legacy creator API. For summer.games use `summer_store_releases` (hosted, mounted after `summer login --store`). |
 | `summer_creator_config` | Read or confirm updates to the shared non-secret `~/.summer/config.json`. It never accepts or returns tokens. |
-| `summer_capture_gameplay` | Real gameplay frames without a running editor: starts the game (main scene or `scene`) in the engine's offscreen verify instance (`--summer-verify`, real renderer, window parked offscreen, no focus) at `resolution` (default `1920x1080`), waits `waitSeconds`, saves `frames` PNGs (HUD included) to `<project>/.summer/captures/<time>/`. Imports the project first when `.godot/` is missing. Returns each path with its real width and height; warns when the stretch settings render another size. For store screenshots. |
+| `summer_capture_gameplay` | Real gameplay frames without a running editor: starts the game (main scene or `scene`) in the engine's offscreen verify instance (`--summer-verify`, real renderer, window parked offscreen, no focus) (`--summer-offscreen`) at `resolution` (default `1920x1080`), waits `waitSeconds`, runs `steps` (`press` a button by text, `key`, `action`, `click`, `drag`, `wait`, `shot`), saves `frames` PNGs (HUD included; with a `shot` step, one per shot) to `<project>/.summer/captures/<time>/`. `args` are the game's own flags, passed after `--` (e.g. `["--autostart"]` to skip the title screen). Imports the project first when `.godot/` is missing. Returns each path with its real width and height; warns when the stretch settings render another size. For store screenshots. |
 
 ### Library search (2)
 

package/library/skills/README.md

@@ -1,6 +1,6 @@
 # Summer skills
 
-> 118 skills, grouped by their primary domain. **Generated** by `npm run generate:registry` from each skill's `resource.yaml`; `--check` fails when this file and the library disagree. Do not edit by hand.
+> 122 skills, grouped by their primary domain. **Generated** by `npm run generate:registry` from each skill's `resource.yaml`; `--check` fails when this file and the library disagree. Do not edit by hand.
 
 The folder is flat on purpose (`docs/design/DECISIONS.md`, D3): a skill usually belongs to several domains, so categories live in each skill's `facets.domains` and this index is rendered from them. The first domain listed is the primary one. `summer skills list --by-domain` prints the same grouping; `summer skills info <slug>` shows one skill.
 
@@ -16,6 +16,7 @@ Status: **stable** unless marked; *preview* = not yet exercised in-engine by the
 - [assets](#assets) (3)
 - [audio](#audio) (6)
 - [character-controller](#character-controller) (2)
+- [creator](#creator) (4)
 - [debug](#debug) (1)
 - [deployment](#deployment) (2)
 - [editor](#editor) (1)
@@ -126,6 +127,15 @@ Status: **stable** unless marked; *preview* = not yet exercised in-engine by the
 | [*character-movement*](./character-movement/SKILL.md) (preview) | Player controllers for 2D and 3D, plus the canonical third-person controller for Summer humanoid packages: movement owns translation, clips follow state. | gameplay, 2d, 3d |
 | [fps-controller](./fps-controller/SKILL.md) ★ | Production-quality first-person controller — WASD, mouse look, jump, coyote time, jump buffering, air control, and external-velocity handling. | gameplay |
 
+## creator
+
+| skill | when to use | also |
+|---|---|---|
+| [grow-analytics](./grow-analytics/SKILL.md) | Read and analyse a creator's Summer Grow numbers: store page views, launches, play sessions, play time; compare windows, flag drops. | deployment |
+| [publish-your-game](./publish-your-game/SKILL.md) | Publish a Summer game on Summer Games through MCP: store page, art, build upload, submit, and one approval link for the owner. | deployment |
+| [store-art](./store-art/SKILL.md) | Make Summer Games store art per slot and flow: key art, covers, icons, screenshots, trailer: size, shape, text rules, fallbacks. | assets |
+| [store-listing](./store-listing/SKILL.md) | Write a Summer Games store page per flow (desktop, mobile): targets, title, tagline, descriptions, tags, and what never to write. | product-language |
+
 ## debug
 
 | skill | when to use | also |

package/library/skills/export-and-ship/SKILL.md

@@ -298,7 +298,7 @@ Per platform, point the user at the correct upload path:
 - **summer.games:** `summer_export_game` writes the summer.games `.zip`; `summer_publish_build` uploads it to the game's store listing after the user confirms the exact game, file and version (needs `summer login --store`). If it answers `store_auth_refused`, the user uploads the `.zip` in Studio instead.
   - Per platform, the store takes: iPhone, Android, macOS and Windows in the Summer apps = one summer.games bundle (`summer_export_game` `targets`, format `bundle`; no template, no signing; a game without a server targets `ios`/`android` only). Web = an HTML5 `.zip` on Summer's WebGPU Forward+ template (`targets:["web"]`; the project must render with Forward+ or Mobile). A macOS or Windows download for the store page = `targets:["macos"]` or `["windows"]` with format `download`. Download exports need the template: `summer_export_templates` `install` fetches it from Summer's CDN.
   - Hosted games: if `summer_export_game` fails with "… is in the source graph's authority_engine domain, which the client pack leaves out", an authority root in `source-domains.json` holds a file the client loads (often the composition `.tres`). Narrow that root to the server-only files, or move the shared file under a `shared` path, then export again. Every exporter message is in the `multiplayer-publish` skill's export-errors.md; the folder rules are in `multiplayer-project`.
-  - Store page art: key art, covers and icons carry no text, logos or UI (the store page shows the title). Screenshots are real gameplay and may show the game's own HUD; add no captions, logos or overlays. Capture them with `summer_capture_gameplay` (offscreen, no editor needed; `resolution` `1920x1080`, or `1080x1920` for portrait; pass the gameplay `scene` when the main scene is a title menu), or `summer_screenshot` target `game` while the editor runs the game.
+  - Store page art: key art, covers and icons carry no text, logos or UI (the store page shows the title). Screenshots are real gameplay and may show the game's own HUD; add no captions, logos or overlays. Capture them with `summer_capture_gameplay` (offscreen, no editor needed; `resolution` `1920x1080`, or `1080x1920` for portrait; get past a title menu with the game's own flags in `args`, e.g. `["--autostart"]`, or `steps` such as `[{"press":"Play"},{"wait":3000},{"shot":true}]`), or `summer_screenshot` target `game` while the editor runs the game.
 - **Steam:** `steamcmd` + Steam Pipe (`builder_app_xxx.vdf`). Set up depots first in Steamworks.
 - **itch.io:** `butler push <path> <user>/<game>:<channel>` (e.g. `butler push build/win <user>/mygame:windows`).
 - **Web (itch hosted):** zip + drop into itch upload UI as "playable in browser".

package/library/skills/export-and-ship/resource.yaml

@@ -6,7 +6,7 @@ use_when:
   - the user wants to assess or prepare a Summer game export — Steam, itch, HTML5, iOS, Android targets as available in the installed build
   - the user says 'publish my game', 'release it', or 'ship a build to players' — produce the build they will upload
 do_not_use_when:
-  - publishing, uploading, hosting, or submitting a game — this skill only produces local builds
+  - publishing, uploading, hosting, or submitting a game — this skill only produces local builds; publishing is skill/publish-your-game
 facets:
   lifecycle:
     - launch
@@ -21,6 +21,7 @@ related:
   skills:
     - skill/debug
     - skill/tune-performance
+    - skill/publish-your-game
 source: official
 license: MIT
 status: stable

package/library/skills/grow-analytics/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: grow-analytics
+description: "Read and analyse a creator's Summer Grow numbers: store page views, launches, play sessions, play time; compare windows, flag drops."
+license: MIT
+compatibility: [Cursor, Claude Code, Windsurf, Codex]
+category: deployment
+user-invocable: true
+allowed-tools: summer_read_library
+---
+
+# /grow-analytics — grow analytics
+
+This skill covers how to read a creator's Summer Grow numbers (store page views, launches, play sessions, play time) and analyse them: compare windows, walk the funnel, flag drops, give one next step.
+
+Its current text lives on the hosted Summer Engine MCP, the same text the Studio agent reads, so it changes with the store and is never stale here. Load it before you act:
+
+1. `summer_read_library` with id `skill/grow-analytics` returns the current text when this machine has a store sign-in (`summer login --store`).
+2. A host that shows MCP prompts or resources has it as the `grow-analytics` prompt and the resource `summer://skills/grow-analytics`.
+3. Without a store sign-in: https://docs.summerengine.com/llms.txt lists every docs page; fetch any page as .md.
+
+The one rule to keep even before you load it: Report what the numbers show; do not guess causes the data cannot support.

package/library/skills/grow-analytics/resource.yaml

@@ -0,0 +1,27 @@
+id: skill/grow-analytics
+kind: skill
+version: 1.0.0
+summary: "Read and analyse a creator's Summer Grow numbers: store page views, launches, play sessions, play time; compare windows, flag drops."
+use_when:
+  - "the user asks how their game is doing on Summer Games: views, launches, players, play time"
+  - "reading summer_grow_overview or summer_grow_analytics and turning the numbers into one next step"
+  - "comparing two time windows, walking the store funnel or finding where players drop"
+do_not_use_when:
+  - "sending analytics events from game code — skill/summer-analytics"
+facets:
+  lifecycle:
+    - grow
+  domains:
+    - creator
+    - deployment
+  modalities:
+    - docs
+related:
+  skills:
+    - skill/publish-your-game
+    - skill/summer-analytics
+hosted_resource: "summer://skills/grow-analytics"
+source: official
+license: MIT
+status: stable
+recommended: false

package/library/skills/publish-your-game/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: publish-your-game
+description: "Publish a Summer game on Summer Games through MCP: store page, art, build upload, submit, and one approval link for the owner."
+license: MIT
+compatibility: [Cursor, Claude Code, Windsurf, Codex]
+category: deployment
+user-invocable: true
+allowed-tools: summer_read_library
+---
+
+# /publish-your-game — publish your game
+
+This skill covers the whole publishing journey: find the game, make its store page, write the text, set the art, export and upload the build, submit, and hand the owner the approval link.
+
+Its current text lives on the hosted Summer Engine MCP, the same text the Studio agent reads, so it changes with the store and is never stale here. Load it before you act:
+
+1. `summer_read_library` with id `skill/publish-your-game` returns the current text when this machine has a store sign-in (`summer login --store`).
+2. A host that shows MCP prompts or resources has it as the `publish-your-game` prompt and the resource `summer://skills/publish-your-game`.
+3. Without a store sign-in: https://docs.summerengine.com/llms.txt lists every docs page; fetch any page as .md.
+
+The one rule to keep even before you load it: Submitting does not publish. `summer_store_submit` returns an approval link; only the owner's click sends the game to review, and review comes before live.

package/library/skills/publish-your-game/resource.yaml

@@ -0,0 +1,29 @@
+id: skill/publish-your-game
+kind: skill
+version: 1.0.0
+summary: "Publish a Summer game on Summer Games through MCP: store page, art, build upload, submit, and one approval link for the owner."
+use_when:
+  - "the user says 'publish my game', 'put it on summer.games', 'launch it on the store' or 'submit it for review'"
+  - "taking a built Summer game to a submitted store page: listing text, art, build upload, summer_store_submit and the owner's approval link"
+  - "an agent publishes for the owner end to end and needs the order of the summer_store_* and summer_build_* tools"
+do_not_use_when:
+  - "only producing a local export build — skill/export-and-ship"
+facets:
+  lifecycle:
+    - launch
+  domains:
+    - creator
+    - deployment
+  modalities:
+    - docs
+related:
+  skills:
+    - skill/store-listing
+    - skill/store-art
+    - skill/grow-analytics
+    - skill/export-and-ship
+hosted_resource: "summer://skills/publish-your-game"
+source: official
+license: MIT
+status: stable
+recommended: false

package/library/skills/store-art/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: store-art
+description: "Make Summer Games store art per slot and flow: key art, covers, icons, screenshots, trailer: size, shape, text rules, fallbacks."
+license: MIT
+compatibility: [Cursor, Claude Code, Windsurf, Codex]
+category: deployment
+user-invocable: true
+allowed-tools: summer_read_library
+---
+
+# /store-art — store art
+
+This skill covers every store art slot per flow (desktop and mobile): size, shape, text rules, fallbacks, and why each one matters.
+
+Its current text lives on the hosted Summer Engine MCP, the same text the Studio agent reads, so it changes with the store and is never stale here. Load it before you act:
+
+1. `summer_read_library` with id `skill/store-art` returns the current text when this machine has a store sign-in (`summer login --store`).
+2. A host that shows MCP prompts or resources has it as the `store-art` prompt and the resource `summer://skills/store-art`.
+3. Without a store sign-in: https://docs.summerengine.com/llms.txt lists every docs page; fetch any page as .md.
+
+Screenshots: `summer_capture_gameplay` takes them offscreen. Get past the title screen with the game's own flags in `args` or with `steps`, e.g. `{"args":["--autostart"],"steps":[{"wait":3000},{"shot":true},{"key":"Space"},{"wait":800},{"shot":true}]}`.
+
+The one rule to keep even before you load it: Key art, covers and icons carry no text: the stores draw the title over them. Screenshots are real play.

package/library/skills/store-art/resource.yaml

@@ -0,0 +1,30 @@
+id: skill/store-art
+kind: skill
+version: 1.0.0
+summary: "Make Summer Games store art per slot and flow: key art, covers, icons, screenshots, trailer: size, shape, text rules, fallbacks."
+use_when:
+  - "making or choosing store art for Summer Games: key art, cover, icon, screenshots, trailer"
+  - "summer_store_set_art rejects an image for its shape or size, or summer_store_get_listing says an art slot is missing"
+  - "deciding whether a store image may carry text, and which slot falls back to which"
+facets:
+  lifecycle:
+    - launch
+  domains:
+    - creator
+    - assets
+  modalities:
+    - images
+    - video
+related:
+  skills:
+    - skill/publish-your-game
+    - skill/store-listing
+  tools:
+    - tool/generate-image
+    - tool/capture-gameplay
+    - tool/list-my-assets
+hosted_resource: "summer://skills/store-art"
+source: official
+license: MIT
+status: stable
+recommended: false

package/library/skills/store-listing/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: store-listing
+description: "Write a Summer Games store page per flow (desktop, mobile): targets, title, tagline, descriptions, tags, and what never to write."
+license: MIT
+compatibility: [Cursor, Claude Code, Windsurf, Codex]
+category: deployment
+user-invocable: true
+allowed-tools: summer_read_library
+---
+
+# /store-listing — store listing
+
+This skill covers the store page text per flow (desktop and mobile): targets, title, tagline, descriptions, tags, and what never to write.
+
+Its current text lives on the hosted Summer Engine MCP, the same text the Studio agent reads, so it changes with the store and is never stale here. Load it before you act:
+
+1. `summer_read_library` with id `skill/store-listing` returns the current text when this machine has a store sign-in (`summer login --store`).
+2. A host that shows MCP prompts or resources has it as the `store-listing` prompt and the resource `summer://skills/store-listing`.
+3. Without a store sign-in: https://docs.summerengine.com/llms.txt lists every docs page; fetch any page as .md.
+
+The one rule to keep even before you load it: Never invent features, modes, player counts, awards or prices.

package/library/skills/store-listing/resource.yaml

@@ -0,0 +1,25 @@
+id: skill/store-listing
+kind: skill
+version: 1.0.0
+summary: "Write a Summer Games store page per flow (desktop, mobile): targets, title, tagline, descriptions, tags, and what never to write."
+use_when:
+  - "writing or fixing a game's store page text on Summer Games: title, tagline, description, tags"
+  - "summer_store_update_listing or summer_store_get_listing says a text field is missing or wrong"
+  - "choosing the targets (web, Mac, Windows, Linux, iPhone, Android) that decide the desktop and mobile store flows"
+facets:
+  lifecycle:
+    - launch
+  domains:
+    - creator
+    - product-language
+  modalities:
+    - docs
+related:
+  skills:
+    - skill/publish-your-game
+    - skill/store-art
+hosted_resource: "summer://skills/store-listing"
+source: official
+license: MIT
+status: stable
+recommended: false

package/library/skills/summer-analytics/resource.yaml

@@ -22,6 +22,7 @@ related:
     - skill/multiplayer-state
     - skill/summer-match-results
     - skill/summer-store
+    - skill/grow-analytics
 source: official
 license: MIT
 status: preview

package/library/tools/capture-gameplay/resource.yaml

@@ -1,12 +1,13 @@
 id: tool/capture-gameplay
 kind: tool
 version: 1.0.0
-summary: Capture real gameplay frames (PNG, HUD included) in Summer Engine's offscreen verify instance, without a running editor, e.g. store screenshots.
+summary: Capture real gameplay PNGs (HUD included) offscreen without a running editor; game flags and player steps (press, key, click) get past the title screen.
 use_when:
   - '"take gameplay screenshots for my store page"'
   - '"I need screenshots but the editor is not open"'
   - '"capture a 1920x1080 frame of my game"'
   - collecting real gameplay screenshots for summer_store_set_art desktop.screenshots or mobile.screenshots
+  - every capture shows the title screen — pass the game's flags in args or steps like press Play
 do_not_use_when:
   - the editor is open and the game is running — tool/screenshot with target game shows the live game
   - key art, covers or icons — those are generated art, not gameplay frames
@@ -62,6 +63,70 @@ input_schema:
     out:
       type: string
       description: Output folder. Defaults to <project>/.summer/captures/<time>/ (ignored by git).
+    args:
+      type: array
+      maxItems: 32
+      items:
+        type: string
+      description: The game's own command-line flags, passed after "--" (OS.get_cmdline_user_args()), e.g. ["--autostart", "--solo"] to skip the title screen.
+    steps:
+      type: array
+      maxItems: 50
+      description: 'What to do after waitSeconds, in order; exactly one of press, key, action, click, drag, wait, shot per step. Example: [{"press":"Play"},{"wait":3000},{"key":"Space"},{"shot":true},{"action":"jump"},{"wait":500},{"shot":true}]. With a shot step only shot steps save frames. A step that cannot run becomes a warning.'
+      items:
+        type: object
+        properties:
+          press:
+            type: string
+            description: Press the visible button with this text (or node name); waits up to timeoutSeconds (default 10) for it.
+          timeoutSeconds:
+            type: number
+            minimum: 0
+            maximum: 60
+          key:
+            type: string
+            description: Press a key by Godot name (Space, Enter, Escape, A, Up).
+          action:
+            type: string
+            description: Press an input action from the project's InputMap, e.g. jump.
+          holdMs:
+            type: number
+            minimum: 0
+            maximum: 10000
+            description: How long key or action is held (default 100).
+          click:
+            type: array
+            items:
+              type: number
+            description: Left-click at [x, y] in frame pixels.
+          drag:
+            type: object
+            properties:
+              from:
+                type: array
+                items:
+                  type: number
+              to:
+                type: array
+                items:
+                  type: number
+              ms:
+                type: number
+                minimum: 0
+                maximum: 10000
+            required:
+              - from
+              - to
+            description: Drag with the left button from [x, y] to [x, y] over ms (default 300).
+          wait:
+            type: number
+            minimum: 0
+            maximum: 60000
+            description: Wait this many milliseconds.
+          shot:
+            type: boolean
+            description: true saves a frame now.
+        additionalProperties: false
   additionalProperties: false
 authority:
   filesystem: true

package/library/tools/export-game/resource.yaml

@@ -61,6 +61,9 @@ input_schema:
       minimum: 10
       maximum: 7200
       description: Stop the engine after this many seconds (default 900; a first export imports every asset).
+    alignDeclaration:
+      type: boolean
+      description: A game with a server, set summer.build.json targetPlatforms to targets before exporting. The store refuses an upload whose declaration differs from the exported platforms (declaration_mismatch) and that spends the version.
   additionalProperties: false
 authority:
   filesystem: true

package/library/tools/generate-image/resource.yaml

@@ -33,8 +33,7 @@ input_schema:
       description: Description of the image to generate
     model:
       type: string
-      default: nano-banana-2
-      description: Model name or full provider ID
+      description: Model name or full provider ID. Omit it and the server picks one that reaches the requested size (nano-banana-2 when no size is asked).
     style:
       type: string
       default: realistic
@@ -63,6 +62,9 @@ input_schema:
       type: object
       additionalProperties: {}
       description: Extra model params (seed, negative_prompt, ...). The result lists any it did not use in ignoredOptions.
+    out:
+      type: string
+      description: Where to save the image on this machine, a folder or a file path ending in .png, .jpg or .webp. Default is <TMPDIR>/summer-gen/.
   required:
     - prompt
   additionalProperties: false