summer-engine 2.0.0 → 2.2.0

package/dist/lib/skills-registry.d.ts

@@ -1,6 +1,6 @@
 export declare const AGENT_CLIENTS: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
 export type AgentClient = (typeof AGENT_CLIENTS)[number];
-export declare const SKILL_CATEGORIES: readonly ["_meta", "character-controllers", "gameplay-mechanics", "scripting-patterns", "scene-and-project", "rendering-and-lighting", "shaders", "visual-effects", "post-processing", "animation", "audio", "physics", "multiplayer-and-networking", "ai-and-npcs", "level-design", "performance", "ui-and-ux", "asset-pipeline", "input-and-controls", "debugging", "deployment"];
+export declare const SKILL_CATEGORIES: readonly ["_meta", "2d-assets", "3d-assets", "video", "character-controllers", "gameplay-mechanics", "scripting-patterns", "scene-and-project", "rendering-and-lighting", "shaders", "visual-effects", "post-processing", "animation", "audio", "physics", "multiplayer-and-networking", "ai-and-npcs", "level-design", "performance", "ui-and-ux", "asset-pipeline", "input-and-controls", "debugging", "deployment"];
 export type SkillCategory = (typeof SKILL_CATEGORIES)[number];
 export interface SkillRegistryEntry {
     name: string;
@@ -145,7 +145,7 @@ export declare const SKILL_REGISTRY: readonly [{
     readonly requiresMcpTools: readonly ["summer_get_project_context", "summer_get_scene_tree", "summer_inspect_node", "summer_add_node", "summer_project_setting", "summer_generate_audio"];
     readonly testScenario: "Define audio direction (music + SFX vocabulary + dynamic plan) for a cozy farming sim; write .summer/audio-bible.md and configure the audio bus layout.";
 }, {
-    readonly name: "vfx";
+    readonly name: "game-feel";
     readonly category: "visual-effects";
     readonly public: true;
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
@@ -200,4 +200,268 @@ export declare const SKILL_REGISTRY: readonly [{
     readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_get_scene_tree", "summer_inspect_node", "summer_project_setting", "summer_get_console", "summer_get_diagnostics"];
     readonly testScenario: "Run the Steam pre-flight checklist (Windows + Mac + Linux), validate icons/banners/screenshots/build config, and produce a release build only when green.";
+}, {
+    readonly name: "concept-art";
+    readonly category: "2d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_search_assets", "summer_import_from_url"];
+    readonly testScenario: "User asks for 'concept art for the protagonist' — skill produces 3-4 variant prompts on a locked style anchor and writes prompts to art/concept/_prompts.md as fallback when MCP unavailable.";
+}, {
+    readonly name: "character-portrait";
+    readonly category: "2d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_search_assets", "summer_import_from_url"];
+    readonly testScenario: "User asks for a 'final portrait of the queen for dialogue UI' — skill locks composition, generates one polished bust against a locked anchor, imports as res://art/portraits/queen.png.";
+}, {
+    readonly name: "pixel-art";
+    readonly category: "2d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_search_assets", "summer_import_from_url"];
+    readonly testScenario: "User requests a '64x64 pixel art heart icon' — skill generates with style: 'pixel', enforces nearest-neighbor texture filter project setting, imports to res://art/sprites/.";
+}, {
+    readonly name: "ui-graphics";
+    readonly category: "2d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for an inventory grid icon set — skill generates flat-design transparent PNGs, sets up AtlasTexture import, wires into TextureRect / NinePatchRect.";
+}, {
+    readonly name: "tileable-texture";
+    readonly category: "2d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_import_from_url", "summer_set_resource_property"];
+    readonly testScenario: "User asks for a 'seamless brick wall texture' — skill generates with seamless prompt suffix, applies to PlaneMesh + StandardMaterial3D with uv1_scale tiled.";
+}, {
+    readonly name: "sprite-sheet";
+    readonly category: "2d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_import_from_url", "summer_set_resource_property", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User requests a '4-frame walk cycle for the goblin' — skill generates per-frame at locked anchor, builds SpriteFrames resource, wires AnimatedSprite2D.";
+}, {
+    readonly name: "skybox-panorama";
+    readonly category: "2d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_import_from_url", "summer_set_resource_property"];
+    readonly testScenario: "User asks for a 'sunset desert skybox' — skill generates equirectangular 2:1 panorama, wires PanoramaSkyMaterial on WorldEnvironment.";
+}, {
+    readonly name: "prop-model";
+    readonly category: "3d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_3d", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'a treasure chest' — skill calls summer_generate_3d via image-to-3d pipeline with white-background prompt suffix, imports as MeshInstance3D.";
+}, {
+    readonly name: "character-model";
+    readonly category: "3d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_image", "summer_generate_3d", "summer_generate_motion", "summer_search_assets", "summer_inspect_resource", "summer_add_node", "summer_set_prop", "summer_save_scene"];
+    readonly testScenario: "User asks for 'a knight character' — skill produces T-pose ref via image, gates rig pass on user approval, imports rigged glb, wires CharacterBody3D + Skeleton3D, hands off to animation/generate-motion.";
+}, {
+    readonly name: "environment-kit";
+    readonly category: "3d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_3d", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop", "summer_save_scene"];
+    readonly testScenario: "User asks for 'a dungeon kit' — skill locks style anchor, generates 5-10 modular pieces with consistent prompt suffix, imports on snap-grid.";
+}, {
+    readonly name: "vehicle-model";
+    readonly category: "3d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_3d", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'a sci-fi hover bike' — skill provides multi-angle reference, generates with hard-surface model preference, recommends texture pass for panel detail.";
+}, {
+    readonly name: "organic-model";
+    readonly category: "3d-assets";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_3d", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'a glowing mushroom cluster' — skill generates organic shape via summer_generate_3d, imports with emission material, suggests MultiMeshInstance3D for forest fill.";
+}, {
+    readonly name: "generate-motion";
+    readonly category: "animation";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_motion", "summer_check_job", "summer_search_assets", "summer_inspect_resource", "summer_get_scene_tree", "summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_save_scene"];
+    readonly testScenario: "User asks for 'a walk animation on the goblin' — skill verifies the rigged target, picks meshy-library backend for standard 'walk', wires the clip into AnimationPlayer.";
+}, {
+    readonly name: "retarget";
+    readonly category: "animation";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_motion", "summer_search_assets", "summer_inspect_resource", "summer_set_resource_property", "summer_save_scene"];
+    readonly testScenario: "User asks to 'apply the goblin's walk to the orc' — skill identifies the source clip, retargets to the orc skeleton via SkeletonProfile, wires into the orc's AnimationPlayer.";
+}, {
+    readonly name: "animation-tree";
+    readonly category: "animation";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_get_scene_tree", "summer_inspect_node", "summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_save_scene"];
+    readonly testScenario: "User has idle/walk/run clips — skill builds an AnimationTree with a BlendSpace1D driven by speed, wires the BlendTree to the player controller.";
+}, {
+    readonly name: "procedural-animation";
+    readonly category: "animation";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_get_scene_tree", "summer_inspect_node", "summer_add_node", "summer_set_prop", "summer_save_scene"];
+    readonly testScenario: "User asks for 'foot IK so the character doesn't sink into stairs' — skill adds SkeletonModification3DLookAt + raycasting on each foot, wires into the character's Skeleton3D.";
+}, {
+    readonly name: "facial-and-lipsync";
+    readonly category: "animation";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_inspect_resource", "summer_set_resource_property", "summer_save_scene", "summer_generate_audio"];
+    readonly testScenario: "User has a voice line and wants the character to lip-sync to it — skill generates phoneme markers, builds blend-shape animation track on the character's MeshInstance3D.";
+}, {
+    readonly name: "sound-effect";
+    readonly category: "audio";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_audio", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'a sword swing sound' — skill reads audio bible, builds ElevenLabs SFX prompt with material+action+intensity, wires AudioStreamPlayer3D on the SFX bus.";
+}, {
+    readonly name: "music-track";
+    readonly category: "audio";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_audio", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'ambient forest theme music for level 1' — skill generates 60s loop via ElevenLabs music, imports with loop enabled, wires AudioStreamPlayer on Music bus.";
+}, {
+    readonly name: "ambient-bed";
+    readonly category: "audio";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_audio", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'rain on tin roof ambience' — skill generates loop-clean ambience, sets up positional or non-positional player on Ambient bus.";
+}, {
+    readonly name: "voice-line";
+    readonly category: "audio";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_audio", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'the king says: you have served me well' — skill picks a voice ID matching character traits, generates TTS, wires to character's mouth via AudioStreamPlayer3D.";
+}, {
+    readonly name: "adaptive-music";
+    readonly category: "audio";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_audio", "summer_search_assets", "summer_inspect_node", "summer_add_node", "summer_set_prop", "summer_set_resource_property"];
+    readonly testScenario: "User wants combat music that swells when enemies are nearby — skill generates layered stems (calm, tension, combat), wires AudioStreamPlaybackInteractive with combat-state listener.";
+}, {
+    readonly name: "cinematic-cutscene";
+    readonly category: "video";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_generate_video", "summer_generate_image", "summer_generate_audio", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'an opening cutscene where the hero arrives at the castle' — skill builds reference image, generates 5-10s shot via image-to-video, wires VideoStreamPlayer in cutscene scene.";
+}, {
+    readonly name: "trailer-shot";
+    readonly category: "video";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_video", "summer_generate_image", "summer_search_assets", "summer_import_from_url"];
+    readonly testScenario: "User asks for 'a hero shot of the boss for the trailer' — skill picks kling for premium quality, generates 5s low-angle dramatic shot, exports to assets/trailer/.";
+}, {
+    readonly name: "animated-loop";
+    readonly category: "video";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_generate_video", "summer_search_assets", "summer_import_from_url", "summer_add_node", "summer_set_prop"];
+    readonly testScenario: "User asks for 'a looping fire backdrop for the title screen' — skill generates 3-5s loop-clean clip via ltx, wires VideoStreamPlayer with autoplay+loop in title scene.";
+}, {
+    readonly name: "fire";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene"];
+    readonly testScenario: "User asks for 'a torch flame' — skill creates GPUParticles3D with custom shader, writes addons/vfx/fire/{fire.gdshader, fire_controller.gd}, wires to scene.";
+}, {
+    readonly name: "muzzle-flash";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene"];
+    readonly testScenario: "User asks for 'a muzzle flash on the rifle' — skill creates one-shot GPUParticles3D with star-burst shader, wires restart() on weapon-fire signal.";
+}, {
+    readonly name: "water-ripple";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene"];
+    readonly testScenario: "User wants 'water ripples when objects splash' — skill creates MeshInstance3D plane with custom water shader, exposes add_ripple(position) API.";
+}, {
+    readonly name: "lightning";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene", "summer_connect_signal"];
+    readonly testScenario: "User wants 'a lightning strike VFX' — skill builds ImmediateMesh-based jagged-segment renderer with shader, calls CameraShake.add_trauma(0.6) on cast.";
+}, {
+    readonly name: "dissolve";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene"];
+    readonly testScenario: "User wants 'an enemy that dissolves on death' — skill writes dissolve.gdshader override + dissolve_object(target, duration) controller, animates threshold uniform.";
+}, {
+    readonly name: "smoke";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene"];
+    readonly testScenario: "User wants 'smoke from a burning torch' — skill creates GPUParticles3D + smoke shader using shared FBM noise, wires wind direction parameter.";
+}, {
+    readonly name: "hit-spark";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene"];
+    readonly testScenario: "User wants 'sparks when a sword hits metal' — skill spawns one-shot GPUParticles3D with additive billboard material, orients to surface normal.";
+}, {
+    readonly name: "magic-glow";
+    readonly category: "visual-effects";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: false;
+    readonly requiresMcpTools: readonly ["summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_inspect_node", "summer_save_scene"];
+    readonly testScenario: "User wants 'a magical glow on a rune' — skill creates OmniLight3D with pulse-on-sin script + GPUParticles3D motes, uses additive billboard material from building blocks.";
 }];