summer-engine 3.0.0 → 3.1.0

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
     {
       "name": "summer",
       "source": "./",
-      "version": "3.0.0",
+      "version": "3.1.0",
       "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
       "author": {
         "name": "Summer Engine",

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "_generated": "GENERATED from integrations/claude — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "_generated": "GENERATED from integrations/codex — do not edit; npm run generate:registry",
   "name": "summer",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge. Build games by talking.",
   "author": {
     "name": "Summer Engine",

package/.cursor-plugin/plugin.json

@@ -3,7 +3,7 @@
   "_generated": "GENERATED from integrations/cursor — do not edit; npm run generate:registry",
   "name": "summer",
   "displayName": "Summer",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
   "author": {
     "name": "Summer Engine",

package/.factory-plugin/plugin.json

@@ -2,7 +2,7 @@
   "_generated": "GENERATED from integrations/factory — do not edit; npm run generate:registry",
   "name": "summer",
   "description": "Agent tooling for Summer Engine: game-dev skills, lifecycle hooks, and a 86-tool MCP bridge to the local desktop app.",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "author": {
     "name": "Summer Engine",
     "email": "founders@summerengine.com",

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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/).
 
+## [3.1.0] - 2026-09-11
+
+### Added
+- `summer setup` now covers every MCP-capable coding agent with a user-editable config: Claude Desktop, Antigravity, Zed, Kiro, Goose, Hermes Agent, GitHub Copilot in Visual Studio and in JetBrains IDEs, Trae, Qwen Code, Kimi Code CLI, Crush, Amp, Factory Droid, Junie, Warp, Rovo Dev CLI, Qoder CLI, Grok Build, Mistral Vibe and Cline CLI join the existing targets (31 active agents). New file shapes: Zed `context_servers`, Amp `amp.mcpServers`, Crush `mcp`, Rovo `transport: stdio`, Mistral Vibe `[[mcp_servers]]` TOML, Goose and Hermes YAML (comments preserved), typed-stdio `mcpServers`.
+- One agent table (`src/installer/agent-table.ts`) now holds every per-agent fact: label, aliases, MCP path per scope and OS, file shape, skills home, restart hint. `integrations/<id>/` folders, `AGENT_CLIENTS`, doctor's skill-marker probes and the docs tables are checked against it by tests.
+
+### Changed
+- Cursor skills install as `~/.cursor/skills/<skill>/SKILL.md` (Cursor's skills format) instead of `.cursor/rules/*.mdc`; `--force` removes the old rule files.
+- Devin Desktop (formerly Windsurf) skills install as `~/.codeium/windsurf/skills/<skill>/SKILL.md` instead of a `.windsurfrules` block.
+- Cline skills install to `~/.cline/skills` (shared by the VS Code extension and the CLI) instead of `Documents/Cline/Rules` markdown.
+- OpenCode skills install to `~/.config/opencode/skills/<skill>/SKILL.md` (OpenCode's native skills folder) instead of `agents/summer/*.md`; `--force` removes the old files.
+- Kilo Code config moved to `~/.config/kilo/kilo.json` (`mcp` key, array command, `enabled: true`) and `./kilo.json` for project scope, matching Kilo's current CLI + extension; skills go to `~/.kilo/skills`.
+- Claude Code and Cursor entries now carry `type: "stdio"`, which both products' docs list as required.
+- Project requests on agents with a user-only config now warn with one shared wording ("writing user scope instead"); Trae, whose user-level servers are UI-managed, writes its project file.
+
+### Deprecated
+- `gemini` (Gemini CLI, retired for individual accounts 2026-06-18) and `roo-code` (shut down 2026-05-15) still work but are hidden from help and warn on use; `antigravity` is the replacement for Gemini users.
+
 ## [3.0.0] (2026-09-09): "The Library"
 
 v3 rebuilds the package around one idea: every resource is described once (`library/<kind>/<slug>/resource.yaml`) and everything else (the searchable index, every agent manifest, the skill and template registries, counts, aliases) is generated from it, with CI failing on drift. Migrating from v2: `docs/MIGRATION-V2-V3.md`. The design contract and the verified-vs-planned status live in the repository under `docs/design/`.

package/README.md

@@ -93,7 +93,7 @@ The check ids are `node-version`, `cli-version`, `cli-version-current`, `skills-
 npx -y summer-engine@latest setup claude-code --yes --force
 ```
 
-Replace `claude-code` with the user's actual agent: `codex`, `cursor`, `windsurf`, `cline`, `roo-code`, `kilo-code`, `gemini`, `github-copilot`, `vscode-copilot`, `opencode`, or `lm-studio`. Use `github-copilot` for Copilot CLI and `vscode-copilot` for GitHub Copilot Chat/Agent in VS Code. Factory Droid uses the plugin marketplace path (see [`integrations/README.md`](integrations/README.md)). This installs **every skill in the library** (`status: preview` skills included — they are labelled as preview in their guidance, and `--stable-only` skips them) to `~/.claude/skills/<slug>/SKILL.md` (or the agent's equivalent user-skill directory) AND writes the MCP server config so the agent can talk to the engine, then runs doctor and prints what it installed and where. The `--force` flag wipes any stale skill content first, so re-runs always end up with the latest copy. `--recommended` installs only the recommended subset — don't use it from this playbook.
+Replace `claude-code` with the user's actual agent: `claude-desktop`, `codex`, `cursor`, `windsurf`, `antigravity`, `cline`, `cline-cli`, `kilo-code`, `github-copilot`, `vscode-copilot`, `visual-studio`, `copilot-jetbrains`, `opencode`, `zed`, `kiro`, `goose`, `hermes`, `trae`, `qwen-code`, `kimi-code`, `crush`, `amp`, `factory`, `junie`, `warp`, `rovo-dev`, `qoder`, `grok-build`, `mistral-vibe`, `lm-studio`. Use `github-copilot` for Copilot CLI, `vscode-copilot` for GitHub Copilot Chat/Agent in VS Code, `visual-studio` for Copilot in Visual Studio, and `copilot-jetbrains` for Copilot in JetBrains IDEs. `gemini` (Gemini CLI, retired June 2026) and `roo-code` (shut down May 2026) still work but are legacy; use `antigravity` for Google's agent. This installs **every skill in the library** (`status: preview` skills included — they are labelled as preview in their guidance, and `--stable-only` skips them) to `~/.claude/skills/<slug>/SKILL.md` (or the agent's equivalent user-skill directory) AND writes the MCP server config so the agent can talk to the engine, then runs doctor and prints what it installed and where. The `--force` flag wipes any stale skill content first, so re-runs always end up with the latest copy. `--recommended` installs only the recommended subset — don't use it from this playbook.
 
 **First-install detection:** if `~/.claude/skills/` didn't exist before this command, Claude Code wasn't watching it and won't auto-detect the new files this session. Tell the user **once**: "Skills installed - restart your agent so they load." On subsequent installs (directory already existed), skills auto-detect mid-session and no restart is needed. **You can detect first-install vs upgrade by checking if `~/.claude/skills/` existed before Step 1; record the result before running setup.**
 
@@ -186,7 +186,7 @@ Only skip brainstorm if the user explicitly said "skip brainstorm" or "just buil
 - **Don't loop `summer login` if it times out at 120s.** Re-run it once and tell the user to be quicker; loop forever and the user is stuck.
 - **Don't jump straight into `summer create` from a vague prompt.** Invoke the `brainstorm-game` skill first (Step 6). The build skills assume `.summer/GameSoul.md` exists.
 
-**Using a different agent?** Replace `claude-code` with any supported agent in Step 1: `codex`, `cursor`, `windsurf`, `cline`, `roo-code`, `kilo-code`, `gemini`, `github-copilot`, `vscode-copilot`, `opencode`, or `lm-studio`. (`devin` is also accepted as an alias for `windsurf`.) Skill targets vary per agent; the CLI handles the difference, and [`integrations/README.md`](integrations/README.md) documents exactly what gets written where for every client. After install, **Cline and Roo Code users should restart VS Code** so the extension reloads its MCP config. **Gemini users** may need to run `gemini extensions enable summer-engine` after the first install. **VS Code Copilot users** should start the `summer-engine` MCP server from Agent mode if VS Code does not autostart it.
+**Using a different agent?** Replace `claude-code` with any supported agent in Step 1: `claude-desktop`, `codex`, `cursor`, `windsurf`, `antigravity`, `cline`, `cline-cli`, `kilo-code`, `github-copilot`, `vscode-copilot`, `visual-studio`, `copilot-jetbrains`, `opencode`, `zed`, `kiro`, `goose`, `hermes`, `trae`, `qwen-code`, `kimi-code`, `crush`, `amp`, `factory`, `junie`, `warp`, `rovo-dev`, `qoder`, `grok-build`, `mistral-vibe`, `lm-studio`. (`devin` is also accepted as an alias for `windsurf`; `agy` for `antigravity`; `droid` for `factory`.) Skill targets vary per agent; the CLI handles the difference, and [`integrations/README.md`](integrations/README.md) documents exactly what gets written where for every client. After install, **Cline users should restart VS Code** so the extension reloads its MCP config. **VS Code Copilot users** should start the `summer-engine` MCP server from Agent mode if VS Code does not autostart it.
 
 **Power-user note:** if the user specifically wants `summer` on their `PATH` for everyday terminal use outside the AI agent, a global npm install is still possible. The agent flow doesn't need it.
 
@@ -336,7 +336,7 @@ matchmaking are not promised by this package.
 | `summer list templates` / `projects` | Browse. |
 | `summer events [--follow] [--kinds <csv>] [--since <seq>] [--json]` | The engine events channel (engine 0.5.66+): newest events, or stream them live. |
 | `summer debug [issue…]` | Support-ready Markdown debug report. |
-| `summer skills list` | Show all skills. |
+| `summer skills list` | Show all skills (`--by-domain` groups them; the same grouping is in [`library/skills/README.md`](library/skills/README.md)). |
 | `summer skills install <name>` | Install one. |
 | `summer skills install --all --agent <agent>` / `--recommended` [`--stable-only`] | Install every skill (preview included and labelled), or only the recommended subset; `--stable-only` skips preview skills. |
 | `summer tool <name> --args '<json>'` | Run any Summer tool from the shell — the same implementation the MCP tool uses. `summer tool --list` prints them all. |
@@ -344,7 +344,7 @@ matchmaking are not promised by this package.
 | `summer mcp setup <agent>` | Deprecated alias of `summer setup <agent>`. |
 | `summer setup <agent> [--yes] [--force] [--recommended] [--stable-only]` | One shot: MCP config + all skills, preview included (`--recommended` for the subset, `--stable-only` to skip preview) + doctor. Idempotent. |
 
-Agents: `claude-code`, `codex`, `cursor`, `windsurf`, `cline`, `roo-code`, `kilo-code`, `gemini`, `github-copilot`, `vscode-copilot`, `opencode`, `lm-studio`. (`devin` and `devin-desktop` are accepted as aliases for `windsurf`.) Scopes: `--scope user` (default), `--scope project`.
+Agents: `claude-code`, `claude-desktop`, `codex`, `cursor`, `windsurf`, `antigravity`, `cline`, `cline-cli`, `kilo-code`, `github-copilot`, `vscode-copilot`, `visual-studio`, `copilot-jetbrains`, `opencode`, `zed`, `kiro`, `goose`, `hermes`, `trae`, `qwen-code`, `kimi-code`, `crush`, `amp`, `factory`, `junie`, `warp`, `rovo-dev`, `qoder`, `grok-build`, `mistral-vibe`, `lm-studio`. Legacy (still accepted, warn on use): `gemini`, `roo-code`. Aliases: `devin`/`devin-desktop` → `windsurf`, `agy` → `antigravity`, `droid` → `factory`, `copilot` → `github-copilot`, `vscode` → `vscode-copilot`, `kilo` → `kilo-code`, `qwen` → `qwen-code`, `kimi` → `kimi-code`. Scopes: `--scope user` (default), `--scope project`.
 
 ## Contributing
 

package/dist/cli/commands/setup.js

@@ -5,20 +5,7 @@ import { printDoctorResult, runDoctor } from "../../core/capabilities/doctor.js"
 import { brandLine, c, sym, tildeify } from "../../core/format.js";
 import { TOOLKIT_VERSION as cliVersion } from "../../core/version.js";
 import { resolveDefaultChannel } from "../../installer/version-check.js";
-const AGENT_LABEL = {
-    "claude-code": "Claude Code",
-    codex: "Codex",
-    cursor: "Cursor",
-    windsurf: "Devin Desktop (Windsurf)",
-    cline: "Cline",
-    "roo-code": "Roo Code",
-    "kilo-code": "Kilo Code",
-    gemini: "Gemini CLI",
-    "github-copilot": "GitHub Copilot CLI",
-    "vscode-copilot": "GitHub Copilot in VS Code",
-    opencode: "OpenCode",
-    "lm-studio": "LM Studio",
-};
+import { agentLabel } from "../../installer/agent-table.js";
 export const setupCommand = new Command("setup")
     .description("Configure Summer Engine for an AI agent and run diagnostics")
     .argument("[agent]", `Agent to configure: ${supportedAgents.join(", ")}`)
@@ -82,15 +69,15 @@ function printSetupResult(config, skills, doctor) {
     console.log("");
     console.log(brandLine(cliVersion));
     console.log("");
-    const agentLabel = AGENT_LABEL[config.agent] ?? config.agent;
+    const label = agentLabel(config.agent);
     if (config.dryRun) {
-        console.log(`  ${c.dim("(dry run)")}  Would link to ${agentLabel}  ${c.dim(tildeify(config.path))}`);
+        console.log(`  ${c.dim("(dry run)")}  Would link to ${label}  ${c.dim(tildeify(config.path))}`);
     }
     else if (config.wrote) {
-        console.log(`  ${sym.ok()}  Linked to ${c.bold(agentLabel)}  ${c.dim(tildeify(config.path))}`);
+        console.log(`  ${sym.ok()}  Linked to ${c.bold(label)}  ${c.dim(tildeify(config.path))}`);
     }
     else {
-        console.log(`  ${sym.ok()}  Already linked to ${c.bold(agentLabel)}  ${c.dim(tildeify(config.path))}`);
+        console.log(`  ${sym.ok()}  Already linked to ${c.bold(label)}  ${c.dim(tildeify(config.path))}`);
     }
     if (config.localDev) {
         console.log(`  ${c.dim("(local dev)")}  MCP server command: ${c.dim(`${config.server.command} ${config.server.args.join(" ")}`)}`);
@@ -140,7 +127,7 @@ function printSetupResult(config, skills, doctor) {
     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\"")}`);
+        console.log(`${c.dim("Try it:")} open ${label} and ask: ${c.bold("\"add a DirectionalLight3D and Camera3D to my scene\"")}`);
     }
 }
 function parseInstalledSkills(stdout) {

package/dist/cli/commands/skills.js

@@ -8,6 +8,7 @@ import { writeSkillMarker } from "../../installer/version-check.js";
 import { pruneRetiredSkills } from "../../installer/legacy-skills.js";
 import { resolveInstallLocation, resolveSkillAgent, resolveSkillScope, } from "../../installer/skill-locations.js";
 import { PACKAGE_ROOT } from "../../core/package-root.js";
+import { agentLabel as tableAgentLabel, agentSpec, defaultPathContext, legacyRuleFiles } from "../../installer/agent-table.js";
 import { TOOLKIT_VERSION as cliVersion } from "../../core/version.js";
 // Skill files live in library/skills/<slug>/ and are resolved through the
 // generated registry (registry/generated/skills-registry.json).
@@ -52,32 +53,7 @@ function orDie(parse) {
     }
 }
 function agentLabel(agent) {
-    switch (agent) {
-        case "claude-code":
-            return "Claude Code";
-        case "codex":
-            return "Codex";
-        case "cursor":
-            return "Cursor";
-        case "windsurf":
-            return "Devin Desktop (Windsurf)";
-        case "cline":
-            return "Cline";
-        case "roo-code":
-            return "Roo Code";
-        case "kilo-code":
-            return "Kilo Code";
-        case "gemini":
-            return "Gemini CLI";
-        case "github-copilot":
-            return "GitHub Copilot CLI";
-        case "vscode-copilot":
-            return "GitHub Copilot in VS Code";
-        case "opencode":
-            return "OpenCode";
-        case "summer":
-            return "Summer";
-    }
+    return agent === "summer" ? "Summer" : tableAgentLabel(agent);
 }
 function previewSkippedLine(count) {
     return `  Skipped ${count} preview skill${count === 1 ? "" : "s"} (--stable-only).`;
@@ -219,11 +195,11 @@ 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).`);
+    const reloadHint = agent === "summer" ? undefined : agentSpec(agent).skills?.reloadHint;
     if (location.kind === "skill-dir") {
         console.log(`${label} can read skills from ${tildeified}/<skill>/SKILL.md`);
-        if (agent === "gemini") {
-            console.log("Gemini loads them as extension skills; run `summer setup gemini` once so the extension manifest exists, then restart Gemini CLI.");
-        }
+        if (reloadHint)
+            console.log(reloadHint);
     }
     else if (location.kind === "cursor-rule-dir") {
         console.log(`Cursor rules are in ${tildeified}/summer-<skill>.mdc`);
@@ -248,17 +224,36 @@ export const skillsCommand = new Command("skills")
 skillsCommand
     .command("list")
     .description("List available skills")
-    .action(() => {
+    .option("--by-domain", "Group skills by their primary domain (same grouping as library/skills/README.md)")
+    .action((opts) => {
     const skills = getBuiltinSkills();
     if (skills.length === 0) {
         console.log("No skills found.");
         return;
     }
-    console.log("Available public skills:\n");
-    for (const s of skills) {
+    const line = (s) => {
         const badge = s.recommended ? "recommended" : "optional";
         const tag = s.status === "preview" ? "[preview] " : "";
-        console.log(`  ${s.name.padEnd(24)} ${badge.padEnd(11)} ${tag}${s.description}`);
+        return `  ${s.name.padEnd(24)} ${badge.padEnd(11)} ${tag}${s.description}`;
+    };
+    if (opts.byDomain) {
+        const groups = new Map();
+        for (const s of skills) {
+            const primary = s.domains[0] ?? "uncategorised";
+            groups.set(primary, [...(groups.get(primary) ?? []), s]);
+        }
+        console.log(`${skills.length} skills by primary domain (full index: library/skills/README.md):`);
+        for (const domain of [...groups.keys()].sort()) {
+            const group = groups.get(domain);
+            console.log(`\n${domain} (${group.length})`);
+            for (const s of group)
+                console.log(line(s));
+        }
+    }
+    else {
+        console.log("Available public skills:\n");
+        for (const s of skills)
+            console.log(line(s));
     }
     const previewCount = skills.filter((s) => s.status === "preview").length;
     if (previewCount > 0) {
@@ -307,6 +302,18 @@ skillsCommand
         for (const pruned of pruneRetiredSkills(location.path, getSkillRegistry().map((entry) => entry.name))) {
             console.log(`  Removed ${pruned.name} -> ${pruned.path} (retired in 3.0.0)`);
         }
+        // Agents that moved from generated rule files to SKILL.md skills in 3.1
+        // (Cursor, OpenCode): drop the rule files 3.0 wrote so the agent does not
+        // load both for the same slug. Only files with Summer's own naming go.
+        if (agent !== "summer" && !process.env.SUMMER_SKILLS_DIR) {
+            const legacy = legacyRuleFiles(agentSpec(agent), scope, defaultPathContext(), skills.map((skill) => skill.name)) ?? [];
+            for (const file of legacy) {
+                if (!existsSync(file))
+                    continue;
+                rmSync(file, { force: true });
+                console.log(`  Removed ${tildeify(file)} (rule file from Summer 3.0; now a skill)`);
+            }
+        }
     }
     if (name && skills[0]?.status === "preview") {
         console.log(`  Note: ${name} is a preview skill — not yet exercised in-engine by the Summer team; its guidance says so.`);

package/dist/core/capabilities/runtime-control.d.ts

@@ -186,18 +186,18 @@ export declare const runtimeAnimateArgsSchema: z.ZodObject<{
     instance?: string | undefined;
     name?: string | undefined;
     value?: string | number | boolean | undefined;
+    space?: "local" | "global" | "both" | undefined;
+    cmd?: "pause" | "play" | "stop" | "state" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     blend?: number | undefined;
     state?: string | undefined;
     position?: number | undefined;
     speed?: number | undefined;
     bones?: string[] | undefined;
-    cmd?: "pause" | "play" | "stop" | "state" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     from_end?: boolean | undefined;
     update?: boolean | undefined;
     reset?: boolean | undefined;
     param?: string | undefined;
     playback_path?: string | undefined;
-    space?: "local" | "global" | "both" | undefined;
     include_rest?: boolean | undefined;
 }, {
     path: string;
@@ -205,18 +205,18 @@ export declare const runtimeAnimateArgsSchema: z.ZodObject<{
     instance?: string | undefined;
     name?: string | undefined;
     value?: string | number | boolean | undefined;
+    space?: "local" | "global" | "both" | undefined;
+    cmd?: "pause" | "play" | "stop" | "state" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     blend?: number | undefined;
     state?: string | undefined;
     position?: number | undefined;
     speed?: number | undefined;
     bones?: string[] | undefined;
-    cmd?: "pause" | "play" | "stop" | "state" | "seek" | "speed" | "travel" | "start" | "set_param" | "get_param" | undefined;
     from_end?: boolean | undefined;
     update?: boolean | undefined;
     reset?: boolean | undefined;
     param?: string | undefined;
     playback_path?: string | undefined;
-    space?: "local" | "global" | "both" | undefined;
     include_rest?: boolean | undefined;
 }>;
 export type RuntimeAnimateArgs = z.infer<typeof runtimeAnimateArgsSchema>;

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

@@ -1,4 +1,10 @@
-export declare const AGENT_CLIENTS: readonly ["summer", "codex", "claude-code", "cursor", "windsurf", "cline", "roo-code", "kilo-code", "gemini", "github-copilot", "vscode-copilot", "opencode"];
+/**
+ * Clients `summer skills install --agent` accepts: "summer" (the toolkit's
+ * own ~/.summer/skills) plus every agent in the installer's agent table that
+ * has a skills or rules folder. core/ cannot import installer/, so this list
+ * is written out; agent-table.test.ts fails if the two drift.
+ */
+export declare const AGENT_CLIENTS: readonly ["summer", "claude-code", "codex", "cursor", "windsurf", "antigravity", "gemini", "cline", "cline-cli", "roo-code", "kilo-code", "github-copilot", "vscode-copilot", "opencode", "zed", "kiro", "goose", "hermes", "qwen-code", "kimi-code", "crush", "amp", "factory", "warp", "rovo-dev", "qoder", "grok-build", "mistral-vibe"];
 export type AgentClient = (typeof AGENT_CLIENTS)[number];
 /** resource.yaml `status` (registry/schemas/skill.schema.json). */
 export type SkillStatus = "stable" | "preview" | "deprecated";
@@ -17,6 +23,8 @@ export interface SkillRegistryEntry {
     status: SkillStatus;
     /** Package-root-relative skill dir, e.g. "library/skills/3d-lighting/". */
     path: string;
+    /** facets.domains from resource.yaml; the first is the primary domain. Empty on old registries. */
+    domains: string[];
 }
 /**
  * Load the generated skill registry (cached after first read).

package/dist/core/skills-registry.js

@@ -11,19 +11,41 @@
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { PACKAGE_ROOT } from "./package-root.js";
+/**
+ * Clients `summer skills install --agent` accepts: "summer" (the toolkit's
+ * own ~/.summer/skills) plus every agent in the installer's agent table that
+ * has a skills or rules folder. core/ cannot import installer/, so this list
+ * is written out; agent-table.test.ts fails if the two drift.
+ */
 export const AGENT_CLIENTS = [
     "summer",
-    "codex",
     "claude-code",
+    "codex",
     "cursor",
     "windsurf",
+    "antigravity",
+    "gemini",
     "cline",
+    "cline-cli",
     "roo-code",
     "kilo-code",
-    "gemini",
     "github-copilot",
     "vscode-copilot",
     "opencode",
+    "zed",
+    "kiro",
+    "goose",
+    "hermes",
+    "qwen-code",
+    "kimi-code",
+    "crush",
+    "amp",
+    "factory",
+    "warp",
+    "rovo-dev",
+    "qoder",
+    "grok-build",
+    "mistral-vibe",
 ];
 const packageRoot = PACKAGE_ROOT;
 const REGISTRY_RELPATH = join("registry", "generated", "skills-registry.json");
@@ -55,6 +77,7 @@ export function parseSkillRegistry(json) {
         recommended: s.recommended === true,
         status: s.status === "preview" || s.status === "deprecated" ? s.status : "stable",
         path: s.path,
+        domains: Array.isArray(s.domains) ? s.domains.filter((d) => typeof d === "string") : [],
     }));
 }
 /**

package/dist/installer/agent-config.d.ts

@@ -1,7 +1,6 @@
+import { type ConfigScope, type McpFormat, type SupportedAgent } from "./agent-table.js";
+export { supportedAgents, type ConfigScope, type SupportedAgent } from "./agent-table.js";
 export declare const SUMMER_MCP_SERVER_NAME = "summer-engine";
-export declare const supportedAgents: readonly ["codex", "claude-code", "cursor", "windsurf", "cline", "roo-code", "kilo-code", "gemini", "github-copilot", "vscode-copilot", "opencode", "lm-studio"];
-export type SupportedAgent = (typeof supportedAgents)[number];
-export type ConfigScope = "user" | "project";
 export interface StdioMcpServerConfig {
     command: string;
     args: string[];
@@ -25,7 +24,7 @@ export interface AgentConfigResult {
     path: string;
     serverName: string;
     server: StdioMcpServerConfig;
-    format: "json" | "toml" | "json-opencode" | "json-copilot" | "json-vscode";
+    format: McpFormat;
     snippet: string;
     changed: boolean;
     wrote: boolean;
@@ -37,6 +36,7 @@ export interface AgentConfigResult {
     warnings: string[];
     nextSteps: string[];
 }
+type JsonObject = Record<string, unknown>;
 export declare function parseAgent(value: string | undefined): SupportedAgent | null;
 export declare function parseScope(value: string | undefined): ConfigScope | null;
 /** `summer setup [agent] --agent <agent>`: positional and option must agree;
@@ -52,7 +52,12 @@ export declare const DEFAULT_CHANNEL = "latest";
 export declare function normalizeChannel(channel: string | undefined): string;
 export declare function createSummerMcpServerConfig(localDev: boolean, platform?: NodeJS.Platform, channel?: string): StdioMcpServerConfig;
 export declare function renderConfigSnippet(agent: SupportedAgent, server: StdioMcpServerConfig): string;
+/** The key under which the file lists MCP servers (see McpFormat in agent-table.ts). */
+export declare function topLevelKey(format: McpFormat): string;
+/** One server entry in the shape the agent's file expects. */
+export declare function mcpEntry(format: McpFormat, server: StdioMcpServerConfig): JsonObject;
 /** Installed package root (dist/ and src/ alike). */
 export declare function resolvePackageRoot(): string;
 /** Directory name Gemini expects the extension under; the manifest `name` must match it. */
 export declare const GEMINI_EXTENSION_DIR_NAME = "summer-engine";
+export declare function upsertTomlArrayBlock(content: string, block: string): string;