summer-engine 1.2.1 → 1.3.0

package/skills/_tests/specs/ui-basics.md

@@ -0,0 +1,19 @@
+# Skill Spec: /ui-basics
+
+> Stub spec. Expand with Happy / Failure / Edge cases. See `fps-controller.md` for the canonical format.
+
+## Fixture
+
+- TBD
+
+## Case 1: Happy Path
+
+**Input:** "<typical user prompt>"
+
+**Expected MCP tool sequence (in order):**
+
+1. TBD
+
+**Assertions:**
+
+- [ ] TBD

package/skills/{asset-strategy → asset-pipeline/asset-strategy}/SKILL.md

@@ -1,11 +1,10 @@
 ---
 name: asset-strategy
-description: Decision guide for how to create different game asset types. Use when deciding whether to generate 3D models, textures, or use primitives. Includes prompt templates for AI image-to-3D pipeline.
+description: Decision guide for how to create different game asset types — generated 3D, library search, AI textures, or primitives. Use when planning asset creation, picking an asset pipeline, or writing image-to-3D prompts. Trigger on "assets", "3D models", "textures", "art pipeline".
 license: MIT
-compatibility:
-  - Cursor
-  - Claude Code
-  - Windsurf
+compatibility: [Cursor, Claude Code, Windsurf, Codex]
+category: asset-pipeline
+allowed-tools: Read Grep summer_search_assets summer_import_asset summer_generate_image summer_generate_3d summer_generate_audio summer_import_from_url
 ---
 
 # Asset Strategy for Summer Engine

package/skills/catalog.yaml

@@ -0,0 +1,636 @@
+# Summer Skill Library Catalog
+# Canonical registry of every skill. Source of truth for `summer skills list` and `summer skills install`.
+# Status: HAVE = ships today, NEXT = next wave, LATER = roadmap.
+# When adding/changing a skill, update this file in the same commit.
+
+version: 1
+generated: 2026-05-05
+
+skills:
+  # ── character-controllers ──
+  - name: fps-controller
+    category: character-controllers
+    status: HAVE
+    template-id: template-3d-fps
+    public: true
+    recommended: true
+    last-tested: 2026-05-05
+  - name: tps-controller
+    category: character-controllers
+    status: NEXT
+    template-id: template-3d-tps
+    public: true
+    recommended: false
+  - name: platformer-2d
+    category: character-controllers
+    status: NEXT
+    template-id: template-2d-platformer
+    public: true
+    recommended: false
+  - name: platformer-3d
+    category: character-controllers
+    status: NEXT
+    template-id: template-3d-platformer
+    public: true
+    recommended: false
+  - name: top-down-2d
+    category: character-controllers
+    status: NEXT
+    public: true
+    recommended: false
+  - name: vehicle-arcade
+    category: character-controllers
+    status: LATER
+    public: true
+  - name: flying-and-swimming
+    category: character-controllers
+    status: LATER
+    public: true
+
+  # ── gameplay-mechanics ──
+  - name: melee-combat
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: ranged-projectile-combat
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: hitboxes-and-hurtboxes
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: damage-numbers
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: inventory-system
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: dialogue-system
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: save-load
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: interaction-prompts
+    category: gameplay-mechanics
+    status: NEXT
+    public: true
+  - name: crafting-system
+    category: gameplay-mechanics
+    status: LATER
+    public: true
+  - name: quest-system
+    category: gameplay-mechanics
+    status: LATER
+    public: true
+  - name: progression-and-skill-trees
+    category: gameplay-mechanics
+    status: LATER
+    public: true
+  - name: economy-currency
+    category: gameplay-mechanics
+    status: LATER
+    public: true
+
+  # ── scripting-patterns ──
+  - name: gdscript-patterns
+    category: scripting-patterns
+    status: HAVE
+    public: true
+    recommended: true
+    last-tested: 2026-05-05
+  - name: signal-patterns
+    category: scripting-patterns
+    status: NEXT
+    public: true
+    recommended: false
+  - name: state-machine-patterns
+    category: scripting-patterns
+    status: NEXT
+    public: true
+    recommended: false
+  - name: autoloads-and-singletons
+    category: scripting-patterns
+    status: NEXT
+    public: true
+  - name: error-recovery
+    category: scripting-patterns
+    status: NEXT
+    public: true
+  - name: gdextension-cpp-bindings
+    category: scripting-patterns
+    status: LATER
+    public: true
+  - name: godot-csharp-interop
+    category: scripting-patterns
+    status: LATER
+    public: true
+
+  # ── scene-and-project ──
+  - name: scene-composition
+    category: scene-and-project
+    status: HAVE
+    public: true
+    recommended: true
+    last-tested: 2026-05-05
+  - name: make-game
+    category: scene-and-project
+    status: HAVE
+    public: true
+    recommended: false
+    last-tested: 2026-05-05
+  - name: godot-project-conventions
+    category: scene-and-project
+    status: NEXT
+    public: true
+  - name: summer-mcp-bootstrap
+    category: scene-and-project
+    status: NEXT
+    public: true
+  - name: git-lfs-for-games
+    category: scene-and-project
+    status: NEXT
+    public: true
+  - name: scene-instancing-patterns
+    category: scene-and-project
+    status: NEXT
+    public: true
+  - name: level-streaming
+    category: scene-and-project
+    status: LATER
+    public: true
+  - name: nested-scenes
+    category: scene-and-project
+    status: LATER
+    public: true
+
+  # ── rendering-and-lighting ──
+  - name: 3d-lighting
+    category: rendering-and-lighting
+    status: HAVE
+    public: true
+    recommended: true
+    last-tested: 2026-05-05
+  - name: pbr-materials
+    category: rendering-and-lighting
+    status: NEXT
+    public: true
+  - name: world-environment-and-sky
+    category: rendering-and-lighting
+    status: NEXT
+    public: true
+  - name: baked-vs-realtime-lighting
+    category: rendering-and-lighting
+    status: NEXT
+    public: true
+  - name: volumetric-fog
+    category: rendering-and-lighting
+    status: LATER
+    public: true
+  - name: ssr-glass-water
+    category: rendering-and-lighting
+    status: LATER
+    public: true
+  - name: light-probes
+    category: rendering-and-lighting
+    status: LATER
+    public: true
+  - name: gi-sdfgi
+    category: rendering-and-lighting
+    status: LATER
+    public: true
+
+  # ── shaders ──
+  - name: shader-basics
+    category: shaders
+    status: NEXT
+    public: true
+  - name: surface-shaders
+    category: shaders
+    status: NEXT
+    public: true
+  - name: screen-space-effects
+    category: shaders
+    status: NEXT
+    public: true
+  - name: fresnel-and-rim-light
+    category: shaders
+    status: NEXT
+    public: true
+  - name: dissolve-effect
+    category: shaders
+    status: NEXT
+    public: true
+  - name: water-shader
+    category: shaders
+    status: NEXT
+    public: true
+  - name: outline-shader
+    category: shaders
+    status: NEXT
+    public: true
+  - name: hologram-shader
+    category: shaders
+    status: LATER
+    public: true
+  - name: toon-shading
+    category: shaders
+    status: LATER
+    public: true
+  - name: compute-shaders
+    category: shaders
+    status: LATER
+    public: true
+
+  # ── visual-effects ──
+  - name: gpuparticles-3d-basics
+    category: visual-effects
+    status: NEXT
+    public: true
+  - name: hit-impact-flashes
+    category: visual-effects
+    status: NEXT
+    public: true
+  - name: trail-renderers
+    category: visual-effects
+    status: NEXT
+    public: true
+  - name: muzzle-flashes
+    category: visual-effects
+    status: NEXT
+    public: true
+  - name: explosion-recipes
+    category: visual-effects
+    status: NEXT
+    public: true
+  - name: magic-spell-effects
+    category: visual-effects
+    status: LATER
+    public: true
+  - name: weather-fx
+    category: visual-effects
+    status: LATER
+    public: true
+  - name: decals
+    category: visual-effects
+    status: LATER
+    public: true
+
+  # ── post-processing ──
+  - name: bloom-and-glow
+    category: post-processing
+    status: NEXT
+    public: true
+  - name: color-grading
+    category: post-processing
+    status: NEXT
+    public: true
+  - name: screen-shake
+    category: post-processing
+    status: NEXT
+    public: true
+  - name: camera-effects
+    category: post-processing
+    status: NEXT
+    public: true
+
+  # ── animation ──
+  - name: animation-tree-basics
+    category: animation
+    status: NEXT
+    public: true
+  - name: state-machine-anim
+    category: animation
+    status: NEXT
+    public: true
+  - name: retargeting
+    category: animation
+    status: NEXT
+    public: true
+  - name: procedural-animation-ik
+    category: animation
+    status: LATER
+    public: true
+  - name: root-motion
+    category: animation
+    status: LATER
+    public: true
+  - name: lip-sync
+    category: animation
+    status: LATER
+    public: true
+
+  # ── audio ──
+  - name: audio-bus-setup
+    category: audio
+    status: NEXT
+    public: true
+  - name: 3d-spatial-audio
+    category: audio
+    status: NEXT
+    public: true
+  - name: sfx-pipeline
+    category: audio
+    status: NEXT
+    public: true
+  - name: footstep-systems
+    category: audio
+    status: NEXT
+    public: true
+  - name: dynamic-music-stingers
+    category: audio
+    status: LATER
+    public: true
+  - name: audio-occlusion
+    category: audio
+    status: LATER
+    public: true
+
+  # ── physics ──
+  - name: rigid-bodies
+    category: physics
+    status: NEXT
+    public: true
+  - name: character-physics
+    category: physics
+    status: NEXT
+    public: true
+  - name: area-triggers
+    category: physics
+    status: NEXT
+    public: true
+  - name: raycasting-patterns
+    category: physics
+    status: NEXT
+    public: true
+  - name: shapecasting
+    category: physics
+    status: NEXT
+    public: true
+  - name: joints-and-constraints
+    category: physics
+    status: LATER
+    public: true
+  - name: buoyancy
+    category: physics
+    status: LATER
+    public: true
+  - name: destructible-objects
+    category: physics
+    status: LATER
+    public: true
+
+  # ── multiplayer-and-networking ──
+  - name: multiplayerapi-basics
+    category: multiplayer-and-networking
+    status: NEXT
+    public: true
+  - name: client-server-pattern
+    category: multiplayer-and-networking
+    status: NEXT
+    public: true
+  - name: enet-vs-websocket
+    category: multiplayer-and-networking
+    status: NEXT
+    public: true
+  - name: peer-replication
+    category: multiplayer-and-networking
+    status: NEXT
+    public: true
+  - name: state-sync
+    category: multiplayer-and-networking
+    status: LATER
+    public: true
+  - name: lag-compensation
+    category: multiplayer-and-networking
+    status: LATER
+    public: true
+  - name: lobby-and-matchmaking
+    category: multiplayer-and-networking
+    status: LATER
+    public: true
+
+  # ── ai-and-npcs ──
+  - name: navmesh-pathfinding
+    category: ai-and-npcs
+    status: NEXT
+    public: true
+  - name: behavior-trees
+    category: ai-and-npcs
+    status: NEXT
+    public: true
+  - name: state-machine-npc
+    category: ai-and-npcs
+    status: NEXT
+    public: true
+  - name: llm-driven-dialogue
+    category: ai-and-npcs
+    status: NEXT
+    public: true
+  - name: perception-sight-and-hearing
+    category: ai-and-npcs
+    status: NEXT
+    public: true
+  - name: group-tactics
+    category: ai-and-npcs
+    status: LATER
+    public: true
+  - name: boss-patterns
+    category: ai-and-npcs
+    status: LATER
+    public: true
+
+  # ── level-design ──
+  - name: gridmap-building
+    category: level-design
+    status: NEXT
+    public: true
+  - name: grid-snapping
+    category: level-design
+    status: NEXT
+    public: true
+  - name: modular-environments
+    category: level-design
+    status: LATER
+    public: true
+  - name: procedural-rooms
+    category: level-design
+    status: LATER
+    public: true
+  - name: occlusion-culling-zones
+    category: level-design
+    status: LATER
+    public: true
+  - name: open-world-streaming
+    category: level-design
+    status: LATER
+    public: true
+
+  # ── performance ──
+  - name: profiling-godot
+    category: performance
+    status: NEXT
+    public: true
+  - name: draw-call-batching
+    category: performance
+    status: NEXT
+    public: true
+  - name: gdscript-hotpaths
+    category: performance
+    status: LATER
+    public: true
+  - name: texture-streaming
+    category: performance
+    status: LATER
+    public: true
+  - name: lod-and-culling
+    category: performance
+    status: LATER
+    public: true
+  - name: mobile-optimization
+    category: performance
+    status: LATER
+    public: true
+
+  # ── ui-and-ux ──
+  - name: ui-basics
+    category: ui-and-ux
+    status: HAVE
+    public: true
+    recommended: true
+    last-tested: 2026-05-05
+  - name: control-anchors-and-containers
+    category: ui-and-ux
+    status: NEXT
+    public: true
+  - name: theme-resources
+    category: ui-and-ux
+    status: NEXT
+    public: true
+  - name: main-menu
+    category: ui-and-ux
+    status: NEXT
+    public: true
+  - name: pause-menu
+    category: ui-and-ux
+    status: NEXT
+    public: true
+  - name: hud-patterns
+    category: ui-and-ux
+    status: NEXT
+    public: true
+  - name: inventory-ui
+    category: ui-and-ux
+    status: LATER
+    public: true
+  - name: responsive-ui
+    category: ui-and-ux
+    status: LATER
+    public: true
+  - name: localization-ui
+    category: ui-and-ux
+    status: LATER
+    public: true
+  - name: controller-navigation
+    category: ui-and-ux
+    status: LATER
+    public: true
+
+  # ── asset-pipeline ──
+  - name: asset-strategy
+    category: asset-pipeline
+    status: HAVE
+    public: true
+    recommended: true
+    last-tested: 2026-05-05
+  - name: import-from-url
+    category: asset-pipeline
+    status: NEXT
+    public: true
+  - name: texture-import-pipeline
+    category: asset-pipeline
+    status: NEXT
+    public: true
+  - name: normal-bump-roughness
+    category: asset-pipeline
+    status: NEXT
+    public: true
+  - name: attribution-and-licensing
+    category: asset-pipeline
+    status: NEXT
+    public: true
+  - name: 3d-mesh-cleanup
+    category: asset-pipeline
+    status: LATER
+    public: true
+  - name: trim-sheets
+    category: asset-pipeline
+    status: LATER
+    public: true
+  - name: rigging-from-markers
+    category: asset-pipeline
+    status: LATER
+    public: true
+
+  # ── input-and-controls ──
+  - name: input-map-fundamentals
+    category: input-and-controls
+    status: NEXT
+    public: true
+  - name: gamepad-support
+    category: input-and-controls
+    status: NEXT
+    public: true
+  - name: action-buffering
+    category: input-and-controls
+    status: LATER
+    public: true
+  - name: rebindable-controls
+    category: input-and-controls
+    status: LATER
+    public: true
+  - name: accessibility-input
+    category: input-and-controls
+    status: LATER
+    public: true
+
+  # ── debugging ──
+  - name: debugger-basics
+    category: debugging
+    status: NEXT
+    public: true
+  - name: error-triage-via-summer-mcp
+    category: debugging
+    status: NEXT
+    public: true
+  - name: perf-investigation
+    category: debugging
+    status: LATER
+    public: true
+
+  # ── deployment ──
+  - name: export-presets
+    category: deployment
+    status: NEXT
+    public: true
+  - name: web-html5-export
+    category: deployment
+    status: NEXT
+    public: true
+  - name: steam-uploader
+    category: deployment
+    status: LATER
+    public: true
+  - name: itch-uploader
+    category: deployment
+    status: LATER
+    public: true
+  - name: mobile-export
+    category: deployment
+    status: LATER
+    public: true

package/skills/{fps-controller → character-controllers/fps-controller}/SKILL.md

@@ -1,11 +1,12 @@
 ---
 name: fps-controller
-description: First-person character controller with movement, camera, and physics. Use when building an FPS game, first-person movement, or a 3D character that moves with WASD and looks with mouse.
+description: First-person character controller with WASD movement, mouse look, jumping, and physics. Use when building an FPS, first-person movement, or a 3D character that walks/jumps. Trigger on "FPS", "first-person", "WASD", "character controller", "mouse look".
 license: MIT
-compatibility:
-  - Cursor
-  - Claude Code
-  - Windsurf
+compatibility: [Cursor, Claude Code, Windsurf, Codex]
+category: character-controllers
+template-id: template-3d-fps
+allowed-tools: Read Grep summer_add_node summer_set_prop summer_set_resource_property summer_input_map_bind summer_save_scene summer_get_script_errors
+paths: ["**/*.gd", "**/*.tscn"]
 ---
 
 # FPS Controller for Summer Engine

package/skills/{3d-lighting → rendering-and-lighting/3d-lighting}/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: 3d-lighting
-description: Lighting setup, environment, sky, and shadows for 3D scenes. Use when setting up a 3D scene, adding lights, configuring WorldEnvironment, or adjusting shadows.
+description: Lighting setup, WorldEnvironment, sky, and shadows for 3D scenes. Use when setting up a 3D scene, adding lights, configuring environment, or adjusting shadows. Trigger on "lighting", "shadows", "WorldEnvironment", "sun", "ambient".
 license: MIT
-compatibility:
-  - Cursor
-  - Claude Code
-  - Windsurf
+compatibility: [Cursor, Claude Code, Windsurf, Codex]
+category: rendering-and-lighting
+allowed-tools: Read Grep summer_add_node summer_set_prop summer_set_resource_property summer_save_scene
+paths: ["**/*.tscn", "**/*.tres"]
 ---
 
 # 3D Lighting for Summer Engine