summer-engine 3.1.0 → 3.2.0

package/.claude-plugin/marketplace.json

@@ -11,8 +11,8 @@
     {
       "name": "summer",
       "source": "./",
-      "version": "3.1.0",
-      "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
+      "version": "3.2.0",
+      "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
       "author": {
         "name": "Summer Engine",
         "email": "founders@summerengine.com"

package/.claude-plugin/plugin.json

@@ -2,8 +2,8 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "_generated": "GENERATED from integrations/claude — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.1.0",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
+  "version": "3.2.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -30,6 +30,7 @@
     "./library/skills/3d-lighting/",
     "./library/skills/adaptive-music/",
     "./library/skills/agent-playtesting/",
+    "./library/skills/ai-characters-in-games/",
     "./library/skills/ambient-bed/",
     "./library/skills/animated-loop/",
     "./library/skills/animation-tree/",
@@ -40,11 +41,14 @@
     "./library/skills/brainstorm-game/",
     "./library/skills/brainstorming/",
     "./library/skills/browse-templates/",
+    "./library/skills/camera-rigs/",
     "./library/skills/celeste-momentum-platforming/",
     "./library/skills/character-animation-wiring/",
     "./library/skills/character-model/",
+    "./library/skills/character-movement/",
     "./library/skills/character-portrait/",
     "./library/skills/cinematic-cutscene/",
+    "./library/skills/combat-basics/",
     "./library/skills/concept-art/",
     "./library/skills/create-asset-sheet/",
     "./library/skills/debug/",
@@ -66,16 +70,21 @@
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
     "./library/skills/headless-scripting/",
-    "./library/skills/host-authoritative-state/",
+    "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
     "./library/skills/investigating-bugs/",
     "./library/skills/lumera-single-image-scene-reconstruction/",
     "./library/skills/make-game/",
+    "./library/skills/multiplayer/",
+    "./library/skills/multiplayer-movement/",
+    "./library/skills/multiplayer-project/",
+    "./library/skills/multiplayer-publish/",
+    "./library/skills/multiplayer-state/",
+    "./library/skills/multiplayer-testing/",
     "./library/skills/music-track/",
     "./library/skills/navigate-summer/",
     "./library/skills/new-project/",
     "./library/skills/organic-model/",
-    "./library/skills/peer-to-peer-multiplayer/",
     "./library/skills/pixel-art/",
     "./library/skills/play/",
     "./library/skills/playtesting-a-feature/",
@@ -86,11 +95,11 @@
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",
+    "./library/skills/save-load/",
     "./library/skills/scene-composition/",
     "./library/skills/scene-hierarchy-design/",
     "./library/skills/scene-scripting/",
     "./library/skills/scene-to-level/",
-    "./library/skills/setup-multiplayer/",
     "./library/skills/skill-create/",
     "./library/skills/skill-improve/",
     "./library/skills/skill-test/",
@@ -99,6 +108,17 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/summer-analytics/",
+    "./library/skills/summer-friends/",
+    "./library/skills/summer-leaderboards/",
+    "./library/skills/summer-match-results/",
+    "./library/skills/summer-matchmaking/",
+    "./library/skills/summer-parties/",
+    "./library/skills/summer-player-data/",
+    "./library/skills/summer-store/",
+    "./library/skills/summer-world-chat/",
+    "./library/skills/summer-world-saves/",
+    "./library/skills/text-to-motion/",
     "./library/skills/tileable-texture/",
     "./library/skills/trailer-shot/",
     "./library/skills/tune-performance/",
@@ -118,6 +138,8 @@
     "./library/skills/vfx-smoke/",
     "./library/skills/vfx-water-ripple/",
     "./library/skills/voice-line/",
+    "./library/skills/web-and-touch-input/",
+    "./library/skills/web-compatibility-look/",
     "./library/skills/world-building-3d/",
     "./library/skills/writing-plans/",
     "./library/skills/writing-skills/"

package/.codex-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "_generated": "GENERATED from integrations/codex — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.1.0",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge. Build games by talking.",
+  "version": "3.2.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -25,6 +25,7 @@
     "./library/skills/3d-lighting/",
     "./library/skills/adaptive-music/",
     "./library/skills/agent-playtesting/",
+    "./library/skills/ai-characters-in-games/",
     "./library/skills/ambient-bed/",
     "./library/skills/animated-loop/",
     "./library/skills/animation-tree/",
@@ -35,11 +36,14 @@
     "./library/skills/brainstorm-game/",
     "./library/skills/brainstorming/",
     "./library/skills/browse-templates/",
+    "./library/skills/camera-rigs/",
     "./library/skills/celeste-momentum-platforming/",
     "./library/skills/character-animation-wiring/",
     "./library/skills/character-model/",
+    "./library/skills/character-movement/",
     "./library/skills/character-portrait/",
     "./library/skills/cinematic-cutscene/",
+    "./library/skills/combat-basics/",
     "./library/skills/concept-art/",
     "./library/skills/create-asset-sheet/",
     "./library/skills/debug/",
@@ -61,16 +65,21 @@
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
     "./library/skills/headless-scripting/",
-    "./library/skills/host-authoritative-state/",
+    "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
     "./library/skills/investigating-bugs/",
     "./library/skills/lumera-single-image-scene-reconstruction/",
     "./library/skills/make-game/",
+    "./library/skills/multiplayer/",
+    "./library/skills/multiplayer-movement/",
+    "./library/skills/multiplayer-project/",
+    "./library/skills/multiplayer-publish/",
+    "./library/skills/multiplayer-state/",
+    "./library/skills/multiplayer-testing/",
     "./library/skills/music-track/",
     "./library/skills/navigate-summer/",
     "./library/skills/new-project/",
     "./library/skills/organic-model/",
-    "./library/skills/peer-to-peer-multiplayer/",
     "./library/skills/pixel-art/",
     "./library/skills/play/",
     "./library/skills/playtesting-a-feature/",
@@ -81,11 +90,11 @@
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",
+    "./library/skills/save-load/",
     "./library/skills/scene-composition/",
     "./library/skills/scene-hierarchy-design/",
     "./library/skills/scene-scripting/",
     "./library/skills/scene-to-level/",
-    "./library/skills/setup-multiplayer/",
     "./library/skills/skill-create/",
     "./library/skills/skill-improve/",
     "./library/skills/skill-test/",
@@ -94,6 +103,17 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/summer-analytics/",
+    "./library/skills/summer-friends/",
+    "./library/skills/summer-leaderboards/",
+    "./library/skills/summer-match-results/",
+    "./library/skills/summer-matchmaking/",
+    "./library/skills/summer-parties/",
+    "./library/skills/summer-player-data/",
+    "./library/skills/summer-store/",
+    "./library/skills/summer-world-chat/",
+    "./library/skills/summer-world-saves/",
+    "./library/skills/text-to-motion/",
     "./library/skills/tileable-texture/",
     "./library/skills/trailer-shot/",
     "./library/skills/tune-performance/",
@@ -113,6 +133,8 @@
     "./library/skills/vfx-smoke/",
     "./library/skills/vfx-water-ripple/",
     "./library/skills/voice-line/",
+    "./library/skills/web-and-touch-input/",
+    "./library/skills/web-compatibility-look/",
     "./library/skills/world-building-3d/",
     "./library/skills/writing-plans/",
     "./library/skills/writing-skills/"
@@ -122,7 +144,7 @@
   "interface": {
     "displayName": "Summer",
     "shortDescription": "Superpowers for AI game dev. Build games by talking.",
-    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine. Users make Summer games with the Summer SDK and GDScript. The plugin adds game-dev skills, lifecycle hooks, and a 86-tool MCP bridge for guarded project files, scene editing, asset import, play mode, diagnostics, generation, and creator workflows. Git, shell, and grep stay with the host agent. Summer follows its upstream technical base continuously; version-sensitive work uses the bundled compatibility reference instead of a fixed onboarding version. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
+    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine. Users make Summer games with the Summer SDK and GDScript. The plugin adds game-dev skills, lifecycle hooks, and a 101-tool MCP bridge for guarded project files, scene editing, asset import, play mode, diagnostics, generation, and creator workflows. Git, shell, and grep stay with the host agent. Summer follows its upstream technical base continuously; version-sensitive work uses the bundled compatibility reference instead of a fixed onboarding version. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
     "developerName": "Summer Engine",
     "category": "Coding",
     "capabilities": [

package/.cursor-plugin/plugin.json

@@ -3,8 +3,8 @@
   "_generated": "GENERATED from integrations/cursor — do not edit; npm run generate:registry",
   "name": "summer",
   "displayName": "Summer",
-  "version": "3.1.0",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
+  "version": "3.2.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com"
@@ -37,6 +37,7 @@
     "./library/skills/3d-lighting/",
     "./library/skills/adaptive-music/",
     "./library/skills/agent-playtesting/",
+    "./library/skills/ai-characters-in-games/",
     "./library/skills/ambient-bed/",
     "./library/skills/animated-loop/",
     "./library/skills/animation-tree/",
@@ -47,11 +48,14 @@
     "./library/skills/brainstorm-game/",
     "./library/skills/brainstorming/",
     "./library/skills/browse-templates/",
+    "./library/skills/camera-rigs/",
     "./library/skills/celeste-momentum-platforming/",
     "./library/skills/character-animation-wiring/",
     "./library/skills/character-model/",
+    "./library/skills/character-movement/",
     "./library/skills/character-portrait/",
     "./library/skills/cinematic-cutscene/",
+    "./library/skills/combat-basics/",
     "./library/skills/concept-art/",
     "./library/skills/create-asset-sheet/",
     "./library/skills/debug/",
@@ -73,16 +77,21 @@
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
     "./library/skills/headless-scripting/",
-    "./library/skills/host-authoritative-state/",
+    "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
     "./library/skills/investigating-bugs/",
     "./library/skills/lumera-single-image-scene-reconstruction/",
     "./library/skills/make-game/",
+    "./library/skills/multiplayer/",
+    "./library/skills/multiplayer-movement/",
+    "./library/skills/multiplayer-project/",
+    "./library/skills/multiplayer-publish/",
+    "./library/skills/multiplayer-state/",
+    "./library/skills/multiplayer-testing/",
     "./library/skills/music-track/",
     "./library/skills/navigate-summer/",
     "./library/skills/new-project/",
     "./library/skills/organic-model/",
-    "./library/skills/peer-to-peer-multiplayer/",
     "./library/skills/pixel-art/",
     "./library/skills/play/",
     "./library/skills/playtesting-a-feature/",
@@ -93,11 +102,11 @@
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",
+    "./library/skills/save-load/",
     "./library/skills/scene-composition/",
     "./library/skills/scene-hierarchy-design/",
     "./library/skills/scene-scripting/",
     "./library/skills/scene-to-level/",
-    "./library/skills/setup-multiplayer/",
     "./library/skills/skill-create/",
     "./library/skills/skill-improve/",
     "./library/skills/skill-test/",
@@ -106,6 +115,17 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/summer-analytics/",
+    "./library/skills/summer-friends/",
+    "./library/skills/summer-leaderboards/",
+    "./library/skills/summer-match-results/",
+    "./library/skills/summer-matchmaking/",
+    "./library/skills/summer-parties/",
+    "./library/skills/summer-player-data/",
+    "./library/skills/summer-store/",
+    "./library/skills/summer-world-chat/",
+    "./library/skills/summer-world-saves/",
+    "./library/skills/text-to-motion/",
     "./library/skills/tileable-texture/",
     "./library/skills/trailer-shot/",
     "./library/skills/tune-performance/",
@@ -125,6 +145,8 @@
     "./library/skills/vfx-smoke/",
     "./library/skills/vfx-water-ripple/",
     "./library/skills/voice-line/",
+    "./library/skills/web-and-touch-input/",
+    "./library/skills/web-compatibility-look/",
     "./library/skills/world-building-3d/",
     "./library/skills/writing-plans/",
     "./library/skills/writing-skills/"

package/.factory-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "_generated": "GENERATED from integrations/factory — do not edit; npm run generate:registry",
   "name": "summer",
-  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
-  "version": "3.1.0",
+  "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 101-tool MCP bridge to the local desktop app.",
+  "version": "3.2.0",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -22,6 +22,7 @@
     "./library/skills/3d-lighting/",
     "./library/skills/adaptive-music/",
     "./library/skills/agent-playtesting/",
+    "./library/skills/ai-characters-in-games/",
     "./library/skills/ambient-bed/",
     "./library/skills/animated-loop/",
     "./library/skills/animation-tree/",
@@ -32,11 +33,14 @@
     "./library/skills/brainstorm-game/",
     "./library/skills/brainstorming/",
     "./library/skills/browse-templates/",
+    "./library/skills/camera-rigs/",
     "./library/skills/celeste-momentum-platforming/",
     "./library/skills/character-animation-wiring/",
     "./library/skills/character-model/",
+    "./library/skills/character-movement/",
     "./library/skills/character-portrait/",
     "./library/skills/cinematic-cutscene/",
+    "./library/skills/combat-basics/",
     "./library/skills/concept-art/",
     "./library/skills/create-asset-sheet/",
     "./library/skills/debug/",
@@ -58,16 +62,21 @@
     "./library/skills/generate-motion/",
     "./library/skills/godogen-visual-proof-game-generation/",
     "./library/skills/headless-scripting/",
-    "./library/skills/host-authoritative-state/",
+    "./library/skills/in-game-purchases/",
     "./library/skills/instantiate-asset-pack/",
     "./library/skills/investigating-bugs/",
     "./library/skills/lumera-single-image-scene-reconstruction/",
     "./library/skills/make-game/",
+    "./library/skills/multiplayer/",
+    "./library/skills/multiplayer-movement/",
+    "./library/skills/multiplayer-project/",
+    "./library/skills/multiplayer-publish/",
+    "./library/skills/multiplayer-state/",
+    "./library/skills/multiplayer-testing/",
     "./library/skills/music-track/",
     "./library/skills/navigate-summer/",
     "./library/skills/new-project/",
     "./library/skills/organic-model/",
-    "./library/skills/peer-to-peer-multiplayer/",
     "./library/skills/pixel-art/",
     "./library/skills/play/",
     "./library/skills/playtesting-a-feature/",
@@ -78,11 +87,11 @@
     "./library/skills/remote-deploy/",
     "./library/skills/retarget/",
     "./library/skills/running-in-the-cloud/",
+    "./library/skills/save-load/",
     "./library/skills/scene-composition/",
     "./library/skills/scene-hierarchy-design/",
     "./library/skills/scene-scripting/",
     "./library/skills/scene-to-level/",
-    "./library/skills/setup-multiplayer/",
     "./library/skills/skill-create/",
     "./library/skills/skill-improve/",
     "./library/skills/skill-test/",
@@ -91,6 +100,17 @@
     "./library/skills/sound-effect/",
     "./library/skills/spatial-placement/",
     "./library/skills/sprite-sheet/",
+    "./library/skills/summer-analytics/",
+    "./library/skills/summer-friends/",
+    "./library/skills/summer-leaderboards/",
+    "./library/skills/summer-match-results/",
+    "./library/skills/summer-matchmaking/",
+    "./library/skills/summer-parties/",
+    "./library/skills/summer-player-data/",
+    "./library/skills/summer-store/",
+    "./library/skills/summer-world-chat/",
+    "./library/skills/summer-world-saves/",
+    "./library/skills/text-to-motion/",
     "./library/skills/tileable-texture/",
     "./library/skills/trailer-shot/",
     "./library/skills/tune-performance/",
@@ -110,6 +130,8 @@
     "./library/skills/vfx-smoke/",
     "./library/skills/vfx-water-ripple/",
     "./library/skills/voice-line/",
+    "./library/skills/web-and-touch-input/",
+    "./library/skills/web-compatibility-look/",
     "./library/skills/world-building-3d/",
     "./library/skills/writing-plans/",
     "./library/skills/writing-skills/"

package/.opencode/plugins/summer.js

@@ -31,7 +31,7 @@ Activate summer:using-summer FIRST in any Summer Engine session — it sets work
 
 Process skills (run before building): brainstorm-game, debug, play.
 Discipline skills (shape what you build): gdscript-patterns, scene-composition, art-direction, audio-direction, asset-strategy.
-Build skills (produce artifacts): fps-controller, design-mechanic, design-level, setup-multiplayer, host-authoritative-state, peer-to-peer-multiplayer, design-npc, 3d-lighting, ui-basics, game-feel, vfx-fire, vfx-smoke, vfx-lightning, vfx-hit-spark, tune-performance, export-and-ship, make-game.
+Build skills (produce artifacts): fps-controller, design-mechanic, design-level, multiplayer, multiplayer-project, multiplayer-movement, multiplayer-state, design-npc, 3d-lighting, ui-basics, game-feel, vfx-fire, vfx-smoke, vfx-lightning, vfx-hit-spark, tune-performance, export-and-ship, make-game.
 
 Always check for a relevant skill before responding. The summer-engine MCP server (npx -y summer-engine@latest mcp) provides identity-bound project file mutations plus scene, asset, render, play, and diagnostics tools. Git, shell, and grep remain native; do not bypass Summer's file guards when MCP is available.
 </EXTREMELY_IMPORTANT>`;

package/CHANGELOG.md

@@ -2,6 +2,108 @@
 
 All notable changes to summer-engine will be documented here. Following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/).
 
+## [3.2.0] - 2026-10-07
+
+### Added
+- Multiplayer skills, rewritten from scratch around Summer's own networking. `multiplayer` explains the model (one project, a client scene and a headless authority scene, Worlds, Sessions, queues, Local Play) and routes to a linked sequence:
+  - `multiplayer-project`: the export-ready layout (`client/`, `authority/`, `network/`), `summer.build.json`, `world.json`, the runtime descriptor, the source graph, one network composition, joining a queue and a first Local Play run.
+  - `multiplayer-movement`: client-side movement. The owner moves its character locally and publishes a pose to an owner-written State group bound to its player entity. The authority checks every pose with a refilling distance allowance and can teleport players with `reset()`. Others glide between poses 100 ms behind, ordered by authority acceptance time.
+  - `multiplayer-state`: shared and private authority-written State groups, Commands with verified Sessions and request ids, and Transient Events.
+  - `multiplayer-testing`: Local Play under latency, jitter and loss, bots driven through `-- --bot={client}`, and what a passing run must show. "Every client joined" alone can hide a composition that never attached.
+  - `multiplayer-publish` (preview): the two export presets, the summer.games bundle, the source graph analyzer and native upload probe, and uploading a Build. `export-errors.md` lists every exporter message.
+  - One skill per Summer SDK service: `summer-matchmaking` (preview), `summer-match-results`, `summer-leaderboards` (preview), `summer-parties` (preview), `summer-friends` (preview; needs an engine release with the Friends SDK), `summer-player-data`, `summer-world-saves` (preview), `summer-world-chat` (preview), `summer-store` (preview), `summer-analytics` (preview).
+  - The core skills' code was run as written: a 2-player Local Play game at 100 ms round trip, 10 ms jitter and 1 % loss (movement, a refused teleport cheat, Commands, private state, Events), and a summer.games bundle export that passes the source graph analyzer and the native upload probe.
+- Kit-placement tools (preview), built only on existing engine ops (a read-only `RunSceneScript` probe, then `SetProp` / `SnapToSurface` / `InstantiateScene` with the usual scene target, undo and final save). Every result is under 5 KB, names its evidence (`visual_aabb`, `physics`, `mesh_triangles`, `markers`) and declares any cut list:
+  - `summer_inspect_asset`: measure a `.tscn`/`.glb`/`.gltf` (or Mesh) without adding it to a scene. A `summary` block comes first: AABB, origin label, the two largest opposite plane pairs with a `one_sided` flag per plane (its material culls back faces) and the ids of port-like open loops. Then per-mesh AABBs and triangle counts, the 6 largest planar faces, open boundary loops, Marker3D anchors, collision shapes. Open loops have stable ids by facing and position (`+Y` = the outermost loop facing +Y in the piece's own axes, `+Y#2` the next), never by radius, so the same id names the same loop in every pose. `detail: "summary"` (default) lists only port-like loops (radius over 2 cm with a partner loop facing another way, or the one opening of an end piece such as an outlet's socket), so a flat wall's outline no longer buries the facing; `detail: "full"` lists every loop. `maxTriangles` goes down to 100, and the summary says which budget covers a mesh the budget cut.
+  - `summer_place_adjacent`: put one node's bounds face against another's along an axis, lining up the other axes per axis; verified by a fresh read.
+  - `summer_attach_to_surface`: turn a piece's measured local back axis into a surface found by a ray (up kept), then seat its back face (the extreme of its visible bounds along the back axis, not its origin) with `SnapToSurface` at a standoff. The piece keeps its height and place along the surface (`placeAt: "current"`) unless `placeAt: "hit"` slides its back-face centre onto the ray hit. Before saving it refuses, and puts the piece back exactly where it started, when the seat lands on another node than the named surface (or, with a ray only, off the hit plane) or the piece would move more than `maxMove` (default 2). The receipt names `seated_on`, `final_gap`, `back_face_gap` and `moved_by`; a failed seat adds `blockers` (what the piece overlaps, whether it started overlapping, the first contact) and a `next_step`.
+  - `summer_repeat_along`: instance up to 64 copies of a scene along a line by spacing or count, with a compact receipt of the created paths. N copies cost N + 2 engine requests.
+  - `summer_connect_ports`: move and turn a piece so its port (open-loop id such as `"+Y"`, Marker3D name, or open-loop index) meets another piece's port; verified distance, angle and tilt. A join that would tilt the piece's up axis more than `maxTiltDegrees` (default 5) is refused before anything changes, with the predicted tilt and the ports that join within the limit, unless `allowTilt` is set. `rollDegrees` is documented exactly (axis = the target port direction reversed, right-hand rule, zero = the shortest turn from the current orientation), and the receipt adds `roll_axis` and `other_ports`: where each other port of the subject ends up (world position and outward direction), so a bend's free end needs no extra measure.
+  - `summer_raycast`: one ray from any point; physics first, visual-AABB fallback declared.
+  - `summer_measure`: gap or overlap per axis between two nodes, or face coplanarity across 2-32 nodes (proud / recessed).
+- `summer_instantiate_scene` takes `position`, `rotation_degrees`, `scale` or `transform`, set on the node path the receipt reports right after the instance exists: one call per placed piece. The same fields work on `InstantiateScene` ops in `summer_batch`, where the transforms of a run of placed pieces travel in one request before the next other op: N placed pieces cost about N + 2 engine requests instead of 2N + 1.
+- `summer_batch` gains `receipt: "summary"`: counts, failures with their op index, created node paths and renames, under 5 KB.
+- `spatial-placement` skill: a question-to-tool table for every placement tool, a modular-kit workflow and a worked two-storey facade example with a downpipe, clamps and a lamp; `references/kit-placement-tools.md` documents each tool's arguments, results, limits and engine ops. `world-building-3d` routes kit placement to it.
+- `summer_generate_motion` gains `backend: "text-to-motion"`: custom 2-second clips from text prompts on any of your own rigged models (humanoid, animal, creature, cartoon plant, prop; 5-70 bones). New fields `prompt` / `prompts` (1-8), `takes` (1-4), `lockJoints`, `cfgScale` (1.5-8) and `idempotencyKey`; one billed clip per prompt x take; poll `summer_check_job`, import with `summer_import_asset_by_id`. The server keeps the backend off until it is enabled and answers `backend_unavailable`; the tool then points back to `meshy-library`. `summer tool generate-motion` validates with the same schema.
+- `text-to-motion` skill (preview): route, rigging for non-humanoids (human bone names, the talking-flower recipe), prompts and controls, failure codes. `asset-strategy` and `generate-motion` route custom and non-humanoid motion to it.
+- Seeing tools (preview) for judging 3D environments like a player and an artist; every image inline (one grid per call), rendered from the saved scene with its REAL WorldEnvironment and lights, read-only, structured failures. `summer_frame_nodes` (fit a pose to node world bounds, optional bookmark and marks), `summer_shot_sheet` (N bookmarks/poses in one labelled grid; `compare_previous` adds previous / now / difference map), `summer_debug_views` (beauty, lighting, unshaded, normals, overdraw, wireframe), `summer_zoom` (exact sub-frustum of a region or mark N at full resolution), `summer_frame_shot` (smart framing for establishing / eye_level / low_angle / detail / corridor: thick-sweep visibility, selective occluders, near-lens check, low-angle rule, a small beauty render per pose, rule-of-thirds / fill / horizon / sky / depth / featureless-area / value-contrast / foreground scoring; top 3, best bookmarked, one sheet). Built on the existing ScenePreview op (a throwaway wrapper scene with a read-only @tool kernel, `assets/seeing/seeing_probe.gd`); no engine change.
+- Bounded shot storage: one previous-image slot per rendered bookmark at `res://.summer/shots/<bookmark>.jpg` (JPEG, at most 1024 px, folder capped at 20 MB with oldest-first eviction) and explicit `save_to` copies; nothing else is written. `summer_screenshot framing:"bookmark"` keeps a clean render there when the bookmark has none, and gains `compare_previous` and `update_previous`.
+- `verifying-scenes` gains an environment review section (the loop and a beauty rubric); the playbook gains a `seeing` section.
+- `summer_scene_audit` (preview): one read-only call that walks every node of a 3D scene and lists likely visual and placement problems, at most 5 KB, sorted error / warn / look, each with node path, world position, reason, evidence numbers and the next tool; counts and editor time per check; `offset`/`limit` paging, `checks`, `root` (subtree) and `min_severity` filters; `render:"sheet"` adds one inline image of the page's first 6 issues framed from their open side. Checks: `through_hole` (capped ray grids through each facade line; rays that pass the wall and reach the far side of the building), `floor_gap`, `floating` / `sunken`, `interpenetration`, `orientation`, `uv_stretch`, `duplicate` / `z_fight`, `lights`, `transform`, `resource`. Every check works on any scene from geometry, the engine's node and resource data and materials alone, never node or file names or kit metadata: each piece's role comes from its shape (see-through cards are dressing, upright sheets walls, flat slabs floors, raised slabs with walls under them roofs, a large slab below the rest the underlay, a piece in a wall's opening an insert, bands, piers and corner blocks against a facade structure, the rest props). Built on the seeing tools' private-copy path (ScenePreview of a throwaway wrapper scene with a read-only @tool kernel, `assets/audit/scene_audit.gd`): the open tab never becomes unsaved; no engine change. `verifying-scenes` gains the audit loop and the playbook routes to it.
+- `summer_scene_audit` check refinements:
+  - `floor_gap` classifies each ray by the surface it hits first. An underlay plane above the floor's own drain channel or dip is "covers the floor" (warn), not a hole.
+  - `floor_gap` also samples bare strips between each tile edge and a wall within 1 m.
+  - `floor_gap` measures areas from the missed rays' own footprints, with the strip's size (a thin seam counts its own area, not whole grid cells).
+  - `sunken` measures and names the surface a prop is buried in, seen from above.
+  - `interpenetration` lists every partner a prop cuts (up to 3).
+- `summer_scene_audit` `budget_ms` (default 3000): each check gets a weighted share of the editor time. A check past its share stops and shows `partial` (the share it covered) in its counts, and is never listed as clean.
+- `summer_scene_audit` `z_fight` is exhaustive. A geometry pass (its own stage time) compares each mesh's planar face groups:
+  - between any two pieces: props, roofs, ledges, side walls, inserts against hosts, decals; opposite-facing pairs only when both are double-sided;
+  - between two surfaces of one mesh, reported once per mesh;
+  - the ray samples still run.
+  - "Coplanar" means a gap under twice the 24-bit depth step at the view distance (the nearest walkable eye point, camera or bookmark) for the main camera's near/far. `ev` carries the overlap, gap, tolerance and surfaces.
+  - The material decides what is demoted to look, with the reason: `render_priority`, depth or normal offsets, a see-through (alpha) material such as a decal or overlay, no depth test or depth writes.
+- `summer_scene_audit` gains three gap detectors. They run last in `budget_ms`, on the time the other checks leave, so no other check loses time to them. Like every check they decide from geometry alone: the pieces they look at are walls and the facade members (bands, piers, corner blocks) the roles found, and run pieces for open ends.
+  - `exposed_edge`: open outline edges of walls, bands, piers and corner blocks (cached per mesh) that nothing covers within 4-7 mm and that walkable space sees (eye points over open-sky floor cells, flood-filled from the scene's cameras and characters, sight lines not through a building). Each comes with its reveal: a 2-60 cm step, a seam (the next sheet within 4 cm) or a gap (the next sheet within 35 cm). Band pieces warn. Wall pieces are look items, or warn when `depth_step` agrees. Band pieces are scanned first.
+  - `open_fixture_end`: an open end of a run piece (a mesh with two or more open rims of one size: a pipe, duct or gutter section, an elbow, a tee) that nothing joins within 2.5 cm (sleeve tolerance), seen from walkable space (warn). A piece with one rim, or rims of different sizes (a cap, a funnel, an outlet), is open by design.
+  - `depth_step` (look): ray rows across each facade at its band levels (band rows first) and every 1.25 m. It finds band recesses and missing band runs, seams, proud modules and holes with something behind them. A hole confirms a nearby `through_hole` (warn -> error). Runs a door-like opening (an insert reaching the floor) covers are skipped.
+- `summer_scene_audit` `accept:[{key, reason}]`: look and warn items you judged fine are written to `res://.summer/audit-accept.json`, the only file the audit writes. Each issue carries a `key` (check:path@x,y,z, rounded to 0.1 m). Later audits count accepted items (`counts.<check>.accepted`, `accepted`) and hide them until their evidence changes materially (severity rises, or the measured size moves by over 25%); then they show again with `accept_stale`. Errors cannot be accepted. `show_accepted` lists them.
+- `summer_grep` (preview): regex search over project files through the engine's ripgrep `Grep` op, which agents could reach only as an undocumented raw `summer_batch` op. Returns file, line and text per match; `context_lines` (0-10) adds the lines before and after each match (read back from the matched files, because the engine op drops ripgrep's context output); `path` (a res:// directory or file), `glob`, `case_sensitive`, `multiline`; `max_results` (default 50, max 500) with `truncated`; every line is clipped to `max_line_chars`. A missing path is `failure_reason: path_not_found` instead of a raw ripgrep error string.
+- `summer_read_file` reads big files in parts. `offset` / `limit` page by lines (default) or bytes (`unit: "bytes"`, cut on UTF-8 boundaries), and `data.window` reports `start_line` / `end_line`, `total_lines`, `next_offset` and `eof`. For JSON, `json_path` returns one value (`pieces.wall_a`, `items[3]`), `keys` keeps matching object keys (`["wall_*"]`) and `keys_only` lists key names only; `data.json` says what matched. The sha256 stays the full-file receipt, so a windowed read still guards an overwrite. Without these arguments the call is unchanged.
+- `summer_world_snapshot` filters: `path_prefix` (one subtree), `classes`, `fields` and `offset`. A filtered read adds `matched_nodes` and `matched_counts` (the subtree's class counts) and filters `lights` / `cameras` to the subtree. `counts`, `total_nodes` and the `snapshot_id` diff baseline still cover the whole scene.
+- `summer_inspect_node` `fields`: only the named properties (globs allowed) plus derived `transform` (local position / rotation_degrees / scale and a `Transform3D` literal), `global_transform` (composed from the world snapshot), `scene_file_path`, `aabb` and `warnings`. Reading a transform drops from about 5 KB to a few hundred bytes.
+
+### Changed
+- `fps-controller`, `procedural-animation`, `make-game`, `browse-templates`, `using-summer` and the `.summer/` folder reference point at the new multiplayer skills and no longer suggest `@rpc` or `MultiplayerSynchronizer`.
+- The `3d-lan-multiplayer-starter` template (host/join over Godot RPCs) is deprecated: it cannot use Summer hosting, matchmaking or identity.
+- `summer_get_agent_playbook` gains a `placement3d` section: read `spatial-placement` first, then a question-to-tool map for the spatial tools that already ship (`summer_starcast`, `summer_test_placement`, `summer_snap_to_surface`, `summer_align_distribute_3d`, `summer_navigation_probe`, world snapshot + diff + screenshot) and the kit-placement tools (measure the piece, place it in one call, place relative, mount, repeat, join ports, raycast, measure), with their preview status.
+- `summer_get_project_context` returns a compact payload by default (a few KB instead of tens of KB): project name and path, current and main scene, `sceneSummary` (root node and node count), `health` with scalar fields and capability counts, `projectMemory`, and the warnings. The open scene's tree, the engine's capability lists and the project settings come back with `include: ["scene_tree" | "capabilities" | "settings"]`; `settingsPrefix` / `settingsPrefixes` imply `settings`; `omitted` says how to ask for each block left out. Callers that read `scene`, `project` or `health.capabilities` must pass `include`.
+- `summer_world_snapshot` lists at most 200 nodes by default, and `max_nodes` now caps the listed entries rather than the stored snapshot: the engine always snapshots the whole scene (its default 4000), so `summer_snapshot_diff` keeps seeing every change. `truncated` and `next_offset` say when the list is cut.
+- `summer_generate_motion`: `motionName` is optional in the schema and still required for `meshy-library` (checked before any request); text-to-motion fields sent with `meshy-library` are rejected instead of silently ignored. The description lists the five motion aliases that always resolve instead of names that do not. `summer tool generate-motion` waits up to 10 minutes, like the MCP tool.
+- Scene receipts carry `scenePersistence.saved` instead of `scenePersistence.persisted`: the engine sets that flag when the SaveScene ran, which says nothing about what the file holds. Callers that read `persisted` must read `saved`; `verified` appears only where a tool read the saved file back (`summer_replace_node`, `summer_batch` with ReparentNode, `summer_connect_signal`).
+
+### Removed
+- `setup-multiplayer`, `host-authoritative-state` and `peer-to-peer-multiplayer`, replaced by the multiplayer skills above. `summer setup --force` prunes installed copies.
+
+### Fixed
+- `summer_scene_audit`:
+  - `transform` no longer flags correctly placed pieces whose global origin is the world origin. A piece is "left at the origin" only when its LOCAL transform is identity, its parent's is identity, it touches nothing and it is not one of a row of siblings. Several pieces sharing that transform are a warning each; one alone is a look item.
+  - Screen-space quads (a post-process `extra_cull_margin` or a huge `custom_aabb`) are skipped. They were "sunken" and "at the origin".
+  - `z_fight` evidence names the shared plane's `normal` and the axis to nudge (`nudge.world`, `nudge.local`), so a window insert whose head or jamb is the shared plane is not nudged along the facade normal.
+- Seeing tools (preview):
+  - Camera poses behind one-sided walls. The visibility pass now reads which side of each surface a ray meets (a short front-faces-only ray at the hit). A sight line that crosses a hard or subject surface from behind blocks like a wall, unless the material is transparent. A frame that is more than 25% surfaces seen from behind is rejected as `behind_surface`. So is a lens inside a closed shell (`inside_volume`) or within 0.3 m behind a back face. This removes `summer_frame_shot` corridor winners that stood behind a back wall and looked through its door hole.
+  - `summer_frame_nodes` with an explicit `from` measures that exact pose plus about 20 nearby alternatives (wider lens, turned, raised or lowered). If walls block it, or it stands behind or inside a surface, the caption opens with a WARNING and the nearest valid `from` (+ `fov`). The requested view is still rendered. `receipt.view_check` carries the result.
+  - Marks no longer pass off hidden nodes as visible. `summer_frame_nodes marks:true`, `summer_screenshot marks:true` (3D scene) and `summer_zoom mark` test each labelled node from the rendered camera (centre plus 4 points across the box face it shows). Hidden labels are noted `(hidden behind <path>)`, and a zoom on a hidden mark warns.
+  - `summer_zoom` honours the region exactly. The region is no longer grown to 16:9 or padded by default. The image takes the region's own aspect, with dark bars only past 0.5-3.2. The caption reports the real zoom per axis and `widened_because`. `pad` defaults to 0 for `region` and to 0.15 for `mark`.
+  - Establishing shots:
+    - the top 3 are three different views: one per side of the subject while the score is within 0.15 of the best, and always at least 25 degrees apart. This also applies to low-angle and detail shots; eye-level looks are spaced 25 degrees apart;
+    - a `light` term reads the strongest DirectionalLight3D: side or front-side light scores best, light from straight behind the camera (a flat-lit face) worst;
+    - an `edge` term penalises sky or void below the horizon from 4% of the frame;
+    - a `solid` term counts surfaces seen from behind.
+  - `summer_frame_shot` eye-level and corridor cameras stay at eye height. Corridor winners could come back "adjusted: raised" well above eye height: the candidates included 2.4 m and 3.5 m eyes, and the ground-clearance check read a duct or balcony overhead as ground and lifted the camera over it. Now every eye-level and corridor pose stands 1.5-1.8 m (or exactly `eye_height`) above the walkable surface straight below the lens, within a step of the spawn's or corridor's floor, and is never raised. A pose that cannot stand there moves horizontally (along the view, then sideways) or is rejected (`no_walkable_ground`, `not_walkable`; a raised or off-height pose is `raised_above_eye` / `above_eye_height`). The corridor scan seeds on the walkable floor inside the subject (a 7 x 7 grid of downward rays from the subject's middle; the most common horizontal surface met from above with headroom for an eye wins) instead of the subject's lowest point, which walls sunk into the ground put under the floor. The caption and `receipt.scan_floor` say where it seeded, and a fallback to the lowest point is declared.
+  - Establishing shots rank in tiers: a pose showing more than 15% empty ground (featureless ground or surroundings outside the subject's footprint, from the image check) or world edge ranks below every pose showing less, whatever its score.
+  - Every `summer_frame_shot` top pose and tile label states the real camera height: metres above the first surface below it and the absolute y (`receipt.top[].camera_y`, `ground_y`, `height_above_ground`).
+  - Transparent materials (alpha blend, scissor, hash, depth pre-pass, shaders that write ALPHA, instance fade) no longer block like walls. They get their own physics layer, outside every sweep. A sight line through them counts 0.8, and a grid cell counts half a soft cell. Meshes that mix opaque and transparent surfaces are split per surface.
+  - `summer_shot_sheet` without `compare_previous` no longer overwrites each bookmark's previous image (the compare baseline). The same rule now holds for `summer_debug_views` and `summer_screenshot framing:"bookmark"` (MCP and `summer tool`). A plain render creates a missing baseline and keeps an existing one, and says so. Only `compare_previous:true`, the new `update_previous:true`, or re-saving the pose with `summer_frame_nodes` / `summer_frame_shot` replaces it.
+- `summer_snap_to_surface` could not seat a prop sunk into its support: the engine backs a start overlap off, sweeps, then measures `hitTravel` from the original pose (negative when sunk) and refuses with `gap_exceeds_hit_travel`, so agents set the height by hand. When the subject starts inside its support the tool now lifts it against the cast direction by the overlap depth plus 2 cm (at most the subject's extent and 0.5 m; exact local position from the saved scene, mapped through the parent transform), snaps again, and keeps the result only when it settles on a node it was sunk into; otherwise it restores the original position. The receipt carries `recovery` (`lifted_by`, `original_local_position`).
+- `summer_snap_to_surface` failed on props without colliders: collider-less ferns on a ground PlaneMesh all answered `overlap_recovery_exceeded`, "starts in contact with or inside (unnamed)". Without a collider on the subject or the support the engine falls back to `visual_aabb`, the subject's AABB swept against every other visible AABB, and one big AABB around it (a tree, a block, a post quad with a huge custom AABB) is an overlap no back-off clears; a seat can also rest on an AABB above the real surface. Whenever the engine answers with `visual_aabb` (that failure, `gap_exceeds_hit_travel`, `surface_not_found`, or a seat) a read-only probe measures the move from visible triangles: the subject's vertices cast along the direction onto the triangles of the meshes below (a surface through the subject means it is sunk and is lifted out, at most 0.5 m), plus the support's vertices under it cast back onto the subject. One SetProp places it, a second read verifies the gap (undone beyond 5 mm), and the scene is saved: `evidence: visual_mesh`, with the engine's answer under `engine`, `verify`, and `evidenceDetails` (samples, triangles, colliders). Screen-space meshes (a shader that writes `POSITION`) are not surfaces. When the triangles find no support either, the engine's failure comes back with `mesh_fallback`.
+- `summer_snap_to_surface` failures `gap_exceeds_hit_travel` and `overlap_recovery_exceeded` said nothing about why. A read-only starcast at the current pose now adds `start_overlap`, `blocking` (the nodes the subject touches or sits inside), `below`, and a concrete `next_step`, also in the error text. Same implementation on `summer tool snap-to-surface`.
+- `summer_replace_node` with `scene` lost the change silently: the editor showed the new piece and the receipt said ok, but the saved .tscn kept the OLD scene reference (with a new unique_id), so the swap reverted on reload. The engine's ReplaceNode routes through the editor's "Change Type" path, whose `Node::replace_by` copies the old node's `scene_file_path` onto the new instance. The tool now saves, reads the saved scene, and swaps through ops that persist: InstantiateScene under a temporary name, SetProp for each property override (transform, visibility, ...), ReparentNode for each child the scene added (re-owning deeper descendants the engine's ReparentNode leaves unowned), MoveNode to the old index, RemoveNode, rename, SaveScene. It then reads the file back and returns `persisted: true` only when the node at the path instances the new scene under the same parent with every child present; otherwise it is an error with `failure_reason: not_persisted`. State that cannot travel (groups, signal connections, scene-local sub_resource values, overrides of nodes inside the old scene) is listed in `not_carried_over`. A type change of a plain node keeps the engine op, which persists, and gets the same read-back. `summer_batch` refuses a raw `ReplaceNode` with `scene`. Same implementation on `summer tool replace-node`.
+- `summer_batch` with `ReparentNode` lost the moved node's children and grandchildren on save while the op said ok: the engine's ReparentNode re-owns only the node it moves, and its `remove_child` clears the scene owner of everything below it, so the saved .tscn held `Cabinet/Box` but not `Box/Toy` or `Box/Toy/ToyPart`. A batch with ReparentNode now saves, reads the saved scene (which nodes the scene owns), sends each ReparentNode in its own request together with one in-place ReparentNode per scene-owned descendant (same parent, same live index, local transform kept), which gives each back to the scene, and after the final save reads the file again. `persisted: true` / `verified: true` only when every moved node and descendant is at its new path; otherwise an error with `failure_reason: not_persisted` and the missing paths. Nodes created earlier in the batch and renames after the move are followed. A move onto a parent that already has a child of that name is refused (`name_collision`), and so are `Undo` in the same batch and a binary `.scn`. `summer_replace_node` shares the same re-owning step. Same implementation on `summer tool batch`.
+- `summer_inspect_resource` failed on every call with "missing nodePath or property", on a mesh `.res` and a `.glb` alike: it sent only `path`, but the engine's resource endpoint reads a resource a node holds and takes `nodePath` + `property`. `path` now loads the resource FILE read-only in the editor (a RunSceneScript probe): a Mesh returns its AABB, `surface_count`, per-surface primitive, vertex and index counts, attributes, triangles and material, the unique materials and blend shapes; a `.tscn`/`.glb`/`.gltf` returns its node count, first 40 nodes (type, instanced scene, mesh) and meshes, pointing to `summer_inspect_asset` for measurements; any other resource returns its editor properties that differ from the class default (`props`, `props_at_default`). `nodePath` + `property` reach the engine endpoint as it expects. Same implementation on `summer tool inspect-resource`.
+- `summer_read_library` could not load a file a skill links: `spatial-placement` points to `references/kit-placement-tools.md` for arguments, result shapes and limits, but `reference/kit-placement-tools` was `not_found` and `part: "resource"` returned only resource.yaml. A linked file now loads by `<entry id>/<link as written>` (resolved inside `library/` only, text files only, at most 256 KB), by the relative path alone when exactly one entry ships it, and `reference/<slug>` falls back to the one `references/<slug>.md` an entry ships. Every body ends with its relative links and the id that loads each (`links` in the result); a link to another entry's `SKILL.md` or body resolves to that entry. A test walks every markdown file every skill ships and loads each link both ways. `realtime-wet-surfaces` linked a source record outside the package; it is now named, not linked.
+- `summer_connect_signal` never saved the connection while the receipt said ok: the engine's ConnectSignal connects without `CONNECT_PERSIST` and reads no flags argument, so the saved .tscn had no `[connection]` line. The tool now connects through a RunSceneScript probe with `emitter.connect(signal, Callable(receiver, method), CONNECT_PERSIST)` (a non-persistent connection of the same pair, left by the old op, is replaced), saves (the run marks the tab unsaved; the save leaves it clean), reads the saved scene back and returns `persisted: true` / `verified: true` only when the `[connection]` line is there; otherwise `failure_reason: not_persisted`. A missing emitter, receiver or signal is a structured failure (`emitter_not_found`, `receiver_not_found`, `signal_not_found` with the emitter's signals). The probe runs in the active tab, so a scene in a background tab is brought forward and the user's tab restored (`tab_switched`). The scene must be a `.tscn`. `summer_batch` refuses a raw `ConnectSignal` before anything is sent. Same implementation on `summer tool connect-signal`.
+- `summer_play` takes `players`, `spectators` and `queue` for Local Play on Summer multiplayer games. The engine starts the game's authority headless plus that many clients on this machine, each joining through the game's own `Summer.client.join`, with scenes and queue taken from the project's `summer.build.json`. The result's `local_play` block lists every process. An engine without Local Play ignores the keys and runs one client; the tool adds `local_play_note` saying so.
+
+## [3.1.1] - 2026-09-11
+
+### Fixed
+- Skill descriptions no longer blow the hosts' skills context budget. Every SKILL.md description is now the skill's 160-character `summary` (94 skills: 13k characters, about 3.3k tokens, down from 32k characters). Codex had started truncating descriptions and Claude Code's budget is about 15k characters. Trigger phrases live in the skill body; `validate-library` fails when a description and its summary differ.
+- `summer setup goose` / `hermes` on an empty config wrote the file as one flow mapping; new files are block-style YAML.
+
+### Changed
+- Agents whose docs read the agentskills.io folder now install skills to `~/.agents/skills` (project: `.agents/skills`) instead of each agent's own folder: Codex, Cursor, Zed, OpenCode, Copilot in VS Code, Devin Desktop, Amp, Crush, Warp, Kimi Code, Factory Droid, Rovo Dev, Grok Build; Antigravity, Goose, Hermes and Mistral Vibe at project scope. One install serves all of them and "where are the skills" has one answer. `skills install --force` removes the copies 3.1.0 wrote in the old per-agent folders.
+
 ## [3.1.0] - 2026-09-11
 
 ### Added

package/README.md

@@ -50,7 +50,9 @@ At that point the agent has the skills, the MCP server, and your engine running.
 
 ## AGENTS READING THIS: install playbook
 
-You are an AI coding agent. The user told you to install Summer Engine. **Run this playbook via your shell**: Bash on macOS/Linux or PowerShell on Windows. `npx -y` is shell-agnostic and works identically in both. Detection first, then only install what's missing. (Once installed, your working guide is [`AGENTS.md`](AGENTS.md).)
+You are an AI coding agent. The user told you to install Summer Engine. **Run this playbook via your shell**: Bash on macOS/Linux or PowerShell on Windows. Detection first, then only install what's missing. (Once installed, your working guide is [`AGENTS.md`](AGENTS.md).)
+
+**Windows PowerShell: type `npx.cmd` wherever this playbook says `npx`.** Plain `npx` in PowerShell runs `npx.ps1`, which Windows blocks by default ("running scripts is disabled on this system"). `npx.cmd` is the same command without that block. Never change the execution policy or turn off Windows Defender to work around it. Bash (including Git Bash on Windows) can use plain `npx`.
 
 ### Step -1: Verify Node.js is on PATH
 
@@ -58,7 +60,19 @@ You are an AI coding agent. The user told you to install Summer Engine. **Run th
 node --version
 ```
 
-If this command does not print Node.js 20 or newer, **stop**. Tell the user: "Summer needs Node.js 20+. Install from https://nodejs.org and re-run the prompt." Do NOT try to install Node yourself.
+If this prints Node.js 20 or newer, continue to Step 0.
+
+**Windows, Node missing or older than 20:** a clean Windows machine has no Node, and the whole CLI and MCP server run through it. Ask the user once: "Summer needs Node.js. OK if I install the LTS version with winget?" On yes, run:
+
+```powershell
+winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
+$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')
+node --version
+```
+
+The second line makes the new Node visible to this shell without a restart. Windows may show an administrator prompt; tell the user to accept it. Then continue the playbook in the same shell. When setup finishes, tell the user: "Restart <your agent app> once so it sees Node, then the Summer MCP connects." An app that was already open when Node was installed cannot start the MCP server until it restarts. If `winget` itself is not available, tell the user: "Install Node.js LTS from https://nodejs.org, then restart this app and re-run the prompt," and stop.
+
+**macOS/Linux, Node missing or older than 20:** stop and tell the user: "Summer needs Node.js 20+. Install from https://nodejs.org and re-run the prompt."
 
 ### Step 0: Pre-detection (no commits to disk, just check state)
 
@@ -173,7 +187,8 @@ Only skip brainstorm if the user explicitly said "skip brainstorm" or "just buil
 ### Anti-patterns (do NOT do these)
 
 - **Don't run `npm install -g summer-engine`.** Use `npx -y summer-engine@latest ...` instead. `-g` requires `sudo` on most Mac/Linux setups, so the user will get permission errors and you'll get stuck. `npx` works without root and the MCP config we ship already points at `npx summer-engine mcp`.
-- **Don't try to install Node.js for the user.** If `node --version` is unavailable, point them at https://nodejs.org and stop.
+- **Don't install Node.js without asking, and don't use anything but winget for it.** On Windows, Step -1 installs Node LTS with winget after the user says yes. On macOS/Linux, point them at https://nodejs.org and stop.
+- **Don't run plain `npx` in Windows PowerShell, and don't change the execution policy or Defender to make it work.** Use `npx.cmd`.
 - **Don't ask the user "do you want the engine too?" or "do you also want the CLI?"** There is one product, three pieces, all installed by this playbook.
 - **Don't double-download.** Always run `npx -y summer-engine@latest doctor --json` first and skip the engine download and the browser login when their checks are `status: "ok"`. Step 1 (`setup`) is the exception: run it every time — it is idempotent, and doctor's top-level `ok` cannot tell you whether skills or the MCP config are installed.
 - **Don't tell the user to type `/plugin marketplace add` or `/plugin install`.** The CLI path is the canonical install. Those slash commands are an alternative for the marketplace TUI, not the primary flow.