summer-engine 1.3.0 → 1.3.2

package/CHANGELOG.md

@@ -0,0 +1,67 @@
+# Changelog
+
+All notable changes to summer-engine will be documented here. Following [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/).
+
+## [1.3.2] — 2026-05-05
+
+### Fixed
+- `summer_input_map_bind` syntax aligned across `fps-controller` SKILL.md and its behavioral test spec.
+- `_meta/skill-test` static linter relaxed to allow forward-reference `See also` links to other SKILL.md files (warn instead of fail).
+
+### Added
+- `_shared/summer-folder.md` — canonical `.summer/` folder convention (documents files written by `/summer:brainstorm-game`, `/summer:art-direction`, etc.).
+- `CHANGELOG.md` — retroactive v1.0.0 → v1.3.1 history.
+
+## [1.3.1] — 2026-05-05
+
+### Added
+- ASCII banner displays on bare `summer` command (`npx summer-engine`).
+- ANSI colors throughout: green ✓ for OK, yellow ⚠ for warnings, red ✗ for failures.
+- Brand line + colored slash command list in setup output.
+- `/debug` workflow skill — triage and fix a bug end-to-end via Summer MCP diagnostics.
+- `/play` workflow skill — run the game and report state.
+- 7 specialist skills marked `user-invocable: false` (auto-trigger only).
+
+### Fixed
+- `summer doctor` defaults to human-readable output instead of JSON.
+- Engine path display shortened (`/Applications/Summer.app/Contents/MacOS/Summer` → `/Applications/Summer.app`).
+- Home-relative paths now display tildeified.
+- MCP server status no longer leaks "stdio" implementation detail (now reads "ready").
+- `tools/summer-cli/src/bin/` finally tracked in git (root `.gitignore`'s `[Bb]in/` was silently excluding the npm entrypoint).
+- `LICENSE` now bundled in the npm tarball.
+
+## [1.3.0] — 2026-05-05
+
+### Added
+- 20-category skill library scaffold with descriptive folder names (`character-controllers`, `gameplay-mechanics`, `scripting-patterns`, etc.).
+- `_shared/` directory with 5 canonical references (godot-version, mcp-tools-reference, collaborative-protocol, template-registry, gd-style).
+- `_meta/` directory with 3 meta-skills (skill-test linter, skill-create bootstrap, skill-improve eval harness).
+- `_tests/specs/` directory with per-skill behavioral test specs (fps-controller as canonical format).
+- `catalog.yaml` — 85-skill roadmap with HAVE / NEXT / LATER status.
+
+### Changed
+- 7 existing skills migrated into category folders with Anthropic-spec frontmatter (`category`, `template-id`, `allowed-tools`, `paths`).
+- CLI `skills install` walks `<skillsDir>/<category>/<name>/` paths.
+
+## [1.2.1] — 2026-05-05
+
+### Added
+- `summer setup <agent>` — one-shot MCP config + recommended skills install + doctor.
+- `summer doctor` — node, login, engine, local API, MCP boot diagnostics.
+- `summer mcp setup <agent>` — idempotent JSON/TOML config writer.
+- Multi-agent skills install (codex, claude-code, cursor, windsurf with user/project scopes; Cursor `.mdc` rule generation; Windsurf rule blocks).
+- Skill registry (`src/lib/skills-registry.ts`) with category metadata.
+- Per-agent docs (AGENT_KIT, CLAUDE_CODE, CODEX, CURSOR, SKILLS, TEMPLATES).
+
+### Changed
+- `/api/mcp/assets`: removed Pro gate; public/community asset search now free for all signed-in users (deployed on summerengine.com).
+- `/api/mcp/log-local-call`: removed visible 100/week quota; auth-gated telemetry only.
+
+## [1.2.0] — 2026-04-23
+
+### Added
+- Initial public release on npm.
+- MCP server with 36 `summer_*` tools.
+- 7 specialist skills (`fps-controller`, `gdscript-patterns`, `scene-composition`, `3d-lighting`, `ui-basics`, `asset-strategy`, `make-game`).
+- CLI commands (`install`, `login`, `logout`, `status`, `run`, `open`, `create`, `list`, `skills`, `mcp`).
+- MIT license.

package/README.md

@@ -32,9 +32,14 @@ Verify:
 summer doctor
 ```
 
-Then open your agent and try the verification prompt:
+Then open your agent and try one of the slash commands:
 
-> Use Summer Engine MCP. First call `summer_get_project_context` and `summer_get_agent_playbook`, then add a `DirectionalLight3D` and `Camera3D` to the main scene, save it, and check diagnostics.
+| Command | What it does |
+|---|---|
+| `/debug` | Triage and fix a bug end-to-end (reads engine errors, locates code, proposes fix) |
+| `/play` | Run the game and report state (clean run, warnings, or crash) |
+
+Or just describe what you want — the specialist skills (FPS controller, lighting, GDScript patterns, scene composition, UI, asset strategy) auto-trigger on natural language: "make me an FPS", "add lighting", "I need a HUD".
 
 ## Commands
 

package/dist/bin/summer.js

@@ -14,13 +14,18 @@ import { skillsCommand } from "../commands/skills.js";
 import { orchestratorCommand } from "../commands/orchestrator.js";
 import { setupCommand } from "../commands/setup.js";
 import { doctorCommand } from "../commands/doctor.js";
+import { getBanner } from "../lib/banner.js";
+import { c, sym } from "../lib/format.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 const program = new Command();
 program
     .name("summer")
     .description("CLI and MCP tools for Summer Engine — the AI-native game engine")
-    .version(version);
+    .version(version)
+    .action(() => {
+    printIntro(version);
+});
 program.addCommand(installCommand);
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
@@ -38,3 +43,21 @@ program.parseAsync().catch((err) => {
     console.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
 });
+function printIntro(version) {
+    console.log("");
+    console.log(getBanner());
+    console.log("");
+    console.log(`     ${sym.arrow()} ${c.bold("Summer Engine")} ${c.dim("v" + version)}  ${c.dim("·")}  AI-native game engine`);
+    console.log("");
+    console.log(`     ${c.bold("Get started")}`);
+    console.log(`     ${c.dim("$")} summer setup claude-code      ${c.dim("Configure Claude Code (or codex/cursor/windsurf)")}`);
+    console.log(`     ${c.dim("$")} summer create 3d-basic my-game ${c.dim("Start a project")}`);
+    console.log(`     ${c.dim("$")} summer doctor                  ${c.dim("Check setup")}`);
+    console.log("");
+    console.log(`     ${c.bold("Slash commands")} ${c.dim("(in your AI agent)")}`);
+    console.log(`     ${c.brand("/debug")}   ${c.dim("Triage and fix a bug end-to-end")}`);
+    console.log(`     ${c.brand("/play")}    ${c.dim("Run the game and report state")}`);
+    console.log("");
+    console.log(`     ${c.dim("Docs:")} https://summerengine.com/docs`);
+    console.log("");
+}

package/dist/commands/doctor.js

@@ -5,6 +5,7 @@ import { platform } from "os";
 import { Command } from "commander";
 import { getAuthToken, getUserInfo } from "../lib/auth.js";
 import { checkEngineHealth, getApiPort, getApiToken } from "../lib/engine.js";
+import { brandLine, c, pad, sym, tildeify } from "../lib/format.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../../package.json");
 const MAC_ENGINE_PATHS = [
@@ -17,11 +18,17 @@ const WIN_ENGINE_PATHS = [
     `${process.env.PROGRAMFILES}\\Summer Engine\\Summer.exe`,
 ];
 export const doctorCommand = new Command("doctor")
-    .description("Run setup and connection diagnostics")
+    .description("Diagnose Node, login, engine, local API, and MCP boot")
     .option("--json", "Print diagnostics as JSON")
-    .option("--human", "Print diagnostics in a human-readable format")
     .action(async (opts) => {
-    const result = await runDoctor({ json: opts.json || !opts.human });
+    if (!opts.json) {
+        const { createRequire: req } = await import("node:module");
+        const ver = req(import.meta.url)("../../package.json").version;
+        console.log("");
+        console.log(brandLine(ver));
+        console.log("");
+    }
+    const result = await runDoctor({ json: Boolean(opts.json) });
     if (!result.ok) {
         process.exit(1);
     }
@@ -33,7 +40,7 @@ export async function runDoctor(options = {}) {
         id: "cli-version",
         label: "Summer CLI",
         status: "ok",
-        message: `summer-engine CLI v${version}`,
+        message: `v${version}`,
     });
     checks.push(await checkLogin());
     checks.push(checkEngineInstall());
@@ -57,14 +64,14 @@ function checkNodeVersion() {
             id: "node-version",
             label: "Node.js",
             status: "ok",
-            message: `Node ${process.version}`,
+            message: process.version,
         };
     }
     return {
         id: "node-version",
         label: "Node.js",
         status: "fail",
-        message: `Node ${process.version} found; Summer CLI requires Node 18 or newer.`,
+        message: `${process.version} (need 18+)`,
     };
 }
 async function checkLogin() {
@@ -75,32 +82,34 @@ async function checkLogin() {
             id: "login",
             label: "Login",
             status: "warning",
-            message: "Not logged in. Run: summer login",
+            message: "not signed in (run: summer login)",
         };
     }
     return {
         id: "login",
         label: "Login",
         status: "ok",
-        message: user ? `Logged in as ${user.email}` : "Auth token found.",
+        message: user ? user.email : "signed in",
     };
 }
 function checkEngineInstall() {
     const binary = findEngineBinary();
     if (binary) {
+        // Shorten /Applications/Summer.app/Contents/MacOS/Summer -> /Applications/Summer.app
+        const display = binary.replace(/\/Contents\/MacOS\/Summer$/, "");
         return {
             id: "engine-install",
-            label: "Engine Install",
+            label: "Engine",
             status: "ok",
-            message: `Summer Engine binary found at ${binary}`,
+            message: tildeify(display),
             details: { path: binary },
         };
     }
     return {
         id: "engine-install",
-        label: "Engine Install",
+        label: "Engine",
         status: "warning",
-        message: "Summer Engine binary was not found in the default install locations.",
+        message: "not installed (run: summer install)",
     };
 }
 async function checkLocalApi() {
@@ -111,7 +120,7 @@ async function checkLocalApi() {
             id: "local-api",
             label: "Local API",
             status: "warning",
-            message: "Engine API token not found; Summer Engine is probably not running.",
+            message: "engine not running",
             details: { port },
         };
     }
@@ -121,7 +130,7 @@ async function checkLocalApi() {
             id: "local-api",
             label: "Local API",
             status: "warning",
-            message: `API token found, but Summer Engine is not responding on port ${port}.`,
+            message: `not responding on :${port}`,
             details: { port },
         };
     }
@@ -129,7 +138,7 @@ async function checkLocalApi() {
         id: "local-api",
         label: "Local API",
         status: "ok",
-        message: `Summer Engine API is responding on port ${port}.`,
+        message: `:${port}`,
         details: {
             port,
             version: health.version,
@@ -182,7 +191,7 @@ async function checkMcpBoot() {
                     id: "mcp-boot",
                     label: "MCP Server",
                     status: "ok",
-                    message: "MCP stdio server starts successfully.",
+                    message: "ready",
                 });
             }
         });
@@ -225,12 +234,27 @@ function summarizeChecks(checks) {
     };
 }
 export function printDoctorResult(result) {
-    console.log("Summer Doctor\n");
+    console.log(c.bold("Doctor"));
+    console.log("");
+    const labelWidth = 14;
     for (const check of result.checks) {
-        const mark = check.status === "ok" ? "OK" : check.status === "warning" ? "WARN" : "FAIL";
-        console.log(`  ${mark.padEnd(4)} ${check.label}: ${check.message}`);
+        const mark = check.status === "ok"
+            ? sym.ok()
+            : check.status === "warning"
+                ? sym.warn()
+                : sym.fail();
+        console.log(`  ${mark}  ${pad(c.bold(check.label), labelWidth)}${c.dim(check.message)}`);
+    }
+    console.log("");
+    if (result.summary.failures > 0) {
+        console.log(c.red(`${result.summary.failures} ${result.summary.failures === 1 ? "issue" : "issues"} to fix.`));
+    }
+    else if (result.summary.warnings > 0) {
+        console.log(c.yellow(`${result.summary.warnings} ${result.summary.warnings === 1 ? "warning" : "warnings"}, ${result.summary.ok} OK.`));
+    }
+    else {
+        console.log(c.green("Everything's wired up."));
     }
-    console.log(`\n${result.summary.ok} ok, ${result.summary.warnings} warnings, ${result.summary.failures} failures`);
 }
 function findEngineBinary() {
     const paths = platform() === "darwin" ? MAC_ENGINE_PATHS : WIN_ENGINE_PATHS;

package/dist/commands/setup.js

@@ -1,7 +1,17 @@
 import { spawnSync } from "child_process";
+import { createRequire } from "node:module";
 import { Command } from "commander";
 import { configureAgentMcp, parseAgent, parseScope, supportedAgents, } from "../lib/agent-config.js";
 import { printDoctorResult, runDoctor } from "./doctor.js";
+import { brandLine, c, sym, tildeify } from "../lib/format.js";
+const requireFromHere = createRequire(import.meta.url);
+const { version: cliVersion } = requireFromHere("../../package.json");
+const AGENT_LABEL = {
+    "claude-code": "Claude Code",
+    codex: "Codex",
+    cursor: "Cursor",
+    windsurf: "Windsurf",
+};
 export const setupCommand = new Command("setup")
     .description("Configure Summer Engine for an AI agent and run diagnostics")
     .argument("[agent]", `Agent to configure: ${supportedAgents.join(", ")}`)
@@ -109,20 +119,81 @@ function skillInstallInvocation(agent) {
 function printSetupResult(config, skills, doctor) {
     if (config.print) {
         console.log(config.snippet.trimEnd());
+        return;
     }
-    else if (config.dryRun) {
-        console.log(`Would update ${config.path} for ${config.agent} (${config.scope}).`);
+    console.log("");
+    console.log(brandLine(cliVersion));
+    console.log("");
+    const agentLabel = AGENT_LABEL[config.agent] ?? config.agent;
+    if (config.dryRun) {
+        console.log(`  ${c.dim("(dry run)")}  Would link to ${agentLabel}  ${c.dim(tildeify(config.path))}`);
     }
     else if (config.wrote) {
-        console.log(`Configured Summer Engine MCP for ${config.agent} (${config.scope}) at ${config.path}.`);
+        console.log(`  ${sym.ok()}  Linked to ${c.bold(agentLabel)}  ${c.dim(tildeify(config.path))}`);
     }
     else {
-        console.log(`Summer Engine MCP already configured for ${config.agent} (${config.scope}) at ${config.path}.`);
+        console.log(`  ${sym.ok()}  Already linked to ${c.bold(agentLabel)}  ${c.dim(tildeify(config.path))}`);
+    }
+    if (skills.status === "installed") {
+        const installed = parseInstalledSkills(skills.stdout);
+        if (installed.length > 0) {
+            const where = parseSkillTargetDir(skills.stdout);
+            console.log(`  ${sym.ok()}  Installed ${c.bold(String(installed.length) + " skills")}  ${where ? c.dim(tildeify(where)) : ""}`);
+            const grouped = installed.reduce((rows, name, i) => {
+                const row = Math.floor(i / 3);
+                rows[row] = rows[row] ?? [];
+                rows[row].push(name);
+                return rows;
+            }, []);
+            for (const row of grouped) {
+                console.log(`     ${c.dim(row.join(" · "))}`);
+            }
+        }
+        else {
+            console.log(`  ${sym.ok()}  Installed recommended skills`);
+        }
+    }
+    else if (skills.status === "planned" || skills.status === "skipped") {
+        console.log(`  ${sym.warn()}  Skills: ${c.dim(skills.message)}`);
+    }
+    else if (skills.status === "failed") {
+        console.log(`  ${sym.fail()}  Skills install failed`);
+        if (skills.stderr)
+            console.log(`     ${c.dim(skills.stderr)}`);
     }
     for (const warning of config.warnings) {
-        console.warn(`Warning: ${warning}`);
+        console.log(`  ${sym.warn()}  ${c.yellow(warning)}`);
     }
-    console.log(`Skills: ${skills.message}`);
     console.log("");
     printDoctorResult(doctor);
+    if (doctor.ok && skills.status !== "failed" && !config.dryRun) {
+        console.log("");
+        console.log(`${c.dim("Try it:")} open ${AGENT_LABEL[config.agent] ?? config.agent} and ask: ${c.bold("\"add a DirectionalLight3D and Camera3D to my scene\"")}`);
+    }
+}
+function parseInstalledSkills(stdout) {
+    if (!stdout)
+        return [];
+    // Lines look like: "  Installed fps-controller -> /path/.../fps-controller"
+    const names = [];
+    for (const line of stdout.split("\n")) {
+        const m = line.match(/^\s*Installed\s+([a-z0-9-]+)\s+->/i);
+        if (m)
+            names.push(m[1]);
+    }
+    return names;
+}
+function parseSkillTargetDir(stdout) {
+    if (!stdout)
+        return null;
+    for (const line of stdout.split("\n")) {
+        const m = line.match(/^\s*Installed\s+[a-z0-9-]+\s+->\s+(.+)$/i);
+        if (m) {
+            const path = m[1].trim();
+            // Strip trailing /<skill-name> to get the parent dir
+            const parent = path.replace(/\/[a-z0-9-]+$/i, "/");
+            return parent;
+        }
+    }
+    return null;
 }

package/dist/commands/skills.js

@@ -4,6 +4,7 @@ import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { homedir } from "os";
 import { AGENT_CLIENTS, SKILL_REGISTRY, } from "../lib/skills-registry.js";
+import { tildeify } from "../lib/format.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 // Resolve skills dir: from dist/commands/skills.js -> ../../skills
 const skillsDir = join(__dirname, "..", "..", "skills");
@@ -242,15 +243,16 @@ function escapeRegExp(value) {
 }
 function printInstallSummary(count, agent, scope, location) {
     const label = agentLabel(agent);
+    const tildeified = tildeify(location.path);
     console.log(`\n${count} skill${count === 1 ? "" : "s"} ready for ${label} (${scope} scope).`);
     if (location.kind === "skill-dir") {
-        console.log(`${label} can read skills from ${location.path}/<skill>/SKILL.md`);
+        console.log(`${label} can read skills from ${tildeified}/<skill>/SKILL.md`);
     }
     else if (location.kind === "cursor-rule-dir") {
-        console.log(`Cursor rules are in ${location.path}/summer-<skill>.mdc`);
+        console.log(`Cursor rules are in ${tildeified}/summer-<skill>.mdc`);
     }
     else {
-        console.log(`Windsurf rules are in ${location.path}`);
+        console.log(`Windsurf rules are in ${tildeified}`);
     }
 }
 export const skillsCommand = new Command("skills")

package/dist/lib/format.d.ts

@@ -0,0 +1,23 @@
+export declare function useColor(): boolean;
+export declare const c: {
+    bold: (s: string) => string;
+    dim: (s: string) => string;
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    cyan: (s: string) => string;
+    brand: (s: string) => string;
+};
+export declare const sym: {
+    ok: () => string;
+    warn: () => string;
+    fail: () => string;
+    arrow: () => string;
+};
+export declare function tildeify(path: string | undefined | null): string;
+export declare function brandLine(version: string): string;
+export declare function stripAnsi(s: string): string;
+/**
+ * Pad a string to a visible width, accounting for ANSI codes.
+ */
+export declare function pad(s: string, width: number): string;

package/dist/lib/format.js

@@ -0,0 +1,60 @@
+import { homedir } from "os";
+const ANSI = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    // Summer brand orange (matches banner.ts mid gradient)
+    brand: "\x1b[38;2;255;143;23m",
+};
+export function useColor() {
+    if (process.env.NO_COLOR)
+        return false;
+    if (process.env.FORCE_COLOR)
+        return true;
+    return Boolean(process.stdout.isTTY);
+}
+function paint(code, s) {
+    return useColor() ? `${code}${s}${ANSI.reset}` : s;
+}
+export const c = {
+    bold: (s) => paint(ANSI.bold, s),
+    dim: (s) => paint(ANSI.dim, s),
+    red: (s) => paint(ANSI.red, s),
+    green: (s) => paint(ANSI.green, s),
+    yellow: (s) => paint(ANSI.yellow, s),
+    cyan: (s) => paint(ANSI.cyan, s),
+    brand: (s) => paint(ANSI.brand, s),
+};
+export const sym = {
+    ok: () => c.green("✓"),
+    warn: () => c.yellow("⚠"),
+    fail: () => c.red("✗"),
+    arrow: () => c.brand("▶"),
+};
+export function tildeify(path) {
+    if (!path)
+        return "";
+    const home = homedir();
+    if (path === home)
+        return "~";
+    if (path.startsWith(home + "/"))
+        return "~" + path.slice(home.length);
+    return path;
+}
+export function brandLine(version) {
+    return `${sym.arrow()} ${c.bold("Summer Engine")} ${c.dim("v" + version)}`;
+}
+export function stripAnsi(s) {
+    return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/**
+ * Pad a string to a visible width, accounting for ANSI codes.
+ */
+export function pad(s, width) {
+    const visLen = stripAnsi(s).length;
+    return s + " ".repeat(Math.max(0, width - visLen));
+}

package/dist/lib/format.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/format.test.js

@@ -0,0 +1,36 @@
+import { homedir } from "os";
+import { describe, expect, it } from "vitest";
+import { stripAnsi, tildeify } from "./format.js";
+describe("tildeify", () => {
+    it("replaces home directory prefix with ~", () => {
+        const home = homedir();
+        expect(tildeify(home + "/.claude.json")).toBe("~/.claude.json");
+        expect(tildeify(home + "/projects/foo")).toBe("~/projects/foo");
+    });
+    it("returns ~ when path is the home directory exactly", () => {
+        expect(tildeify(homedir())).toBe("~");
+    });
+    it("does not touch non-home paths", () => {
+        expect(tildeify("/Applications/Summer.app")).toBe("/Applications/Summer.app");
+        expect(tildeify("/tmp/foo")).toBe("/tmp/foo");
+    });
+    it("does not partial-match (e.g. /Users/Mat vs /Users/MathiasWork)", () => {
+        const home = homedir();
+        const sibling = home.slice(0, -2) + "Other";
+        expect(tildeify(sibling + "/file")).toBe(sibling + "/file");
+    });
+    it("handles empty/null/undefined input", () => {
+        expect(tildeify(undefined)).toBe("");
+        expect(tildeify(null)).toBe("");
+        expect(tildeify("")).toBe("");
+    });
+});
+describe("stripAnsi", () => {
+    it("removes ANSI color codes", () => {
+        expect(stripAnsi("\x1b[31mhello\x1b[0m")).toBe("hello");
+        expect(stripAnsi("\x1b[1;32mbold green\x1b[0m text")).toBe("bold green text");
+    });
+    it("leaves clean strings untouched", () => {
+        expect(stripAnsi("hello")).toBe("hello");
+    });
+});

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

@@ -17,6 +17,22 @@ export interface SkillRegistryEntry {
  * with shippable content). When a NEXT skill ships, mirror it here.
  */
 export declare const SKILL_REGISTRY: readonly [{
+    readonly name: "debug";
+    readonly category: "debugging";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_get_console", "summer_get_debugger_errors", "summer_get_script_errors", "summer_get_diagnostics", "summer_clear_console", "summer_play", "summer_stop", "summer_inspect_node"];
+    readonly testScenario: "Triage a runtime crash end-to-end: read errors, locate code, propose fix, apply on approval, verify.";
+}, {
+    readonly name: "play";
+    readonly category: "scene-and-project";
+    readonly public: true;
+    readonly clients: readonly ["summer", "codex", "claude-code", "cursor", "windsurf"];
+    readonly recommended: true;
+    readonly requiresMcpTools: readonly ["summer_is_running", "summer_play", "summer_stop", "summer_clear_console", "summer_get_diagnostics", "summer_get_debugger_errors", "summer_get_script_errors"];
+    readonly testScenario: "Run the game from a clean state, wait for first frame, report whether it runs cleanly or has errors.";
+}, {
     readonly name: "gdscript-patterns";
     readonly category: "scripting-patterns";
     readonly public: true;

package/dist/lib/skills-registry.js

@@ -35,6 +35,41 @@ const ALL_CLIENTS = AGENT_CLIENTS;
  * with shippable content). When a NEXT skill ships, mirror it here.
  */
 export const SKILL_REGISTRY = [
+    {
+        name: "debug",
+        category: "debugging",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_get_console",
+            "summer_get_debugger_errors",
+            "summer_get_script_errors",
+            "summer_get_diagnostics",
+            "summer_clear_console",
+            "summer_play",
+            "summer_stop",
+            "summer_inspect_node",
+        ],
+        testScenario: "Triage a runtime crash end-to-end: read errors, locate code, propose fix, apply on approval, verify.",
+    },
+    {
+        name: "play",
+        category: "scene-and-project",
+        public: true,
+        clients: ALL_CLIENTS,
+        recommended: true,
+        requiresMcpTools: [
+            "summer_is_running",
+            "summer_play",
+            "summer_stop",
+            "summer_clear_console",
+            "summer_get_diagnostics",
+            "summer_get_debugger_errors",
+            "summer_get_script_errors",
+        ],
+        testScenario: "Run the game from a clean state, wait for first frame, report whether it runs cleanly or has errors.",
+    },
     {
         name: "gdscript-patterns",
         category: "scripting-patterns",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "summer-engine",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "CLI and MCP tools for Summer Engine — the AI-native game engine",
   "keywords": [
     "game-engine",
@@ -25,7 +25,9 @@
   "files": [
     "dist/",
     "skills/",
-    "README.md"
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc",
@@ -33,7 +35,7 @@
     "summer": "node dist/bin/summer.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build && npm test"
   },
   "engines": {
     "node": ">=18"

package/skills/_meta/skill-test/SKILL.md

@@ -23,7 +23,7 @@ For a single skill at `skills/<category>/<name>/`, run these checks:
 4. **Collaborative protocol.** If the skill triggers user-visible writes, body must contain at least one of: `May I`, `I'm about to`, `Continue?`, `OK?`, `Proceed?`. Skills that only inspect/read are exempt.
 5. **Template-id resolved.** If the skill's frontmatter declares `template-id: <id>`, that id must exist in `_shared/template-registry.md`.
 6. **Tests/spec.md present.** Every skill in a non-`_meta` category must have `tests/spec.md` with at least one `## Case` heading.
-7. **No broken relative links.** Every `](../...)` and `](./...)` in the body must point at an existing file.
+7. **Relative links resolve.** Every `](../_shared/...)`, `](../../_shared/...)`, `](./references/...)`, and `](./examples/...)` link must point at an existing file (FAIL if broken). Forward references in `## See also` to other SKILL.md files (e.g., `[design-mechanic](../../gameplay-mechanics/design-mechanic/SKILL.md)`) are allowed to dangle and only WARN if the target is missing — the catalog evolves and skills should be free to point at planned skills.
 
 Output: