summer-engine 3.4.0 → 3.5.0

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

@@ -20,7 +20,7 @@ groups searching players, reserves a server for them, and every player's
 The authority then reads each player's team from the verified Session.
 
 There is no lobby object, invite code or server browser. Friends who want to
-play together use a party (`skill/summer-parties`), which enters a queue as one group.
+play together use a party (`summer-parties`), which enters a queue as one group.
 
 Where it works:
 
@@ -31,8 +31,8 @@ Where it works:
 | Accept/Decline prompt | No: no proposal happens | Yes, when the queue declares `acceptance` |
 | Rating-based grouping | No | Yes |
 
-This skill extends the Courtyard game from `skill/multiplayer-project` and
-`skill/multiplayer-state`. Its client already joins `Game.QUEUE` and sends a
+This skill extends the Courtyard game from `multiplayer-project` and
+`multiplayer-state`. Its client already joins `Game.QUEUE` and sends a
 `join` Command; its authority publishes `match_doc`.
 
 ## Steps
@@ -64,7 +64,7 @@ The fields Summer accepts, and their rules:
 | `minPlayers` / `maxPlayers` | Players per match | `minPlayers` ≥ 1, `maxPlayers` ≥ `minPlayers`. Measured support is up to 16 per match |
 | `worldDefinition` | The WorldDefinition's `definition_id` | Required; every WorldDefinition must be used by a queue |
 | `policy` | `fifo` (first come) or `rating` (group by skill) | `rating` needs `ratingSystemRef`; `fifo` must not declare one |
-| `ratingSystemRef` | `elo_v1` (Summer rates two sides) or `authority_v1` (your authority reports rating moves) | See `skill/summer-leaderboards` |
+| `ratingSystemRef` | `elo_v1` (Summer rates two sides) or `authority_v1` (your authority reports rating moves) | See `summer-leaderboards` |
 | `teams` | `{count, size}`: fixed sides, such as 2v2 = `{2, 2}` | `count` 2..64, `size` 1..16, `minPlayers` = `maxPlayers` = count × size; `elo_v1` needs exactly 2 teams |
 | `acceptance` | `{"mode": "all", "ttl": "20s"}` asks every player to accept; `{"mode": "none"}` skips it | `ttl` required with `all`, forbidden with `none` |
 | `searchTtl` | `{min, default, max}` search lifetime | Go durations (`30s`, `2m`); min ≤ default ≤ max |
@@ -249,8 +249,8 @@ one you name. In the editor and with `summer_play`, name it with the
 `summer/local_play/queue` project setting:
 
 ```
-summer_project_setting name="summer/local_play/queue" value="duel"
-summer_project_setting name="summer/local_play/players" value=2
+summer_project_setting key="summer/local_play/queue" value="duel"
+summer_project_setting key="summer/local_play/players" value=2
 summer_play
 summer_get_diagnostics
 summer_stop
@@ -294,8 +294,8 @@ Test the accept prompt and rating-based grouping on a hosted staging build.
 
 ## See also
 
-- `skill/multiplayer` — how Summer multiplayer fits together
-- `skill/summer-match-results` — ending a match and reporting who won
-- `skill/summer-leaderboards` — ratings and leaderboards for rated queues
-- `skill/summer-parties` — friends entering a queue together
-- `skill/multiplayer-testing` — Local Play options and bots
+- `multiplayer` — how Summer multiplayer fits together
+- `summer-match-results` — ending a match and reporting who won
+- `summer-leaderboards` — ratings and leaderboards for rated queues
+- `summer-parties` — friends entering a queue together
+- `multiplayer-testing` — Local Play options and bots

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

@@ -39,7 +39,7 @@ Outside a party, or when parties are unavailable, getters are empty and
 `is_in_party()` is `false`. So the same Play button works everywhere: no party
 means an ordinary `SummerJoinTarget.queue(...)` join. Build that path first.
 
-This skill extends the Courtyard game from `skill/multiplayer-project`
+This skill extends the Courtyard game from `multiplayer-project`
 (`network/game.gd` as `Game`, `client/main.gd` with `command()`).
 
 ## Steps
@@ -48,7 +48,7 @@ This skill extends the Courtyard game from `skill/multiplayer-project`
 
 A party member must not join on their own the moment the game starts. Move the
 join out of `client/main.gd`'s `_ready` into `enter(target)`, and keep every
-signal connection from `skill/multiplayer-movement` and `skill/multiplayer-state`:
+signal connection from `multiplayer-movement` and `multiplayer-state`:
 
 ```gdscript
 func _ready() -> void:
@@ -87,7 +87,7 @@ func enter(target: SummerJoinTarget) -> bool:
 	return true
 ```
 
-Move the Local Play bot hook from `skill/multiplayer-testing` into `enter()`,
+Move the Local Play bot hook from `multiplayer-testing` into `enter()`,
 after the joined line.
 
 ### 2. Add the party node
@@ -193,7 +193,7 @@ fails with retryable `party_version_conflict`. React to `data_changed(key)` and
 `member_data_changed(member, key)`, or just re-render on `changed`.
 
 Party data is a lobby convenience, not game state. Once the match starts, the
-authority owns everything (`skill/multiplayer-state`). It never sees party data;
+authority owns everything (`multiplayer-state`). It never sees party data;
 send choices that matter in your `join` Command and validate them there.
 
 ### 4. Handle join failures
@@ -217,7 +217,7 @@ client joins solo from `_ready`. Test that path locally, then the party path
 on Summer staging with real accounts.
 
 ```
-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
@@ -247,7 +247,7 @@ summer_stop
 
 ## See also
 
-- `skill/summer-matchmaking`: queues, sizes, teams and the accept prompt
-- `skill/summer-friends`: friends list, profiles and messages
-- `skill/multiplayer-project`: the client entry scene this extends
-- `skill/multiplayer-testing`: Local Play, and what needs staging
+- `summer-matchmaking`: queues, sizes, teams and the accept prompt
+- `summer-friends`: friends list, profiles and messages
+- `multiplayer-project`: the client entry scene this extends
+- `multiplayer-testing`: Local Play, and what needs staging

package/library/skills/summer-player-data/SKILL.md

@@ -39,8 +39,8 @@ Local Play's store keeps the latest value plus five earlier revisions, with
 the same validation and `save_id` rules as hosted. Delete a persona's folder
 to start that player fresh. Only hosted play proves durability.
 
-This skill extends the game from `skill/multiplayer-project` and
-`skill/multiplayer-state`: the authority's `_join` Command handler, the
+This skill extends the game from `multiplayer-project` and
+`multiplayer-state`: the authority's `_join` Command handler, the
 private `mine` State group, and the `wallets` it keeps.
 
 ## Steps
@@ -70,7 +70,7 @@ var profiles := {}
 ```
 
 In `_ready()`, next to the other `world` signals, before `Summer.initialize`
-(connect `session_joined` only once if `skill/summer-match-results` already
+(connect `session_joined` only once if `summer-match-results` already
 did):
 
 ```gdscript
@@ -83,7 +83,7 @@ did):
 	autosave.start()
 ```
 
-If `_on_session_joined` already exists (`skill/summer-match-results` adds
+If `_on_session_joined` already exists (`summer-match-results` adds
 one), put this body at its end instead of defining it twice.
 
 ```gdscript
@@ -254,7 +254,7 @@ func _show_saved_progress() -> void:
 
 ### 6. Keep the publish checks passing
 
-The source-graph check in `skill/multiplayer-publish` (step 4b) flags every
+The source-graph check in `multiplayer-publish` (step 4b) flags every
 call ending in `load(` without a string literal inside, so
 `Summer.authority.player_data.load(session)` and
 `Summer.client.player_data.load()` report
@@ -274,7 +274,7 @@ Run the same session twice. Local Play personas (`player-1`, `player-2`)
 keep their files between runs, so run 2 must start where run 1 ended.
 
 ```
-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
@@ -284,7 +284,7 @@ summer_stop
 ```
 
 From a terminal: `<summer> --path . --summer-local-play 2 --summer-local-play-headless --summer-local-play-timeout 20 -- --bot={client}`,
-twice (see `skill/multiplayer-testing` for bot mode). Print markers such as
+twice (see `multiplayer-testing` for bot mode). Print markers such as
 `print("PROFILE_LOADED coins=", ...)` and `print("SAVED ", save_id, " revision=", commit.revision)` while testing, then check them.
 
 Files: `~/Library/Application Support/Godot/app_userdata/<project name>/summer_local_player_data/<game id>/<persona>/public.json`
@@ -311,12 +311,12 @@ folder to start over.
 | Start a second commit while one is pending | One commit per player and slot at a time | The second fails with `operation_in_progress` |
 | Keep retrying after `player_data_superseded` | Stop saving through that Session | A newer World owns the player now |
 | Store `Vector3`, `Color` or `null` | Plain JSON: numbers, strings, arrays, dictionaries | Unsupported types fail with `player_data_unsupported_type` |
-| Save the match (positions, round score) | Save only what outlives the match | The World ends; `skill/summer-world-saves` covers Worlds that persist |
+| Save the match (positions, round score) | Save only what outlives the match | The World ends; `summer-world-saves` covers Worlds that persist |
 | Truncate data that grew past 64 KiB | Refuse to grow; test the maximum size | `player_data_too_large` rejects the whole commit |
 
 ## See also
 
-- `skill/multiplayer-state` — the wallet and private State group this skill saves
-- `skill/summer-world-saves` — saving a whole persistent World instead of one player
-- `skill/multiplayer-testing` — bots and repeated Local Play runs
-- `skill/summer-leaderboards` — scores other players can see
+- `multiplayer-state` — the wallet and private State group this skill saves
+- `summer-world-saves` — saving a whole persistent World instead of one player
+- `multiplayer-testing` — bots and repeated Local Play runs
+- `summer-leaderboards` — scores other players can see

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

@@ -45,8 +45,8 @@ proves nothing.
 Items and offers are created in your game's Studio pages (`summer_open` target
 `game`). Code never creates items.
 
-This skill extends the Courtyard game from `skill/multiplayer-project` and
-`skill/multiplayer-state`.
+This skill extends the Courtyard game from `multiplayer-project` and
+`multiplayer-state`.
 
 ## Steps
 
@@ -265,7 +265,7 @@ Walk through every outcome:
 
 ## See also
 
-- `skill/multiplayer-state`: Commands and the match document used for equipped items
-- `skill/multiplayer-testing`: Local Play fixtures and personas
-- `skill/summer-player-data`: saving a player's loadout between matches
-- `skill/summer-analytics`: measuring the shop
+- `multiplayer-state`: Commands and the match document used for equipped items
+- `multiplayer-testing`: Local Play fixtures and personas
+- `summer-player-data`: saving a player's loadout between matches
+- `summer-analytics`: measuring the shop

package/library/skills/summer-world-chat/SKILL.md

@@ -32,7 +32,7 @@ composition, and the authority neither sees nor writes them.
 | Channel keys | 1–64 of `A-Z a-z 0-9 _ . -`, starting with a letter or digit; at most 64 channels per World |
 | History | Best effort, not a full log. A new handle shows the newest 2 messages; `load_older()` grows the window to at most 16 |
 | Lifetime | A handle belongs to one World admission. After leaving or joining another World, open a new one |
-| Not included | Direct messages (`skill/summer-friends`), party chat (the Summer app) and messages written by your server |
+| Not included | Direct messages (`summer-friends`), party chat (the Summer app) and messages written by your server |
 
 **Hosted only.** Chat needs a joined hosted World and a Summer app whose Player
 Host offers `player.channels`. A queue reservation is not enough: open the
@@ -40,8 +40,8 @@ channel after `enter()` succeeds. In Local Play and editor runs,
 `check_open_readiness()` and `open_world_channel()` fail with `unavailable`.
 Build the "chat hidden" path first.
 
-This skill extends the Courtyard game from `skill/multiplayer-project` and
-`skill/multiplayer-state`.
+This skill extends the Courtyard game from `multiplayer-project` and
+`multiplayer-state`.
 
 ## Steps
 
@@ -49,7 +49,7 @@ This skill extends the Courtyard game from `skill/multiplayer-project` and
 
 Messages carry the author's Summer user id (`player_id`), not a name. The
 authority already knows every verified name. Publish them in the shared match
-document (`skill/multiplayer-state`): in `authority/main.gd`'s `_join`, before
+document (`multiplayer-state`): in `authority/main.gd`'s `_join`, before
 accepting, add
 
 ```gdscript
@@ -158,7 +158,7 @@ Call `$Chat.open()` after `enter()` returns `true`. Wire it into the UI:
 Locally, check that the hidden path works and nothing 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
@@ -189,7 +189,7 @@ Then test real chat on Summer staging with two accounts in one match.
 
 ## See also
 
-- `skill/multiplayer-state`: the match document that carries player names
-- `skill/summer-friends`: direct messages with friends
-- `skill/summer-parties`: party chat lives in the Summer app
-- `skill/multiplayer-testing`: what Local Play can and can't test
+- `multiplayer-state`: the match document that carries player names
+- `summer-friends`: direct messages with friends
+- `summer-parties`: party chat lives in the Summer app
+- `multiplayer-testing`: what Local Play can and can't test

package/library/skills/summer-world-saves/SKILL.md

@@ -26,13 +26,13 @@ a move. A new authority then restores the World from its last save.
 | Keep | Use |
 |---|---|
 | What belongs to the place: built walls, chests, the coins left on the ground | **World save** (this skill) |
-| What belongs to a player: their coins, unlocks, level | **Player data** (`skill/summer-player-data`) |
+| What belongs to a player: their coins, unlocks, level | **Player data** (`summer-player-data`) |
 
 The engine never serializes nodes for you. The game decides what one save
 holds. It must be **one consistent cut**: if an item moves from a chest into
 an inventory, both sides go in the same save.
 
-This skill extends the Courtyard game from `skill/multiplayer-state`: its
+This skill extends the Courtyard game from `multiplayer-state`: its
 `match_doc` (the coins still on the ground, and the scoreboard) becomes the
 World's saved state.
 
@@ -238,7 +238,7 @@ Local Play runs a persistent World with an **in-memory** save store:
 - Nothing survives the run.
 
 ```
-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
@@ -278,7 +278,7 @@ Restoring after a real restart can only be proven hosted.
 
 ## See also
 
-- `skill/summer-player-data` — progress that follows a player
-- `skill/multiplayer-state` — the shared document this skill saves
-- `skill/multiplayer-project` — `world.json` and the authority scene
-- `skill/multiplayer-testing` — Local Play runs and markers
+- `summer-player-data` — progress that follows a player
+- `multiplayer-state` — the shared document this skill saves
+- `multiplayer-project` — `world.json` and the authority scene
+- `multiplayer-testing` — Local Play runs and markers

package/library/skills/text-to-motion/rigging-for-text-motion.md

@@ -3,7 +3,7 @@
 The motion model reads the skeleton's rest pose, hierarchy **and bone names**. Names carry
 meaning: a bone called `LeftArm` borrows everything the model learned from human arms.
 Rigs named like a human skeleton therefore animate far better than freeform names, even
-on non-humans. Measured on cartoon flowers (2026-09-29): with plant names (`Stem1`,
+on non-humans. Measured on cartoon flowers: with plant names (`Stem1`,
 `LeafL1`) most prompts barely moved; the same rig with human names nodded, bowed,
 gestured and looked around on cue.
 

package/library/skills/tileable-texture/SKILL.md

@@ -68,7 +68,7 @@ summer_generate_image(
 
 Two things about the arguments:
 
-- **There is no `image_size` and no `negative_prompt`.** `summer_generate_image` takes only `prompt`, `model`, `style`, `referenceImageUrl`, and `options`, and `options` only recognizes Nano Banana provider keys (`seed`, `outputFormat`, `safetyTolerance`, `syncMode`, `systemPrompt`, `limitGenerations`, `thinkingLevel`) plus `removeBackground`. Anything else is dropped without an error, so the call looks like it worked. Put the negations in the prompt text. Square is what you get regardless — MCP images come back at the server's 1:1 default, which is exactly what a tileable texture wants.
+- **There is no `image_size` and no `negative_prompt`.** `summer_generate_image` takes only `prompt`, `model`, `style`, `referenceImageUrl`, `removeBackground` and `options`, and `options` only recognizes Nano Banana provider keys (`seed`, `outputFormat`, `safetyTolerance`, `syncMode`, `systemPrompt`, `limitGenerations`, `thinkingLevel`). Anything else is dropped without an error, so the call looks like it worked. Put the negations in the prompt text. Square is what you get regardless — MCP images come back at the server's 1:1 default, which is exactly what a tileable texture wants.
 - **`style: "realistic"` is a no-op.** Only `cartoon` and `anime` append anything to the prompt; `realistic` and `none` append nothing, and any other value is coerced to `none`. The photographic look has to come from the prompt (`photographic detail`). Switching to `"none"` for stylized work likewise changes nothing on its own — change the prompt.
 
 ### 4. Import to project

package/library/skills/trailer-shot/SKILL.md

@@ -13,7 +13,7 @@ paths: ["assets/video/**", "trailers/**", "marketing/**"]
 
 A trailer shot is not a cutscene and not a loop. It is a single, deliberately-composed beat designed to live inside an edit — Steam capsule video, social cut, pitch-deck reel, Discord teaser, Twitter promo. Every shot has to earn its slot in 5 seconds or less because viewer attention drops past that. This skill produces those shots one at a time, with strong composition references and trailer-grade prompting, then hands the user off to a non-linear editor (DaVinci Resolve, Premiere, CapCut) to chain them. **Studio doesn't ship a video editor** — generation is the part this skill owns; the cutting is yours.
 
-If the user is generating a non-interactive narrative beat with dialogue, that's `video/cinematic-cutscene`. If they want a seamless background loop for a splash screen, that's `video/animated-loop`. This skill is for the punchy stuff — the kind of shot that ends up on the Steam page or in the first 10 seconds of a launch trailer.
+If the user is generating a non-interactive narrative beat with dialogue, that's `cinematic-cutscene`. If they want a seamless background loop for a splash screen, that's `animated-loop`. This skill is for the punchy stuff — the kind of shot that ends up on the Steam page or in the first 10 seconds of a launch trailer.
 
 ## When to use
 
@@ -26,9 +26,9 @@ If the user is generating a non-interactive narrative beat with dialogue, that's
 
 ## When NOT to use
 
-- Multi-shot story sequence with dialogue — `video/cinematic-cutscene`.
-- Seamless looping background — `video/animated-loop`.
-- Static marketing key art — `2d-assets/concept-art` then `2d-assets/character-portrait`.
+- Multi-shot story sequence with dialogue — `cinematic-cutscene`.
+- Seamless looping background — `animated-loop`.
+- Static marketing key art — `concept-art` then `character-portrait`.
 - Animated GIF of UI — that's a screen recording, not a generated video.
 - A literal Steam trailer (the assembled cut) — generate the shots here, then take them to your NLE.
 
@@ -69,13 +69,13 @@ For pure environment / abstract / VFX shots, you can skip this and prompt text-t
 
 The available models depend on whether you pass `imageUrl`. With a reference image (step 2) the call goes to the image-to-video route, which accepts only `ltx`, `kling`, and `minimax`; `kling-turbo` and `veo3` exist on the text-to-video route only, and pairing either with an `imageUrl` is a 400 `invalid_model`.
 
-| Model | Text-to-video | Image-to-video | Cost | Speed | When |
-|---|---|---|---|---|---|
-| `kling` | yes | yes | $0.50 | 2-4 min | Default for trailer hero shots — best motion + composition |
-| `ltx` | yes | yes | $0.10 | ~30s | B-roll, throwaway tests, blocking the composition before committing |
-| `minimax` | yes | yes | $0.25 | 2-3 min | Anime / stylized trailer looks |
-| `kling-turbo` | yes | **no** | $0.30 | 1-2 min | Same look as kling, faster, slight quality dip — but you lose `imageUrl` |
-| `veo3` | yes | **no** | $1.00 | 3-5 min | Pitch deck for investors, the one shot that has to be perfect — but you lose `imageUrl` |
+| Model | Text-to-video | Image-to-video | Speed | When |
+|---|---|---|---|---|
+| `kling` | yes | yes | 2-4 min | Default for trailer hero shots — best motion + composition |
+| `ltx` | yes | yes | ~30s | Cheapest. B-roll, throwaway tests, blocking the composition before committing |
+| `minimax` | yes | yes | 2-3 min | Anime / stylized trailer looks |
+| `kling-turbo` | yes | **no** | 1-2 min | Same look as kling, faster, slight quality dip — but you lose `imageUrl` |
+| `veo3` | yes | **no** | 3-5 min | Most expensive. Pitch deck for investors, the one shot that has to be perfect — but you lose `imageUrl` |
 
 Default: **`ltx` first to block the composition, then `kling` for the final**. For the *one* hero shot that drives the Steam page, escalate to `veo3` only if `kling` failed twice.
 
@@ -114,7 +114,7 @@ If "regenerate", revise *one* axis (camera move, lighting, or framing) — don't
 
 Trailer footage usually lives on the user's local disk and goes straight into the NLE, where the generated `.mp4` is exactly what you want.
 
-For shots that double as **in-engine** splash content, transcode first — Summer Engine has no MP4 or WebM loader, and `.ogv` (Ogg Theora) is the only video container it can open. `summer_import_from_url` runs Godot's import pipeline and rejects the file if it never becomes a loadable resource, so importing the `.mp4` fails outright rather than half-working.
+For shots that double as **in-engine** splash content, transcode first — Summer Engine has no MP4 or WebM loader, and `.ogv` (Ogg Theora) is the only video container it can open. `summer_import_from_url` runs the engine's import pipeline and rejects the file if it never becomes a loadable resource, so importing the `.mp4` fails outright rather than half-working.
 
 ```
 ffmpeg -i hero_boss_reveal.mp4 -c:v libtheora -q:v 8 -an hero_boss_reveal.ogv
@@ -133,24 +133,24 @@ Studio does not ship a video editor. After all the shots land, tell the user:
 > 3-5. Action beats (slow-mo combat, environmental destruction)
 > 6. Money shot (low-angle hero, ends on logo card)
 >
-> Score it with the music from `audio/music-track`. Add SFX hits on the cuts with `audio/sound-effect`.
+> Score it with the music from `music-track`. Add SFX hits on the cuts with `sound-effect`.
 
 ## Reference card — prompts that work
 
 Pattern: `<archetype framing> + <subject> + <action verb> + <camera move> + <lighting / time of day> + <stylistic anchor>`. Keep under 50 words. Anchor with a reference image whenever a specific character or asset appears.
 
-| Goal | Model | Prompt | Cost | Duration |
-|---|---|---|---|---|
-| Hero boss reveal | `kling` | `low-angle hero shot of an armored dragon turning toward camera, slow tilt-up, volcanic backlight, embers in air, cinematic, anamorphic flare, 16mm grain` | $0.50 | 5s |
-| Slow-mo combat impact | `kling` | `mid shot of a swordsman striking a parry, sparks fly, time-dilation slow motion, dust and motion blur, dramatic side-light, cinematic` | $0.50 | 5s |
-| Establishing kingdom wide | `kling` | `wide aerial of a clifftop fortress at golden hour, slow dolly forward, low sun raking the towers, cinematic, anamorphic, faint heat haze` | $0.50 | 5s |
-| Splash screen card | `kling` | `static composition of a lone hooded figure on a windswept ridge, only the cloak and grass moving, dusk, painterly cinematic, room for title text upper third` | $0.50 | 5s |
-| Whip pan reveal | `kling` | `whip pan from left to right across a battlefield at night, lands on the protagonist standing alone among bodies, torches flickering, cinematic` | $0.50 | 5s |
-| Detail dolly-in | `kling` | `slow dolly-in on a glowing rune-etched sword embedded in stone, motes of magic rising, blue-cold key light, shallow depth of field, cinematic` | $0.50 | 5s |
-| Vertical social hero | `kling` | `vertical close-up of a young witch raising hands, magical wind, hair flowing, candle-warm key, cinematic, framed for 9:16` | $0.50 | 5s |
-| Pitch-deck premium shot | `veo3` | `wide cinematic of a fleet of airships emerging through cloud cover at dawn, slow truck forward, golden god-rays, soaring orchestral cinematic` | $1.00 | 5s |
-| Cheap B-roll iteration | `ltx` | `mid shot of a knight walking through fog, slow truck backward, dawn light, cinematic` | $0.10 | 5s |
-| Anime style hero | `minimax` | `anime-style hero girl draws a katana in slow motion, sakura petals swirling, dramatic side-light, dynamic camera, Ghibli painterly` | $0.25 | 5s |
+| Goal | Model | Prompt | Duration |
+|---|---|---|---|
+| Hero boss reveal | `kling` | `low-angle hero shot of an armored dragon turning toward camera, slow tilt-up, volcanic backlight, embers in air, cinematic, anamorphic flare, 16mm grain` | 5s |
+| Slow-mo combat impact | `kling` | `mid shot of a swordsman striking a parry, sparks fly, time-dilation slow motion, dust and motion blur, dramatic side-light, cinematic` | 5s |
+| Establishing kingdom wide | `kling` | `wide aerial of a clifftop fortress at golden hour, slow dolly forward, low sun raking the towers, cinematic, anamorphic, faint heat haze` | 5s |
+| Splash screen card | `kling` | `static composition of a lone hooded figure on a windswept ridge, only the cloak and grass moving, dusk, painterly cinematic, room for title text upper third` | 5s |
+| Whip pan reveal | `kling` | `whip pan from left to right across a battlefield at night, lands on the protagonist standing alone among bodies, torches flickering, cinematic` | 5s |
+| Detail dolly-in | `kling` | `slow dolly-in on a glowing rune-etched sword embedded in stone, motes of magic rising, blue-cold key light, shallow depth of field, cinematic` | 5s |
+| Vertical social hero | `kling` | `vertical close-up of a young witch raising hands, magical wind, hair flowing, candle-warm key, cinematic, framed for 9:16` | 5s |
+| Pitch-deck premium shot | `veo3` | `wide cinematic of a fleet of airships emerging through cloud cover at dawn, slow truck forward, golden god-rays, soaring orchestral cinematic` | 5s |
+| Cheap B-roll iteration | `ltx` | `mid shot of a knight walking through fog, slow truck backward, dawn light, cinematic` | 5s |
+| Anime style hero | `minimax` | `anime-style hero girl draws a katana in slow motion, sakura petals swirling, dramatic side-light, dynamic camera, Ghibli painterly` | 5s |
 
 ### Bad prompts and why
 
@@ -166,7 +166,7 @@ Pattern: `<archetype framing> + <subject> + <action verb> + <camera move> + <lig
 
 - **Trying to chain shots inside one video generation.** Each clip is one beat. The cut between shots is the editor's job, not the model's. A 10s prompt with three actions returns mush.
 - **Skipping the reference image for the hero shot.** The boss in the Steam capsule must look like the boss in the game. Always lock identity with `imageUrl`.
-- **Using `veo3` for B-roll.** Burn $0.10 on `ltx` for blocking and B-roll; reserve `veo3` for the one shot that has to be perfect.
+- **Using `veo3` for B-roll.** Use `ltx` for blocking and B-roll; reserve `veo3` for the one shot that has to be perfect.
 - **Generating shots without composing the trailer first.** Make a 6-shot list before generating shot 1. Otherwise you'll generate shots that don't intercut.
 - **Assuming `aspectRatio="9:16"` reframed an image-to-video call.** It is ignored whenever `imageUrl` is set — the reference image decides the framing. Pillarboxed 16:9 on TikTok / Reels / Shorts reads as a desktop YouTube embed and gets demoted by the algorithm, so fix the reference, not the argument.
 - **Treating `summer_generate_video` as synchronous.** It returns `{ queued: true, jobId }` and no URL. Poll `summer_check_job` before handing the user a link.
@@ -176,7 +176,7 @@ Pattern: `<archetype framing> + <subject> + <action verb> + <camera move> + <lig
 ## Edge cases
 
 - **Steam capsule animated header (Steam asset).** Steam wants `.webm` at 616x353 or 1920x1080, ≤6s, 30fps, no audio, ≤4MB. Generate at 16:9, transcode in DaVinci, export `.webm` with VP9. The video model gives you the source; format conversion is on you.
-- **Pitch deck for investors.** One shot, `veo3`, money composition (low-angle hero or wide establishing). Worth the $1.00.
+- **Pitch deck for investors.** One shot, `veo3`, money composition (low-angle hero or wide establishing).
 - **Vertical for TikTok / Shorts.** The reference image must genuinely be portrait — `aspectRatio` is ignored once `imageUrl` is set. Frame the subject in the upper-middle so titles can sit at the bottom.
 - **Subject is a UGC environment the player built.** Take a screenshot of the in-engine view, run it through `summer_generate_image` as `referenceImageUrl` to "upgrade" the look, then use that as the video reference. The model can stylize a screenshot; it can't invent the user's level.
 - **Logo splash with motion graphics.** Generate a static logo card in `summer_generate_image` (or use the user's existing logo PNG), then prompt video as `static composition of <logo>, only background particles drifting, cinematic, room for title text` — keep the foreground motionless.
@@ -197,16 +197,16 @@ Once the shots are generated:
 
 > Generated 6 shots, ready for the cut. Next:
 > - Take them into DaVinci Resolve (free) or Premiere. Studio doesn't cut video.
-> - Score the trailer with `audio/music-track` — a 60-second trailer cue with a swell and a cold ending.
-> - Add hit SFX on the cuts with `audio/sound-effect` (impact whooshes between shots).
-> - For the title-card splash that ships in-engine, hand off to `video/animated-loop` with the established palette.
-> - For a narrative beat inside the trailer (a 10s "story" segment), hand off to `video/cinematic-cutscene`.
+> - Score the trailer with `music-track` — a 60-second trailer cue with a swell and a cold ending.
+> - Add hit SFX on the cuts with `sound-effect` (impact whooshes between shots).
+> - For the title-card splash that ships in-engine, hand off to `animated-loop` with the established palette.
+> - For a narrative beat inside the trailer (a 10s "story" segment), hand off to `cinematic-cutscene`.
 
 ## See also
 
-- `video/cinematic-cutscene` — narrative beats with dialogue.
-- `video/animated-loop` — seamless background clips for splash screens / title menus.
-- `audio/music-track` — trailer score.
-- `audio/sound-effect` — cut SFX (whooshes, impacts, stingers).
-- `2d-assets/concept-art` — generate the reference image axis when no asset exists yet.
+- `cinematic-cutscene` — narrative beats with dialogue.
+- `animated-loop` — seamless background clips for splash screens / title menus.
+- `music-track` — trailer score.
+- `sound-effect` — cut SFX (whooshes, impacts, stingers).
+- `concept-art` — generate the reference image axis when no asset exists yet.
 - `../../references/mcp-tools-reference/mcp-tools-reference.md` — `summer_generate_video` parameter schema and error codes.

package/library/skills/tune-performance/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tune-performance
-description: "Profile a slow game via summer_get_diagnostics, identify rendering/physics/scripting hotspots, propose fixes with before/after metric expectations."
+description: "Profile a slow game with a measurement probe, identify rendering/physics/scripting hotspots, propose fixes with before/after metric expectations."
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: performance
@@ -23,7 +23,7 @@ Performance tuning without measurement is gambling. This skill enforces a measur
 
 > What's slow? Pick the closest: framerate drops in scene X / startup is long / freezes for a moment / runs fine on my machine but bad on hardware Y.
 
-Wait. The answer narrows the fix domain by 5x:
+Wait for the answer. It narrows where to look:
 
 | Symptom | Likely subsystem |
 |---|---|
@@ -75,7 +75,7 @@ Write the returned numbers down before fixing anything. Drive the probe to the s
 
 **Never profile with `--headless`.** A headless instance has no renderer: `RENDER_TOTAL_DRAW_CALLS_IN_FRAME` and `RENDER_TOTAL_OBJECTS_IN_FRAME` read `0.0`, and the FPS figure is an uncapped loop rate, not the game's framerate. The verify instance is windowed-offscreen precisely so the numbers are real.
 
-**Genuine fallback (engine not running at all):** ask the user to enable Godot's built-in monitor (`Debug → Monitor`, or in-game with `Performance.get_monitor`) and paste numbers. At minimum: FPS, frame time, draw calls, physics active objects.
+**Fallback (engine not running at all):** ask the user to open the editor's built-in monitors (Debugger → Monitors) or print `Performance.get_monitor` values in game, and paste the numbers. At minimum: FPS, frame time, draw calls, physics active objects.
 
 ### 3. Identify the dominant cost
 
@@ -91,7 +91,7 @@ Decision tree:
 
 ### 4a. Rendering hotspot
 
-Common Godot 4.x rendering costs, ordered by frequency:
+Common rendering costs, ordered by frequency:
 
 | Pattern | Symptom | Fix |
 |---|---|---|
@@ -105,8 +105,8 @@ Common Godot 4.x rendering costs, ordered by frequency:
 To inspect a suspect node:
 
 ```
-summer_inspect_node "./World/Enemy"
-summer_inspect_resource "./World/Enemy"   # for mesh/material/shape details
+summer_inspect_node path:"./World/Enemy"
+summer_inspect_resource nodePath:"./World/Enemy" property:"mesh"   # mesh/material/shape details
 ```
 
 **Bakes: know which process can run them.** `LightmapGI.bake(from_node, image_data_path)` IS script-bound on this build — run it from `summer_run_script` in the live editor (the GPU lightmapper needs a real renderer: desktop editors have one, cloud containers need xvfb + GL per `running-in-the-cloud`, and pure-headless returns `BAKE_ERROR_NO_LIGHTMAPPER`). The `OccluderInstance3D` bake remains editor-button only — say so rather than reporting it as applied. Navmesh baking, collision-shape generation from meshes, and `ImporterMesh.generate_lods` are all scriptable and remain yours to do.
@@ -119,7 +119,7 @@ Top patterns:
 |---|---|
 | 100+ active RigidBody3D | Sleep them when idle (`can_sleep = true`), or convert to Area3D where collision response isn't needed |
 | Concave collision shapes on dynamic bodies | Convert to ConvexPolygonShape3D or compound primitives (sphere/capsule/box). Concave costs 5–20x more. |
-| Physics tick at 120 Hz default | Lower `physics/common/physics_ticks_per_second` to 60 if visual smoothness allows |
+| Physics tick rate raised above the 60 Hz default | Lower `physics/common/physics_ticks_per_second` back to 60 if visual smoothness allows |
 | Per-frame raycast in `_physics_process` | Cache the result, raycast every N frames, or use ShapeCast3D |
 | Hundreds of overlap queries | Use Area3D with `monitoring = true` only on the bodies that need to detect — turn it off on environment |
 
@@ -142,13 +142,13 @@ Fixes:
 - Cache the group lookup in `_ready()` if the group composition is stable.
 - Move per-frame work to a timer at 10 Hz (`_on_timer_timeout`), not 60 Hz.
 - Replace `distance_to` with `distance_squared_to` in comparisons (no sqrt).
-- Push hot loops to a `@tool`-able C# script or GDExtension if it's truly per-frame.
+- Move a truly per-frame hot loop to C# or a GDExtension.
 
 ### 4d. Frame time spikes (jitter)
 
 If FPS is good but frame time spikes:
 
-- **Shader compilation**: precompile shaders during loading screen via `RenderingServer.shader_compile_from_code` or by warming up the scene off-screen.
+- **Shader compilation**: warm shaders up during a loading screen by rendering each material once off-screen.
 - **GC / object allocation**: `var x := []` inside `_process` allocates each frame. Pre-allocate.
 - **Async resource load**: ensure `ResourceLoader.load_threaded_request` is finished before referencing.
 
@@ -217,7 +217,7 @@ Compare: was the metric movement at least 50% of what was promised? If yes, ship
 - **"Just disable VSync to see real FPS."** Disabling VSync helps you measure, but performance work targets perceived smoothness (16.7 ms, locked). Re-enable before shipping.
 - **Premature C++ rewrite.** A GDScript hotpath at 5% of frame time isn't the bottleneck. Profile first.
 - **"It's slow on user machines, must be the GPU."** Often it's resolution scale + shadow quality + GI settings. Add a quality preset switcher first.
-- **Threading gameplay code.** Godot's gameplay layer isn't thread-safe. Threading is for asset load, network, AI compute — not `_physics_process`.
+- **Threading gameplay code.** The scene tree isn't thread-safe. Threading is for asset load, network, AI compute — not `_physics_process`.
 
 ## Collaborative protocol
 
@@ -233,6 +233,6 @@ No template — this is a workflow. Performance tuning is project-specific by de
 - `../../references/godot-version/godot-version.md` — renderer API churn notes (Compositor, RenderSceneBuffers)
 - `../../references/collaborative-protocol/collaborative-protocol.md` — "May I write" pattern
 - `../../references/gd-style/gd-style.md` — GDScript conventions (avoid bare types, use `:=`)
-- `debugging/debug/SKILL.md` — bug triage (related but different)
-- `workflow/diagnosing-perf-regressions/SKILL.md` — when it *got* slow rather than always was
-- `rendering-and-lighting/3d-lighting/SKILL.md` — light setup and bake decisions
+- `debug` — bug triage (related but different)
+- `diagnosing-perf-regressions` — when it *got* slow rather than always was
+- `3d-lighting` — light setup and bake decisions

package/library/skills/tune-performance/resource.yaml

@@ -1,7 +1,7 @@
 id: skill/tune-performance
 kind: skill
 version: 1.0.3
-summary: Profile a slow game via summer_get_diagnostics, identify rendering/physics/scripting hotspots, propose fixes with before/after metric expectations.
+summary: Profile a slow game with a measurement probe, identify rendering/physics/scripting hotspots, propose fixes with before/after metric expectations.
 use_when:
   - the game is slow, drops framerate, stutters, takes forever to start, or runs poorly on specific hardware
   - fps drops or stutter when many units, projectiles, or particles spawn at once and the hotspot is unknown

package/library/skills/ui-graphics/SKILL.md

@@ -77,7 +77,7 @@ Pattern:
 <asset class> of <subject>, game UI, <anchor style>, flat design, clean edges, transparent background, centered, isolated
 ```
 
-`isolated` is load-bearing. For the background, **do not rely on the prompt** — pass `options.removeBackground: true`, which runs a real background-removal pass after generation and returns a PNG with true alpha. That is the single highest-value argument in this skill, and it is the actual fix for the checkerboard failure listed below: models asked for a "transparent background" in text frequently paint the checkerboard.
+`isolated` is load-bearing. For the background, **do not rely on the prompt** — pass `removeBackground: true`, which runs a real background-removal pass after generation and returns a PNG with true alpha. That is the single highest-value argument in this skill, and it is the actual fix for the checkerboard failure listed below: models asked for a "transparent background" in text frequently paint the checkerboard.
 
 ### 5. Generate
 
@@ -87,11 +87,11 @@ summer_generate_image(
   prompt="ability icon for a fire spell, glowing flame in cupped hand, game UI, flat design with subtle gradient and soft inner shadow, 2px deep navy outline, gold and parchment palette, rounded square frame, centered, isolated on a plain background. Not photorealistic, no 3D render, no scene background, not busy, no multiple objects.",
   model="nano-banana-2",
   style="none",
-  options={ removeBackground: true }
+  removeBackground=true
 )
 ```
 
-`image_size` and `negative_prompt` do not exist on this tool and are dropped without an error — the negations have to live in the prompt text, and the size is fixed. `removeBackground` is the one `options` key here that does real work.
+`image_size` and `negative_prompt` do not exist on this tool and are dropped without an error — the negations have to live in the prompt text, and the size is fixed.
 
 **Button (3 states in 3 calls):**
 ```
@@ -164,7 +164,7 @@ If you generate a 4×4 grid of icons in one image, each icon becomes an `AtlasTe
 | Bad | Failure mode |
 |---|---|
 | `cool button` | No subject, no anchor. Returns a generic button on a card background. |
-| `transparent button with icon` | Model often renders a checkerboard "transparent" pattern as the actual fill. There is no negative-prompt argument to counter it — drop the word "transparent" from the prompt entirely and pass `options.removeBackground: true` instead. |
+| `transparent button with icon` | Model often renders a checkerboard "transparent" pattern as the actual fill. There is no negative-prompt argument to counter it — drop the word "transparent" from the prompt entirely and pass `removeBackground: true` instead. |
 | `8 ability icons in one image` | Inconsistent style across the 8. Generate one at a time with the same anchor. |
 | `realistic 3D rendered button` | Conflicts with flat-UI. Stay flat. |
 | `button with the word "Play"` on it | Models render text badly. Add text in Summer Engine via a `Label` over the button, not in the texture. |
@@ -175,7 +175,7 @@ If you generate a 4×4 grid of icons in one image, each icon becomes an `AtlasTe
 - **Letting the model render text.** Diffusion models cannot render reliable
   text. Always overlay text in Summer Engine with a `Label` node. The button
   texture is the frame; the label is the word.
-- **Forgetting `options.removeBackground: true`.** Default is opaque. Prompting for "transparent background" instead is what produces the painted-checkerboard failure below — the option runs a real alpha pass and does not.
+- **Forgetting `removeBackground: true`.** Default is opaque. Prompting for "transparent background" instead is what produces the painted-checkerboard failure below — the option runs a real alpha pass and does not.
 - **Expecting `style` to do the work.** Only `cartoon` and `anime` append anything; `realistic` and `none` append nothing, and any other value is coerced to `none`. `style: "none"` is right for UI, but "flat design" has to be in the prompt regardless.
 - **NinePatch with no border-vs-center distinction.** The 9-slice scaling smears the border into the center.
 - **Mipmaps on UI.** UI textures shouldn't mipmap — they're displayed at 1:1 or near it. Mipmaps waste memory and blur sharp edges.
@@ -187,7 +187,7 @@ If you generate a 4×4 grid of icons in one image, each icon becomes an `AtlasTe
   `STRETCH_KEEP_ASPECT_CENTERED` scales it down cleanly.
 - **User wants pixel-style UI.** Route to `pixel-art` — different prompt pattern, different filter, different anchor.
 - **User wants animated UI (spinning loading icon).** Generate the static frame here. Animate via `AnimationPlayer` rotating the `TextureRect`, not as a sprite sheet.
-- **Transparency comes back as a checkerboard pattern in the image.** The model rendered the checkerboard literally because the prompt asked for transparency. Remove every mention of transparency from the prompt, generate on a plain background, and pass `options.removeBackground: true` to cut the alpha server-side.
+- **Transparency comes back as a checkerboard pattern in the image.** The model rendered the checkerboard literally because the prompt asked for transparency. Remove every mention of transparency from the prompt, generate on a plain background, and pass `removeBackground: true` to cut the alpha server-side.
 - **Icons need to read at very small size (16-24px in a packed bar).** Bias prompts toward bold silhouette + minimal interior detail. Ornate detail is invisible at 16px and adds noise.
 
 ## Fallback (no MCP)
@@ -199,7 +199,7 @@ summer_generate_image(
   prompt="<asset + anchor>, isolated on a plain background. No scene background, not photorealistic, no 3D, not busy.",
   model="nano-banana-2",
   style="none",
-  options={ removeBackground: true }
+  removeBackground=true
 )
 ```