summer-engine 3.1.0 → 3.2.0

package/registry/generated/skills-registry.json

@@ -4,7 +4,7 @@
     {
       "id": "skill/3d-lighting",
       "name": "3d-lighting",
-      "description": "Use when setting up lighting in a Summer Engine 3D scene — adding lights, configuring WorldEnvironment, sky, or shadows. Covers DirectionalLight3D versus Omni versus Spot, shadow tuning, ambient and sky-driven lighting, and the current Summer rendering conventions. Trigger on \"lighting\", \"shadows\", \"WorldEnvironment\", \"sun\", \"ambient\", \"sky\", \"light\".",
+      "description": "Set up 3D scene lighting — DirectionalLight3D vs Omni vs Spot, WorldEnvironment, sky, shadow tuning, ambient — per current Summer conventions.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -17,7 +17,7 @@
     {
       "id": "skill/adaptive-music",
       "name": "adaptive-music",
-      "description": "Use when wiring music stems to game state — combat / explore / boss / tension crossfades on a shared bus. Pairs generated stems with a state machine and AudioBus structure. Trigger on \"adaptive music\", \"dynamic music\", \"music changes when combat starts\", \"layered music\", \"vertical music\", \"wire stems\".",
+      "description": "Wire music stems to game state — combat/explore/boss/tension crossfades on a shared bus, paired with a state machine and AudioBus structure.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -30,7 +30,7 @@
     {
       "id": "skill/agent-playtesting",
       "name": "agent-playtesting",
-      "description": "Use when proving a gameplay feature, reproducing a bug, or comparing two variants by driving the LIVE running game yourself — deterministic launch (seed, fixed_fps, offscreen instances), frame-stamped probes before and after every action, exact frame stepping, scripted or recorded input. The doctrine behind summer_game_probe, summer_game_input, summer_game_control and the summer_runtime_* tools.",
+      "description": "Playtest by driving the LIVE game — deterministic launch, frame-stamped probes before/after each action, exact frame steps, scripted or recorded input.",
       "clients": "all",
       "recommended": true,
       "status": "preview",
@@ -42,10 +42,23 @@
         "agent-workflow"
       ]
     },
+    {
+      "id": "skill/ai-characters-in-games",
+      "name": "ai-characters-in-games",
+      "description": "Safe AI characters in published games: no keys in the build, replies via Summer's player AI gateway, moderation, spend caps, offline brain and a report button.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/ai-characters-in-games/",
+      "domains": [
+        "ai",
+        "npc"
+      ]
+    },
     {
       "id": "skill/ambient-bed",
       "name": "ambient-bed",
-      "description": "Use when generating a long looping location ambience — forest at dawn, dungeon air, city street, spaceship hum, cave drip. Non-melodic, low-energy, never draws attention. Wires as a looping AudioStreamPlayer on the Ambient bus with a marked seamless loop. Trigger on \"ambient bed\", \"room tone\", \"background ambience\", \"forest ambience\", \"dungeon air\", \"make it sound like a cave\".",
+      "description": "Generate a long looping location ambience — forest, dungeon, city, spaceship, cave — a looping AudioStreamPlayer on the Ambient bus with a seamless loop.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -58,7 +71,7 @@
     {
       "id": "skill/animated-loop",
       "name": "animated-loop",
-      "description": "Use when generating a short looping video clip — splash screen background, animated logo backdrop, idle title-screen footage, looping environment ambience. Output must loop seamlessly and is wired as a VideoStreamPlayer with autoplay and loop set true. Trigger on \"looping background\", \"splash loop\", \"title screen video\", \"animated backdrop\", \"menu background loop\", \"ambient loop video\", \"looping clip\", \"seamless loop\".",
+      "description": "Generate a short seamlessly-looping video clip — splash background, animated logo backdrop, idle title-screen footage — wired as a looping VideoStreamPlayer.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -71,7 +84,7 @@
     {
       "id": "skill/animation-tree",
       "name": "animation-tree",
-      "description": "Use when the user has clips on a character and needs them to play in response to gameplay — idle/walk/run blend, attacks that interrupt locomotion, hit reactions that override everything. Designs and wires Summer Engine AnimationTree state machines and blend trees. Trigger on \"AnimationTree\", \"state machine\", \"blend tree\", \"transition\", \"play animation when\", \"character keeps T-posing\", \"wire animations\".",
+      "description": "Design and wire AnimationTree state machines and blend trees so clips respond to gameplay — locomotion blends, attack interrupts, hit reactions.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -84,7 +97,7 @@
     {
       "id": "skill/art-direction",
       "name": "art-direction",
-      "description": "Use when defining the visual style of the game — references, palette, mood, lighting plan, post-processing, do/don't list. Outputs an art bible at `.summer/art-bible.md`. Trigger on \"art direction\", \"art bible\", \"visual style\", \"color palette\", \"what should it look like\", \"the look\".",
+      "description": "Define the game's visual style — references, palette, mood, lighting plan, post-processing, do/don't list — output as an art bible at .summer/art-bible.md.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -97,7 +110,7 @@
     {
       "id": "skill/asset-strategy",
       "name": "asset-strategy",
-      "description": "Use when planning asset creation, picking an asset pipeline, or routing an \"I need a [thing]\" request to the right specialist skill. Disambiguates between 2D / 3D / audio / video / VFX / animation pipelines and dispatches via the Skill tool. Trigger on \"assets\", \"asset pipeline\", \"make a model\", \"I need a sound\", \"create concept art\", \"generate something\", broad creative requests.",
+      "description": "Route any 'I need a [thing]' asset request to the right specialist skill — disambiguates 2D / 3D / audio / video / VFX / animation pipelines.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -110,7 +123,7 @@
     {
       "id": "skill/audio-direction",
       "name": "audio-direction",
-      "description": "Use when defining the sonic identity — music style, instruments, SFX vocabulary, dynamic music plan. Outputs an audio bible at `.summer/audio-bible.md`. Trigger on \"audio direction\", \"audio bible\", \"music style\", \"sound design\", \"what should it sound like\", \"dynamic music\".",
+      "description": "Define the game's sonic identity — music style, instruments, SFX vocabulary, dynamic music plan — output as an audio bible at .summer/audio-bible.md.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -123,7 +136,7 @@
     {
       "id": "skill/auto-fire-targeting",
       "name": "auto-fire-targeting",
-      "description": "Use when designing or fixing the targeting system for an auto-fire weapon (survivors-genre, top-down ARPG, tower-defense). Covers the pending-damage pattern that prevents over-commit when bullet flight time is longer than fire rate. Trigger on \"auto-fire\", \"auto-aim\", \"weapon targeting\", \"targeting\", \"wasted bullets\", \"overkill\", \"damage prediction\", \"survivors weapon\".",
+      "description": "Design or fix auto-fire weapon targeting (survivors, top-down ARPG, tower defense) — the pending-damage pattern that prevents over-commit and overkill.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -136,7 +149,7 @@
     {
       "id": "skill/brainstorm-game",
       "name": "brainstorm-game",
-      "description": "Use when the user wants help deciding what game to make, scoping a new project, or turning a vague idea into a buildable plan. Walks through genre, scope, core loop, mechanics, and art direction, then writes a 1-page brief to `.summer/GameSoul.md`. Trigger on \"brainstorm a game\", \"what should I make\", \"I want to make a game\", \"help me scope\", \"new game idea\".",
+      "description": "Turn a vague idea into a buildable plan — genre, scope, core loop, mechanics, art direction — written as a 1-page brief to .summer/GameSoul.md.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -149,7 +162,7 @@
     {
       "id": "skill/brainstorming",
       "name": "brainstorming",
-      "description": "Use when starting creative work — designing a game, picking a mechanic, building features or components, modifying behavior. Explores user intent, requirements, and design before implementation. MUST run before any creative work.",
+      "description": "Explore user intent, requirements, and design before implementation — must run before any creative work: features, components, mechanics, behavior.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -162,7 +175,7 @@
     {
       "id": "skill/browse-templates",
       "name": "browse-templates",
-      "description": "Use when the user wants to see available Summer Engine project templates, start from an existing template, or asks \"what templates exist?\" — lists the pinned template registry via `summer list templates`, presents the choices, and creates a project from the chosen template via `summer create <slug> <project-name>`. Trigger on \"templates\", \"starter\", \"boilerplate\", \"from a template\", \"what's available\", \"show me templates\", \"third-person\", \"platformer\", \"multiplayer starter\".",
+      "description": "List available Summer Engine project templates, present the choices, and create a project from the chosen one via summer create.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -172,10 +185,24 @@
         "project"
       ]
     },
+    {
+      "id": "skill/camera-rigs",
+      "name": "camera-rigs",
+      "description": "Camera rigs for 2D and 3D: Camera2D follow with limits, first-person head camera, SpringArm3D third-person, orthographic top-down, FOV guidance.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/camera-rigs/",
+      "domains": [
+        "scenes",
+        "3d",
+        "2d"
+      ]
+    },
     {
       "id": "skill/celeste-momentum-platforming",
       "name": "celeste-momentum-platforming",
-      "description": "Use when building or tuning Celeste-style momentum-based precision platformer movement in SummerEngine (Godot 4): tuned gravity/fall, run acceleration, variable-height jumps with coyote time, dashes, wall jumps/slides, climb stamina, and pixel-scale corner correction, using the exact tuning constants extracted from Celeste's open-source Player class.",
+      "description": "Celeste-style 2D precision platformer movement — momentum running, coyote time, variable jumps, dash, wall jump/slide, climb stamina, pixel corner correction.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -189,7 +216,7 @@
     {
       "id": "skill/character-animation-wiring",
       "name": "character-animation-wiring",
-      "description": "Use when a rigged, animated character is in the scene (Meshy rig + generated clips, or an imported GLB) and needs to be wired end to end — inspect the clips and bones that actually arrived, build idle/walk/run locomotion with blend times, method-track footsteps and attack frames, still poses and head tracking, blend-shape facial keys, root motion. Trigger on \"wire the character\", \"hook up the animations\", \"make it walk around\", \"the GLB has animations\", \"footstep events\", \"attack frame\", \"root motion\", \"character slides while walking\".",
+      "description": "Wire a rigged, animated character end to end — inspect real clips and bones, locomotion state machine, method-track events, poses, blend shapes, root motion.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -202,7 +229,7 @@
     {
       "id": "skill/character-model",
       "name": "character-model",
-      "description": "Use when generating a humanoid character ready for animation — player avatar, NPC, enemy, boss, companion. Generates a T-pose reference image, gates an un-rigged preview past the user, then runs the Meshy auto-rig pass and wires the result as a CharacterBody3D (movement) or Node3D (cinematic). Trigger on \"make a character\", \"generate the player\", \"I need an enemy model\", \"create an NPC\", \"rigged humanoid\", \"character with a skeleton\", \"model for animation\".",
+      "description": "Generate a rigged humanoid — player, NPC, enemy, boss — via T-pose reference, user-gated preview, and Meshy auto-rig, wired as CharacterBody3D or Node3D.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -212,10 +239,25 @@
         "assets"
       ]
     },
+    {
+      "id": "skill/character-movement",
+      "name": "character-movement",
+      "description": "Player controllers for 2D and 3D, plus the canonical third-person controller for Summer humanoid packages: movement owns translation, clips follow state.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/character-movement/",
+      "domains": [
+        "character-controller",
+        "gameplay",
+        "2d",
+        "3d"
+      ]
+    },
     {
       "id": "skill/character-portrait",
       "name": "character-portrait",
-      "description": "Use when generating a single, polished bust/portrait of a character for dialogue UI, character-select screens, lore cards, or codex entries. One character, locked composition, VN-style. Trigger on \"character portrait\", \"dialogue portrait\", \"VN portrait\", \"character bust\", \"headshot\", \"character select image\", \"lore card art\".",
+      "description": "Generate a single polished character bust for dialogue UI, character select, lore cards, or codex entries. One character, locked composition, VN-style.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -228,7 +270,7 @@
     {
       "id": "skill/cinematic-cutscene",
       "name": "cinematic-cutscene",
-      "description": "Use when generating a non-interactive cutscene clip — opening scene, story beat, character intro, ending. Locks the look with a reference image, image-to-videos a 5-10s shot, optionally adds TTS dialogue, and wires it as a VideoStreamPlayer that fades in/out. Trigger on \"cutscene\", \"intro cinematic\", \"opening scene\", \"ending cinematic\", \"story beat video\", \"character intro video\", \"in-engine cinematic\", \"non-playable scene\".",
+      "description": "Generate a non-interactive cutscene — reference-locked look, a 5-10s image-to-video shot, optional TTS dialogue — wired as a fading VideoStreamPlayer.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -238,10 +280,24 @@
         "assets"
       ]
     },
+    {
+      "id": "skill/combat-basics",
+      "name": "combat-basics",
+      "description": "Damage in Summer Engine: hitbox and hurtbox Areas on opposing layers, a reusable Health component, damage signals, knockback, hit feedback, projectiles.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/combat-basics/",
+      "domains": [
+        "gameplay",
+        "scripting",
+        "game-design"
+      ]
+    },
     {
       "id": "skill/concept-art",
       "name": "concept-art",
-      "description": "Use when the user is exploring art direction — wants 3-4 rough variants of a character, environment, or prop to pick a vibe before committing to a final asset. Generates a batch of evocative concept images, not finals. Trigger on \"concept art\", \"art direction\", \"explore the look\", \"give me some variants\", \"what could this character look like\", \"mood board\", \"rough sketches\".",
+      "description": "Explore art direction with 3-4 rough concept variants of a character, environment, or prop to pick a vibe before committing to a final asset.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -254,7 +310,7 @@
     {
       "id": "skill/create-asset-sheet",
       "name": "create-asset-sheet",
-      "description": "Use when the user wants to generate a pack of 2D game assets from a single prompt — a tile sheet, UI kit, menu screen, character pack, or biome set. The skill plans the prompt, generates a coherent sheet, removes the background, vision-detects each item, classifies it, and saves as a single pack ArtAsset. Trigger on \"asset sheet\", \"asset pack\", \"tile sheet\", \"tileset\", \"UI kit\", \"asset pack for\", \"make me a sheet of\", \"generate a bunch of <category> assets\".",
+      "description": "Generate a pack of 2D game assets from one prompt — tile sheet, UI kit, character pack, or biome set — sliced, classified, and saved as one pack ArtAsset.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -267,7 +323,7 @@
     {
       "id": "skill/debug",
       "name": "debug",
-      "description": "Use when the user reports a bug, crash, error, or unexpected behavior in a Summer project, before making code or scene changes. Runs a disciplined script-errors, console, debugger, hypothesis, fix, and verify loop. Trigger on \"debug\", \"crash\", \"error\", \"broken\", \"not working\", \"freezes\", \"wrong\".",
+      "description": "Disciplined bug/crash/error loop for Summer projects — script errors, console, debugger, hypothesis, fix, verify — before making code or scene changes.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -280,7 +336,7 @@
     {
       "id": "skill/debugging-game-feel",
       "name": "debugging-game-feel",
-      "description": "Use when a gameplay feature works correctly but feels wrong — floaty jumps, mushy combat, sluggish camera, weightless impacts. Different from logical bug debugging; the bug is subjective and lives in tuning, timing, and feedback layers.",
+      "description": "Debug features that work but feel wrong — floaty jumps, mushy combat, sluggish camera — subjective bugs living in tuning, timing, and feedback layers.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -293,7 +349,7 @@
     {
       "id": "skill/design-level",
       "name": "design-level",
-      "description": "Use when designing a single level — layout, pacing, encounters, secrets, reward gating. Outputs a level design doc and a concrete node-tree skeleton for `summer_create_scene`. Trigger on \"design a level\", \"design level 1\", \"tutorial level\", \"boss arena\", \"design the encounter\", \"make a level layout\".",
+      "description": "Design a single level — layout, pacing, encounters, secrets, reward gating — outputs a level design doc and a node-tree skeleton for summer_create_scene.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -306,7 +362,7 @@
     {
       "id": "skill/design-mechanic",
       "name": "design-mechanic",
-      "description": "Use when designing one specific game mechanic in detail — input, response, feedback, failure modes, depth, tunables. Outputs a design doc and a scaffolding-ready node-graph sketch + GDScript stub. Trigger on \"design a mechanic\", \"how should X work\", \"design the parry\", \"design the dash\", \"design the inventory\", \"the loop is broken\".",
+      "description": "Design one game mechanic in detail — input, response, feedback, failure modes, depth, tunables — outputs a design doc, node-graph sketch, GDScript stub.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -319,7 +375,7 @@
     {
       "id": "skill/design-npc",
       "name": "design-npc",
-      "description": "Use when the user wants to design an enemy, NPC, boss, companion, civilian, or wave-spawned mob's behavior. Walks perception, personality knobs, intent layer, action state machine, telegraphs, defeat handling, and group emergence — outputs a state-machine GDScript stub plus the recommended node tree. Trigger on \"enemy\", \"NPC\", \"boss\", \"companion\", \"AI\", \"behavior\", \"mob\", \"perception\", \"design enemy\".",
+      "description": "Design enemy/NPC/boss/companion behavior — perception, personality, intent, action state machine, telegraphs — outputs a GDScript stub plus node tree.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -332,7 +388,7 @@
     {
       "id": "skill/diagnosing-perf-regressions",
       "name": "diagnosing-perf-regressions",
-      "description": "Use when frame rate, frame time, or load time has gotten worse since a known-good state — \"it used to run at 60, now it's at 30.\" Focused on finding the cause of a regression, not general performance tuning.",
+      "description": "Find why frame rate, frame time, or load time got worse since a known-good state — regression hunting, not general performance tuning.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -345,7 +401,7 @@
     {
       "id": "skill/dispatching-parallel-agents",
       "name": "dispatching-parallel-agents",
-      "description": "Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies",
+      "description": "Work 2+ independent tasks in parallel when they share no state and have no sequential dependencies.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -358,7 +414,7 @@
     {
       "id": "skill/driving-the-editor-ui",
       "name": "driving-the-editor-ui",
-      "description": "Use when a task is an editor-workflow step a human would do with the mouse — open Project Settings or a dock, switch the 2D/3D/Script main screen, toggle a panel, clear a dialog that is blocking the editor, read what a dock shows — and when deciding whether a request is UI work or scene work. Drives the editor by NAME through summer_ui_actions, reads it as structure through summer_ui_tree, activates the long tail by path through summer_ui_activate, and treats summer_ui_screenshot as the pixels-last fallback. Preview — the ops ship with a follow-up engine build.",
+      "description": "Drive the editor UI by name: invoke actions, clear blocking dialogs, switch the main screen, read a dock — and route scene work to the scene tools instead.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -372,7 +428,7 @@
     {
       "id": "skill/environment-kit",
       "name": "environment-kit",
-      "description": "Use when generating a modular environment kit — wall pieces, floor tiles, pillars, doors, arches, corner blocks that snap together to form a level. Multiple meshes that share a visual style. Trigger on \"build a dungeon kit\", \"modular walls\", \"level kit\", \"tileset\", \"interior pieces\", \"snap-together pieces\", \"make a kit for the temple\".",
+      "description": "Generate a modular environment kit — wall pieces, floor tiles, pillars, doors, arches, corners — snap-together meshes sharing one visual style.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -385,7 +441,7 @@
     {
       "id": "skill/export-and-ship",
       "name": "export-and-ship",
-      "description": "Use when the user wants to assess or prepare a Summer game export. Inventories the templates and targets actually available in the installed Summer Engine build, validates release assets and configuration, and produces only locally supported builds after approval. It does not publish, upload, host, or submit a game. Trigger on \"export\", \"ship\", \"release\", \"build\", \"Steam\", \"itch\", \"HTML5\", \"iOS\", \"Android\", \"submit\", \"publish\".",
+      "description": "Assess and prepare a game export: inventory installed templates and targets, validate release assets and config, produce supported builds after approval.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -398,7 +454,7 @@
     {
       "id": "skill/fabricating-assets",
       "name": "fabricating-assets",
-      "description": "Use when an asset needs Blender's mesh tooling rather than generation or a library download — a modular kit with exact dimensions and snapping, VFX meshes (shatter fragments, curve sweeps, LOD chains), or decimating/UV-unwrapping/baking a generated model — and you are about to write a bpy script for summer_fabricate_3d. Covers the route decision (fabricate vs generate vs import), the bpy rules that survive glTF export, the script -> import -> snapshot -> screenshot loop, every failure_reason and what to do about it, and the licensing shape (the user's own Blender, never bundled).",
+      "description": "Fabricate meshes with a bpy script in the user's own Blender (summer_fabricate_3d) — kits with exact dimensions, VFX meshes, post-processing generated models.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -413,7 +469,7 @@
     {
       "id": "skill/facial-and-lipsync",
       "name": "facial-and-lipsync",
-      "description": "Use when the user has a voice-over (or wants one) and needs the character's mouth to actually move with the words — phoneme extraction from audio, mapping to viseme blendshapes, plus emotional facial expressions (smile, frown, surprise). Trigger on \"lipsync\", \"lip sync\", \"talking head\", \"phonemes\", \"viseme\", \"facial animation\", \"blendshapes\", \"make him talk\", \"dialogue animation\".",
+      "description": "Make a character's mouth move with a voice-over — phoneme extraction from audio, viseme blendshape mapping, and emotional facial expressions.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -426,7 +482,7 @@
     {
       "id": "skill/fps-controller",
       "name": "fps-controller",
-      "description": "Use when building an FPS, first-person movement, or a 3D character that walks, jumps, and reacts to external forces — production-quality first-person controller with WASD, mouse look, jump, coyote time, jump buffering, air control, and external-velocity handling. Trigger on \"FPS\", \"first-person\", \"WASD\", \"character controller\", \"mouse look\", \"player movement\", \"jump\".",
+      "description": "Production-quality first-person controller — WASD, mouse look, jump, coyote time, jump buffering, air control, and external-velocity handling.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -439,7 +495,7 @@
     {
       "id": "skill/game-feel",
       "name": "game-feel",
-      "description": "Use when a Summer game \"feels flat\", \"lacks impact\", \"needs juice\", or \"needs punch\", or the user asks for hit feedback, screen shake, camera shake, audio ducking, or general game feel. Walks through Summer Engine's hit-flash, trauma camera shake, and audio-ducking stack, wired so one hit fires all three. Trigger on \"vfx\", \"juice\", \"punch\", \"feels flat\", \"game feel\", \"hit flash\", \"screen shake\", \"camera shake\", \"ducking\".",
+      "description": "Add juice: hit-flash, trauma-based camera shake, and audio ducking wired so one hit fires all three — for games that feel flat or lack impact.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -452,7 +508,7 @@
     {
       "id": "skill/gameskill",
       "name": "gameskill",
-      "description": "Use when finishing a game-development session and you want to capture what you just learned as a reusable skill so the next session starts smarter. Trigger on \"gameskill\", \"/gameskill\", \"capture learnings\", \"save to skills\".",
+      "description": "Capture what a game-dev session just learned as a reusable skill (project, user or Summer library) so the next session starts smarter.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -465,7 +521,7 @@
     {
       "id": "skill/gdscript-patterns",
       "name": "gdscript-patterns",
-      "description": "Use when writing or refactoring GDScript — type hints, signals, exports, onready, lifecycle methods (`_ready` vs `_process` vs `_physics_process`), `get_node` vs `$NodePath`, naming conventions. Trigger on \"GDScript\", \"script\", \"signals\", \"exports\", \"onready\", \"_ready\", \"_process\".",
+      "description": "GDScript conventions — type hints, signals, exports, onready, lifecycle methods, get_node vs $NodePath, naming.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -478,7 +534,7 @@
     {
       "id": "skill/generate-motion",
       "name": "generate-motion",
-      "description": "Use when the user needs an animation clip on a rigged character — idle/walk/run/attack from the curated Meshy library. Picks the right curated motion, attaches the resulting clip to an AnimationPlayer. Trigger on \"animation\", \"animate\", \"idle\", \"walk\", \"run\", \"attack animation\", \"motion\", \"mocap\", \"dance\", \"death animation\".",
+      "description": "Attach an animation clip to a rigged character from the curated Meshy motion library — idle, walk, run, attack — wired via AnimationPlayer.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -491,7 +547,7 @@
     {
       "id": "skill/godogen-visual-proof-game-generation",
       "name": "godogen-visual-proof-game-generation",
-      "description": "Use when adopting Godogen's thin-runtime autonomous game generation and its 'proof over claims' visual QC loop for SummerEngine: capture frames from the running engine, let the host agent self-verify against the brief, and drive bounded fix iterations until a proof recording closes the run.",
+      "description": "Godogen-style game generation with a visual QC loop — capture frames from the running game, self-verify against the brief, bounded fix rounds, proof clip.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -504,7 +560,7 @@
     {
       "id": "skill/headless-scripting",
       "name": "headless-scripting",
-      "description": "Use when a Summer project needs an operation no MCP tool exposes, such as baking a navmesh, generating collision shapes, authoring an Animation, building a TileSet, re-importing assets after file changes, or preparing a supported local export. Runs a GDScript file against Summer Engine from the shell. Also use when a plan involves \"run it headless and screenshot it\", which does not work and this skill explains why.",
+      "description": "Run a GDScript file against Summer Engine from the shell for operations no MCP tool exposes — navmesh baking, collision shapes, TileSets, re-imports.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -515,22 +571,23 @@
       ]
     },
     {
-      "id": "skill/host-authoritative-state",
-      "name": "host-authoritative-state",
-      "description": "Use when designing the state layer of a multiplayer Summer game: deciding what the host owns, how clients request changes, and how the host validates and broadcasts. Pairs with `/peer-to-peer-multiplayer`. Trigger on \"host authority\", \"authoritative state\", \"state ownership\", \"MP cheating\", \"client validation\", \"RPC patterns\".",
+      "id": "skill/in-game-purchases",
+      "name": "in-game-purchases",
+      "description": "Sell items for Sparks and let short players buy Sparks in game via the Summer purchase sheet: checkout, Sparks purchase, results, testing, store policy.",
       "clients": "all",
-      "recommended": true,
-      "status": "stable",
-      "path": "library/skills/host-authoritative-state/",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/in-game-purchases/",
       "domains": [
-        "multiplayer",
+        "gameplay",
+        "scripting",
         "game-design"
       ]
     },
     {
       "id": "skill/instantiate-asset-pack",
       "name": "instantiate-asset-pack",
-      "description": "Use when the user wants to import or spawn an entire asset pack (the multi-slice ArtAsset produced by `create-asset-sheet`) into the current scene — not a single slice, the whole pack. Reads the pack's per-slice metadata (zOrder, isComposite, parentSliceIndex, widget, bbox), groups composites, sorts children by paint order, and emits the Sprite2D / Node2D / NinePatchRect ops to lay it out correctly. Trigger on \"import the X pack\", \"spawn the UI from pack Y\", \"bring in that asset sheet\", \"add the panel from the pack\".",
+      "description": "Import a whole create-asset-sheet pack into the scene: groups composites, sorts paint order, emits Sprite2D/Node2D/NinePatchRect ops to lay it out.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -543,7 +600,7 @@
     {
       "id": "skill/investigating-bugs",
       "name": "investigating-bugs",
-      "description": "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes",
+      "description": "Systematic investigation of any bug, test failure, or unexpected behavior before proposing fixes.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -556,7 +613,7 @@
     {
       "id": "skill/lumera-single-image-scene-reconstruction",
       "name": "lumera-single-image-scene-reconstruction",
-      "description": "Use when building a Lumera-style single-image → editable-engine-scene pipeline in SummerEngine: VLM-parsed object boxes and parametric lights, per-object meshes, HDR environment probe, engine-native assembly, and a bounded dual-agent refinement loop.",
+      "description": "Lumera-style single image to editable 3D scene — VLM-parsed object boxes and parametric lights, per-object meshes, HDR probe, .tscn assembly, refinement loop.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -571,7 +628,7 @@
     {
       "id": "skill/make-game",
       "name": "make-game",
-      "description": "Use when the user says \"make me a game\", \"build me a game\", \"I want to make a [genre] game\", \"let's build something\" — the orchestration spine that runs the full game-dev pipeline: brainstorm → plan → scaffold → build core mechanics → art direction → audio → polish/VFX → verify → ship. Delegates to specialist skills with explicit checkpoints between phases. Trigger on \"make a game\", \"build me a game\", \"create a new game\", \"make me a game\", \"let's build a game\", \"I want to build [game shape]\".",
+      "description": "Orchestration spine for 'make me a game': brainstorm, plan, scaffold, mechanics, art, audio, polish, verify, ship — delegates to specialist skills.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -581,10 +638,92 @@
         "project"
       ]
     },
+    {
+      "id": "skill/multiplayer",
+      "name": "multiplayer",
+      "description": "Start here for Summer multiplayer: how the authority, clients, Worlds and Sessions fit, and which skill comes next.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/multiplayer/",
+      "domains": [
+        "multiplayer",
+        "project"
+      ]
+    },
+    {
+      "id": "skill/multiplayer-movement",
+      "name": "multiplayer-movement",
+      "description": "Client-side movement in Summer multiplayer: owners move instantly, others glide, the authority checks each pose.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/multiplayer-movement/",
+      "domains": [
+        "multiplayer",
+        "character-controller",
+        "scripting"
+      ]
+    },
+    {
+      "id": "skill/multiplayer-project",
+      "name": "multiplayer-project",
+      "description": "Set up a Summer multiplayer project: both entry scenes, World and queue files, joining, and a first Local Play run.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/multiplayer-project/",
+      "domains": [
+        "multiplayer",
+        "project",
+        "scripting"
+      ]
+    },
+    {
+      "id": "skill/multiplayer-publish",
+      "name": "multiplayer-publish",
+      "description": "Ship a hosted Summer multiplayer game: the summer.games bundle, server preset, pre-upload checks, and a new Build.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/multiplayer-publish/",
+      "domains": [
+        "multiplayer",
+        "deployment"
+      ]
+    },
+    {
+      "id": "skill/multiplayer-state",
+      "name": "multiplayer-state",
+      "description": "Authority-owned game state in Summer multiplayer: shared and private State groups, validated Commands, and Events.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/multiplayer-state/",
+      "domains": [
+        "multiplayer",
+        "game-design",
+        "scripting"
+      ]
+    },
+    {
+      "id": "skill/multiplayer-testing",
+      "name": "multiplayer-testing",
+      "description": "Test a Summer multiplayer game with Local Play: several players, a bad network, bots, and what a passing run shows.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/multiplayer-testing/",
+      "domains": [
+        "multiplayer",
+        "playtest",
+        "verification"
+      ]
+    },
     {
       "id": "skill/music-track",
       "name": "music-track",
-      "description": "Use when generating a looped or cinematic music track. Loops are authored at >=30s with a marked loop point; cinematic tracks at >=60s linear. Trigger on \"generate music\", \"make a calm track\", \"boss music\", \"title screen music\", \"main theme\", \"exploration loop\", \"combat track\".",
+      "description": "Generate a looped or cinematic music track — loops authored at >=30s with a marked loop point, cinematic tracks at >=60s linear.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -597,7 +736,7 @@
     {
       "id": "skill/navigate-summer",
       "name": "navigate-summer",
-      "description": "Use when the user wants to SEE, CHECK, or DECIDE something — \"show me my billing\", \"where do I change my plan\", \"open my games\", \"let me look at the scene\", \"open the MCP guide for Cursor\". Decides whether to open a Summer web page or editor surface for the user or to act through the API, and lands exactly there with summer_open.",
+      "description": "When to open a Summer web page or editor surface FOR the user (billing, their games, the scene just built) versus acting through the API, using summer_open.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -611,7 +750,7 @@
     {
       "id": "skill/new-project",
       "name": "new-project",
-      "description": "Use when the user wants a fresh blank Summer Engine project — not from a template. Asks one question (project name) and runs `summer create empty <name>`. Trigger on \"new project\", \"blank project\", \"empty project\", \"from scratch\", \"start fresh\", \"create new game\", \"blank canvas\", \"scaffold a project\".",
+      "description": "Create a fresh blank Summer Engine project — asks one question (project name) and runs summer create empty.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -624,7 +763,7 @@
     {
       "id": "skill/organic-model",
       "name": "organic-model",
-      "description": "Use when generating organic shapes — trees, rocks, mushrooms, coral, bushes, alien plants, vines, crystals, fruit, bones. The \"easy mode\" of 3D generation; AI artifacts read as natural irregularity. Trigger on \"make a tree\", \"generate rocks\", \"I need foliage\", \"mushroom prop\", \"alien plants\", \"fill the scene with shrubs\", \"scatter some boulders\".",
+      "description": "Generate organic 3D shapes — trees, rocks, mushrooms, coral, plants, vines, crystals — where AI artifacts read as natural irregularity.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -634,23 +773,10 @@
         "assets"
       ]
     },
-    {
-      "id": "skill/peer-to-peer-multiplayer",
-      "name": "peer-to-peer-multiplayer",
-      "description": "Use when starting a multiplayer Summer game from scratch with peer-to-peer host authority. Build the network architecture top-down so authoritative state, routing rules, and real-time rendering are not bolted on later. Use before writing game logic, not after. Trigger on \"multiplayer\", \"peer-to-peer\", \"p2p\", \"co-op\", \"host\", \"multiplayer architecture\", \"add multiplayer\".",
-      "clients": "all",
-      "recommended": true,
-      "status": "stable",
-      "path": "library/skills/peer-to-peer-multiplayer/",
-      "domains": [
-        "multiplayer",
-        "project"
-      ]
-    },
     {
       "id": "skill/pixel-art",
       "name": "pixel-art",
-      "description": "Use when generating pixel-art assets — sprites, items, tiles, portraits in a pixel style at a specific resolution (32×32, 64×64, 128×128). Pixel-perfect grid, limited palette, retro feel. Trigger on \"pixel art\", \"8-bit art\", \"16-bit sprite\", \"pixel sprite\", \"retro tileset\", \"pixel icon\", \"pixel portrait\".",
+      "description": "Generate pixel-art assets — sprites, items, tiles, portraits — at a specific resolution with pixel-perfect grid, limited palette, retro feel.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -663,7 +789,7 @@
     {
       "id": "skill/play",
       "name": "play",
-      "description": "Use when the user says \"play\", \"run it\", \"test it\", \"let me see it\", or \"start the game\". Runs the project in Summer Engine, briefly waits, then reports what's happening — clean run, errors, or warnings.",
+      "description": "Run the project in Summer Engine, wait briefly, then report what's happening — clean run, errors, or warnings.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -676,7 +802,7 @@
     {
       "id": "skill/playtesting-a-feature",
       "name": "playtesting-a-feature",
-      "description": "Use when about to claim a gameplay feature is done, shipped, or working — requires actually running the game and walking through the feature before declaring completion. Static diagnostics and type checks do not count as playtesting.",
+      "description": "Before claiming a gameplay feature done: actually run the game and walk through the feature. Static diagnostics and type checks do not count.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -689,7 +815,7 @@
     {
       "id": "skill/procedural-animation",
       "name": "procedural-animation",
-      "description": "Use when the user needs runtime-driven bone modification on top of clips — head look-at, foot IK on uneven ground, hand-grabs-prop, additive lean, hit-direction recoil. Code-and-modifier patterns, not generation. Trigger on \"look at\", \"IK\", \"foot placement\", \"foot IK\", \"lean\", \"additive layer\", \"feet floating\", \"hand penetration\", \"head tracks player\", \"ragdoll\".",
+      "description": "Runtime bone modification on top of clips — head look-at, foot IK, hand-grabs-prop, additive lean, recoil. Code-and-modifier patterns, not generation.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -702,7 +828,7 @@
     {
       "id": "skill/prop-model",
       "name": "prop-model",
-      "description": "Use when generating a single static 3D prop — sword, barrel, chest, lantern, throne, statue, crate, key, potion, banner. One isolated object, no rigging, wired into the scene as a MeshInstance3D. Trigger on \"make a sword\", \"generate a chest\", \"I need a barrel\", \"add a lantern model\", \"give me a treasure prop\", \"create a statue\".",
+      "description": "Generate a single static 3D prop — sword, barrel, chest, lantern, throne, statue — one isolated object, no rigging, wired as a MeshInstance3D.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -715,7 +841,7 @@
     {
       "id": "skill/psx-retro-rendering",
       "name": "psx-retro-rendering",
-      "description": "Use when building or reviewing a hardware-informed PlayStation 1 rendering pipeline in Godot 4, including low-resolution output, RGB5 color and exact dithering, affine textures, screen-coordinate snapping, draw-order/depth approximation, vertex lighting, PS1 blend modes, and fog — when accuracy and the limits of each Godot approximation matter, not for a generic pixel-art filter.",
+      "description": "Hardware-informed PlayStation 1 rendering in Godot 4 — low-res output, RGB5 and exact dither, affine textures, vertex snapping, blend modes, fog; limits named.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -728,7 +854,7 @@
     {
       "id": "skill/realtime-wet-surfaces",
       "name": "realtime-wet-surfaces",
-      "description": "Use when adding real-time wetness to existing Godot 4 materials while preserving their parameter values, mapping Unity's Lit-preserving wet ShaderGraph swap onto a value-copying shader conversion with a geometry-driven wet mask and instance-uniform control.",
+      "description": "Real-time wetness on existing Godot 4 materials without losing their values — value-copying wet shader, geometry-driven wet mask, instance-uniform wet amount.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -741,7 +867,7 @@
     {
       "id": "skill/remote-deploy",
       "name": "remote-deploy",
-      "description": "Use when the user wants to run or test the game on a real target instead of the editor — a phone, tablet, or another computer (\"deploy to my phone\", \"run on device\", \"test on Android/iOS\", \"remote deploy\", \"one-click deploy\", \"play on hardware\"). Covers the topnav Remote Deploy button, runnable export presets, export templates, and on-device remote debugging. Use when the Remote Deploy button is greyed out and the user wants to know why.",
+      "description": "Run or test the game on a real device — phone, tablet, another computer — via the Remote Deploy button, runnable export presets, and on-device debugging.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -754,7 +880,7 @@
     {
       "id": "skill/retarget",
       "name": "retarget",
-      "description": "Use when the user wants to apply existing animation clips from one rigged character to a different rigged character — same library, multiple models, no regeneration. Trigger on \"retarget\", \"reuse animation\", \"apply to other character\", \"same animations on different model\", \"share animation library\".",
+      "description": "Apply existing animation clips from one rigged character to a different rigged character — same library, multiple models, no regeneration.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -767,7 +893,7 @@
     {
       "id": "skill/running-in-the-cloud",
       "name": "running-in-the-cloud",
-      "description": "Use when Summer Engine runs in a cloud container, CI job, remote agent sandbox, or any Linux box with no desktop — installing the engine there, launching it headless, deciding when xvfb-run and software GL are required, and authenticating without a browser. Also use when a tool reports \"engine not running\" in an environment that has no display, or when SUMMER_ENGINE_BINARY / SUMMER_TOKEN come up.",
+      "description": "Run Summer Engine on a Linux box with no display — install it, launch headless, know when xvfb + software GL are needed, authenticate without a browser.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -777,10 +903,23 @@
         "project"
       ]
     },
+    {
+      "id": "skill/save-load",
+      "name": "save-load",
+      "description": "Persist game state in Summer Engine: user:// paths, JSON progress vs ConfigFile settings, a versioned save schema with migration, autosave hooks.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/save-load/",
+      "domains": [
+        "scripting",
+        "gameplay"
+      ]
+    },
     {
       "id": "skill/scene-composition",
       "name": "scene-composition",
-      "description": "Use when building or organizing Summer Engine scenes: node hierarchy conventions, when to extract sub-scenes, reusable prefab patterns, and instance-versus-add-node decisions. Trigger on \"scene\", \"sub-scene\", \"instance\", \"prefab\", \"node hierarchy\", \"scene structure\", \"PackedScene\".",
+      "description": "Scene structure conventions — node hierarchy, when to extract sub-scenes, reusable prefab patterns, and instance-versus-add-node decisions.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -793,7 +932,7 @@
     {
       "id": "skill/scene-hierarchy-design",
       "name": "scene-hierarchy-design",
-      "description": "Use when applying data-oriented hierarchy principles (from Sander Mertens' ECS hierarchies article) to structure Summer Engine scenes: split asset vs. live hierarchies, group by dominant access pattern, use sub-scenes for reuse, and keep logic path-agnostic via MCP scene tools.",
+      "description": "Structure Summer Engine scenes by access pattern — asset vs live hierarchies, wrapper nodes per operation, sub-scenes for reuse, path-agnostic logic.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -807,7 +946,7 @@
     {
       "id": "skill/scene-scripting",
       "name": "scene-scripting",
-      "description": "Use when building or modifying a scene takes more than a couple of node/property calls — scattering instances, procedural meshes, booleans/lathe/sweep geometry, terrain, GridMap fills, lighting rigs, keyframe animation, shader FX, 2D levels (tilemaps, sprites, bodies, cameras, parallax), HUDs and Control trees, persisted signal wiring, attached scripts, prefabs, input actions/autoloads/main scene, or anything with computed placement. Runs one GDScript inside the live editor via summer_run_script instead of long CRUD chains, verifies with summer_snapshot_diff + summer_screenshot, and checks API names with summer_api_docs instead of guessing.",
+      "description": "One GDScript in the live editor (summer_run_script) builds scenes, 2D levels, HUDs and gameplay wiring instead of CRUD chains; verify with diff + screenshot.",
       "clients": "all",
       "recommended": true,
       "status": "preview",
@@ -823,7 +962,7 @@
     {
       "id": "skill/scene-to-level",
       "name": "scene-to-level",
-      "description": "Use when the user wants to go from a scene reference image or concept art to a playable Summer Engine scene populated with the right assets and terrain. Orchestrates concept, asset pack, terrain, composition, and scene assembly. Trigger on \"build this scene\", \"make this playable\", \"I want a level that looks like this\", \"from a screenshot to a game\", \"implement this concept\".",
+      "description": "Go from a scene reference image or concept art to a playable scene — orchestrates concept, asset pack, terrain, composition, and scene assembly.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -833,23 +972,10 @@
         "game-design"
       ]
     },
-    {
-      "id": "skill/setup-multiplayer",
-      "name": "setup-multiplayer",
-      "description": "Use when the user wants to add multiplayer to an existing Summer game: co-op LAN, co-op online, competitive PvP, or a lobby. Start with Summer Engine's high-level MultiplayerAPI plus MultiplayerSpawner and MultiplayerSynchronizer; use custom networking only with a justified reason. Walks peer authority, RPC patterns, replication, and irreversible architecture decisions. It does not claim that managed matchmaking or hosting is live. Trigger on \"multiplayer\", \"co-op\", \"PvP\", \"online\", \"netcode\", \"rollback\", \"MultiplayerAPI\", \"host migration\", \"matchmaking\".",
-      "clients": "all",
-      "recommended": true,
-      "status": "stable",
-      "path": "library/skills/setup-multiplayer/",
-      "domains": [
-        "multiplayer",
-        "scripting"
-      ]
-    },
     {
       "id": "skill/skill-create",
       "name": "skill-create",
-      "description": "Use when a contributor wants to add a new skill to the Summer library. Bootstraps the canonical folder (library/skills/<slug>/ with resource.yaml and SKILL.md), frontmatter, and stub sections. Trigger on \"create skill\", \"add skill\", \"new skill\", \"skill-create\".",
+      "description": "Bootstrap a new Summer library skill (library/skills/<slug>/ with resource.yaml and SKILL.md), frontmatter, and stub sections.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -862,7 +988,7 @@
     {
       "id": "skill/skill-improve",
       "name": "skill-improve",
-      "description": "Use when a contributor wants to upgrade a Summer skill that is underperforming or to fix a regression — runs the skill against a behavioral spec with and without proposed changes via parallel-eval harness and ships the version that wins. Trigger on \"improve skill\", \"iterate on skill\", \"make this skill better\".",
+      "description": "Upgrade an underperforming Summer skill — run it against a behavioral spec with and without changes via a parallel-eval harness; ship the winner.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -875,7 +1001,7 @@
     {
       "id": "skill/skill-test",
       "name": "skill-test",
-      "description": "Use when a contributor wants to lint a Summer skill before commit, audit the whole library, or check a behavioral spec assertion — validates against static structural rules and per-skill behavioral specs. Trigger on \"skill test\", \"lint skill\", \"validate skill\".",
+      "description": "Lint a Summer skill before commit, audit the whole library, or check a behavioral spec assertion — static structural rules plus behavioral specs.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -888,7 +1014,7 @@
     {
       "id": "skill/skintokens-auto-rigging",
       "name": "skintokens-auto-rigging",
-      "description": "Use when auto-rigging a static GLB mesh offline with skin-tokens.cpp (LocalAI's C++/GGML port of VAST-AI SkinTokens/TokenRig) in SummerEngine's art pipeline: generate a skeleton and skin weights on CPU/Vulkan, then import the rigged GLB into Godot 4.",
+      "description": "Offline auto-rigging with skin-tokens.cpp (GGML SkinTokens/TokenRig port) — skeleton and skin weights from a static GLB mesh on CPU/Vulkan, into Godot 4.",
       "clients": "all",
       "recommended": false,
       "status": "preview",
@@ -903,7 +1029,7 @@
     {
       "id": "skill/skybox-panorama",
       "name": "skybox-panorama",
-      "description": "Use when generating a 360° panoramic sky image for use as a Sky resource (PanoramaSkyMaterial) in a 3D scene. Equirectangular projection, 2:1 aspect. Wires into WorldEnvironment.sky. Trigger on \"skybox\", \"sky panorama\", \"360 background\", \"environment sky\", \"HDRI sky\", \"panoramic background\", \"panorama sky\".",
+      "description": "Generate a 360-degree equirectangular sky panorama and wire it as a PanoramaSkyMaterial Sky resource on WorldEnvironment in a 3D scene.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -916,7 +1042,7 @@
     {
       "id": "skill/sound-effect",
       "name": "sound-effect",
-      "description": "Use when generating short SFX one-shots — footsteps, weapon swings, UI clicks, hit impacts, environmental cues. Wires the resulting clip as an AudioStreamPlayer / 2D / 3D and auto-frees on finished. Trigger on \"make a sword swing sound\", \"generate a UI click\", \"I need a footstep\", \"add a hit sound\", \"spawn an SFX\".",
+      "description": "Generate short SFX one-shots — footsteps, weapon swings, UI clicks, hit impacts — wired as AudioStreamPlayer/2D/3D that auto-frees on finished.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -929,7 +1055,7 @@
     {
       "id": "skill/spatial-placement",
       "name": "spatial-placement",
-      "description": "Use when positioning or verifying 3D objects with surrounding-scene evidence — floor and shelf support, wall gaps, collider or mesh overlap, directional clearance, alcoves, rotated props, and post-placement checks. Trigger on \"place\", \"position\", \"align\", \"sit on\", \"against the wall\", \"inside\", \"overlap\", \"clearance\", \"grounded\", \"flush\", \"spatial\", \"Starcast\".",
+      "description": "Place 3D objects and modular kit pieces from measured geometry — inspect, place, starcast, measure, correct; floor, wall, facade, pipe and alcove recipes.",
       "clients": "all",
       "recommended": true,
       "status": "preview",
@@ -945,7 +1071,7 @@
     {
       "id": "skill/sprite-sheet",
       "name": "sprite-sheet",
-      "description": "Use when generating animated 2D character sprites laid out as a sprite sheet (grid of frames) — walk cycle, attack frames, idle bob, death sequence. Wires into AnimatedSprite2D / SpriteFrames. Trigger on \"sprite sheet\", \"walk cycle\", \"attack frames\", \"animated sprite\", \"frame-by-frame animation\", \"2D character animation\".",
+      "description": "Generate animated 2D character sprites laid out as a sprite sheet — walk cycle, attack, idle, death — wired into AnimatedSprite2D / SpriteFrames.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -955,10 +1081,154 @@
         "assets"
       ]
     },
+    {
+      "id": "skill/summer-analytics",
+      "name": "summer-analytics",
+      "description": "Send game events to Summer analytics from the authority or client: fire-and-forget, never blocking gameplay.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-analytics/",
+      "domains": [
+        "multiplayer",
+        "scripting"
+      ]
+    },
+    {
+      "id": "skill/summer-friends",
+      "name": "summer-friends",
+      "description": "Summer friends in a game: a consented friends list, profile and chat screens, direct messages. Hosted only.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-friends/",
+      "domains": [
+        "multiplayer",
+        "ui"
+      ]
+    },
+    {
+      "id": "skill/summer-leaderboards",
+      "name": "summer-leaderboards",
+      "description": "Leaderboards in a Summer game: queue ratings from matches, and Game rankings your authority scores.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-leaderboards/",
+      "domains": [
+        "multiplayer",
+        "ui"
+      ]
+    },
+    {
+      "id": "skill/summer-match-results",
+      "name": "summer-match-results",
+      "description": "End a Summer match: report each player's win, loss or draw, show results on clients, then close the World.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/summer-match-results/",
+      "domains": [
+        "multiplayer",
+        "gameplay"
+      ]
+    },
+    {
+      "id": "skill/summer-matchmaking",
+      "name": "summer-matchmaking",
+      "description": "Get players into matches with Summer matchmaking: queues, teams, accept prompts, join progress and failures.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-matchmaking/",
+      "domains": [
+        "multiplayer",
+        "ux"
+      ]
+    },
+    {
+      "id": "skill/summer-parties",
+      "name": "summer-parties",
+      "description": "Let a Summer party play together: the leader presses Play, members follow into the same match. Hosted only.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-parties/",
+      "domains": [
+        "multiplayer",
+        "ui"
+      ]
+    },
+    {
+      "id": "skill/summer-player-data",
+      "name": "summer-player-data",
+      "description": "Save a player's progress so it follows them to every match: authority load and commit, autosave, safe retries.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/summer-player-data/",
+      "domains": [
+        "multiplayer",
+        "scripting"
+      ]
+    },
+    {
+      "id": "skill/summer-store",
+      "name": "summer-store",
+      "description": "Sell Summer items for Sparks in a multiplayer game: shop, checkout, owned items, authority entitlement checks.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-store/",
+      "domains": [
+        "multiplayer",
+        "gameplay"
+      ]
+    },
+    {
+      "id": "skill/summer-world-chat",
+      "name": "summer-world-chat",
+      "description": "Add match chat to a Summer game: one World channel shared by everyone in the match. Hosted only.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-world-chat/",
+      "domains": [
+        "multiplayer",
+        "ui"
+      ]
+    },
+    {
+      "id": "skill/summer-world-saves",
+      "name": "summer-world-saves",
+      "description": "Keep a persistent Summer World between restarts: checkpoint saves, restore before join, the final save.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/summer-world-saves/",
+      "domains": [
+        "multiplayer",
+        "scripting"
+      ]
+    },
+    {
+      "id": "skill/text-to-motion",
+      "name": "text-to-motion",
+      "description": "Custom 2-second animation clips from text prompts on any of the user's own rigged models — humanoids, animals, creatures, cartoon plants, props.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/text-to-motion/",
+      "domains": [
+        "animation",
+        "generate",
+        "3d"
+      ]
+    },
     {
       "id": "skill/tileable-texture",
       "name": "tileable-texture",
-      "description": "Use when generating a seamless tileable texture for walls, floors, terrain, ceilings — square tile that repeats cleanly on all four edges. Wires onto PlaneMesh / CSGBox3D / MeshInstance3D as a StandardMaterial3D albedo. Trigger on \"tileable texture\", \"seamless texture\", \"wall texture\", \"floor texture\", \"ground texture\", \"terrain texture\", \"tiled material\".",
+      "description": "Generate a seamless tileable texture for walls, floors, or terrain — repeats cleanly on all four edges, wired as a StandardMaterial3D albedo.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -971,7 +1241,7 @@
     {
       "id": "skill/trailer-shot",
       "name": "trailer-shot",
-      "description": "Use when generating marketing or trailer footage — slow-mo combat, dramatic establishing shots, hero beats, splash screens, pitch-deck B-roll. Optimizes for maximum visual punch in 5-10 seconds. Trigger on \"trailer\", \"marketing footage\", \"Steam capsule video\", \"splash screen\", \"hero shot\", \"pitch deck clip\", \"promo clip\", \"money shot\", \"B-roll\".",
+      "description": "Generate marketing or trailer footage — slow-mo combat, establishing shots, hero beats, splash screens, pitch-deck B-roll — max punch in 5-10 seconds.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -984,7 +1254,7 @@
     {
       "id": "skill/tune-performance",
       "name": "tune-performance",
-      "description": "Use when the user reports the game is slow, drops framerate, stutters, takes forever to start, or runs poorly on specific hardware. Profiles the running game via summer_get_diagnostics, identifies hotspots (rendering / physics / scripting), and proposes specific fixes with before/after metric expectations. Trigger on \"slow\", \"lag\", \"fps drop\", \"stuttering\", \"performance\", \"optimize\", \"profile\", \"framerate\".",
+      "description": "Profile a slow game via summer_get_diagnostics, identify rendering/physics/scripting hotspots, propose fixes with before/after metric expectations.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -997,7 +1267,7 @@
     {
       "id": "skill/ui-basics",
       "name": "ui-basics",
-      "description": "Use when building Summer Engine UI: HUDs, main menus, pause menus, health bars, progress bars, dialogue boxes, or any Control-node tree. Covers anchors, containers (VBox/HBox/Margin), responsive layout, and theme versus inline styling. Trigger on \"UI\", \"HUD\", \"menu\", \"health bar\", \"Control\", \"anchors\", \"VBoxContainer\", \"main menu\", \"pause menu\".",
+      "description": "Build Summer Engine UI — HUDs, menus, health bars, dialogue boxes, Control trees — anchors, containers, responsive layout, theme vs inline styling.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -1010,7 +1280,7 @@
     {
       "id": "skill/ui-graphics",
       "name": "ui-graphics",
-      "description": "Use when generating UI elements — icons, buttons, panels, frames, HUD widgets, badges. Flat-design, transparent-background, game-UI style. Wires the result via TextureRect / NinePatchRect / AtlasTexture. Trigger on \"UI icon\", \"button graphic\", \"HUD element\", \"panel frame\", \"menu background\", \"inventory slot\", \"ability icon\", \"badge\".",
+      "description": "Generate game-UI elements — icons, buttons, panels, frames, HUD widgets, badges — flat design, transparent background, wired via TextureRect/NinePatchRect.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1023,7 +1293,7 @@
     {
       "id": "skill/use-widget-asset",
       "name": "use-widget-asset",
-      "description": "Use when consuming a widget slice (panel, button, slider, progress bar, or toggle pair) from a `create-asset-sheet` pack in a Summer Engine scene. The pack's metadata.sliceMeta carries 9-slice margins, fill rects, and on/off pair links per slice. This skill explains how to wire those into NinePatchRect, TextureProgressBar, or TextureRect so the asset behaves like a real UI control instead of a static texture.",
+      "description": "Wire a widget slice from a create-asset-sheet pack (panel, button, slider, bar, toggle) into NinePatchRect, TextureProgressBar, or TextureRect via sliceMeta.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1036,7 +1306,7 @@
     {
       "id": "skill/using-summer",
       "name": "using-summer",
-      "description": "Use when starting any conversation in a Summer Engine project — establishes how to find and use Summer skills and the summer-engine MCP, requiring Skill tool invocation before ANY response including clarifying questions.",
+      "description": "Session bootstrap for Summer projects — establishes how to find and use Summer skills and the summer-engine MCP before any response.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1049,7 +1319,7 @@
     {
       "id": "skill/vehicle-model",
       "name": "vehicle-model",
-      "description": "Use when generating a hard-surface vehicle — car, motorcycle, spaceship, hover bike, boat, mech, tank, helicopter. Static mesh, optional secondary detail-texture pass, wired as Vehicle3D (player-driven) or MeshInstance3D (background). Trigger on \"make a car\", \"spaceship model\", \"generate a mech\", \"I need a vehicle\", \"hover bike\", \"tank model\", \"racing car\".",
+      "description": "Generate a hard-surface vehicle — car, spaceship, mech, boat, tank — static mesh with optional detail-texture pass, wired as Vehicle3D or MeshInstance3D.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1062,7 +1332,7 @@
     {
       "id": "skill/verification-before-completion",
       "name": "verification-before-completion",
-      "description": "Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always",
+      "description": "Run verification commands and confirm output before claiming work complete, fixed, or passing — evidence before assertions, always.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -1075,7 +1345,7 @@
     {
       "id": "skill/verifying-scenes",
       "name": "verifying-scenes",
-      "description": "Use when verifying that scene work actually landed — after any mutation batch, asset import, lighting change, or during a playtest — and before claiming any visual or structural result. Runs the before/after discipline (summer_world_snapshot → mutate → summer_snapshot_diff + summer_screenshot), reads live runtime state with summer_get_runtime_tree / summer_inspect_runtime_node instead of stopping the game, and enforces honest-claim rules.",
+      "description": "Prove scene work landed (snapshot, diff, screenshots, runtime reads), audit 3D scenes for holes and misplacement, review them with shot sheets and zooms.",
       "clients": "all",
       "recommended": true,
       "status": "preview",
@@ -1089,7 +1359,7 @@
     {
       "id": "skill/vfx-dissolve",
       "name": "vfx-dissolve",
-      "description": "Use when authoring a dissolve effect — an object's mesh disintegrating with a glowing burning edge, driven by a noise threshold ShaderMaterial overriding the target's existing material. Trigger on \"dissolve\", \"disintegrate\", \"burn away\", \"Thanos snap\", \"vanish into ash\", \"enemy fades out\", \"object burns up\".",
+      "description": "Dissolve effect — a mesh disintegrating with a glowing burning edge, driven by a noise-threshold ShaderMaterial overriding the target's material.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1102,7 +1372,7 @@
     {
       "id": "skill/vfx-fire",
       "name": "vfx-fire",
-      "description": "Use when authoring a fire visual effect — animated flames built with a particle shader, GPUParticles3D, and a noise-based color ramp. Trigger on \"torch\", \"campfire\", \"bonfire\", \"flame\", \"fire effect\", \"burning\", \"make this thing on fire\", \"candle\".",
+      "description": "Fire effect — animated flames built with a particle shader, GPUParticles3D, and a noise-based color ramp — torches, campfires, candles.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -1115,7 +1385,7 @@
     {
       "id": "skill/vfx-hit-spark",
       "name": "vfx-hit-spark",
-      "description": "Use when authoring a hit-spark visual effect — a one-shot burst of additive billboard particles oriented to a surface normal, fired on impact. Trigger on \"hit spark\", \"impact spark\", \"bullet hit\", \"sword clash\", \"metal-on-metal\", \"ricochet\", \"impact effect\", \"spawn sparks at hit point\".",
+      "description": "Hit-spark effect — a one-shot burst of additive billboard particles oriented to a surface normal, fired on impact.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1128,7 +1398,7 @@
     {
       "id": "skill/vfx-lightning",
       "name": "vfx-lightning",
-      "description": "Use when authoring a lightning bolt visual effect — procedural jagged path drawn via ImmediateMesh, glow shader, sparks at endpoints, screen shake. Trigger on \"lightning bolt\", \"chain lightning\", \"electric attack\", \"tesla coil\", \"shock spell\", \"thunderbolt\", \"energy beam\".",
+      "description": "Lightning bolt effect — procedural jagged path drawn via ImmediateMesh, glow shader, sparks at endpoints, screen shake.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1141,7 +1411,7 @@
     {
       "id": "skill/vfx-magic-glow",
       "name": "vfx-magic-glow",
-      "description": "Use when authoring a magic-glow visual effect — a pulsing OmniLight3D plus drifting additive motes plus optional emission shader on the source mesh. Trigger on \"magic glow\", \"enchanted item\", \"soul gem\", \"pulsing aura\", \"rune glow\", \"magical orb\", \"summon circle glow\", \"fairy\", \"wisp\".",
+      "description": "Magic-glow effect — a pulsing OmniLight3D plus drifting additive motes plus optional emission shader on the source mesh.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1154,7 +1424,7 @@
     {
       "id": "skill/vfx-muzzle-flash",
       "name": "vfx-muzzle-flash",
-      "description": "Use when authoring a muzzle-flash visual effect — a one-shot ~80 ms burst at a gun barrel built with a particle one-shot OR a flashing quad with a star-burst shader. Trigger on \"muzzle flash\", \"gun fire\", \"weapon flash\", \"barrel flash\", \"shoot a gun\", \"spell-cast burst at hand\".",
+      "description": "Muzzle-flash effect — a one-shot ~80 ms burst at a gun barrel built with a particle one-shot or a flashing quad with a star-burst shader.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -1167,7 +1437,7 @@
     {
       "id": "skill/vfx-smoke",
       "name": "vfx-smoke",
-      "description": "Use when authoring a smoke visual effect — a slow-rising column or puff of soft particles built with a noise + density falloff shader on a quad mesh, GPUParticles3D. Trigger on \"smoke\", \"smoke trail\", \"puff\", \"chimney smoke\", \"smoke from a fire\", \"steam\", \"fog cloud\", \"explosion smoke\".",
+      "description": "Smoke effect — a slow-rising column or puff of soft particles built with a noise + density falloff shader on a quad mesh, GPUParticles3D.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1180,7 +1450,7 @@
     {
       "id": "skill/vfx-water-ripple",
       "name": "vfx-water-ripple",
-      "description": "Use when authoring a water-ripple visual effect — animated normal-distortion ripples on a water plane (or as a Decal) triggered by impacts. Trigger on \"water ripple\", \"ripples on water\", \"raindrop ripple\", \"splash ripple\", \"rain on water\", \"footstep in puddle\", \"fish jumps\".",
+      "description": "Water-ripple effect — animated normal-distortion ripples on a water plane (or as a Decal) triggered by impacts.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1193,7 +1463,7 @@
     {
       "id": "skill/voice-line",
       "name": "voice-line",
-      "description": "Use when generating TTS voice lines — NPC barks, narrator, dialogue. Covers where voice ids come from, a character-to-voice decision tree, stability/style/similarity guidance, and the multi-line dialogue case via text_to_dialogue. Trigger on \"make a voice line\", \"narrator\", \"NPC says\", \"voice for the merchant\", \"TTS line\", \"dialogue\".",
+      "description": "Generate TTS voice lines — NPC barks, narrator, dialogue — with voice-id sourcing, a character-to-voice decision tree, and multi-line dialogue support.",
       "clients": "all",
       "recommended": true,
       "status": "stable",
@@ -1203,10 +1473,37 @@
         "assets"
       ]
     },
+    {
+      "id": "skill/web-and-touch-input",
+      "name": "web-and-touch-input",
+      "description": "Input for the browser and phones: the first-click rule for sound and mouse capture, focus, and touch buttons or a virtual stick on the same actions.",
+      "clients": "all",
+      "recommended": true,
+      "status": "preview",
+      "path": "library/skills/web-and-touch-input/",
+      "domains": [
+        "gameplay",
+        "ui"
+      ]
+    },
+    {
+      "id": "skill/web-compatibility-look",
+      "name": "web-compatibility-look",
+      "description": "Make a web or browser game look high-end in the Compatibility renderer (WebGL 2): what works, what to avoid, 2D and 3D recipes, web performance.",
+      "clients": "all",
+      "recommended": true,
+      "status": "preview",
+      "path": "library/skills/web-compatibility-look/",
+      "domains": [
+        "rendering",
+        "2d",
+        "3d"
+      ]
+    },
     {
       "id": "skill/world-building-3d",
       "name": "world-building-3d",
-      "description": "Use when composing, placing, grounding, spacing, or validating 3D objects in Summer Engine scenes. Trigger on \"world building\", \"place props\", \"snap to floor\", \"align objects\", \"distribute objects\", \"navigation reachability\", or requests to make a 3D scene look deliberately arranged rather than roughly positioned.",
+      "description": "Compose, ground, space, and validate 3D scenes with Summer's four bounded spatial tools — exact paths, one geometric decision at a time, verified.",
       "clients": "all",
       "recommended": true,
       "status": "preview",
@@ -1222,7 +1519,7 @@
     {
       "id": "skill/writing-plans",
       "name": "writing-plans",
-      "description": "Use when you have a spec or requirements for a multi-step task, before touching code",
+      "description": "Turn a spec or requirements for a multi-step task into a written implementation plan before touching code.",
       "clients": "all",
       "recommended": false,
       "status": "stable",
@@ -1235,7 +1532,7 @@
     {
       "id": "skill/writing-skills",
       "name": "writing-skills",
-      "description": "Use when creating new skills, editing existing skills, or verifying skills work before deployment",
+      "description": "Create, edit, and verify agent skills — format, structure, testing with subagents, and best practices.",
       "clients": "all",
       "recommended": false,
       "status": "stable",