summer-engine 2.8.1 → 3.0.0

package/registry/generated/skills-registry.json

@@ -0,0 +1,851 @@
+{
+  "_generated": "GENERATED — do not edit; run npm run generate:registry",
+  "skills": [
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/3d-lighting/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/adaptive-music/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "preview",
+      "path": "library/skills/agent-playtesting/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/ambient-bed/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/animated-loop/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/animation-tree/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/art-direction/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/asset-strategy/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/audio-direction/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/auto-fire-targeting/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/brainstorm-game/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/brainstorming/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/browse-templates/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/celeste-momentum-platforming/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/character-animation-wiring/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/character-model/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/character-portrait/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/cinematic-cutscene/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/concept-art/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/create-asset-sheet/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/debug/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/debugging-game-feel/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/design-level/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/design-mechanic/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/design-npc/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/diagnosing-perf-regressions/"
+    },
+    {
+      "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",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/dispatching-parallel-agents/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/driving-the-editor-ui/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/environment-kit/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/export-and-ship/"
+    },
+    {
+      "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).",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/fabricating-assets/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/facial-and-lipsync/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/fps-controller/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/game-feel/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/gameskill/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/gdscript-patterns/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/generate-motion/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/godogen-visual-proof-game-generation/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/headless-scripting/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/host-authoritative-state/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/instantiate-asset-pack/"
+    },
+    {
+      "id": "skill/investigating-bugs",
+      "name": "investigating-bugs",
+      "description": "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/investigating-bugs/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/lumera-single-image-scene-reconstruction/"
+    },
+    {
+      "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]\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/make-game/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/music-track/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/navigate-summer/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/new-project/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/organic-model/"
+    },
+    {
+      "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/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/pixel-art/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/play/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/playtesting-a-feature/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/procedural-animation/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/prop-model/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/psx-retro-rendering/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/realtime-wet-surfaces/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/remote-deploy/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/retarget/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/running-in-the-cloud/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/scene-composition/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/scene-hierarchy-design/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "preview",
+      "path": "library/skills/scene-scripting/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/scene-to-level/"
+    },
+    {
+      "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/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/skill-create/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/skill-improve/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/skill-test/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "preview",
+      "path": "library/skills/skintokens-auto-rigging/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/skybox-panorama/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/sound-effect/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "preview",
+      "path": "library/skills/spatial-placement/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/sprite-sheet/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/tileable-texture/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/trailer-shot/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/tune-performance/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/ui-basics/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/ui-graphics/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/use-widget-asset/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/using-summer/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/vehicle-model/"
+    },
+    {
+      "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",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/verification-before-completion/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "preview",
+      "path": "library/skills/verifying-scenes/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/vfx-dissolve/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/vfx-fire/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/vfx-hit-spark/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/vfx-lightning/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/vfx-magic-glow/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/vfx-muzzle-flash/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/vfx-smoke/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/vfx-water-ripple/"
+    },
+    {
+      "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\".",
+      "clients": "all",
+      "recommended": true,
+      "status": "stable",
+      "path": "library/skills/voice-line/"
+    },
+    {
+      "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.",
+      "clients": "all",
+      "recommended": true,
+      "status": "preview",
+      "path": "library/skills/world-building-3d/"
+    },
+    {
+      "id": "skill/writing-plans",
+      "name": "writing-plans",
+      "description": "Use when you have a spec or requirements for a multi-step task, before touching code",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/writing-plans/"
+    },
+    {
+      "id": "skill/writing-skills",
+      "name": "writing-skills",
+      "description": "Use when creating new skills, editing existing skills, or verifying skills work before deployment",
+      "clients": "all",
+      "recommended": false,
+      "status": "stable",
+      "path": "library/skills/writing-skills/"
+    }
+  ]
+}