summer-engine 3.8.0 → 4.0.0

package/library/skills/navigate-summer/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: navigate-summer
-description: "When to open a Summer web page or editor surface FOR the user (billing, their games, the scene just built) versus acting through the API, using summer_open."
+description: "Open a Summer web page or editor surface for the user (billing, their games, a scene) with studio.open."
 license: MIT
 compatibility: [Cursor, Claude Code, Codex, Windsurf, Gemini, OpenCode, Factory, Copilot]
 category: _meta
 user-invocable: true
-allowed-tools: summer_open summer_get_project_context summer_is_running
+allowed-tools: summer_call summer_get_project_context summer_is_running
 paths: ["**/project.godot", "**/*.tscn", "**/.summer/**"]
 ---
 
@@ -13,7 +13,9 @@ paths: ["**/project.godot", "**/*.tscn", "**/.summer/**"]
 
 ## Overview
 
-Summer has two surfaces the user looks at: **summerengine.com** (Studio, games, billing, templates, guides, docs) and the **Summer Engine editor** (scenes, nodes, docks). `summer_open` — the same behavior as `summer open <target>` in a shell — takes an intent ("billing", "my games", "the scene I'm editing", "res://player.gd") and opens the exact page or panel, or prints the URL / engine op so you can hand it over. The **product map** reference (`../../references/product-map/product-map.md`) is the full table of destinations with their intent phrases, required context, and what the user will see.
+Summer has two surfaces the user looks at: **summerengine.com** (Studio, games, billing, templates, guides, docs) and the **Summer Engine editor** (scenes, nodes, docks). `studio.open` — the same behavior as `summer open <target>` in a shell, run by the Summer MCP on this computer — takes an intent ("billing", "my games", "the scene I'm editing", "res://player.gd") and opens the exact page or panel, or prints the URL / engine op so you can hand it over. The **product map** reference (`summer_docs_read` id `reference/product-map`) is the full table of destinations with their intent phrases, required context, and what the user will see.
+
+A call written `studio.open({...})` is `summer_call({ op: "studio.open", input: {...} })` (3.x name: `summer_open`). The fields below are in the answer's `result`.
 
 Rigid skill: follow the rules below exactly.
 
@@ -21,18 +23,18 @@ Rigid skill: follow the rules below exactly.
 
 | The user wants to… | Do |
 |---|---|
-| **see / check / decide** — plan and billing (money), their published games and releases, usage, pricing, the MCP setup guide for their agent, docs, the scene or node you just built ("show me") | **Open the surface** with `summer_open` |
-| **get a result** — add a node, set a property, import an asset, run the game, publish | **Act through Summer tools** (mutation tools, `summer_play`, `summer_publish_build`); do not open the editor to do by hand what a tool does |
+| **see / check / decide** — plan and billing (money), their published games and releases, usage, pricing, the MCP setup guide for their agent, docs, the scene or node you just built ("show me") | **Open the surface** with `studio.open` |
+| **get a result** — add a node, set a property, import an asset, run the game, publish | **Act through Summer tools** (mutation tools, `summer_play`, `store.publish`); do not open the editor to do by hand what a tool does |
 | **both** ("add a camera and show me") | act first, then open the scene / select the node so the user sees the result |
 
 Never open a browser or switch the editor's tab as a side effect of building. Opening is a user-visible action — do it because the user asked to look, and say what will open before it opens.
 
 ## How to call it
 
-1. **Resolve first when unsure.** `summer_open({ target: "change my plan", open: false })` returns the matched target, the URL (and `login_url` if login is required), or the engine op — nothing opens. If `action` is `ambiguous`, pick from `matches` and call again with the `id`.
-2. **Open.** `summer_open({ target: "billing" })` opens the browser at Studio → Billing. `summer_open({ target: "scene", params: { path: "res://levels/level_1.tscn" } })` opens the scene in the running editor. `summer_open({ target: "node", params: { node: "Player/Camera3D" } })` selects the node. `summer_open({ target: "res://player.gd" })` routes by extension.
+1. **Resolve first when unsure.** `studio.open({ target: "change my plan", open: false })` returns the matched target, the URL (and `login_url` if login is required), or the engine op — nothing opens. If `action` is `ambiguous`, pick from `matches` and call again with the `id`.
+2. **Open.** `studio.open({ target: "billing" })` opens the browser at Studio → Billing. `studio.open({ target: "scene", params: { path: "res://levels/level_1.tscn" } })` opens the scene in the running editor. `studio.open({ target: "node", params: { node: "Player/Camera3D" } })` selects the node. `studio.open({ target: "res://player.gd" })` routes by extension.
 3. **Fill the slots the target declares.** `game` needs `params.gameId` (and an optional `section` such as `builds`, `releases`, `store-page`, `analytics`); `mcp-guide` takes `params.guide` as an agent name (`cursor`, `claude-code`, `codex`, `gemini`, …); `profile` takes `username`; `changelog` takes `version`.
-4. **List when you do not know the id.** `summer_open({})` returns every target with `surface`, `status`, and `requires`. In a shell: `summer open --list`.
+4. **List when you do not know the id.** `studio.open({})` returns every target with `surface`, `status`, and `requires`. In a shell: `summer open --list`.
 
 ## Read the result honestly
 
@@ -51,7 +53,7 @@ Use `open: false` (CLI: `--print`) and paste the `url` (or `login_url`) when the
 
 ## Editor targets
 
-The editor owns its own table of destinations (the `Navigate` op) and tells the tool which ids it can open. `summer_open({})` lists every editor id with `availability`: `available` (Navigate op), `legacy` (an older engine serving it through its original op), `unavailable` (update Summer Engine), `unknown` (engine not running). Ids: `scene` (default = the project's main scene), `main-scene`, `node`, `script` (with `line`), `file`, `files`, `scene-tree`, `inspector`, `import-dock`, `signals-dock`, `changes-dock`, `screen-2d/3d/script/game/assetlib`, `viewport-show/hide`, `assistant`, `project-settings`, `editor-settings`, `output`, `debugger`, `editor-window`. On a legacy engine, `script` opens without taking focus — mention it if the user does not see it.
+The editor owns its own table of destinations (the `Navigate` op) and tells the tool which ids it can open. `studio.open({})` lists every editor id with `availability`: `available` (Navigate op), `legacy` (an older engine serving it through its original op), `unavailable` (update Summer Engine), `unknown` (engine not running). Ids: `scene` (default = the project's main scene), `main-scene`, `node`, `script` (with `line`), `file`, `files`, `scene-tree`, `inspector`, `import-dock`, `signals-dock`, `changes-dock`, `screen-2d/3d/script/game/assetlib`, `viewport-show/hide`, `assistant`, `project-settings`, `editor-settings`, `output`, `debugger`, `editor-window`. On a legacy engine, `script` opens without taking focus — mention it if the user does not see it.
 
 ## Anti-patterns
 

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

@@ -1,7 +1,7 @@
 id: skill/navigate-summer
 kind: skill
 version: 1.0.0
-summary: When to open a Summer web page or editor surface FOR the user (billing, their games, the scene just built) versus acting through the API, using summer_open.
+summary: "Open a Summer web page or editor surface for the user (billing, their games, a scene) with studio.open."
 use_when:
   - the user asks to see, check, or decide something — "show me my billing", "where do I change my plan", "open my games", "let me look at the scene", "take me to the MCP guide for Cursor"
   - deciding whether to open a surface for the user or to do the work through Summer tools

package/library/skills/new-project/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: new-project
-description: "Create a fresh blank Summer Engine project — asks one question (project name) and runs summer create empty."
+description: "Create a blank Summer Engine project: ask for the project name and run summer create empty."
 license: MIT
 compatibility: [Cursor, Claude Code, Codex, Windsurf, Gemini, OpenCode]
 category: scene-and-project

package/library/skills/new-project/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/new-project
 kind: skill
 version: 1.0.4
-summary: Create a fresh blank Summer Engine project — asks one question (project name) and runs summer create empty.
+summary: "Create a blank Summer Engine project: ask for the project name and run summer create empty."
 use_when:
   - the user wants a fresh blank Summer Engine project — from scratch, blank canvas
   - starting a Summer Engine project with no template, only a name, ready for an empty main scene

package/library/skills/organic-model/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: organic-model
-description: "Generate organic 3D shapes — trees, rocks, mushrooms, coral, plants, vines, crystals — where AI artifacts read as natural irregularity."
+description: "Generate organic 3D shapes (trees, rocks, mushrooms, plants, crystals) where irregularity looks natural."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: 3d-assets
 user-invocable: true
-allowed-tools: Read Grep summer_search_assets summer_list_my_assets summer_get_asset summer_import_asset_by_id summer_generate_3d summer_generate_image summer_import_from_url summer_add_node summer_set_prop summer_inspect_node summer_get_scene_tree summer_save_scene
+allowed-tools: Read Grep summer_assets_search summer_assets_get summer_import_asset_by_id summer_assets_generate_3d summer_assets_generate_image summer_import_from_url summer_add_node summer_set_prop summer_inspect_node summer_get_scene_tree summer_save_scene summer_jobs_wait summer_call
 paths: ["assets/organic/**", "assets/models/**", "**/*.tscn", "**/*.gd"]
 ---
 
@@ -15,7 +15,7 @@ Organic shapes (trees, rocks, mushrooms, coral, alien flora, crystals, vines, bo
 
 This is the cheapest, fastest way to fill out a scene, and the first choice when the user says "this scene feels empty". The failure rate is the lowest of any 3D-asset family.
 
-Backing tool: `summer_generate_3d`. Default `hunyuan` works well here, but `trellis` is faster and the quality difference is hard to see on organic shapes. Pick `trellis` when generating many at once.
+Backing operation: `assets.generate_3d` (it answers with a job: `jobs.wait` until it finishes). Default `hunyuan` works well here, but `trellis` is faster and the quality difference is hard to see on organic shapes. Pick `trellis` when generating many at once.
 
 ## When to use
 
@@ -41,12 +41,12 @@ Organic geometry tolerates aggressive polycount cuts because the silhouette is i
 
 | Use case | Tris | Pass via |
 |---|---|---|
-| Hero tree (mid-distance, prominent) | 4k–8k | `target_polycount: 6000` |
-| Background tree (forest filler) | 1k–3k | `target_polycount: 2000` |
-| Distant tree (use billboard imposter) | 200–500 | `target_polycount: 400` |
-| Large rock / boulder | 800–2000 | `target_polycount: 1500` |
-| Small organic (mushroom, fruit, crystal) | 300–1000 | `target_polycount: 600` |
-| Vine / branch decoration | 200–500 | `target_polycount: 400` |
+| Hero tree (mid-distance, prominent) | 4k–8k | `targetPolycount: 6000` |
+| Background tree (forest filler) | 1k–3k | `targetPolycount: 2000` |
+| Distant tree (use billboard imposter) | 200–500 | `targetPolycount: 400` |
+| Large rock / boulder | 800–2000 | `targetPolycount: 1500` |
+| Small organic (mushroom, fruit, crystal) | 300–1000 | `targetPolycount: 600` |
+| Vine / branch decoration | 200–500 | `targetPolycount: 400` |
 
 Generating a forest? Make 3 hero trees + 5 background trees + 3 rocks at low polycount, then scatter via `MultiMeshInstance3D` for hundreds of copies at near-zero rendering cost.
 
@@ -55,7 +55,7 @@ Generating a forest? Make 3 hero trees + 5 background trees + 3 rocks at low pol
 ### 1. Search before generating
 
 ```
-summer_search_assets(query="<organic type>", assetType="3d_model", source="all")
+assets.search({ query: "<organic type>", assetType: "3d_model", scope: "all" })
 ```
 
 ### 2. Build the prompt
@@ -90,14 +90,16 @@ For batch generation, batch the confirmation:
 
 > About to generate 3 trees + 3 rocks + 5 mushrooms (11 generations, ~5 min). All low-poly via `trellis`. OK?
 
+`dryRun: true` on one call gives its credits (`estimate.credits`) for the batch confirmation. Start every generation of the batch first, then wait on the jobs.
+
 ```
-summer_generate_3d(
-  prompt="A tall pine tree with dense green needles and a straight trunk, slight lean. Game asset, stylized low-poly game art, white background, isolated object.",
-  model="trellis",
-  options={ target_polycount: 2000 },
-  wait=true
-)
-summer_get_asset(assetId="<assetId>")
+assets.generate_3d({
+  prompt: "A tall pine tree with dense green needles and a straight trunk, slight lean. Game asset, stylized low-poly game art, white background, isolated object.",
+  model: "trellis",
+  targetPolycount: 2000
+})
+jobs.wait({ jobId: "<job.id>", timeoutSeconds: 50 })   // again until finished; result.assetId
+assets.get({ assetId: "<assetId>" })
 summer_import_asset_by_id(assetId="<assetId>", path="res://assets/organic/pine_tree_01.glb")
 ```
 
@@ -168,6 +170,10 @@ In a 200-tree forest, only the ~10 closest trees need to be real meshes; the oth
 - **Crystal/glass organic.** Mesh comes back opaque. Generate the geometry, then assign a `StandardMaterial3D` with `transparency = ALPHA` and emissive in the editor.
 - **Bones, skulls, dead trees.** All work; organic forgives them more than props would. Add `weathered, sun-bleached` for desert / tundra feel.
 
+## Without Summer Engine
+
+In a session without Summer Engine tools (the assets profile; the `summer-assets` skill has the whole loop), do steps 1-4 and skip steps 5-6 (scene wiring, LOD). Save the file where the person asked with `out` (the `summer-assets` skill says how), and tell them the path and format. The file is GLB; level of detail and billboards are the person's engine's job.
+
 ## Fallback (no MCP)
 
 1. Run prompts at the Summer dashboard or any 3D-gen web playground (Hunyuan, Trellis, Meshy).
@@ -193,4 +199,4 @@ After the organic models are scattered:
 - `environment-kit` — pair with this skill: kit pieces give the architecture, organic gives the natural softness.
 - `asset-strategy` — meta-router; ground textures and skyboxes go to Pipeline 2 / panoramic gen.
 - `scene-composition` — MultiMeshInstance3D scatter pattern.
-- `../../references/mcp-tools-reference/mcp-tools-reference.md` — `summer_generate_3d` schema.
+- `summer_docs_read` id `reference/mcp-tools-reference` — how to call `assets.generate_3d`; `summer_search` returns its exact input.

package/library/skills/organic-model/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/organic-model
 kind: skill
 version: 1.0.3
-summary: Generate organic 3D shapes — trees, rocks, mushrooms, coral, plants, vines, crystals — where AI artifacts read as natural irregularity.
+summary: "Generate organic 3D shapes (trees, rocks, mushrooms, plants, crystals) where irregularity looks natural."
 use_when:
   - generating organic shapes — trees, rocks, mushrooms, coral, bushes, alien plants, vines, crystals, fruit, bones
   - a level needs vegetation, rocks, or other natural shapes where irregularity reads as realism

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

@@ -1,11 +1,11 @@
 ---
 name: pixel-art
-description: "Generate pixel-art assets — sprites, items, tiles, portraits — at a specific resolution with pixel-perfect grid, limited palette, retro feel."
+description: "Generate pixel-art sprites, items, tiles and portraits at a set resolution with a limited palette."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: 2d-assets
 user-invocable: true
-allowed-tools: Read Grep Glob Write Edit summer_generate_image summer_search_assets summer_import_from_url summer_set_resource_property
+allowed-tools: Read Grep Glob Write Edit summer_assets_generate_image summer_assets_search summer_import_from_url summer_set_resource_property summer_call
 paths: ["assets/**", "art/pixel/**", "sprites/**"]
 ---
 
@@ -13,12 +13,12 @@ paths: ["assets/**", "art/pixel/**", "sprites/**"]
 
 This skill generates pixel-art sprites, items, tiles, icons and portraits at a target resolution (32×32, 64×64, 128×128). Pixel art has hard constraints (grid alignment, limited palette, no anti-aliased edges) that diffusion models break by default. The prompt patterns and post-processing below make the output read as pixel art instead of a blurry small image.
 
-**Backing tool:** `summer_generate_image` with an explicit pixel-art prompt.
+**Backing operation:** `assets.generate_image` with an explicit pixel-art prompt.
 
-Two things about that tool you have to know before writing a call, because both silently do nothing:
+Two things about that operation you have to know before writing a call:
 
 - **There is no `"pixel"` style preset.** `style` accepts exactly `realistic`, `cartoon`, `anime`, `none`; anything else is coerced to `none`. Only `cartoon` and `anime` do anything at all (they append a short suffix); `realistic` and `none` append nothing. So `style: "pixel"` is identical to `style: "none"` — the pixel look has to come entirely from the prompt. Use `style: "none"`.
-- **`options` is not a general passthrough.** The MCP tool forwards `options` to the server, which only recognizes Nano Banana provider keys: `seed`, `outputFormat`, `safetyTolerance`, `syncMode`, `systemPrompt`, `limitGenerations`, `thinkingLevel`. `image_size` and `negative_prompt` are not among them and are dropped without an error. There is no size or aspect-ratio argument on this tool at all — MCP images come back at the server's 1:1 default. Put framing and exclusions in the prompt text instead.
+- **There is no `options` object and no negative prompt.** Shape is `aspectRatio` (`1:1` default, right for sprites and tiles), a minimum size is `width` + `height`, and `seed` repeats a look on Nano Banana models. Exclusions go in the prompt text. The model renders far above the pixel grid either way; the target resolution comes from the downscale below.
 
 Pixel-perfect output is enforced in Summer Engine with Nearest texture filtering
 and by downscaling to the target resolution after generation.
@@ -62,7 +62,7 @@ shading: 3-tone (light, mid, shadow), no gradients, no AA
 ### 2. Search for existing assets
 
 ```
-summer_search_assets(query="<subject> pixel", assetType="2d_image", source="all")
+assets.search({ query: "<subject> pixel", assetType: "2d_image", scope: "all" })
 ```
 
 ### 3. Build the prompt
@@ -78,18 +78,18 @@ The model can't actually generate at 32×32 — it generates at 1024×1024 with
 ### 4. Generate
 
 ```
-summer_generate_image(
-  prompt="pixel art slime monster, 32x32 sprite, PICO-8 palette, hard 1px outline in palette's darkest color, 3-tone shading, no anti-aliasing, no blur, sharp pixel edges, front-facing. Not blurry, no smooth gradients, no soft edges, not photorealistic, no 3D render.",
-  model="nano-banana-2",
-  style="none",
-  removeBackground=true
-)
+assets.generate_image({
+  prompt: "pixel art slime monster, 32x32 sprite, PICO-8 palette, hard 1px outline in palette's darkest color, 3-tone shading, no anti-aliasing, no blur, sharp pixel edges, front-facing. Not blurry, no smooth gradients, no soft edges, not photorealistic, no 3D render.",
+  model: "nano-banana-2",
+  style: "none",
+  removeBackground: true
+})
 ```
 
 Two deliberate choices there:
 
-- **The negations live in the prompt.** There is no `negative_prompt` argument — putting one in `options` is dropped silently. Diffusion models honor in-prompt negations less reliably than a real negative-prompt field, so state them as plain sentences at the end and expect to regenerate more often than you would on a provider UI that exposes the field.
-- **`removeBackground: true` is a top-level argument**, not an `options` key. It runs a background-removal pass after generation and returns a PNG with true alpha. Prefer it over asking for "transparent background" in the prompt, which makes models paint a literal checkerboard.
+- **The negations live in the prompt.** There is no `negative_prompt` argument. Diffusion models honor in-prompt negations less reliably than a real negative-prompt field, so state them as plain sentences at the end and expect to regenerate more often than you would on a provider UI that exposes the field.
+- **`removeBackground: true` is its own argument.** It runs a background-removal pass after generation and returns a PNG with true alpha. Prefer it over asking for "transparent background" in the prompt, which makes models paint a literal checkerboard.
 
 ### 5. Downscale to target resolution
 
@@ -148,7 +148,7 @@ Confirm `Filter: Nearest` is set in the import dock OR project-wide.
 - **Skipping the downscale.** The model returns a 1024×1024 pixel-style image. If you import that as a 1024 texture, the "pixels" are actually 32-pixel blocks of soft color. Downscale to true target resolution OR set `Filter: Nearest` so the up-rendering doesn't smooth.
 - **No `Filter: Nearest`.** The default texture filtering is bilinear. Set
   Nearest on import or project-wide for pixel art.
-- **Reaching for `negative_prompt` or `image_size`.** Neither exists on this tool; both are dropped without an error, so the call looks like it worked and the output is off-style. Negations go in the prompt text; size is fixed.
+- **Reaching for `negative_prompt` or `image_size`.** Neither exists on `assets.generate_image`, and a field it does not list does nothing, so the call looks like it worked and the output is off-style. Negations go in the prompt text; shape is `aspectRatio`, a minimum size `width` + `height`.
 - **Inconsistent palette across the cast.** Pick a named palette (PICO-8, NES, custom hex list) and re-use across every asset in the project. Different palettes = the project doesn't read as one game.
 - **Generating walk-cycle frames as one image.** Sprite sheets via single-prompt are unreliable. Route to `sprite-sheet`.
 
@@ -160,20 +160,24 @@ Confirm `Filter: Nearest` is set in the import dock OR project-wide.
 - **User specifies a palette like "Sweetie-16" or "Endesga-32" and the model ignores it.** Name the hex codes explicitly. Palette names alone are unreliable below the top 5-10 famous ones.
 - **Tilesets need to tile cleanly.** Pixel-art tile-edge cleanliness from raw generation is poor. Generate the tile grid, then fix edge seams by hand in Aseprite.
 
+## Without Summer Engine
+
+In a session without Summer Engine tools (the assets profile; the `summer-assets` skill has the whole loop), do steps 1-5 and skip step 6 (import and wiring). In step 5, downscale with nearest-neighbour in an image editor; the engine settings there do not apply. Pass `out` with the person's folder so the PNG lands there (the `summer-assets` skill says how), and tell them to turn texture filtering off in their engine.
+
 ## Fallback (no MCP)
 
 Print the call:
 
 ```
-summer_generate_image(
-  prompt="<pixel art prompt with full anchor>. Not blurry, no smooth gradients, no anti-aliasing.",
-  model="nano-banana-2",
-  style="none",
-  removeBackground=true
-)
+assets.generate_image({
+  prompt: "<pixel art prompt with full anchor>. Not blurry, no smooth gradients, no anti-aliasing.",
+  model: "nano-banana-2",
+  style: "none",
+  removeBackground: true
+})
 ```
 
-The Summer dashboard *does* expose size and negative-prompt controls that the MCP tool does not — if the user is running it there, tell them to set square + a real negative prompt.
+The Summer dashboard also exposes a negative-prompt control — if the user is running it there, tell them to set square + a real negative prompt.
 
 Tell the user to run via the Summer dashboard, downscale in Aseprite/GIMP to true target resolution with nearest-neighbor, then `summer_import_from_url` (or drop into `res://sprites/`) and set `Filter: Nearest`.
 
@@ -193,4 +197,4 @@ After the asset is wired:
 - `sprite-sheet` — animated pixel frames.
 - `character-portrait` — high-res counterpart.
 - `asset-strategy` — meta-router.
-- `../../references/mcp-tools-reference/mcp-tools-reference.md` — `summer_generate_image` schema.
+- `summer_docs_read` id `reference/mcp-tools-reference` — how to call `assets.generate_image`.

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

@@ -1,7 +1,7 @@
 id: skill/pixel-art
 kind: skill
 version: 1.0.4
-summary: Generate pixel-art assets — sprites, items, tiles, portraits — at a specific resolution with pixel-perfect grid, limited palette, retro feel.
+summary: "Generate pixel-art sprites, items, tiles and portraits at a set resolution with a limited palette."
 use_when:
   - generating pixel-art assets — sprites, items, tiles, portraits — in a pixel style at a specific resolution (32x32, 64x64, 128x128)
   - a retro or low-resolution 2D game needs sprites, tiles, or portraits on a fixed grid with a limited palette

package/library/skills/play/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: play
-description: "Run the project in Summer Engine, wait briefly, then report what's happening — clean run, errors, or warnings."
+description: "Run the project in Summer Engine, wait briefly, then report a clean run, errors or warnings."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: scene-and-project

package/library/skills/play/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/play
 kind: skill
 version: 1.0.2
-summary: Run the project in Summer Engine, wait briefly, then report what's happening — clean run, errors, or warnings.
+summary: "Run the project in Summer Engine, wait briefly, then report a clean run, errors or warnings."
 use_when:
   - the user says 'play', 'run it', 'test it', 'let me see it', or 'start the game'
   - checking that the project still starts and runs cleanly right after a change

package/library/skills/playtesting-a-feature/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: playtesting-a-feature
-description: "Before claiming a gameplay feature done: actually run the game and walk through the feature. Static diagnostics and type checks do not count."
+description: "Before calling a gameplay feature done, run the game and walk through it. Static checks do not count."
 ---
 
 # Playtesting A Feature

package/library/skills/playtesting-a-feature/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/playtesting-a-feature
 kind: skill
 version: 1.1.2
-summary: "Before claiming a gameplay feature done: actually run the game and walk through the feature. Static diagnostics and type checks do not count."
+summary: "Before calling a gameplay feature done, run the game and walk through it. Static checks do not count."
 use_when:
   - about to claim a gameplay feature is done, shipped, or working — requires actually running the game and walking through the feature first
   - a feature passes static diagnostics but nobody has actually run the game and exercised it yet

package/library/skills/procedural-animation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: procedural-animation
-description: "Runtime bone modification on top of clips — head look-at, foot IK, hand-grabs-prop, additive lean, recoil. Code-and-modifier patterns, not generation."
+description: "Runtime bone changes on top of clips: head look-at, foot IK, hand grabs a prop, lean, recoil."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: animation
@@ -61,31 +61,35 @@ The most common NPC liveliness fix.
 ```gdscript
 func run(ctx):
     var skel = ctx.find("NPC").find_children("*", "Skeleton3D", true, false)[0]
-    var mod := ctx.look_at_modifier(skel, ctx.find("Player"), {
+    var mod = ctx.look_at_modifier(skel, ctx.find("Player"), {
         "bone_name": "Head", "forward_axis": 2, "primary_rotation_axis": 1,
         "use_secondary_rotation": true, "use_angle_limitation": true,
         "symmetry_limitation": true, "primary_limit_angle": 1.4, "secondary_limit_angle": 1.0,
     })
 ```
 
-Unknown prop names land in the `prop_warnings` report entry instead of failing silently — read it. On an older engine the helper is a plain script error; fall back to the structured ops:
+Unknown prop names land in the `prop_warnings` report entry instead of failing silently — read it. On an older engine the helper is a plain script error; fall back to plain GDScript in the same tool (confirm the bone names first with `summer_inspect_node`):
 
 ```
-summer_inspect_node "./World/NPC/Skeleton3D"   # confirm bone names
-summer_add_node parent="./World/NPC/Skeleton3D" type="LookAtModifier3D" name="HeadLookAt"
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="bone_name" value="Head"
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="forward_axis" value=2   # +Z forward (Meshy default)
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="primary_rotation_axis" value=1   # Y-up
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="use_secondary_rotation" value=true
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="use_angle_limitation" value=true    # OFF by default — nothing clamps until you set this
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="symmetry_limitation" value=true     # one angle drives both directions
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="primary_limit_angle" value=1.4      # ~80°, prevents the Exorcist
-summer_set_prop "./World/NPC/Skeleton3D/HeadLookAt" key="secondary_limit_angle" value=1.0
+summer_run_script(scenePath="res://main.tscn", source="""
+func run(ctx):
+    var skel = ctx.find("NPC").find_children("*", "Skeleton3D", true, false)[0]
+    var look = LookAtModifier3D.new()
+    look.name = "HeadLookAt"
+    look.bone_name = "Head"
+    look.forward_axis = 2                 # +Z forward (Meshy default)
+    look.primary_rotation_axis = 1        # Y-up
+    look.use_secondary_rotation = true
+    look.use_angle_limitation = true      # OFF by default: nothing clamps until you set this
+    look.symmetry_limitation = true       # one angle drives both directions
+    look.primary_limit_angle = 1.4        # ~80 degrees, prevents the Exorcist
+    look.secondary_limit_angle = 1.0
+    skel.add_child(look)
+    ctx.set_owner_recursive(look)
+    ctx.save_scene()
+""")
 ```
 
-Every `summer_set_prop` above also needs the required `scenePath` (e.g.
-`scenePath="res://main.tscn"`); the paths are shown bare here for readability.
-
 There is no `symmetry_limit` and no `secondary_rotation_axis` property on
 `LookAtModifier3D` — the real names are the ones above, and the secondary
 rotation axis is derived, not set. Confirmed against the shipped 4.6.1 binary;

package/library/skills/procedural-animation/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/procedural-animation
 kind: skill
 version: 1.0.4
-summary: Runtime bone modification on top of clips — head look-at, foot IK, hand-grabs-prop, additive lean, recoil. Code-and-modifier patterns, not generation.
+summary: "Runtime bone changes on top of clips: head look-at, foot IK, hand grabs a prop, lean, recoil."
 use_when:
   - the user needs runtime-driven bone modification on top of clips — head look-at, foot IK on uneven ground, additive lean, hit recoil, ragdoll
   - the character's feet float above or sink into stairs and slopes (foot placement)

package/library/skills/prop-model/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: prop-model
-description: "Generate a single static 3D prop — sword, barrel, chest, lantern, throne, statue — one isolated object, no rigging, wired as a MeshInstance3D."
+description: "Generate one static 3D prop (sword, barrel, chest, lantern, statue): one object, no rig, a MeshInstance3D."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: 3d-assets
 user-invocable: true
-allowed-tools: Read Grep summer_search_assets summer_list_my_assets summer_get_asset summer_import_asset_by_id summer_generate_3d summer_generate_image summer_import_from_url summer_add_node summer_set_prop summer_inspect_node summer_get_scene_tree summer_save_scene
+allowed-tools: Read Grep summer_assets_search summer_assets_get summer_import_asset_by_id summer_assets_generate_3d summer_assets_generate_image summer_import_from_url summer_add_node summer_set_prop summer_inspect_node summer_get_scene_tree summer_save_scene summer_jobs_wait summer_call
 paths: ["assets/models/**", "**/*.tscn", "**/*.gd"]
 ---
 
@@ -13,7 +13,7 @@ paths: ["assets/models/**", "**/*.tscn", "**/*.gd"]
 
 One prop, one mesh, one MeshInstance3D. Most game-world objects are static props, so this is the most common 3D-asset call. The skill keeps two things tight: the **prompt shape** that produces a clean isolated mesh on the first try, and the **wire-in pattern** that gets the asset into the scene without leaving orphans in `res://assets/models/`.
 
-The backing tool is `summer_generate_3d`. Default model is `hunyuan` (Hunyuan 3D v3.1 Pro — best quality). Use `trellis` when speed matters (Trellis 2 is ~2× faster, slightly lower fidelity). `meshy` is the legacy fallback — only pick it if the user asks by name.
+The backing operation is `assets.generate_3d`; it answers with a job that `jobs.wait` follows. Default model is `hunyuan` (Hunyuan 3D v3.1 Pro — best quality). Use `trellis` when speed matters (Trellis 2 is ~2× faster, slightly lower fidelity). `meshy` is the legacy fallback — only pick it if the user asks by name.
 
 ## When to use
 
@@ -37,7 +37,7 @@ The backing tool is `summer_generate_3d`. Default model is `hunyuan` (Hunyuan 3D
 ### 1. Search before generating
 
 ```
-summer_search_assets(query="<prop name>", assetType="3d_model", source="all")
+assets.search({ query: "<prop name>", assetType: "3d_model", scope: "all" })
 ```
 
 If a fitting model exists, propose reuse:
@@ -48,10 +48,10 @@ If a fitting model exists, propose reuse:
 
 | Use case | Tris | Pass via |
 |---|---|---|
-| Hero prop (sword on hip, key item) | 3k–8k | `options: { target_polycount: 5000 }` |
-| Background prop (crate, barrel, sack) | 200–800 | `options: { target_polycount: 600 }` |
-| Mid-range interactive (chest, lantern) | 1k–3k | `options: { target_polycount: 2000 }` |
-| Cinematic showcase (throne, statue) | 10k–30k | `options: { target_polycount: 20000 }` |
+| Hero prop (sword on hip, key item) | 3k–8k | `targetPolycount: 5000` |
+| Background prop (crate, barrel, sack) | 200–800 | `targetPolycount: 600` |
+| Mid-range interactive (chest, lantern) | 1k–3k | `targetPolycount: 2000` |
+| Cinematic showcase (throne, statue) | 10k–30k | `targetPolycount: 20000` |
 
 Default if you don't pass it: provider picks (~10k–30k). For most game-world props, that's overkill — pass a target.
 
@@ -74,22 +74,24 @@ The `isolated object` and `white background` clauses are load-bearing — withou
 
 > About to generate `viking_axe` via `hunyuan`, target ~5k tris, ~60s. This uses credits. OK?
 
+To say how many credits, run the same call with `dryRun: true` first: it returns `estimate` (`credits`, `balance`, `enough`) and generates nothing.
+
 ```
-summer_generate_3d(
-  prompt="A two-handed viking battle axe, weathered iron head with rune etchings, leather-wrapped wooden haft. Game asset, centered, stylized, white background, isolated object.",
-  model="hunyuan",
-  options={ target_polycount: 5000 },
-  wait=true
-)
+assets.generate_3d({
+  prompt: "A two-handed viking battle axe, weathered iron head with rune etchings, leather-wrapped wooden haft. Game asset, centered, stylized, white background, isolated object.",
+  model: "hunyuan",
+  targetPolycount: 5000
+})
+jobs.wait({ jobId: "<job.id>", timeoutSeconds: 50 })   // again until finished
 ```
 
-Returns a job result with `assetId` and `fileUrl`. Treat `assetId` as the
+The finished job's `result` holds `assetId` and `fileUrl`. Treat `assetId` as the
 stable handle and `fileUrl` as a fallback preview/import URL.
 
 ### 5. Import and wire
 
 ```
-summer_get_asset(assetId="<assetId>")
+assets.get({ assetId: "<assetId>" })
 summer_import_asset_by_id(
   assetId="<assetId>",
   path="res://assets/models/viking_axe.glb",
@@ -111,8 +113,8 @@ the parent-shape pattern.
 
 - **Scene context in the prompt.** "A sword lying on a wooden table" → the table becomes geometry. Always say `isolated object`.
 - **Multi-object prompts.** "A sword and a shield" → fused single mesh. Generate separately.
-- **Skipping `target_polycount` for background props.** A 30k-tri barrel in the background tanks frame rate when the level has 50 of them.
-- **Forgetting to import.** `fileUrl` from `summer_generate_3d` is a remote URL — you MUST `summer_import_asset_by_id` or `summer_import_from_url` before referencing it as `res://...`.
+- **Skipping `targetPolycount` for background props.** A 30k-tri barrel in the background tanks frame rate when the level has 50 of them.
+- **Forgetting to import.** `fileUrl` from `assets.generate_3d` is a remote URL — you MUST `summer_import_asset_by_id` or `summer_import_from_url` before referencing it as `res://...`.
 - **Generating before searching.** Reuse beats regenerate every time.
 - **Picking `meshy` by default.** It's legacy. `hunyuan` is better; `trellis` is faster.
 
@@ -123,6 +125,10 @@ the parent-shape pattern.
 - **Concave interior (open chest, hollow vase).** Specify "lid open" or "hollow inside" — Hunyuan defaults to closed solids.
 - **Symmetrical prop comes back asymmetric.** Add `symmetric, mirrored` to the prompt and regenerate.
 
+## Without Summer Engine
+
+In a session without Summer Engine tools (the assets profile; the `summer-assets` skill has the whole loop), do steps 1-4 and skip step 5 (import and wiring). Save the file where the person asked with `out` (the `summer-assets` skill says how), and tell them the path and format. The file is GLB. Generated models are not at real-world size, so give the person the target size (a chair about 1 m, a door about 2 m) to scale it to.
+
 ## Fallback (no MCP)
 
 The user can run the same prompt in the Summer dashboard or a supported
@@ -144,4 +150,4 @@ After the prop is wired:
 - `asset-strategy` — the meta-router that decides between this skill and Pipeline 2 (textures).
 - `character-model` — for humanoids.
 - `environment-kit` — for style-locked sets.
-- `../../references/mcp-tools-reference/mcp-tools-reference.md` — `summer_generate_3d` parameter schema.
+- `summer_docs_read` id `reference/mcp-tools-reference` — how to call `assets.generate_3d`; `summer_search` returns its exact input.

package/library/skills/prop-model/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/prop-model
 kind: skill
 version: 1.0.3
-summary: Generate a single static 3D prop — sword, barrel, chest, lantern, throne, statue — one isolated object, no rigging, wired as a MeshInstance3D.
+summary: "Generate one static 3D prop (sword, barrel, chest, lantern, statue): one object, no rig, a MeshInstance3D."
 use_when:
   - generating a single static 3D prop — sword, barrel, chest, lantern, throne, statue, crate, key, potion, banner
   - a scene needs one static object — furniture, weapon, container, decoration — as a MeshInstance3D without rigging

package/library/skills/psx-retro-rendering/resource.yaml

@@ -30,6 +30,7 @@ source: official
 license: MIT
 status: preview
 recommended: false
+bundled: false
 lint_exceptions:
   - url-allowlist
 lint_exception_reason: "Source citation: the body links the MIT-licensed godot-psxlike reference addon on GitHub (wyvernbw) that the extracted article names as its implementation evidence. Read-only provenance link; the skill never fetches or installs it."

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

@@ -1,11 +1,11 @@
 ---
 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."
+description: "Publish a game on Summer Games through MCP: store page, art, build upload, submit, owner approval link."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: deployment
 user-invocable: true
-allowed-tools: summer_read_library
+allowed-tools: summer_docs_read
 ---
 
 # /publish-your-game — publish your game
@@ -14,12 +14,22 @@ This skill covers the whole publishing journey: find the game, make its store pa
 
 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`).
+1. `summer_docs_read` with id `skill/publish-your-game` returns the current text when this machine is signed in (`summer login`).
 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.
 
-Before the build upload, run `release-readiness` on the exact `.zip` you upload, and report each check to the owner; a hosted game's upload checks can pass while every online join fails.
+## The journey in operations
 
-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.
+A call written `area.action({...})` is the tool `summer_area_action` when your client lists it, else `summer_call({ op: "area.action", input: {...} })`; `summer_search` finds any operation and its exact input. Engine tools keep their `summer_*` names.
 
-After the review: `summer_store_review` (hosted) returns Summer's decision, the reviewer's feedback and the next step. When Summer asks for changes or does not approve the game, fix every point in the feedback, then call `summer_store_submit` again; the owner approves the resubmission. If there is no written feedback, say so and ask the owner instead of guessing. The game is not live until Summer approves it.
+1. `games.list()` finds the game; `games.create({ title, targets })` makes a new one with its first store page draft. Include `web` in `targets` so it plays in the browser. Keep the `gameId`.
+2. `store.get_listing({ gameId })` reads the page: text per store, art per slot, the publish checklist and the tags a page can pick.
+3. `store.update_listing`, `store.set_art`, `store.set_trailer` and `store.set_sound` fill it until `readyToPublish` is true. Editing never publishes.
+4. Export with `summer_export_game`, run `release-readiness` on the exact `.zip`, and report each check to the owner; a hosted game's upload checks can pass while every online join fails. Then upload it: `store.upload_file({ gameId, clientVersion, confirm: true })` from this machine once the owner approved the exact file and version, or `store.upload_begin` (`kind` bundle, web or download), `store.upload_sign_parts` and `store.upload_complete` with the bytes. Finishing answers a job: `jobs.wait({ jobId })` until Summer's checks are done.
+5. `store.publish({ gameId, price, note, idempotencyKey })` asks the owner; `price` is `{ currency: "USD", amountMinor }` in cents (0 is free), omitted it keeps the current price. It answers `needs_approval` with the owner's link and a job. Give the owner the link; `jobs.wait({ jobId })` returns once they answer.
+6. `store.status({ gameId })` shows Summer's review decision and feedback, every upload, what players get now, and one next step.
+7. A store bundle goes to players with `store.release({ gameId, idempotencyKey })` once Summer approved the game: it releases only the build the owner approved, and answers a job. Web builds and downloads need no release.
+
+The one rule to keep even before you load it: Asking does not publish. `store.publish` returns an approval link; only the owner's click sends the game to review, and review comes before live.
+
+After the review: when `store.status` says `review.needsChanges`, fix every point in `review.feedback`, then call `store.publish` again with a new `idempotencyKey`; the owner approves the resubmission. If there is no written feedback, say so and ask the owner instead of guessing. The game is not live until Summer approves it.