fix(#1394): exclude Skill/SlashCommand from the Gemini agent tool converter

convertGeminiToolName lowercased any unmapped Claude tool, so Skill and
SlashCommand became an invalid `skill`/`slashcommand` tool name. Gemini CLI
has no such built-in tool, so frontmatter validation failed (tools.N: Invalid
tool name) and aborted the entire agent load — 22 of 34 GSD agents were dead
on Gemini.

Add Skill and SlashCommand to the same `return null` exclusion branch that
already handles AskUserQuestion, in both the canonical src converter and the
hand-maintained bin/install.js copy that runs on the live --gemini install
path. Antigravity reuses this converter (it runs on the Gemini backend) and is
intentionally covered by the same exclusion — it surfaces GSD skills via the
skill surface (SKILL.md), not the agent tools: allowlist — locked by an added
Antigravity regression test.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

bin/install.js

@@ -1545,11 +1545,17 @@ function convertGeminiToolName(claudeTool) {
   // Task/Agent: exclude — agents are auto-registered as callable tools.
   // AskUserQuestion: exclude — Gemini CLI does not expose an ask_user tool;
   // emitting it causes frontmatter validation errors (#3362).
+  // Skill/SlashCommand: exclude — Gemini CLI has no 'skill' built-in tool;
+  // the lowercase fallback would emit an invalid 'skill'/'slashcommand' name
+  // that fails frontmatter validation (tools.N: Invalid tool name) and aborts
+  // the entire agent load (#1394).
   if (
     claudeTool === 'Task' ||
     claudeTool === 'Agent' ||
     claudeTool === 'AskUserQuestion' ||
-    claudeTool === 'ask_user'
+    claudeTool === 'ask_user' ||
+    claudeTool === 'Skill' ||
+    claudeTool === 'SlashCommand'
   ) {
     return null;
   }

src/runtime-artifact-conversion.cts

@@ -1812,11 +1812,17 @@ function convertGeminiToolName(claudeTool) {
   // Task/Agent: exclude — agents are auto-registered as callable tools.
   // AskUserQuestion: exclude — Gemini CLI does not expose an ask_user tool;
   // emitting it causes frontmatter validation errors (#3362).
+  // Skill/SlashCommand: exclude — Gemini CLI has no 'skill' built-in tool;
+  // the lowercase fallback would emit an invalid 'skill'/'slashcommand' name
+  // that fails frontmatter validation (tools.N: Invalid tool name) and aborts
+  // the entire agent load (#1394).
   if (
     claudeTool === 'Task' ||
     claudeTool === 'Agent' ||
     claudeTool === 'AskUserQuestion' ||
-    claudeTool === 'ask_user'
+    claudeTool === 'ask_user' ||
+    claudeTool === 'Skill' ||
+    claudeTool === 'SlashCommand'
   ) {
     return null;
   }

tests/runtime-converters.test.cjs

@@ -18,6 +18,7 @@ const {
   convertClaudeToOpencodeFrontmatter,
   convertClaudeToKiloFrontmatter,
   convertClaudeToGeminiAgent,
+  convertClaudeAgentToAntigravityAgent,
   convertClaudeCommandToOpencodeSkill,
   convertClaudeCommandToKiloSkill,
   neutralizeAgentReferences,
@@ -292,6 +293,69 @@ Offer choices via AskUserQuestion when user input is needed.
     assert.ok(!result.includes('AskUserQuestion'), 'does not leave Claude-only tool references in the body');
     assert.ok(result.includes('conversational prompting'), 'uses runtime-neutral body wording for user prompts');
   });
+
+  describe('#1394 regression: excludes Skill/SlashCommand from Gemini frontmatter', () => {
+    // Skill/SlashCommand are Claude-only tools with no Gemini built-in equivalent.
+    // Without explicit exclusion they hit the lowercase fallback and emit an
+    // invalid 'skill'/'slashcommand' tool name, which fails Gemini frontmatter
+    // validation (tools.N: Invalid tool name) and aborts the entire agent load —
+    // previously killing 22 of 34 GSD agents on Gemini.
+
+    // Direct unit assertion against the canonical converter (criterion 1).
+    test('convertGeminiToolName returns null for Skill and SlashCommand', () => {
+      const { convertGeminiToolName } = require('../gsd-core/bin/lib/runtime-artifact-conversion.cjs');
+      assert.equal(convertGeminiToolName('Skill'), null, 'Skill is excluded, not lowercased to "skill"');
+      assert.equal(convertGeminiToolName('SlashCommand'), null, 'SlashCommand is excluded, not lowercased to "slashcommand"');
+      // Existing AskUserQuestion exclusion must still hold.
+      assert.equal(convertGeminiToolName('AskUserQuestion'), null, 'AskUserQuestion remains excluded');
+      // Sanity: a mapped tool still converts.
+      assert.equal(convertGeminiToolName('Read'), 'read_file', 'mapped tools still convert');
+    });
+
+    // Agent-level assertion against the live install path (criterion 2/3).
+    test('a Skill tools entry produces no skill/slashcommand in emitted frontmatter', () => {
+      const input = `---
+name: gsd-planner
+description: Creates executable phase plans.
+tools: Read, Write, Bash, Glob, Grep, Skill, WebFetch, SlashCommand
+---
+
+<role>
+Plan the phase.
+</role>`;
+
+      const result = convertClaudeToGeminiAgent(input);
+      const frontmatter = result.split('---')[1] || '';
+
+      assert.ok(frontmatter.includes('  - read_file'), 'maps Read -> read_file');
+      assert.ok(frontmatter.includes('  - web_fetch'), 'maps WebFetch -> web_fetch');
+      assert.ok(!frontmatter.includes('  - skill'), 'does not emit invalid Gemini skill tool');
+      assert.ok(!frontmatter.includes('  - slashcommand'), 'does not emit invalid Gemini slashcommand tool');
+    });
+
+    // Antigravity reuses convertGeminiToolName (it runs on the Gemini backend),
+    // so the exclusion intentionally applies there too. Antigravity surfaces GSD
+    // skills through the skill surface (SKILL.md), not the agent tools: allowlist,
+    // so dropping the invalid 'skill' tool name does not remove skill access —
+    // this locks that cross-runtime behavior (criterion 4).
+    test('Antigravity conversion also excludes Skill/SlashCommand (shared Gemini backend)', () => {
+      const input = `---
+name: gsd-planner
+description: Creates executable phase plans.
+tools: Read, Write, Bash, Skill, WebFetch, SlashCommand
+---
+
+<role>Plan the phase.</role>`;
+
+      const result = convertClaudeAgentToAntigravityAgent(input);
+      const toolsLine = result.split('\n').find(l => l.startsWith('tools:')) || '';
+
+      assert.ok(toolsLine.includes('read_file'), 'maps Read -> read_file');
+      assert.ok(toolsLine.includes('web_fetch'), 'maps WebFetch -> web_fetch');
+      assert.ok(!/\bskill\b/.test(toolsLine), 'no invalid skill tool in Antigravity frontmatter');
+      assert.ok(!/\bslashcommand\b/.test(toolsLine), 'no invalid slashcommand tool in Antigravity frontmatter');
+    });
+  });
 });
 
 // ─── neutralizeAgentReferences (#766) ─────────────────────────────────────────