summer-engine 1.5.0 → 2.2.0

package/dist/lib/plugin-manifests.test.js

@@ -0,0 +1,134 @@
+/**
+ * Validates that every agent plugin manifest references real, on-disk skills,
+ * and that every skill claimed HAVE in catalog.yaml actually exists.
+ *
+ * Catches broken-path bugs before they ship. Add a manifest, add a path here.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(__dirname, "..", "..");
+const MANIFESTS = [
+    {
+        name: ".claude-plugin/plugin.json",
+        path: join(repoRoot, ".claude-plugin", "plugin.json"),
+        skillsField: [],
+    },
+    {
+        name: ".cursor-plugin/plugin.json",
+        path: join(repoRoot, ".cursor-plugin", "plugin.json"),
+        skillsField: [],
+    },
+    {
+        name: ".codex-plugin/plugin.json",
+        path: join(repoRoot, ".codex-plugin", "plugin.json"),
+        skillsField: [],
+    },
+];
+function loadSkillsField(manifestPath) {
+    const raw = readFileSync(manifestPath, "utf-8");
+    const json = JSON.parse(raw);
+    if (json.skills === undefined) {
+        throw new Error(`${manifestPath}: missing "skills" field`);
+    }
+    return json.skills;
+}
+function listSkillDirs(skillsRoot) {
+    const entries = readdirSync(skillsRoot);
+    const out = [];
+    for (const cat of entries) {
+        const catPath = join(skillsRoot, cat);
+        if (!statSync(catPath).isDirectory())
+            continue;
+        if (cat === "_shared" || cat === "_tests")
+            continue;
+        for (const skill of readdirSync(catPath)) {
+            const skillPath = join(catPath, skill);
+            if (!statSync(skillPath).isDirectory())
+                continue;
+            if (existsSync(join(skillPath, "SKILL.md"))) {
+                out.push(`./skills/${cat}/${skill}/`);
+            }
+        }
+    }
+    return out;
+}
+describe("agent plugin manifests", () => {
+    for (const m of MANIFESTS) {
+        describe(m.name, () => {
+            it("exists and parses as JSON", () => {
+                expect(existsSync(m.path), `${m.name} not found`).toBe(true);
+                m.skillsField = loadSkillsField(m.path);
+            });
+            it("every referenced skill path resolves to a SKILL.md on disk", () => {
+                const skills = m.skillsField;
+                if (typeof skills === "string") {
+                    // Directory pointer mode (e.g. "./skills/")
+                    const dir = join(repoRoot, skills);
+                    expect(existsSync(dir), `${m.name}: skills dir ${skills} missing`).toBe(true);
+                    return;
+                }
+                const broken = [];
+                for (const rel of skills) {
+                    const skillMd = join(repoRoot, rel, "SKILL.md");
+                    if (!existsSync(skillMd))
+                        broken.push(rel);
+                }
+                expect(broken, `${m.name} references missing skills:\n${broken.join("\n")}`).toEqual([]);
+            });
+            it("does not duplicate skill paths", () => {
+                const skills = m.skillsField;
+                if (typeof skills === "string")
+                    return;
+                const seen = new Set();
+                const dupes = [];
+                for (const rel of skills) {
+                    if (seen.has(rel))
+                        dupes.push(rel);
+                    seen.add(rel);
+                }
+                expect(dupes, `${m.name} duplicates: ${dupes.join(", ")}`).toEqual([]);
+            });
+        });
+    }
+    describe("skills directory <-> manifest coverage", () => {
+        it("every on-disk skill is listed in .claude-plugin/plugin.json", () => {
+            const onDisk = listSkillDirs(join(repoRoot, "skills"));
+            const claudeManifest = JSON.parse(readFileSync(join(repoRoot, ".claude-plugin", "plugin.json"), "utf-8"));
+            const listed = new Set(claudeManifest.skills);
+            const orphans = onDisk.filter((p) => !listed.has(p));
+            expect(orphans, `On-disk skills missing from .claude-plugin/plugin.json (add or move under skills/_shared|_tests):\n${orphans.join("\n")}`).toEqual([]);
+        });
+    });
+});
+describe("skill SKILL.md frontmatter", () => {
+    it("every shipped SKILL.md has name and Use-when-style description", () => {
+        const skillsRoot = join(repoRoot, "skills");
+        const skillDirs = listSkillDirs(skillsRoot);
+        const failures = [];
+        for (const rel of skillDirs) {
+            const file = join(repoRoot, rel, "SKILL.md");
+            const text = readFileSync(file, "utf-8");
+            const match = text.match(/^---\s*\n([\s\S]+?)\n---/);
+            if (!match) {
+                failures.push(`${rel}: no frontmatter`);
+                continue;
+            }
+            const fm = match[1];
+            const nameMatch = fm.match(/^name:\s*(.+)$/m);
+            const descMatch = fm.match(/^description:\s*(.+)$/m);
+            if (!nameMatch || !nameMatch[1].trim())
+                failures.push(`${rel}: missing name`);
+            if (!descMatch || !descMatch[1].trim())
+                failures.push(`${rel}: missing description`);
+            const desc = descMatch?.[1] ?? "";
+            // Auto-trigger discipline: description must contain "Use when"
+            if (desc && !/\bUse when\b/i.test(desc)) {
+                failures.push(`${rel}: description must contain "Use when ..." (got: "${desc.slice(0, 80)}...")`);
+            }
+        }
+        expect(failures, `Skill frontmatter problems:\n${failures.join("\n")}`).toEqual([]);
+    });
+});

package/dist/lib/remote-templates.d.ts

@@ -0,0 +1,25 @@
+export interface RemoteTemplate {
+    /** Slug used by `summer create <slug>`. The `template-` prefix is stripped. */
+    slug: string;
+    /** Full GitHub repo name including the `template-` prefix. */
+    repo: string;
+    description: string;
+    /** Default branch — used when cloning. */
+    branch: string;
+    url: string;
+    cloneUrl: string;
+    stars: number;
+    updatedAt: string;
+}
+export declare function fetchRemoteTemplates(opts?: {
+    force?: boolean;
+}): Promise<RemoteTemplate[]>;
+export interface CloneOptions {
+    /** Where to put the project. Must not already exist. */
+    targetDir: string;
+    /** If true, drop the .git directory after clone so the user starts with a clean history. */
+    detach?: boolean;
+}
+export declare function cloneTemplate(template: RemoteTemplate, opts: CloneOptions): void;
+/** Quick match: exact slug, then prefix, then substring. Returns null if ambiguous or none. */
+export declare function matchTemplate(query: string, templates: RemoteTemplate[]): RemoteTemplate | null;

package/dist/lib/remote-templates.js

@@ -0,0 +1,86 @@
+/**
+ * Discover and clone open-source Summer Engine project templates hosted at
+ * github.com/SummerEngine/template-*.
+ *
+ * The GitHub API call is cached for one hour in memory to avoid rate-limit
+ * pain when an agent calls back-to-back.
+ */
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+const ORG = "SummerEngine";
+const TEMPLATE_PREFIX = "template-";
+const CACHE_TTL_MS = 60 * 60 * 1000;
+let cache = null;
+export async function fetchRemoteTemplates(opts = {}) {
+    if (!opts.force && cache && Date.now() - cache.fetchedAt < CACHE_TTL_MS) {
+        return cache.templates;
+    }
+    const url = `https://api.github.com/orgs/${ORG}/repos?per_page=100&type=public`;
+    const headers = {
+        Accept: "application/vnd.github+json",
+        "User-Agent": "summer-engine-cli",
+    };
+    if (process.env.GITHUB_TOKEN)
+        headers.Authorization = `Bearer ${process.env.GITHUB_TOKEN}`;
+    const res = await fetch(url, { headers });
+    if (!res.ok) {
+        throw new Error(`GitHub API ${res.status}: ${res.statusText}. ${res.status === 403 ? "Rate-limited; set GITHUB_TOKEN to raise the cap." : ""}`);
+    }
+    const repos = (await res.json());
+    const templates = repos
+        .filter((r) => r.name.startsWith(TEMPLATE_PREFIX) && !r.archived && !r.fork)
+        .map((r) => ({
+        slug: r.name.slice(TEMPLATE_PREFIX.length),
+        repo: r.name,
+        description: r.description ?? "",
+        branch: r.default_branch,
+        url: r.html_url,
+        cloneUrl: r.clone_url,
+        stars: r.stargazers_count,
+        updatedAt: r.updated_at,
+    }))
+        .sort((a, b) => b.stars - a.stars || a.slug.localeCompare(b.slug));
+    cache = { templates, fetchedAt: Date.now() };
+    return templates;
+}
+export function cloneTemplate(template, opts) {
+    if (existsSync(opts.targetDir)) {
+        throw new Error(`Directory already exists: ${opts.targetDir}`);
+    }
+    // Shallow clone for speed.
+    try {
+        execSync(`git clone --depth 1 --branch ${template.branch} ${template.cloneUrl} "${opts.targetDir}"`, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+    }
+    catch (err) {
+        throw new Error(`git clone failed for ${template.repo}. Is git installed? ${err.message}`);
+    }
+    if (opts.detach !== false) {
+        // Default to detached: the user wants their own history.
+        const gitDir = `${opts.targetDir}/.git`;
+        if (existsSync(gitDir)) {
+            try {
+                execSync(process.platform === "win32" ? `rmdir /s /q "${gitDir}"` : `rm -rf "${gitDir}"`, {
+                    stdio: "ignore",
+                });
+            }
+            catch {
+                // best effort — user can clean up manually if it fails
+            }
+        }
+    }
+}
+/** Quick match: exact slug, then prefix, then substring. Returns null if ambiguous or none. */
+export function matchTemplate(query, templates) {
+    const exact = templates.find((t) => t.slug === query || t.repo === query);
+    if (exact)
+        return exact;
+    const prefix = templates.filter((t) => t.slug.startsWith(query));
+    if (prefix.length === 1)
+        return prefix[0];
+    const substring = templates.filter((t) => t.slug.includes(query));
+    if (substring.length === 1)
+        return substring[0];
+    return null;
+}

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;
@@ -85,7 +85,7 @@ export declare const SKILL_REGISTRY: readonly [{
     readonly category: "scene-and-project";
     readonly public: true;
     readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
-    readonly recommended: false;
+    readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_get_agent_playbook", "summer_get_project_context", "summer_create_scene", "summer_open_scene", "summer_save_scene", "summer_add_node", "summer_set_prop", "summer_set_resource_property", "summer_instantiate_scene", "summer_play", "summer_stop", "summer_get_diagnostics"];
     readonly testScenario: "Build one narrow playable prototype from requirements through scene setup, host-edited scripts, and diagnostics.";
 }, {
@@ -96,6 +96,22 @@ export declare const SKILL_REGISTRY: readonly [{
     readonly recommended: true;
     readonly requiresMcpTools: readonly ["summer_get_project_context", "summer_get_scene_tree"];
     readonly testScenario: "Walk a fresh user from \"I want to make a game but I don't know what\" to a 1-page brief saved at .summer/GameSoul.md.";
+}, {
+    readonly name: "new-project";
+    readonly category: "scene-and-project";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_get_project_context"];
+    readonly testScenario: "User says \"start a blank project\" — skill asks for the name, picks empty vs 3d-basic, runs summer create, opens the engine, and stops to ask what to build.";
+}, {
+    readonly name: "browse-templates";
+    readonly category: "scene-and-project";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_get_project_context"];
+    readonly testScenario: "User says \"what templates exist?\" — skill runs summer list templates, presents 3-5 curated picks, asks the project name, and runs summer create <slug> <name>.";
 }, {
     readonly name: "design-mechanic";
     readonly category: "gameplay-mechanics";
@@ -129,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"];
@@ -184,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.";
 }];