summer-engine 3.4.0 → 3.5.0

package/library/skills/sound-effect/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: audio
 user-invocable: true
-allowed-tools: Read Grep Glob Write Edit summer_generate_audio summer_search_assets summer_import_from_url summer_add_node summer_set_prop summer_inspect_node summer_get_scene_tree
+allowed-tools: Read Grep Glob Write Edit summer_generate_audio summer_search_assets summer_import_from_url summer_add_node summer_set_prop summer_instantiate_scene summer_inspect_node summer_get_scene_tree
 paths: ["audio/sfx/**", "scripts/**", "**/*.tscn"]
 ---
 
@@ -13,22 +13,22 @@ paths: ["audio/sfx/**", "scripts/**", "**/*.tscn"]
 
 ## Overview
 
-This skill produces one named SFX clip aligned with the audio bible's vocabulary, then wires it into the scene as an AudioStreamPlayer that plays once and frees its parent (or stops cleanly if it's a looped texture). The shape of the prompt is what makes the difference between "metal sword swing whoosh, dry, sharp, 250ms" returning the right clip on the first try and "epic battle sound" returning twenty seconds of musical noise.
+This skill produces one named SFX clip that follows the audio bible's vocabulary, then wires it into the scene as an AudioStreamPlayer that plays once and frees itself (or stops cleanly if it is a short loop). The prompt shape decides the result: "metal sword swing whoosh, dry, sharp, 250ms" returns the right clip on the first try; "epic battle sound" returns twenty seconds of musical noise.
 
-ElevenLabs SFX (the `sound_effects` capability of `summer_generate_audio`) is *literal*. It treats the prompt as a description of a real sound, not as a vibe. Concrete material + action + intensity beats adjectives every time.
+ElevenLabs SFX (the `sound_effects` capability of `summer_generate_audio`) is literal. It treats the prompt as a description of a real sound. Concrete material, action and intensity beat adjectives.
 
 ## When to use
 
 - One-shot SFX: footstep, swing, click, hit, impact, pickup, jump, land, door, breath.
-- Short loops < 2s: hum, drone snippet, rain texture (for very short looping ambients prefer `audio/ambient-bed`).
+- Short loops < 2s: hum, drone snippet, rain texture (for longer looping ambience use `ambient-bed`).
 - Replacing a placeholder beep with something on-bible.
 
 ## When NOT to use
 
-- Music or musical stings → `audio/music-track`.
-- Long location ambience (>5s) → `audio/ambient-bed`.
-- Voice / dialogue → `audio/voice-line`.
-- Defining the *vocabulary* of SFX — that's `audio/audio-direction`. This skill executes against an existing bible.
+- Music or musical stings → `music-track`.
+- Long location ambience (>5s) → `ambient-bed`.
+- Voice / dialogue → `voice-line`.
+- Defining the *vocabulary* of SFX → `audio-direction`. This skill executes against an existing bible.
 
 ## Steps
 
@@ -46,7 +46,7 @@ The bible defines an SFX *class* (UI, Pickup positive, Damage, Footstep, Attack,
 
 ### 2. Search for an existing clip first
 
-Generation is metered. Reuse beats regenerate.
+Generation uses credits. Reuse an existing clip when one fits.
 
 ```
 summer_search_assets(query="<class> <subject>", assetType="audio", source="all")
@@ -64,7 +64,7 @@ ElevenLabs SFX responds to literal sound descriptions. Pattern:
 <subject> <material> <action>, <intensity>, <character>, <duration cue>
 ```
 
-Working examples (these produce the right clip on the first try):
+Working examples:
 
 | Goal | Prompt that works | Why |
 |---|---|---|
@@ -91,7 +91,7 @@ Prompts that DON'T work (and why):
 
 Show the prompt and the call before running:
 
-> Prompt: `metal sword swing whoosh, dry, sharp, 250ms`. Duration 0.5s (model floor). Model: ElevenLabs SFX. Cost: ~1 credit. Generate?
+> Prompt: `metal sword swing whoosh, dry, sharp, 250ms`. Duration 0.5s (model floor). Model: ElevenLabs SFX. Generate?
 
 The `sound_effects` capability reads the description from **`text`**, not `prompt`. Passing `prompt` here is a 400 `text_required` — `prompt` is only for the `music` capability.
 
@@ -155,7 +155,7 @@ func _ready() -> void:
 	play()
 ```
 
-Save it as a `.tscn`, then `summer_instantiate_scene(scenePath, parent, scene, name)` to place it. Note this only wires the node into a scene at author time — spawning one per event at the emitter's runtime position is a job for GDScript (`preload(...).instantiate()` + `add_child`), not for an MCP call. The node frees itself when the stream finishes — no leaks.
+Save it as a `.tscn`, then `summer_instantiate_scene(scenePath, parent, scene, name)` to place it. That only places the node at author time. To spawn one per event at the emitter's position at runtime, use GDScript (`preload(...).instantiate()` + `add_child`). The node frees itself when the stream finishes.
 
 ### 8. Volume calibration
 
@@ -170,7 +170,7 @@ If it comes back too loud (rare): negative `volume_db`, or trim attack in an edi
 ### 9. Confirm in scene
 
 ```
-summer_inspect_node(path="/root/Game/Player/SwingSFX")
+summer_inspect_node(path="Player/SwingSFX")
 ```
 
 Verify `stream`, `bus`, `volume_db`. Trigger it via `summer_play` if the user wants to hear it now.
@@ -199,7 +199,7 @@ Stinger event:   short triumphant brass stinger, 1.5s, hall reverb
 
 - **Adjective-only prompts.** `epic`, `cool`, `realistic`, `professional` — meaningless to the model.
 - **Multiple events in one prompt.** Split into two generations.
-- **Looping a non-loop-clean clip.** Will click. Use `audio/ambient-bed` for actual loops.
+- **Looping a non-loop-clean clip.** It clicks. Use `ambient-bed` for real loops.
 - **Skipping the bus.** Default bus is `Master`. SFX must route to the `SFX` bus or the mix breaks.
 - **Generating before searching.** Reuse before regenerate.
 - **Generating before reading the bible.** The clip will fight the rest of the audio.
@@ -230,13 +230,13 @@ After the SFX is wired:
 > SFX `sword_swing_01.wav` wired to `Player/SwingSFX` on the `SFX` bus. Next:
 > - Trigger it from your attack animation's `Call Method Track` → `play()`.
 > - Generate the parry / clash counterpart with `/sound-effect` again.
-> - For a full footstep system across surfaces, see `audio/footstep-systems`.
+> - For footsteps across surfaces, generate one clip per material and switch on the floor's `physics_material` (see Edge cases).
 
 ## See also
 
-- `audio/audio-direction` — defines the vocabulary this skill obeys
-- `audio/ambient-bed` — long looping textures
-- `audio/music-track` — music
-- `audio/voice-line` — TTS
+- `audio-direction` — defines the vocabulary this skill obeys
+- `ambient-bed` — long looping textures
+- `music-track` — music
+- `voice-line` — TTS
 - `../../references/mcp-tools-reference/mcp-tools-reference.md`
 - `../../references/godot-version/godot-version.md` — Summer compatibility for audio nodes

package/library/skills/spatial-placement/SKILL.md

@@ -59,7 +59,7 @@ defined relative to a rotated subject; then use `directionSpace="local"`.
 - `grounded: true` means downward support was detected. It does not mean the
   object is centered or otherwise well placed.
 - `contactStatus` and `contacts` identify touching or overlapping colliders.
-  Godot's shape query cannot distinguish touching from penetration here.
+  The physics shape query cannot distinguish touching from penetration here.
 - `directions.<label>.status` is `blocked` when clearance is below the tool's
   threshold; `distance` is measured from the subject bounds.
 - `evidence: "physics"` is exact collider-query evidence.
@@ -93,7 +93,7 @@ defined relative to a rotated subject; then use `directionSpace="local"`.
 5. Check: `summer_measure` plane mode on each facade line (every front on one
    plane), pair mode on joints you doubt, `summer_starcast` with
    `directionSpace: "local"` on mounted pieces, `summer_test_placement` before
-   committing a piece in a tight spot. Starcast's local names follow Godot:
+   committing a piece in a tight spot. Starcast's local names follow the engine:
    `forward` is -Z, `back` is +Z. A piece with a -Z back should read
    `forward` blocked by the wall at about the standoff (or the wall in
    `contacts` when flush) and `back` open.

package/library/skills/spatial-placement/references/kit-placement-tools.md

@@ -30,7 +30,7 @@ Read it before the first call in a task. The workflow that uses them is in
   declared in `truncated: {list: {shown, total}}`.
 - **No silent fallback.** A missing op answers `engine_lacks_op`; a measurement
   that cannot be made answers a named `failure_reason`.
-- **Engine ops.** No new engine op. Reads run one read-only GDScript probe
+- **Engine ops.** Reads run one read-only GDScript probe
   through `RunSceneScript` (the op behind `summer_run_script`: in-process, no
   child editor, `undo: "none"`, no checkpoint). Mutations are ordinary
   `SetProp`, `SnapToSurface` and `InstantiateScene` ops: one undo step per
@@ -52,11 +52,11 @@ Read it before the first call in a task. The workflow that uses them is in
 | Pipe or duct end to end | `summer_connect_ports` |
 | What is in front of this point, and its normal? | `summer_raycast` |
 | Gap or overlap between two pieces; is the facade front flat? | `summer_measure` |
-| What surrounds a placed piece, which side is blocked? | `summer_starcast` (existing) |
-| Will a pose fit before I commit it in a tight spot? | `summer_test_placement` (existing) |
-| Seat a prop on a floor, table or ledge | `summer_snap_to_surface` (existing) |
-| Line up or equally space 2-16 placed pieces on one axis | `summer_align_distribute_3d` (existing) |
-| Did exactly that change, and does it look right? | `summer_world_snapshot` + `summer_snapshot_diff`, then `summer_screenshot` (existing) |
+| What surrounds a placed piece, which side is blocked? | `summer_starcast` |
+| Will a pose fit before I commit it in a tight spot? | `summer_test_placement` |
+| Seat a prop on a floor, table or ledge | `summer_snap_to_surface` |
+| Line up or equally space 2-16 placed pieces on one axis | `summer_align_distribute_3d` |
+| Did exactly that change, and does it look right? | `summer_world_snapshot` + `summer_snapshot_diff`, then `summer_screenshot` |
 
 ## `summer_inspect_asset`
 
@@ -133,20 +133,20 @@ instances it off the scene tree, measures, and frees it.
 
 ## `summer_instantiate_scene` (placed)
 
-- **Arguments added:** `position`, `rotation_degrees`, `scale` (`[x, y, z]`,
+- **Placement arguments:** `position`, `rotation_degrees`, `scale` (`[x, y, z]`,
   parent-local) or `transform` (`"Transform3D(xx, xy, xz, yx, yy, yz, zx, zy,
   zz, ox, oy, oz)"`). Not `transform` with the others; not `scale` or
   `transform` with `target_size`.
 - **Behaviour:** `InstantiateScene` (its own request, as the engine requires),
   then one `SetProp` request on the node path the receipt reports (a name
-  collision rename is followed), then `SaveScene`. Without the new fields it is
-  unchanged.
+  collision rename is followed), then `SaveScene`. Without these fields it only
+  instances the piece.
 - **Result:** the merged receipt (`results` holds every op; the per-request
   `receipts` copies are kept only when something failed) plus
   `placement {nodePath, applied, fields, space: "parent_local"}`.
 - **Ops:** `InstantiateScene`, `SetProp`, `SaveScene`.
 
-## `summer_batch` additions
+## `summer_batch` placement
 
 - `InstantiateScene` ops may carry the same placement fields (arrays or
   `"Vector3(...)"` strings). Each piece is one op; its `SetProp`s are sent right
@@ -161,8 +161,7 @@ instances it off the scene tree, measures, and frees it.
   transforms of a run of `InstantiateScene` ops are held back and sent
   together (up to 200 `SetProp`s per request) just before the next op that is
   not an `InstantiateScene`, riding along with it when it can. A batch of N
-  placed pieces is therefore about N + 2 requests and N + 2 undo steps (it was
-  2N + 1). Every later op in the list (a `SetProp`, `SnapToSurface`, a query,
+  placed pieces is therefore about N + 2 requests and N + 2 undo steps. Every later op in the list (a `SetProp`, `SnapToSurface`, a query,
   the save) runs after the transforms land. If an `InstantiateScene` fails,
   the pieces created before it still get their transforms; nothing is saved.
 
@@ -245,7 +244,7 @@ instances it off the scene tree, measures, and frees it.
   in front of the hit plane); `hit_normal_pointed_away_from_the_ray_flipped`
   (the ray hit a back face; the piece still mounts on the ray's side).
 - **Check after:** `summer_starcast` with `directionSpace: "local"`. Its local
-  names follow Godot (`forward` = -Z, `back` = +Z), so a -Z back reads
+  names follow the engine (`forward` = -Z, `back` = +Z), so a -Z back reads
   `forward` blocked (or the surface in `contacts` when seated flush) and `back`
   open.
 - **Limits:** the back face is the visible-mesh AABB in the piece's own axes;
@@ -353,12 +352,3 @@ instances it off the scene tree, measures, and frees it.
 - **Result, plane:** `{coplanar, plane, spread, off_plane_count, nodes [{path,
   face, deviation, off_plane: proud|recessed}], no_geometry?}`.
 - **Ops:** `RunSceneScript` (read-only).
-
-## What belongs in the engine later
-
-These tools compose existing ops. Natively they would be faster and exact:
-an `InstantiateScene` that takes a transform (one request, one undo step per
-piece), a compact `summer_batch` receipt mode in the ops executor, a raycast and
-a measure op that need no script and do not mark the active tab unsaved, an
-asset-geometry op that reads the import cache without instancing, and an
-oriented-bounds (OBB) query so rotated pieces stop needing `space: "local"`.

package/library/skills/sprite-sheet/SKILL.md

@@ -5,7 +5,7 @@ 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_slice_asset_sheet summer_get_studio_workflow summer_search_assets summer_import_from_url summer_import_asset_by_id summer_set_resource_property summer_add_node summer_set_prop
+allowed-tools: Read Grep Glob Write Edit summer_generate_image summer_slice_asset_sheet summer_get_studio_workflow summer_search_assets summer_import_from_url summer_import_asset_by_id summer_set_resource_property summer_write_file summer_add_node summer_set_prop summer_save_scene
 paths: ["assets/**", "sprites/**", "art/sprites/**"]
 ---
 
@@ -13,7 +13,7 @@ paths: ["assets/**", "sprites/**", "art/sprites/**"]
 
 This skill produces a grid of animation frames for a 2D character — walk cycle, idle bob, attack swing, death sequence — and wires the result into an `AnimatedSprite2D` via a `SpriteFrames` resource.
 
-**Up-front honesty:** sprite-sheet generation from a single text-to-image call is **unreliable**. Models can render "a sprite sheet of a knight walking" and produce 8 frames, but the inter-frame consistency (same anatomy, same costume, same lighting) is poor. Limbs morph between frames. Pixel sprites get extra fingers in frame 3. The result usually looks worse than the static sprite did.
+Sprite-sheet generation from a single text-to-image call is **unreliable**. Models can render "a sprite sheet of a knight walking" and produce 8 frames, but the inter-frame consistency (same anatomy, same costume, same lighting) is poor. Limbs morph between frames. Pixel sprites get extra fingers in frame 3. The result usually looks worse than the static sprite did.
 
 This skill therefore offers **three paths**, ranked by reliability:
 
@@ -38,7 +38,7 @@ So do not tell the user to cut a generated sheet by hand or in ImageMagick. The
 - The character is 3D — use `generate-motion` for skeletal animation.
 - The user wants a single static sprite → `pixel-art` or `character-portrait`.
 - The user wants UI animation (loading spinner, button hover) — animate via `AnimationPlayer` rotating/tweening a static texture instead. Don't sprite-sheet UI.
-- The user has 12+ frames per animation and 4+ animations — that's hundreds of generations at $0.02 each. Pause and discuss budget.
+- The user has 12+ frames per animation and 4+ animations. That is dozens to hundreds of generations, each using credits. Pause and agree on scope first.
 
 ## Steps
 
@@ -62,7 +62,7 @@ Ask the user (or decide based on context):
 | Higher-res character (128px+), 6-12 frames | **Per-frame img2img** |
 | User wants exact-pixel consistency | **Aseprite manual** — AI cannot deliver exact pixels |
 
-State the path before starting: "I'll do per-frame img2img — 6 generations, ~$0.12. The first frame is the base; each next frame uses the previous as reference. OK?"
+State the path before starting: "I'll do per-frame img2img: 6 generations. The first frame is the base; each next frame uses the previous one as reference. OK?"
 
 ### 3a. Path 1 — Per-frame img2img
 
@@ -74,11 +74,11 @@ summer_generate_image(
   referenceImageUrl="<frame 1 fileUrl>",
   model="nano-banana-2",
   style="<same as base>",
-  options={ removeBackground: true }
+  removeBackground=true
 )
 ```
 
-`summer_generate_image` has no `image_size` and no `negative_prompt` — put negations in the prompt text; there is no size argument at all. `options.removeBackground: true` is real and gives you true alpha instead of a prompted "transparent background" the model may paint as a literal checkerboard. `referenceImageUrl` only works on edit-capable models (`nano-banana-2`, `seedream-5-pro`, `nano-banana-lite`, `gpt-image-2`, `gemini-flash`, `flux-2`); `grok-imagine` has no edit endpoint and returns `edit_not_supported`.
+`summer_generate_image` has no size argument; put negations in the prompt text. `removeBackground: true` gives you real alpha instead of a prompted "transparent background" that the model may paint as a literal checkerboard. `referenceImageUrl` only works on edit-capable models (`nano-banana-2`, `seedream-5-pro`, `nano-banana-lite`, `gpt-image-2`, `gemini-flash`, `flux-2`); `grok-imagine` has no edit endpoint and returns `edit_not_supported`.
 
 Repeat for each frame. Save each as `goblin_walk_01.png`, `goblin_walk_02.png`, etc.
 
@@ -93,11 +93,11 @@ summer_generate_image(
   prompt="goblin warrior walk cycle, sprite sheet, 6 frames in a horizontal row, identical character across frames, side view, frames clearly separated with empty space between them, consistent lighting, consistent palette. No scene background, no varying lighting, not a different character per frame.",
   model="nano-banana-2",
   style="none",
-  options={ removeBackground: true }
+  removeBackground=true
 )
 ```
 
-There is no `"pixel"` style preset (`style` is `realistic | cartoon | anime | none`; anything else is coerced to `none`), no `image_size`, and no `negative_prompt` — the layout and the negations have to be in the prompt.
+There is no `"pixel"` style preset (`style` is `realistic | cartoon | anime | none`; anything else is coerced to `none`) and no size argument; the layout and the negations have to be in the prompt.
 
 Then cut it with the same server-side slicer Studio uses, passing the asset id the generation returned:
 
@@ -113,7 +113,7 @@ Inspect the result. If the frames are coherent and the count matches, proceed. I
 
 Tell the user:
 
-> AI sprite-sheet generation is unreliable — best path for clean pixel animation is to hand-author in Aseprite (or Piskel for free in-browser). Onion-skin frame-by-frame; ~10 minutes for a 4-frame walk cycle. Want me to generate a base reference image you can trace?
+> AI sprite-sheet generation is unreliable. For clean pixel animation, hand-author it in Aseprite (or Piskel, free in the browser). Onion-skin frame-by-frame; ~10 minutes for a 4-frame walk cycle. Want me to generate a base reference image you can trace?
 
 If yes, generate the static base via `pixel-art` and stop here. The user takes it to Aseprite.
 
@@ -223,7 +223,7 @@ Frame 3: summer_generate_image(prompt="<base + delta>", referenceImageUrl="<fram
 ...
 ```
 
-Tell the user to run via the Summer dashboard. Or recommend Aseprite (paid, $20) / Piskel (free in-browser) for hand-authoring — for pixel art under 64×64, it is the faster path even with MCP available.
+Tell the user to run via the Summer dashboard. Or recommend Aseprite (paid) or Piskel (free, in the browser) for hand-authoring — for pixel art under 64×64, it is the faster path even with MCP available.
 
 ## Handoff
 

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

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

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

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

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

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

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

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

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

@@ -142,6 +142,6 @@ Every failure is final: none of them asks you to capture again.
 
 ## See also
 
-- `skill/multiplayer` — where the client and the authority run
-- `skill/multiplayer-state` — the authority's Command handlers, where most events happen
-- `skill/summer-match-results` — results and ratings, which Summer records itself
+- `multiplayer` — where the client and the authority run
+- `multiplayer-state` — the authority's Command handlers, where most events happen
+- `summer-match-results` — results and ratings, which Summer records itself

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

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

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

@@ -42,7 +42,7 @@ Declining never blocks play. A game must work without these permissions.
 
 **Availability:**
 
-- **Engine release.** This needs an engine that includes Summer Engine PR #508. On engines without it, `Summer.client.friends` does not exist and scripts that use it fail to parse. Check the class reference for `SummerClientFriends` before using this skill.
+- **Engine release.** This needs an engine release that includes `SummerClientFriends`. On older engines, `Summer.client.friends` does not exist and scripts that use it fail to parse. Check the class reference for `SummerClientFriends` before using this skill.
 - **Hosted only.** `is_available()` is `false` in Local Play and editor runs, for guests, for accounts the platform keeps out of social features (`age_restricted`, under 13), and in Summer apps without `player.friends@1` (friends) or `player.messaging@1` (messages).
 - **Overlays.** The screens need the Summer app to offer friends and parties; otherwise they fail with `capability_unavailable` or `ui_unavailable`.
 
@@ -133,8 +133,8 @@ How it behaves:
 - **When the list is read again.** With a handler on `changed`, the engine re-reads the list on every change hint, after a consent decision, on `refresh()`, and about every 60 seconds while the game is in front. Never poll yourself.
 - **Statuses.** Show `in_this_game` friends first. `unknown` means presence couldn't be read; it is not `offline`.
 - **Rows.** Key them by `user_id`; each read replaces the `SummerFriend` objects.
-- **Profiles of other players.** For the people in the current match, use the user ids your authority publishes (the `players` map in `skill/summer-world-chat`, step 1) and call `show_profile(user_id)`. Your own id fails with `invalid_argument`.
-- **Inviting a friend into a match.** Use the party invite sheet (`skill/summer-parties`).
+- **Profiles of other players.** For the people in the current match, use the user ids your authority publishes (the `players` map in `summer-world-chat`, step 1) and call `show_profile(user_id)`. Your own id fails with `invalid_argument`.
+- **Inviting a friend into a match.** Use the party invite sheet (`summer-parties`).
 
 ### 3. Direct messages (only if chat is central)
 
@@ -188,7 +188,7 @@ Local Play has no accounts, so check the hidden path locally:
 - there are no script errors.
 
 ```
-summer_project_setting name="summer/local_play/players" value=2
+summer_project_setting key="summer/local_play/players" value=2
 summer_play
 summer_get_diagnostics
 summer_stop
@@ -199,7 +199,7 @@ and revoke access in the Summer app, and watch `access_changed`.
 
 ## Checklist
 
-- [ ] The engine's class reference lists `SummerClientFriends` (Summer Engine PR #508 or later).
+- [ ] The engine's class reference lists `SummerClientFriends`.
 - [ ] `summer.build.json` declares exactly the permissions the code asks for.
 - [ ] Local Play: friends features are hidden, with no script errors.
 - [ ] Declining consent leaves the game fully playable, and the button can ask again later.
@@ -216,11 +216,11 @@ and revoke access in the Summer app, and watch `access_changed`.
 | Treat `unknown` as `offline` | Show it as unknown | It means presence couldn't be read |
 | Poll `refresh()` on a timer | Connect `changed` | The engine already re-reads while a handler is connected |
 | Declare every permission "just in case" | Declare only what you use | The consent sheet lists each declared permission |
-| Use friends to put players in one match | `skill/summer-parties` | Parties are how players play together |
+| Use friends to put players in one match | `summer-parties` | Parties are how players play together |
 
 ## See also
 
-- `skill/summer-parties`: playing together, the invite sheet
-- `skill/summer-world-chat`: chat inside a match
-- `skill/multiplayer-publish`: `summer.build.json` and publishing a Build
-- `skill/multiplayer-testing`: what Local Play can and can't test
+- `summer-parties`: playing together, the invite sheet
+- `summer-world-chat`: chat inside a match
+- `multiplayer-publish`: `summer.build.json` and publishing a Build
+- `multiplayer-testing`: what Local Play can and can't test

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

@@ -31,7 +31,7 @@ Under Local Play they fail with a typed code (step 5); the authority's
 degrade gracefully, and check the real numbers on a hosted staging build.
 
 This skill extends the Courtyard game: its authority concludes matches as in
-`skill/summer-match-results`.
+`summer-match-results`.
 
 ## Steps
 
@@ -104,7 +104,7 @@ func show_queue_board(queue: StringName) -> void:
   pending returns the same operation.
 
 After a match, `Summer.client.ratings.rating_committed` delivers the
-player's own before-and-after rating (see `skill/summer-match-results`).
+player's own before-and-after rating (see `summer-match-results`).
 
 ### 3. Write a Game ranking from the authority
 
@@ -136,7 +136,7 @@ func _add_score(ranking: StringName, player_id: String, points: int) -> void:
 ```
 
 `sessions` maps each `session_id` to the `SummerSession` the authority keeps
-in `_on_session_joined` (`skill/summer-match-results`, step 1). The engine never
+in `_on_session_joined` (`summer-match-results`, step 1). The engine never
 retries a write. After a failure other than a conflict, read the score before
 deciding to write again: the first write may have committed.
 
@@ -226,6 +226,6 @@ on them.
 
 ## See also
 
-- `skill/summer-match-results` — concluding matches, which moves ratings
-- `skill/summer-matchmaking` — declaring rated queues and teams
-- `skill/summer-player-data` — saving per-player progress that isn't a ranking
+- `summer-match-results` — concluding matches, which moves ratings
+- `summer-matchmaking` — declaring rated queues and teams
+- `summer-player-data` — saving per-player progress that isn't a ranking

package/library/skills/summer-match-results/SKILL.md

@@ -29,9 +29,9 @@ Where it works: all of this runs under Local Play with a deterministic
 settlement, so the whole flow is testable locally. Rating values are real only
 when hosted.
 
-This skill extends the Courtyard game (`skill/multiplayer-project` and
-`skill/multiplayer-state`): the first player to collect `WIN_COINS` coins wins.
-With a team queue (`skill/summer-matchmaking`), their whole team wins.
+This skill extends the Courtyard game (`multiplayer-project` and
+`multiplayer-state`): the first player to collect `WIN_COINS` coins wins.
+With a team queue (`summer-matchmaking`), their whole team wins.
 
 ## Steps
 
@@ -48,7 +48,7 @@ var sessions := {}      # session_id -> SummerSession
 ```
 
 In `_ready()`, next to the other World signals (skip this line if
-`skill/summer-player-data` already connected it):
+`summer-player-data` already connected it):
 
 ```gdscript
 	world.session_joined.connect(_on_session_joined)
@@ -61,7 +61,7 @@ func _on_session_joined(session: SummerSession) -> void:
 	sessions[session.session_id] = session
 ```
 
-If the game already has `_on_session_joined` (`skill/summer-player-data`
+If the game already has `_on_session_joined` (`summer-player-data`
 adds one), put the line at its start instead of defining it twice.
 
 At the top of `_on_session_left`:
@@ -159,7 +159,7 @@ The rules `conclude` enforces:
   refused. A rejected conclusion (`invalid_request`) commits nothing, so you
   may conclude again with corrected arguments.
 - `rating_deltas`, the third argument, is only for `authority_v1` queues
-  (`skill/summer-leaderboards`).
+  (`summer-leaderboards`).
 
 The settlement lists each player's committed rating changes:
 
@@ -205,7 +205,7 @@ func _on_server_disconnected(code: String, _detail: String) -> void:
 	show_status("The match has ended.")
 ```
 
-`show_status` and the `Hud/Status` label come from `skill/summer-matchmaking`.
+`show_status` and the `Hud/Status` label come from `summer-matchmaking`.
 
 - `match_result` arrives when the authority concludes. Its `rating_state` is
   `RATING_STATE_PENDING` on a rated queue, or `RATING_STATE_NONE`.
@@ -232,7 +232,7 @@ func _on_server_disconnected(code: String, _detail: String) -> void:
   `world.complete()` on a World that should keep running.
 - `draining(deadline_unix)` on the World means Summer is shutting the server
   down (maintenance). Conclude or save before the deadline
-  (`skill/summer-world-saves`).
+  (`summer-world-saves`).
 
 A match that never concludes holds its players until the World is stopped;
 every match needs an ending, including "everyone else left".
@@ -240,7 +240,7 @@ every match needs an ending, including "everyone else left".
 ### 5. Test it with Local Play
 
 ```
-summer_project_setting name="summer/local_play/players" value=2
+summer_project_setting key="summer/local_play/players" value=2
 summer_play
 summer_get_diagnostics
 summer_stop
@@ -280,7 +280,7 @@ clients stay connected until they leave.
 
 ## See also
 
-- `skill/summer-matchmaking` — queues and teams that the outcome refers to
-- `skill/summer-leaderboards` — ratings and `authority_v1` rating moves
-- `skill/summer-world-saves` — persistent Worlds that outlive a match
-- `skill/multiplayer-testing` — running bots through a whole match
+- `summer-matchmaking` — queues and teams that the outcome refers to
+- `summer-leaderboards` — ratings and `authority_v1` rating moves
+- `summer-world-saves` — persistent Worlds that outlive a match
+- `multiplayer-testing` — running bots through a whole match