summer-engine 2.0.0 → 2.3.0

package/skills/asset-pipeline/asset-strategy/SKILL.md

@@ -1,243 +1,133 @@
 ---
 name: asset-strategy
-description: Use when planning asset creation, picking an asset pipeline, or writing image-to-3D prompts — decision guide for whether to generate 3D, search the library, generate AI textures, or use primitives. Includes prompt templates for the AI image-to-3D pipeline. Trigger on "assets", "3D models", "textures", "art pipeline", "make a model", "generate asset".
+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.
 license: MIT
 compatibility: [Cursor, Claude Code, Windsurf, Codex]
 category: asset-pipeline
 user-invocable: false
-allowed-tools: Read Grep summer_search_assets summer_import_asset summer_generate_image summer_generate_3d summer_generate_audio summer_import_from_url
+allowed-tools: Read Grep Skill summer_search_assets
 ---
 
-# Asset Strategy for Summer Engine
+# Asset Strategy — Meta-Router for Asset Creation
 
-How to create different types of game assets. Pick the right pipeline for each asset type.
+Classify the user's request, ask at most one clarifying question, then dispatch to the right specialist via the `Skill` tool. Don't generate anything yourself — every media-type/asset-class combination has a dedicated specialist that owns the prompt patterns, polycount targets, gates, and fallbacks. Your job is the routing decision, not the work.
+
+## Step 1 — Classify by media type
 
----
-
-## Decision Tree
-
-| Asset type | Pipeline | Why |
-|-----------|----------|-----|
-| Props (sword, barrel, chair, crate) | Image-to-3D | Best quality for isolated objects |
-| Characters (player, NPC, enemy) | Image-to-3D (mannequin ref) | T-pose reference preserves proportions |
-| Organic (trees, rocks, mushrooms) | Image-to-3D | Handles complex shapes well |
-| Vehicles (car, spaceship, boat) | Image-to-3D | Good for hard-surface objects |
-| Walls / floors / ceilings | Texture + BoxMesh/CSGBox | Tiled textures on simple geometry |
-| Terrain / ground | Texture + PlaneMesh | Tileable ground textures |
-| Buildings / structures | Texture + CSG or modular kit | Combine primitive shapes with textures |
-| UI elements / icons / HUD | 2D image only | No 3D conversion needed |
-| Sprites (2D games) | 2D image only | Direct use as Sprite2D texture |
-| Skyboxes / backgrounds | Panoramic image gen | Environment, not mesh |
-| Particles / VFX | Built in engine | GPUParticles3D, no generation |
-| Audio / music / SFX | summer_generate_audio | Separate pipeline |
-
----
-
-## Pipeline 1: Image-to-3D (Props, Characters, Organic)
-
-### How it works
-
-1. A reference template image (mannequin on white bg) is stored server-side
-2. nano-banana-2 img2img replaces the mannequin with the desired asset
-3. The result is a clean, 3D-ready reference image
-4. That image feeds into Hunyuan 3D (default) or Trellis 2 for 3D conversion
-5. You get a 3D model back
-
-Available 3D models:
-- **hunyuan** (default) — Hunyuan 3D v3.1 Pro, highest quality
-- **trellis** — Trellis 2, fast and detailed
-- **meshy** — Legacy option
-
-From the CLI, the reference image step is invisible. Just call:
-
-```
-summer_generate_3d(prompt="a treasure chest with gold coins")
-```
-
-The server generates the reference image and feeds it to 3D automatically.
-
-To pick a specific model:
-
-```
-summer_generate_3d(prompt="a treasure chest", model="trellis")
-```
-
-For manual control (you want to see/approve the reference image first):
-
-```
-summer_generate_image(prompt="a treasure chest with gold coins, game asset, white background, stylized, not ultra realistic")
-# Review the image with Read tool
-summer_generate_3d(kind="image-to-3d", imageUrl="<fileUrl from above>")
-```
-
-### Prompt template for 3D reference images
-
-When generating images intended for 3D conversion, use this suffix:
-
-```
-[your asset description]. Game asset, centered in frame, 3D model render style, 
-stylized game art, not ultra realistic, clean white background, soft studio 
-lighting. Isolated object ready for 3D mesh generation.
-```
-
-Examples:
-
-**Weapon:**
-```
-A medieval broadsword with ornate crossguard and leather-wrapped grip. Game asset, 
-centered in frame, 3D model render style, stylized game art, not ultra realistic, 
-clean white background, soft studio lighting. Isolated object ready for 3D mesh 
-generation.
-```
-
-**Character:**
-```
-A fantasy knight in full plate armor, red cape, detailed pauldrons. T-pose, 
-front-facing. Game character asset, 3D model render style, stylized game art, 
-not ultra realistic, clean white background, soft studio lighting. Ready for 
-3D mesh generation.
-```
-
-**Organic prop:**
-```
-Cluster of bioluminescent mushrooms growing from a small mossy rock base. Pale 
-green glow, translucent caps, alien organic shapes. Game asset, centered in frame, 
-3D model render style, stylized game art, not ultra realistic, clean white 
-background, soft studio lighting. Isolated object ready for 3D mesh generation.
-```
-
-**Vehicle:**
-```
-A rusted sci-fi hover bike with exposed engine parts and worn paint. Game asset, 
-centered in frame, 3D model render style, stylized game art, not ultra realistic, 
-clean white background, soft studio lighting. Isolated vehicle ready for 3D mesh 
-generation.
-```
+| Signal in user request | Continue at |
+|---|---|
+| image, art, concept, portrait, icon, sprite, texture, skybox, HUD | 2D table |
+| model, mesh, 3D, prop, character, rigged, vehicle, tree, level kit | 3D table |
+| sound, SFX, music, ambient, voice, VO | Audio table |
+| cutscene, trailer, loop video, animated background | Video table |
+| animation, idle, walk, attack, retarget, blend tree, IK, lipsync | Animation table |
+| fire, muzzle flash, smoke, lightning, shake, hit-stop, particles | VFX table |
 
-### What makes a BAD 3D reference
+If the request spans rows ("a witch with idle and a fire spell"), classify the **first** asset and dispatch — the specialist hands off when it's done.
 
-Avoid these in prompts:
-- Scene context ("sword lying on a table") -- the table becomes part of the mesh
-- Strong directional shadows -- baked into the mesh as geometry
-- Ultra-realistic rendering -- too much detail for game-ready meshes
-- Flat 2D angles (pure front/side view) -- 3D gen needs depth cues
-- Multiple objects ("a sword and a shield") -- generates as one fused mesh
-- Busy backgrounds -- bleeds into the model
+## Step 2 — Disambiguate (one question max)
+
+Ask the **exact phrase** before dispatching. Skipping the question is the most common routing mistake.
 
-### Polycount guidance
+| Ambiguity | Disambiguation question (verbatim) | Routes |
+|---|---|---|
+| Concept art vs character portrait | "Quick check — exploring the look (3-4 variants for art direction) or generating a final character portrait for dialogue UI?" | `summer:2d-assets/concept-art` (exploring) / `summer:2d-assets/character-portrait` (final) |
+| Prop vs character model | "Static object (sword, chair, lantern) or rigged character that needs animation?" | `summer:3d-assets/prop-model` / `summer:3d-assets/character-model` |
+| Tile vs sprite sheet | "One seamless tile that repeats, or a frame grid for an animated sprite?" | `summer:2d-assets/tileable-texture` / `summer:2d-assets/sprite-sheet` |
+| SFX vs music | "One-shot effect or a longer track (loop, theme, ambient bed)?" | `summer:audio/sound-effect` / `summer:audio/music-track` (or `audio/ambient-bed`) |
+| Generate vs retarget motion | "Generate a new clip on this character, or apply an existing library to a new character?" | `summer:animation/generate-motion` / `summer:animation/retarget` |
+| VFX recipe vs game-feel | "Particle/shader effect in the world or screen-feel (camera shake, hit-stop)?" | `summer:visual-effects/recipes/<name>` / `summer:visual-effects/game-feel` |
 
-Pass in options when quality matters:
+## Step 3 — Dispatch
 
-```
-summer_generate_3d(prompt="...", options={ target_polycount: 5000 })
-```
+Invoke the specialist via the `Skill` tool. Don't paraphrase — let it run. Pass the user's original phrasing through.
 
-Rough targets:
-- Mobile games: 1k-3k tris
-- Indie/stylized PC: 3k-10k tris
-- Detailed hero assets: 10k-30k tris
-- Cinematics/showcase: 30k-100k tris
-
-Default if not specified: provider decides (usually 10k-30k range).
+## Routing tables
 
----
-
-## Pipeline 2: Textures + Geometry (Walls, Floors, Structures)
-
-For flat surfaces and repeating structures, don't generate 3D models. Generate textures and apply them to simple geometry.
-
-### Walls
-
-```
-summer_generate_image(prompt="seamless brick wall texture, tileable, game texture, diffuse map")
-summer_import_from_url(url="<fileUrl>", path="res://assets/textures/brick_wall.png")
-```
-
-Then in the scene:
-```
-summer_add_node(parent="./Level", type="CSGBox3D", name="Wall")
-summer_set_prop(path="./Level/Wall", key="size", value="Vector3(10, 3, 0.3)")
-summer_set_prop(path="./Level/Wall", key="position", value="Vector3(0, 1.5, -5)")
-```
-
-Attach material with texture via script or manual setup.
-
-### Floors / ground
-
-```
-summer_generate_image(prompt="seamless grass ground texture, top-down, tileable, game texture")
-```
-
-Apply to PlaneMesh or CSGBox3D scaled flat.
-
-### Modular building kit
+### 2D assets
 
-For buildings, combine CSG shapes:
-- CSGBox3D for walls
-- CSGBox3D for floors/ceilings
-- CSGCylinder3D for pillars
-- CSGPolygon3D for custom shapes
+| Request | Skill |
+|---|---|
+| Concept / mood board / variants | `summer:2d-assets/concept-art` |
+| Polished portrait / NPC bust | `summer:2d-assets/character-portrait` |
+| Pixel sprite / retro icon | `summer:2d-assets/pixel-art` |
+| HUD / button / inventory frame | `summer:2d-assets/ui-graphics` |
+| Wall / floor / seamless ground | `summer:2d-assets/tileable-texture` |
+| Run cycle / spritesheet grid | `summer:2d-assets/sprite-sheet` |
+| 360 sky / panoramic background | `summer:2d-assets/skybox-panorama` |
 
-Generate different textures for each material:
-- Wall texture (brick, stone, wood)
-- Floor texture (tile, wood planks, concrete)
-- Roof texture (shingles, metal)
+### 3D assets
 
-### Texture prompt tips
+| Request | Skill |
+|---|---|
+| Sword / chair / barrel / static object | `summer:3d-assets/prop-model` |
+| Player / NPC / enemy / boss / rigged humanoid | `summer:3d-assets/character-model` (canonical Meshy auto-rig) |
+| Modular dungeon / building blocks | `summer:3d-assets/environment-kit` |
+| Car / spaceship / hard-surface vehicle | `summer:3d-assets/vehicle-model` |
+| Tree / rock / mushroom / foliage | `summer:3d-assets/organic-model` |
 
-For tileable textures, always include:
-```
-[material description], seamless, tileable, game texture, diffuse map, 
-top-down view, uniform lighting, no perspective
-```
+Polycount targets (hero 8k–15k, grunt 3k–6k, mobile 1k–3k, cinematic 20k–40k) live in each specialist.
 
----
-
-## Pipeline 3: 2D Only (UI, Sprites, Icons)
-
-For 2D game assets and UI elements:
+### Audio
 
-```
-summer_generate_image(prompt="pixel art heart icon, 64x64, red, game UI element", 
-  style="pixel")
-```
+| Request | Skill |
+|---|---|
+| Sword clash / footstep / UI click | `summer:audio/sound-effect` |
+| Theme / level music / boss track | `summer:audio/music-track` |
+| Forest ambience / cave drone | `summer:audio/ambient-bed` |
+| NPC line / VO / spoken dialogue | `summer:audio/voice-line` |
+| Music that reacts to combat | `summer:audio/adaptive-music` |
+| What should this game sound like | `summer:audio/audio-direction` |
 
-For sprite sheets, consider the sprite animation tools (separate from this pipeline).
+### Animation
 
-### UI prompt tips
-
-```
-[element description], flat design, clean edges, game UI style, 
-transparent background preferred, [size]px
-```
-
----
-
-## Pipeline 4: Audio
-
-Separate from visual assets. See summer_generate_audio tool:
-
-```
-summer_generate_audio(capability="sound_effects", text="metal sword clash impact")
-summer_generate_audio(capability="music", prompt="ambient fantasy forest theme", durationSeconds=60)
-summer_generate_audio(capability="text_to_speech", text="You shall not pass!", voiceId="<id>")
-```
-
----
+| Request | Skill |
+|---|---|
+| Idle / walk / run / attack — new clip | `summer:animation/generate-motion` |
+| Apply library to a different character | `summer:animation/retarget` |
+| Blend tree / state machine | `summer:animation/animation-tree` |
+| Look-at / IK / foot placement | `summer:animation/procedural-animation` |
+| Lipsync / facial blendshapes | `summer:animation/facial-and-lipsync` |
 
-## Edge Cases (add to this list as they come up)
+### Video
 
-- **Transparent/glass objects**: Add "translucent material, see-through" to prompt. 3D gen may struggle -- consider using engine materials instead.
-- **Animated objects**: Generate static mesh first, animate in engine with AnimationPlayer.
-- **Multi-part objects**: Generate each part separately, assemble in scene tree.
-- **Extremely thin objects** (paper, cloth, flags): 3D gen produces thick meshes. Better to use MeshInstance3D with a plane + texture + shader.
-- **Emissive/glowing objects**: Generate the mesh, add emissive material in engine. Don't rely on the glow being in the mesh.
-- **LOD (Level of Detail)**: Generate one version. If perf needs LOD, use Godot's LOD system or generate a second low-poly version.
+| Request | Skill |
+|---|---|
+| Intro cutscene / story sequence | `summer:video/cinematic-cutscene` |
+| Steam trailer / marketing clip | `summer:video/trailer-shot` |
+| Animated menu background / loop | `summer:video/animated-loop` |
 
-## Fallback
+### Visual effects
 
-No fallback for this — Summer MCP required for the generation pipelines (`summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_search_assets`, `summer_import_from_url`). If MCP isn't connected, the user must source assets externally (Sketchfab, Quaternius, Kenney, AmbientCG) and import via Godot's import system.
+VFX is **code, not generative** — recipes are shader + GDScript + node setup, not image generation.
 
-## Collaborative protocol
+| Request | Skill |
+|---|---|
+| Fire / torch / campfire | `summer:visual-effects/recipes/fire` |
+| Muzzle flash / gunshot | `summer:visual-effects/recipes/muzzle-flash` |
+| Water ripple / splash | `summer:visual-effects/recipes/water-ripple` |
+| Lightning / electric arc | `summer:visual-effects/recipes/lightning` |
+| Dissolve / disintegrate | `summer:visual-effects/recipes/dissolve` |
+| Smoke / dust puff | `summer:visual-effects/recipes/smoke` |
+| Hit spark / impact flash | `summer:visual-effects/recipes/hit-spark` |
+| Magic glow / aura | `summer:visual-effects/recipes/magic-glow` |
+| Camera shake / hit-stop | `summer:visual-effects/game-feel` |
+
+## When NOT to use this skill
+
+- The user already named the specific skill — go straight there.
+- The user is debugging or running the game — route to `summer:debug` or `summer:play`.
+- The asset is being imported, not generated (existing `.glb` / `.wav` from Sketchfab, Quaternius, AmbientCG) — call `summer_import_from_url` directly.
+- The user wants to plan the whole game's asset list — `summer:brainstorm-game` first, then this router on each item.
+
+## Anti-patterns
 
-This skill triggers metered generation (image / 3D / audio) and mutates the scene with imported assets. Always ask before generating ("May I generate a 3D treasure chest via image-to-3D? This is one metered generation.") and before importing ("May I import the result to `res://assets/models/chest.glb`?"). See `../../_shared/collaborative-protocol.md`.
+- **Generating yourself instead of dispatching.** This file holds zero prompt patterns by design. If you're writing a `summer_generate_image` call from here, stop and invoke the specialist.
+- **Skipping the disambiguation question.** Sends users to the wrong specialist and burns a paid generation. The verbatim phrasing in Step 2 is required.
+- **Routing concept-art to character-portrait** (or the reverse). Different goals: concept-art produces 4 divergent variants for art direction; character-portrait produces 1 polished bust for dialogue UI.
+- **Inventing skill names.** Only dispatch to skills listed above. If nothing fits, ask the user to clarify.
+- **Routing rigged-humanoid requests to `prop-model`.** Anything that needs animation always goes to `summer:3d-assets/character-model`.
+
+## Fallback (no MCP)
+
+The router still works without MCP — classification is text-only. It hands off to the specialist, which surfaces its own no-MCP fallback (typically: run the equivalent generation via the Summer dashboard / Meshy / nano-banana web, then `summer_import_from_url` once MCP is back).