summer-engine 2.0.0 → 2.3.0

package/{marketplace.json → .claude-plugin/marketplace.json}

@@ -1,14 +1,14 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-marketplace.json",
-  "name": "summer",
+  "name": "summer-engine",
   "description": "Summer Engine plugins for Claude Code",
   "owner": { "name": "Summer Engine", "email": "founders@summerengine.com" },
   "plugins": [
     {
       "name": "summer",
       "source": "./",
-      "version": "2.0.0",
-      "description": "Superpowers for AI game dev. 24 auto-trigger skills under summer: namespace, MCP bridge to the local Summer Engine, session-start + pre-commit hooks.",
+      "version": "2.3.0",
+      "description": "Superpowers for AI game dev. 60 auto-trigger skills under summer: namespace, MCP bridge to the local Summer Engine, session-start + pre-commit hooks.",
       "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
       "category": "game-development",
       "tags": ["game-dev", "godot", "ai-game-engine"],

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "summer",
-  "version": "2.0.0",
-  "description": "Superpowers for AI game dev. 24 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
+  "version": "2.3.0",
+  "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -42,7 +42,7 @@
     "./skills/rendering-and-lighting/art-direction/",
     "./skills/rendering-and-lighting/3d-lighting/",
     "./skills/audio/audio-direction/",
-    "./skills/visual-effects/vfx/",
+    "./skills/visual-effects/game-feel/",
     "./skills/performance/tune-performance/",
     "./skills/ai-and-npcs/design-npc/",
     "./skills/multiplayer-and-networking/setup-multiplayer/",
@@ -52,7 +52,40 @@
     "./skills/character-controllers/fps-controller/",
     "./skills/scripting-patterns/gdscript-patterns/",
     "./skills/ui-and-ux/ui-basics/",
-    "./skills/asset-pipeline/asset-strategy/"
+    "./skills/asset-pipeline/asset-strategy/",
+    "./skills/2d-assets/concept-art/",
+    "./skills/2d-assets/character-portrait/",
+    "./skills/2d-assets/pixel-art/",
+    "./skills/2d-assets/ui-graphics/",
+    "./skills/2d-assets/tileable-texture/",
+    "./skills/2d-assets/sprite-sheet/",
+    "./skills/2d-assets/skybox-panorama/",
+    "./skills/3d-assets/prop-model/",
+    "./skills/3d-assets/character-model/",
+    "./skills/3d-assets/environment-kit/",
+    "./skills/3d-assets/vehicle-model/",
+    "./skills/3d-assets/organic-model/",
+    "./skills/animation/generate-motion/",
+    "./skills/animation/retarget/",
+    "./skills/animation/animation-tree/",
+    "./skills/animation/procedural-animation/",
+    "./skills/animation/facial-and-lipsync/",
+    "./skills/audio/sound-effect/",
+    "./skills/audio/music-track/",
+    "./skills/audio/ambient-bed/",
+    "./skills/audio/voice-line/",
+    "./skills/audio/adaptive-music/",
+    "./skills/video/cinematic-cutscene/",
+    "./skills/video/trailer-shot/",
+    "./skills/video/animated-loop/",
+    "./skills/visual-effects/recipes/fire/",
+    "./skills/visual-effects/recipes/muzzle-flash/",
+    "./skills/visual-effects/recipes/water-ripple/",
+    "./skills/visual-effects/recipes/lightning/",
+    "./skills/visual-effects/recipes/dissolve/",
+    "./skills/visual-effects/recipes/smoke/",
+    "./skills/visual-effects/recipes/hit-spark/",
+    "./skills/visual-effects/recipes/magic-glow/"
   ],
   "hooks": "./hooks/hooks.json",
   "mcpServers": "./.mcp.json",

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "summer",
-  "version": "2.0.0",
-  "description": "Superpowers for AI game dev. 24 auto-trigger skills, MCP bridge to the local Summer Engine, lifecycle hooks. Build games by talking.",
+  "version": "2.3.0",
+  "description": "Superpowers for AI game dev. 60 auto-trigger skills, MCP bridge to the local Summer Engine, lifecycle hooks. Build games by talking.",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",
@@ -31,7 +31,7 @@
     "./skills/rendering-and-lighting/art-direction/",
     "./skills/rendering-and-lighting/3d-lighting/",
     "./skills/audio/audio-direction/",
-    "./skills/visual-effects/vfx/",
+    "./skills/visual-effects/game-feel/",
     "./skills/performance/tune-performance/",
     "./skills/ai-and-npcs/design-npc/",
     "./skills/multiplayer-and-networking/setup-multiplayer/",
@@ -41,14 +41,47 @@
     "./skills/character-controllers/fps-controller/",
     "./skills/scripting-patterns/gdscript-patterns/",
     "./skills/ui-and-ux/ui-basics/",
-    "./skills/asset-pipeline/asset-strategy/"
+    "./skills/asset-pipeline/asset-strategy/",
+    "./skills/2d-assets/concept-art/",
+    "./skills/2d-assets/character-portrait/",
+    "./skills/2d-assets/pixel-art/",
+    "./skills/2d-assets/ui-graphics/",
+    "./skills/2d-assets/tileable-texture/",
+    "./skills/2d-assets/sprite-sheet/",
+    "./skills/2d-assets/skybox-panorama/",
+    "./skills/3d-assets/prop-model/",
+    "./skills/3d-assets/character-model/",
+    "./skills/3d-assets/environment-kit/",
+    "./skills/3d-assets/vehicle-model/",
+    "./skills/3d-assets/organic-model/",
+    "./skills/animation/generate-motion/",
+    "./skills/animation/retarget/",
+    "./skills/animation/animation-tree/",
+    "./skills/animation/procedural-animation/",
+    "./skills/animation/facial-and-lipsync/",
+    "./skills/audio/sound-effect/",
+    "./skills/audio/music-track/",
+    "./skills/audio/ambient-bed/",
+    "./skills/audio/voice-line/",
+    "./skills/audio/adaptive-music/",
+    "./skills/video/cinematic-cutscene/",
+    "./skills/video/trailer-shot/",
+    "./skills/video/animated-loop/",
+    "./skills/visual-effects/recipes/fire/",
+    "./skills/visual-effects/recipes/muzzle-flash/",
+    "./skills/visual-effects/recipes/water-ripple/",
+    "./skills/visual-effects/recipes/lightning/",
+    "./skills/visual-effects/recipes/dissolve/",
+    "./skills/visual-effects/recipes/smoke/",
+    "./skills/visual-effects/recipes/hit-spark/",
+    "./skills/visual-effects/recipes/magic-glow/"
   ],
   "mcpServers": "./.mcp.json",
   "hooks": "./hooks/hooks.json",
   "interface": {
     "displayName": "Summer",
     "shortDescription": "Superpowers for AI game dev. Build games by talking.",
-    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine — the AI-native game engine. 24 auto-trigger skills covering brainstorm, design, build, play, debug, ship — plus a using-summer meta-skill that establishes workflow priority on session start. The MCP bridge talks to the local Summer Engine for scene mutation, asset import, render, play, and diagnostics — 37 focused tools across scene/debug/project/asset/generate, with file/git/shell/grep deferred to the host agent. Summer Engine is compatible with Godot 4.5 — write code in GDScript, drive the engine via MCP. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
+    "longDescription": "Summer turns Codex into a game-dev studio for Summer Engine — the AI-native game engine. 60 auto-trigger skills covering brainstorm, design, build, play, debug, ship — plus a using-summer meta-skill that establishes workflow priority on session start. The MCP bridge talks to the local Summer Engine for scene mutation, asset import, render, play, and diagnostics — 38 focused tools across scene/debug/project/asset/generate, with file/git/shell/grep deferred to the host agent. Summer Engine is compatible with Godot 4.5 — write code in GDScript, drive the engine via MCP. Session-start orients the session. Pre-commit doctor (opt-in) blocks bad commits.",
     "developerName": "Summer Engine",
     "category": "Coding",
     "capabilities": ["Interactive", "Read", "Write"],

package/.cursor-plugin/plugin.json

@@ -2,8 +2,8 @@
   "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
   "name": "summer",
   "displayName": "Summer",
-  "version": "2.0.0",
-  "description": "Superpowers for AI game dev. 24 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
+  "version": "2.3.0",
+  "description": "Superpowers for AI game dev. 60 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
   "author": { "name": "Summer Engine", "email": "founders@summerengine.com" },
   "publisher": "summer-engine",
   "homepage": "https://summerengine.com",
@@ -33,7 +33,7 @@
     "./skills/rendering-and-lighting/art-direction/",
     "./skills/rendering-and-lighting/3d-lighting/",
     "./skills/audio/audio-direction/",
-    "./skills/visual-effects/vfx/",
+    "./skills/visual-effects/game-feel/",
     "./skills/performance/tune-performance/",
     "./skills/ai-and-npcs/design-npc/",
     "./skills/multiplayer-and-networking/setup-multiplayer/",
@@ -43,7 +43,40 @@
     "./skills/character-controllers/fps-controller/",
     "./skills/scripting-patterns/gdscript-patterns/",
     "./skills/ui-and-ux/ui-basics/",
-    "./skills/asset-pipeline/asset-strategy/"
+    "./skills/asset-pipeline/asset-strategy/",
+    "./skills/2d-assets/concept-art/",
+    "./skills/2d-assets/character-portrait/",
+    "./skills/2d-assets/pixel-art/",
+    "./skills/2d-assets/ui-graphics/",
+    "./skills/2d-assets/tileable-texture/",
+    "./skills/2d-assets/sprite-sheet/",
+    "./skills/2d-assets/skybox-panorama/",
+    "./skills/3d-assets/prop-model/",
+    "./skills/3d-assets/character-model/",
+    "./skills/3d-assets/environment-kit/",
+    "./skills/3d-assets/vehicle-model/",
+    "./skills/3d-assets/organic-model/",
+    "./skills/animation/generate-motion/",
+    "./skills/animation/retarget/",
+    "./skills/animation/animation-tree/",
+    "./skills/animation/procedural-animation/",
+    "./skills/animation/facial-and-lipsync/",
+    "./skills/audio/sound-effect/",
+    "./skills/audio/music-track/",
+    "./skills/audio/ambient-bed/",
+    "./skills/audio/voice-line/",
+    "./skills/audio/adaptive-music/",
+    "./skills/video/cinematic-cutscene/",
+    "./skills/video/trailer-shot/",
+    "./skills/video/animated-loop/",
+    "./skills/visual-effects/recipes/fire/",
+    "./skills/visual-effects/recipes/muzzle-flash/",
+    "./skills/visual-effects/recipes/water-ripple/",
+    "./skills/visual-effects/recipes/lightning/",
+    "./skills/visual-effects/recipes/dissolve/",
+    "./skills/visual-effects/recipes/smoke/",
+    "./skills/visual-effects/recipes/hit-spark/",
+    "./skills/visual-effects/recipes/magic-glow/"
   ],
   "hooks": "./hooks/hooks-cursor.json",
   "mcpServers": "./.mcp.json"

package/.factory-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "summer",
+  "description": "Superpowers for AI game dev. 24 auto-trigger skills + lifecycle hooks + MCP bridge to the local Summer Engine — the AI-native game engine.",
+  "version": "2.0.1",
+  "author": {
+    "name": "Summer Engine",
+    "email": "founders@summerengine.com",
+    "url": "https://summerengine.com"
+  },
+  "homepage": "https://summerengine.com",
+  "repository": "https://github.com/SummerEngine/summer",
+  "license": "MIT",
+  "keywords": [
+    "game-dev",
+    "godot",
+    "ai-game-engine",
+    "skills",
+    "mcp"
+  ]
+}

package/.opencode/INSTALL.md

@@ -14,9 +14,15 @@ Then add the plugin to your `opencode.json`:
 
 ```json
 {
-  "plugin": [
-    "summer-engine/.opencode/plugins/summer.js"
-  ]
+  "plugin": ["summer-engine"]
+}
+```
+
+OpenCode resolves `summer-engine` via the package's `main` field, which points to the Summer plugin entry. You can also pin to git for unreleased changes:
+
+```json
+{
+  "plugin": ["summer-engine@git+https://github.com/SummerEngine/summer.git"]
 }
 ```
 

package/.opencode/plugins/summer.js

@@ -50,5 +50,3 @@ export const SummerPlugin = async ({ client, directory }) => {
     }
   };
 };
-
-export default SummerPlugin;

package/AGENTS.md

@@ -0,0 +1,51 @@
+# Summer — Agent Context
+
+This file is for any AI agent that loads context from `AGENTS.md` (Codex CLI, Factory Droid, etc). It mirrors the Summer onboarding rules — see `GEMINI.md` for the same content keyed for Gemini.
+
+## What you're working with
+
+**Summer Engine** is the AI-native game engine the user is building in. Editor, scene graph, asset pipeline, and runtime are all instrumented for programmatic control via the `summer-engine` MCP server. Summer Engine is compatible with Godot 4.5 — projects use GDScript (`.gd`), C# (`.cs`), scenes (`.tscn`/`.scn`), and resources (`.tres`/`.res`). Write code in those languages; talk to the engine through MCP tools.
+
+## Critical rules
+
+1. **Always check for a relevant Summer skill before responding.** Even a 1% chance a skill applies = invoke it. Start with `summer:using-summer` on every fresh Summer Engine session.
+2. **The user owns fix decisions.** Diagnose first, propose, ask, then edit.
+3. **Don't grep the whole project before reading the actual error.** Use `summer_get_script_errors` first.
+4. **Don't edit `.tscn` files directly while the engine is running.** Use the `summer_*` MCP tools — direct edits get overwritten when the editor saves.
+5. **Never call `summer_set_resource_property` against an inline `sub_resource`** — it silently drops the value. Instantiate via `summer_set_prop` with a class-name string first.
+
+## Skill priority
+
+- **Process** (`brainstorm-game`, `debug`, `play`) → how to approach.
+- **Discipline** (`gdscript-patterns`, `scene-composition`, `art-direction`) → how to shape it.
+- **Build** (`fps-controller`, `design-mechanic`, `design-level`, `setup-multiplayer`, `vfx`, `tune-performance`, `export-and-ship`) → produce the artifact.
+
+## MCP tool palette (engine on `localhost:6550`)
+
+37 tools total. Categories:
+
+- Scene: `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_open_scene`, `summer_replace_node`, `summer_inspect_node`, `summer_inspect_resource`, `summer_get_scene_tree`, `summer_batch`, `summer_select_node`, `summer_instantiate_scene`, `summer_connect_signal`.
+- Diagnostics: `summer_get_script_errors`, `summer_get_diagnostics`, `summer_get_console`, `summer_clear_console`, `summer_get_debugger_errors`.
+- Runtime: `summer_play`, `summer_stop`, `summer_is_running`.
+- Project: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`, `summer_get_agent_playbook`.
+- Assets: `summer_search_assets`, `summer_import_asset`, `summer_import_from_url`, `summer_import_from_url_batch`, `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_check_job`.
+
+File ops, git, shell, and grep are NOT exposed — use the host's native tools.
+
+## Type-system gotchas
+
+`SetProp` values are engine-formatted strings (Godot type-system compatible), not JSON objects:
+- `"Vector3(0, 10, 0)"`
+- `"Color(1, 0.5, 0, 1)"` (RGBA, 4 components)
+- `"Transform3D(1,0,0, 0,1,0, 0,0,1, 0,5,0)"`
+
+Resources are class names: `"BoxMesh"`, `"StandardMaterial3D"`, `"CapsuleShape3D"`.
+
+## When something is off
+
+| Situation | Action |
+|---|---|
+| MCP tool returns "Summer Engine is not running" | Tell user `summer run`. Continue with non-MCP work. |
+| Skill loads but seems wrong | Re-read it. Skills evolve. |
+| Skill not found | Check `summer skills list`, then `summer setup <agent> --yes`. |
+| Generic engine errors on launch | Run `summer doctor` first — usually reveals auth/port/path issues. |

package/CLAUDE.md

@@ -0,0 +1,5 @@
+# Summer — Claude context
+
+This file primes Claude Code on Summer when it loads from this repo. The full agent workflow lives in `skills/_meta/using-summer/SKILL.md`; activate that skill on every fresh session.
+
+@./skills/_meta/using-summer/SKILL.md

package/GEMINI.md

@@ -0,0 +1,56 @@
+# Summer — Context Primer for Gemini
+
+Summer is the AI game-dev studio for **Summer Engine** — the AI-native game engine. When you see this file in a session, it means the user has installed the Summer Gemini extension and you have access to the `summer-engine` MCP server plus 24 skills under the `summer:` namespace.
+
+## What Summer Engine is
+
+A game engine designed for AI agents — editor, scene graph, asset pipeline, and runtime are all instrumented for programmatic control via MCP. Summer Engine is compatible with Godot 4.5: projects use GDScript (`.gd`), C# (`.cs`), scenes (`.tscn`/`.scn`), and resources (`.tres`/`.res`). Write code in those languages; talk to the engine through `summer_*` tools.
+
+## How to behave
+
+**Always check for a relevant Summer skill before writing code or running tools.** Skills encode discipline that matters — debug protocols, scene-composition rules, GDScript idioms Gemini regularly gets wrong. If a skill might apply, even at 1% probability, activate it via `activate_skill`.
+
+The single most important skill to know is `summer:using-summer` — it explains the workflow, priority, and the red-flag table of rationalizations the model needs to resist. Activate it first thing in any Summer Engine session.
+
+## Skill priority
+
+1. **Process skills first**: `brainstorm-game`, `debug`, `play`. These determine HOW.
+2. **Discipline skills second**: `gdscript-patterns`, `scene-composition`, `art-direction`, `audio-direction`. These shape content.
+3. **Build skills third**: `fps-controller`, `design-mechanic`, `design-level`, `setup-multiplayer`, `vfx`, `tune-performance`, `export-and-ship`.
+
+## MCP tools (when the engine is running on `localhost:6550`)
+
+The `summer-engine` MCP server exposes 37 focused tools. The most important:
+
+- **Scene mutation**: `summer_add_node`, `summer_set_prop`, `summer_set_resource_property`, `summer_remove_node`, `summer_save_scene`, `summer_replace_node`, `summer_batch`.
+- **Scene inspection**: `summer_get_scene_tree`, `summer_inspect_node`, `summer_inspect_resource`.
+- **Diagnostics**: `summer_get_script_errors` (cheapest), `summer_get_diagnostics`, `summer_get_console`, `summer_get_debugger_errors`.
+- **Run game**: `summer_play`, `summer_stop`, `summer_is_running`.
+- **Project**: `summer_get_project_context`, `summer_open_main_scene`, `summer_project_setting`, `summer_input_map_bind`.
+- **Assets**: `summer_search_assets`, `summer_import_asset`, `summer_import_from_url`, `summer_generate_image`, `summer_generate_3d`, `summer_generate_audio`, `summer_generate_video`, `summer_check_job`.
+
+File ops (Read/Write/Edit), git, shell, and grep are deliberately **not** exposed via MCP — Gemini already has those natively.
+
+## Type-system traps
+
+`SetProp` values are engine-formatted **strings** (Godot 4.5 type-system compatible):
+
+- `"Vector3(0, 10, 0)"` — NOT `{x: 0, y: 10, z: 0}`.
+- `"Color(1, 0.5, 0, 1)"` — RGBA, 4 components.
+- `"Transform3D(1,0,0, 0,1,0, 0,0,1, 0,5,0)"`.
+
+Resources are class names: `"BoxMesh"`, `"StandardMaterial3D"`, `"CapsuleShape3D"`.
+
+**Trap**: never call `summer_set_resource_property` against an inline `sub_resource` — the value silently drops. Use `summer_set_prop` with a class-name string first to instantiate a standalone resource, then drill in.
+
+## When the engine isn't running
+
+Tools return "Summer Engine is not running." Tell the user to run `summer run` (or open the engine and load the project), then continue with non-MCP work in the meantime. Do NOT fall back to editing `.tscn` files directly — the editor holds in-memory state that diverges from disk.
+
+## Setup help
+
+If skills aren't loading or the MCP server fails:
+
+- `npm install -g summer-engine` — global CLI.
+- `summer setup gemini --yes` — writes the right MCP config.
+- `summer doctor` — reports auth, engine, port, skill state.