feat(core): add skill patching support with /memory inbox integration (#25148)

packages/cli/src/ui/components/SkillInboxDialog.test.tsx

@@ -5,12 +5,16 @@
  */
 
 import { act } from 'react';
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-import type { Config, InboxSkill } from '@google/gemini-cli-core';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import type { Config, InboxSkill, InboxPatch } from '@google/gemini-cli-core';
 import {
   dismissInboxSkill,
   listInboxSkills,
+  listInboxPatches,
   moveInboxSkill,
+  applyInboxPatch,
+  dismissInboxPatch,
+  isProjectSkillPatchTarget,
 } from '@google/gemini-cli-core';
 import { waitFor } from '../../test-utils/async.js';
 import { renderWithProviders } from '../../test-utils/render.js';
@@ -24,7 +28,11 @@ vi.mock('@google/gemini-cli-core', async (importOriginal) => {
     ...original,
     dismissInboxSkill: vi.fn(),
     listInboxSkills: vi.fn(),
+    listInboxPatches: vi.fn(),
     moveInboxSkill: vi.fn(),
+    applyInboxPatch: vi.fn(),
+    dismissInboxPatch: vi.fn(),
+    isProjectSkillPatchTarget: vi.fn(),
     getErrorMessage: vi.fn((error: unknown) =>
       error instanceof Error ? error.message : String(error),
     ),
@@ -32,20 +40,108 @@ vi.mock('@google/gemini-cli-core', async (importOriginal) => {
 });
 
 const mockListInboxSkills = vi.mocked(listInboxSkills);
+const mockListInboxPatches = vi.mocked(listInboxPatches);
 const mockMoveInboxSkill = vi.mocked(moveInboxSkill);
 const mockDismissInboxSkill = vi.mocked(dismissInboxSkill);
+const mockApplyInboxPatch = vi.mocked(applyInboxPatch);
+const mockDismissInboxPatch = vi.mocked(dismissInboxPatch);
+const mockIsProjectSkillPatchTarget = vi.mocked(isProjectSkillPatchTarget);
 
 const inboxSkill: InboxSkill = {
   dirName: 'inbox-skill',
   name: 'Inbox Skill',
   description: 'A test skill',
+  content:
+    '---\nname: Inbox Skill\ndescription: A test skill\n---\n\n## Procedure\n1. Do the thing\n',
   extractedAt: '2025-01-15T10:00:00Z',
 };
 
+const inboxPatch: InboxPatch = {
+  fileName: 'update-docs.patch',
+  name: 'update-docs',
+  entries: [
+    {
+      targetPath: '/home/user/.gemini/skills/docs-writer/SKILL.md',
+      diffContent: [
+        '--- /home/user/.gemini/skills/docs-writer/SKILL.md',
+        '+++ /home/user/.gemini/skills/docs-writer/SKILL.md',
+        '@@ -1,3 +1,4 @@',
+        ' line1',
+        ' line2',
+        '+line2.5',
+        ' line3',
+      ].join('\n'),
+    },
+  ],
+  extractedAt: '2025-01-20T14:00:00Z',
+};
+
+const workspacePatch: InboxPatch = {
+  fileName: 'workspace-update.patch',
+  name: 'workspace-update',
+  entries: [
+    {
+      targetPath: '/repo/.gemini/skills/docs-writer/SKILL.md',
+      diffContent: [
+        '--- /repo/.gemini/skills/docs-writer/SKILL.md',
+        '+++ /repo/.gemini/skills/docs-writer/SKILL.md',
+        '@@ -1,1 +1,2 @@',
+        ' line1',
+        '+line2',
+      ].join('\n'),
+    },
+  ],
+};
+
+const multiSectionPatch: InboxPatch = {
+  fileName: 'multi-section.patch',
+  name: 'multi-section',
+  entries: [
+    {
+      targetPath: '/home/user/.gemini/skills/docs-writer/SKILL.md',
+      diffContent: [
+        '--- /home/user/.gemini/skills/docs-writer/SKILL.md',
+        '+++ /home/user/.gemini/skills/docs-writer/SKILL.md',
+        '@@ -1,1 +1,2 @@',
+        ' line1',
+        '+line2',
+      ].join('\n'),
+    },
+    {
+      targetPath: '/home/user/.gemini/skills/docs-writer/SKILL.md',
+      diffContent: [
+        '--- /home/user/.gemini/skills/docs-writer/SKILL.md',
+        '+++ /home/user/.gemini/skills/docs-writer/SKILL.md',
+        '@@ -3,1 +4,2 @@',
+        ' line3',
+        '+line4',
+      ].join('\n'),
+    },
+  ],
+};
+
+const windowsGlobalPatch: InboxPatch = {
+  fileName: 'windows-update.patch',
+  name: 'windows-update',
+  entries: [
+    {
+      targetPath: 'C:\\Users\\sandy\\.gemini\\skills\\docs-writer\\SKILL.md',
+      diffContent: [
+        '--- C:\\Users\\sandy\\.gemini\\skills\\docs-writer\\SKILL.md',
+        '+++ C:\\Users\\sandy\\.gemini\\skills\\docs-writer\\SKILL.md',
+        '@@ -1,1 +1,2 @@',
+        ' line1',
+        '+line2',
+      ].join('\n'),
+    },
+  ],
+};
+
 describe('SkillInboxDialog', () => {
   beforeEach(() => {
     vi.clearAllMocks();
     mockListInboxSkills.mockResolvedValue([inboxSkill]);
+    mockListInboxPatches.mockResolvedValue([]);
     mockMoveInboxSkill.mockResolvedValue({
       success: true,
       message: 'Moved "inbox-skill" to ~/.gemini/skills.',
@@ -54,6 +150,30 @@ describe('SkillInboxDialog', () => {
       success: true,
       message: 'Dismissed "inbox-skill" from inbox.',
     });
+    mockApplyInboxPatch.mockResolvedValue({
+      success: true,
+      message: 'Applied patch to 1 file.',
+    });
+    mockDismissInboxPatch.mockResolvedValue({
+      success: true,
+      message: 'Dismissed "update-docs.patch" from inbox.',
+    });
+    mockIsProjectSkillPatchTarget.mockImplementation(
+      async (targetPath: string, config: Config) => {
+        const projectSkillsDir = config.storage
+          ?.getProjectSkillsDir?.()
+          ?.replaceAll('\\', '/')
+          ?.replace(/\/+$/, '');
+
+        return projectSkillsDir
+          ? targetPath.replaceAll('\\', '/').startsWith(projectSkillsDir)
+          : false;
+      },
+    );
+  });
+
+  afterEach(() => {
+    vi.unstubAllEnvs();
   });
 
   it('disables the project destination when the workspace is untrusted', async () => {
@@ -75,6 +195,17 @@ describe('SkillInboxDialog', () => {
       expect(lastFrame()).toContain('Inbox Skill');
     });
 
+    // Select skill → lands on preview
+    await act(async () => {
+      stdin.write('\r');
+      await waitUntilReady();
+    });
+
+    await waitFor(() => {
+      expect(lastFrame()).toContain('Review new skill');
+    });
+
+    // Select "Move" → lands on destination chooser
     await act(async () => {
       stdin.write('\r');
       await waitUntilReady();
@@ -86,22 +217,6 @@ describe('SkillInboxDialog', () => {
       expect(frame).toContain('unavailable until this workspace is trusted');
     });
 
-    await act(async () => {
-      stdin.write('\x1b[B');
-      await waitUntilReady();
-    });
-
-    await act(async () => {
-      stdin.write('\r');
-      await waitUntilReady();
-    });
-
-    await waitFor(() => {
-      expect(mockDismissInboxSkill).toHaveBeenCalledWith(config, 'inbox-skill');
-    });
-    expect(mockMoveInboxSkill).not.toHaveBeenCalled();
-    expect(onReloadSkills).not.toHaveBeenCalled();
-
     unmount();
   });
 
@@ -125,11 +240,19 @@ describe('SkillInboxDialog', () => {
       expect(lastFrame()).toContain('Inbox Skill');
     });
 
+    // Select skill → preview
     await act(async () => {
       stdin.write('\r');
       await waitUntilReady();
     });
 
+    // Select "Move" → destination chooser
+    await act(async () => {
+      stdin.write('\r');
+      await waitUntilReady();
+    });
+
+    // Select "Global" → triggers move
     await act(async () => {
       stdin.write('\r');
       await waitUntilReady();
@@ -165,11 +288,19 @@ describe('SkillInboxDialog', () => {
       expect(lastFrame()).toContain('Inbox Skill');
     });
 
+    // Select skill → preview
     await act(async () => {
       stdin.write('\r');
       await waitUntilReady();
     });
 
+    // Select "Move" → destination chooser
+    await act(async () => {
+      stdin.write('\r');
+      await waitUntilReady();
+    });
+
+    // Select "Global" → triggers move
     await act(async () => {
       stdin.write('\r');
       await waitUntilReady();
@@ -184,4 +315,346 @@ describe('SkillInboxDialog', () => {
 
     unmount();
   });
+
+  describe('patch support', () => {
+    it('shows patches alongside skills with section headers', async () => {
+      mockListInboxPatches.mockResolvedValue([inboxPatch]);
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(true),
+        storage: {
+          getProjectSkillsDir: vi.fn().mockReturnValue('/repo/.gemini/skills'),
+        },
+      } as unknown as Config;
+      const { lastFrame, unmount } = await act(async () =>
+        renderWithProviders(
+          <SkillInboxDialog
+            config={config}
+            onClose={vi.fn()}
+            onReloadSkills={vi.fn().mockResolvedValue(undefined)}
+          />,
+        ),
+      );
+
+      await waitFor(() => {
+        const frame = lastFrame();
+        expect(frame).toContain('New Skills');
+        expect(frame).toContain('Inbox Skill');
+        expect(frame).toContain('Skill Updates');
+        expect(frame).toContain('update-docs');
+      });
+
+      unmount();
+    });
+
+    it('shows diff preview when a patch is selected', async () => {
+      mockListInboxSkills.mockResolvedValue([]);
+      mockListInboxPatches.mockResolvedValue([inboxPatch]);
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(true),
+        storage: {
+          getProjectSkillsDir: vi.fn().mockReturnValue('/repo/.gemini/skills'),
+        },
+      } as unknown as Config;
+      const { lastFrame, stdin, unmount, waitUntilReady } = await act(
+        async () =>
+          renderWithProviders(
+            <SkillInboxDialog
+              config={config}
+              onClose={vi.fn()}
+              onReloadSkills={vi.fn().mockResolvedValue(undefined)}
+            />,
+          ),
+      );
+
+      await waitFor(() => {
+        expect(lastFrame()).toContain('update-docs');
+      });
+
+      // Select the patch
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      await waitFor(() => {
+        const frame = lastFrame();
+        expect(frame).toContain('Review changes before applying');
+        expect(frame).toContain('Apply');
+        expect(frame).toContain('Dismiss');
+      });
+
+      unmount();
+    });
+
+    it('applies a patch when Apply is selected', async () => {
+      mockListInboxSkills.mockResolvedValue([]);
+      mockListInboxPatches.mockResolvedValue([inboxPatch]);
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(true),
+        storage: {
+          getProjectSkillsDir: vi.fn().mockReturnValue('/repo/.gemini/skills'),
+        },
+      } as unknown as Config;
+      const onReloadSkills = vi.fn().mockResolvedValue(undefined);
+      const { stdin, unmount, waitUntilReady } = await act(async () =>
+        renderWithProviders(
+          <SkillInboxDialog
+            config={config}
+            onClose={vi.fn()}
+            onReloadSkills={onReloadSkills}
+          />,
+        ),
+      );
+
+      await waitFor(() => {
+        expect(mockListInboxPatches).toHaveBeenCalled();
+      });
+
+      // Select the patch
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      // Select "Apply"
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      await waitFor(() => {
+        expect(mockApplyInboxPatch).toHaveBeenCalledWith(
+          config,
+          'update-docs.patch',
+        );
+      });
+      expect(onReloadSkills).toHaveBeenCalled();
+
+      unmount();
+    });
+
+    it('disables Apply for workspace patches in an untrusted workspace', async () => {
+      mockListInboxSkills.mockResolvedValue([]);
+      mockListInboxPatches.mockResolvedValue([workspacePatch]);
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(false),
+        storage: {
+          getProjectSkillsDir: vi.fn().mockReturnValue('/repo/.gemini/skills'),
+        },
+      } as unknown as Config;
+      const { lastFrame, stdin, unmount, waitUntilReady } = await act(
+        async () =>
+          renderWithProviders(
+            <SkillInboxDialog
+              config={config}
+              onClose={vi.fn()}
+              onReloadSkills={vi.fn().mockResolvedValue(undefined)}
+            />,
+          ),
+      );
+
+      await waitFor(() => {
+        expect(lastFrame()).toContain('workspace-update');
+      });
+
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      await waitFor(() => {
+        const frame = lastFrame();
+        expect(frame).toContain('Apply');
+        expect(frame).toContain(
+          '.gemini/skills — unavailable until this workspace is trusted',
+        );
+      });
+      expect(mockApplyInboxPatch).not.toHaveBeenCalled();
+
+      unmount();
+    });
+
+    it('uses canonical project-scope checks before enabling Apply', async () => {
+      mockListInboxSkills.mockResolvedValue([]);
+      mockListInboxPatches.mockResolvedValue([workspacePatch]);
+      mockIsProjectSkillPatchTarget.mockResolvedValue(true);
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(false),
+        storage: {
+          getProjectSkillsDir: vi
+            .fn()
+            .mockReturnValue('/symlinked/workspace/.gemini/skills'),
+        },
+      } as unknown as Config;
+      const { lastFrame, stdin, unmount, waitUntilReady } = await act(
+        async () =>
+          renderWithProviders(
+            <SkillInboxDialog
+              config={config}
+              onClose={vi.fn()}
+              onReloadSkills={vi.fn().mockResolvedValue(undefined)}
+            />,
+          ),
+      );
+
+      await waitFor(() => {
+        expect(lastFrame()).toContain('workspace-update');
+      });
+
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      await waitFor(() => {
+        expect(lastFrame()).toContain(
+          '.gemini/skills — unavailable until this workspace is trusted',
+        );
+      });
+      expect(mockIsProjectSkillPatchTarget).toHaveBeenCalledWith(
+        '/repo/.gemini/skills/docs-writer/SKILL.md',
+        config,
+      );
+      expect(mockApplyInboxPatch).not.toHaveBeenCalled();
+
+      unmount();
+    });
+
+    it('dismisses a patch when Dismiss is selected', async () => {
+      mockListInboxSkills.mockResolvedValue([]);
+      mockListInboxPatches.mockResolvedValue([inboxPatch]);
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(true),
+        storage: {
+          getProjectSkillsDir: vi.fn().mockReturnValue('/repo/.gemini/skills'),
+        },
+      } as unknown as Config;
+      const onReloadSkills = vi.fn().mockResolvedValue(undefined);
+      const { stdin, unmount, waitUntilReady } = await act(async () =>
+        renderWithProviders(
+          <SkillInboxDialog
+            config={config}
+            onClose={vi.fn()}
+            onReloadSkills={onReloadSkills}
+          />,
+        ),
+      );
+
+      await waitFor(() => {
+        expect(mockListInboxPatches).toHaveBeenCalled();
+      });
+
+      // Select the patch
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      // Move down to "Dismiss" and select
+      await act(async () => {
+        stdin.write('\x1b[B');
+        await waitUntilReady();
+      });
+
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      await waitFor(() => {
+        expect(mockDismissInboxPatch).toHaveBeenCalledWith(
+          config,
+          'update-docs.patch',
+        );
+      });
+      expect(onReloadSkills).not.toHaveBeenCalled();
+
+      unmount();
+    });
+
+    it('shows Windows patch entries with a basename and origin tag', async () => {
+      vi.stubEnv('USERPROFILE', 'C:\\Users\\sandy');
+      mockListInboxSkills.mockResolvedValue([]);
+      mockListInboxPatches.mockResolvedValue([windowsGlobalPatch]);
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(true),
+        storage: {
+          getProjectSkillsDir: vi
+            .fn()
+            .mockReturnValue('C:\\repo\\.gemini\\skills'),
+        },
+      } as unknown as Config;
+      const { lastFrame, unmount } = await act(async () =>
+        renderWithProviders(
+          <SkillInboxDialog
+            config={config}
+            onClose={vi.fn()}
+            onReloadSkills={vi.fn().mockResolvedValue(undefined)}
+          />,
+        ),
+      );
+
+      await waitFor(() => {
+        const frame = lastFrame();
+        expect(frame).toContain('[Global]');
+        expect(frame).toContain('SKILL.md');
+        expect(frame).not.toContain('C:\\Users\\sandy\\.gemini\\skills');
+      });
+
+      unmount();
+    });
+
+    it('renders multi-section patches without duplicate React keys', async () => {
+      mockListInboxSkills.mockResolvedValue([]);
+      mockListInboxPatches.mockResolvedValue([multiSectionPatch]);
+
+      const consoleErrorSpy = vi
+        .spyOn(console, 'error')
+        .mockImplementation(() => {});
+
+      const config = {
+        isTrustedFolder: vi.fn().mockReturnValue(true),
+        storage: {
+          getProjectSkillsDir: vi.fn().mockReturnValue('/repo/.gemini/skills'),
+        },
+      } as unknown as Config;
+      const { lastFrame, stdin, unmount, waitUntilReady } = await act(
+        async () =>
+          renderWithProviders(
+            <SkillInboxDialog
+              config={config}
+              onClose={vi.fn()}
+              onReloadSkills={vi.fn().mockResolvedValue(undefined)}
+            />,
+          ),
+      );
+
+      await waitFor(() => {
+        expect(lastFrame()).toContain('multi-section');
+      });
+
+      await act(async () => {
+        stdin.write('\r');
+        await waitUntilReady();
+      });
+
+      await waitFor(() => {
+        expect(lastFrame()).toContain('Review changes before applying');
+      });
+
+      expect(consoleErrorSpy).not.toHaveBeenCalledWith(
+        expect.stringContaining('Encountered two children with the same key'),
+      );
+
+      consoleErrorSpy.mockRestore();
+      unmount();
+    });
+  });
 });

packages/cli/src/ui/components/SkillInboxDialog.tsx

@@ -4,9 +4,10 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+import * as path from 'node:path';
 import type React from 'react';
 import { useState, useMemo, useCallback, useEffect } from 'react';
-import { Box, Text } from 'ink';
+import { Box, Text, useStdout } from 'ink';
 import { theme } from '../semantic-colors.js';
 import { useKeypress } from '../hooks/useKeypress.js';
 import { Command } from '../key/keyMatchers.js';
@@ -14,25 +15,42 @@ import { useKeyMatchers } from '../hooks/useKeyMatchers.js';
 import { BaseSelectionList } from './shared/BaseSelectionList.js';
 import type { SelectionListItem } from '../hooks/useSelectionList.js';
 import { DialogFooter } from './shared/DialogFooter.js';
+import { DiffRenderer } from './messages/DiffRenderer.js';
 import {
   type Config,
   type InboxSkill,
+  type InboxPatch,
   type InboxSkillDestination,
   getErrorMessage,
   listInboxSkills,
+  listInboxPatches,
   moveInboxSkill,
   dismissInboxSkill,
+  applyInboxPatch,
+  dismissInboxPatch,
+  isProjectSkillPatchTarget,
 } from '@google/gemini-cli-core';
 
-type Phase = 'list' | 'action';
+type Phase = 'list' | 'skill-preview' | 'skill-action' | 'patch-preview';
+
+type InboxItem =
+  | { type: 'skill'; skill: InboxSkill }
+  | { type: 'patch'; patch: InboxPatch; targetsProjectSkills: boolean }
+  | { type: 'header'; label: string };
 
 interface DestinationChoice {
-  destination: InboxSkillDestination | 'dismiss';
+  destination: InboxSkillDestination;
   label: string;
   description: string;
 }
 
-const DESTINATION_CHOICES: DestinationChoice[] = [
+interface PatchAction {
+  action: 'apply' | 'dismiss';
+  label: string;
+  description: string;
+}
+
+const SKILL_DESTINATION_CHOICES: DestinationChoice[] = [
   {
     destination: 'global',
     label: 'Global',
@@ -43,13 +61,105 @@ const DESTINATION_CHOICES: DestinationChoice[] = [
     label: 'Project',
     description: '.gemini/skills — available in this workspace',
   },
+];
+
+interface SkillPreviewAction {
+  action: 'move' | 'dismiss';
+  label: string;
+  description: string;
+}
+
+const SKILL_PREVIEW_CHOICES: SkillPreviewAction[] = [
   {
-    destination: 'dismiss',
+    action: 'move',
+    label: 'Move',
+    description: 'Choose where to install this skill',
+  },
+  {
+    action: 'dismiss',
     label: 'Dismiss',
     description: 'Delete from inbox',
   },
 ];
 
+const PATCH_ACTION_CHOICES: PatchAction[] = [
+  {
+    action: 'apply',
+    label: 'Apply',
+    description: 'Apply patch and delete from inbox',
+  },
+  {
+    action: 'dismiss',
+    label: 'Dismiss',
+    description: 'Delete from inbox without applying',
+  },
+];
+
+function normalizePathForUi(filePath: string): string {
+  return path.posix.normalize(filePath.replaceAll('\\', '/'));
+}
+
+function getPathBasename(filePath: string): string {
+  const normalizedPath = normalizePathForUi(filePath);
+  const basename = path.posix.basename(normalizedPath);
+  return basename === '.' ? filePath : basename;
+}
+
+async function patchTargetsProjectSkills(
+  patch: InboxPatch,
+  config: Config,
+): Promise<boolean> {
+  const entryTargetsProjectSkills = await Promise.all(
+    patch.entries.map((entry) =>
+      isProjectSkillPatchTarget(entry.targetPath, config),
+    ),
+  );
+  return entryTargetsProjectSkills.some(Boolean);
+}
+
+/**
+ * Derives a bracketed origin tag from a skill file path,
+ * matching the existing [Built-in] convention in SkillsList.
+ */
+function getSkillOriginTag(filePath: string): string {
+  const normalizedPath = normalizePathForUi(filePath);
+
+  if (normalizedPath.includes('/bundle/')) {
+    return 'Built-in';
+  }
+  if (normalizedPath.includes('/extensions/')) {
+    return 'Extension';
+  }
+  if (normalizedPath.includes('/.gemini/skills/')) {
+    const homeDirs = [process.env['HOME'], process.env['USERPROFILE']]
+      .filter((homeDir): homeDir is string => Boolean(homeDir))
+      .map(normalizePathForUi);
+    if (
+      homeDirs.some((homeDir) =>
+        normalizedPath.startsWith(`${homeDir}/.gemini/skills/`),
+      )
+    ) {
+      return 'Global';
+    }
+    return 'Workspace';
+  }
+  return '';
+}
+
+/**
+ * Creates a unified diff string representing a new file.
+ */
+function newFileDiff(filename: string, content: string): string {
+  const lines = content.split('\n');
+  const hunkLines = lines.map((l) => `+${l}`).join('\n');
+  return [
+    `--- /dev/null`,
+    `+++ ${filename}`,
+    `@@ -0,0 +1,${lines.length} @@`,
+    hunkLines,
+  ].join('\n');
+}
+
 function formatDate(isoString: string): string {
   try {
     const date = new Date(isoString);
@@ -75,29 +185,57 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
   onReloadSkills,
 }) => {
   const keyMatchers = useKeyMatchers();
+  const { stdout } = useStdout();
+  const terminalWidth = stdout?.columns ?? 80;
   const isTrustedFolder = config.isTrustedFolder();
   const [phase, setPhase] = useState<Phase>('list');
-  const [skills, setSkills] = useState<InboxSkill[]>([]);
+  const [items, setItems] = useState<InboxItem[]>([]);
   const [loading, setLoading] = useState(true);
-  const [selectedSkill, setSelectedSkill] = useState<InboxSkill | null>(null);
+  const [selectedItem, setSelectedItem] = useState<InboxItem | null>(null);
   const [feedback, setFeedback] = useState<{
     text: string;
     isError: boolean;
   } | null>(null);
 
-  // Load inbox skills on mount
+  // Load inbox skills and patches on mount
   useEffect(() => {
     let cancelled = false;
     void (async () => {
       try {
-        const result = await listInboxSkills(config);
+        const [skills, patches] = await Promise.all([
+          listInboxSkills(config),
+          listInboxPatches(config),
+        ]);
+        const patchItems = await Promise.all(
+          patches.map(async (patch): Promise<InboxItem> => {
+            let targetsProjectSkills = false;
+            try {
+              targetsProjectSkills = await patchTargetsProjectSkills(
+                patch,
+                config,
+              );
+            } catch {
+              targetsProjectSkills = false;
+            }
+
+            return {
+              type: 'patch',
+              patch,
+              targetsProjectSkills,
+            };
+          }),
+        );
         if (!cancelled) {
-          setSkills(result);
+          const combined: InboxItem[] = [
+            ...skills.map((skill): InboxItem => ({ type: 'skill', skill })),
+            ...patchItems,
+          ];
+          setItems(combined);
           setLoading(false);
         }
       } catch {
         if (!cancelled) {
-          setSkills([]);
+          setItems([]);
           setLoading(false);
         }
       }
@@ -107,18 +245,56 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
     };
   }, [config]);
 
-  const skillItems: Array<SelectionListItem<InboxSkill>> = useMemo(
-    () =>
-      skills.map((skill) => ({
-        key: skill.dirName,
-        value: skill,
-      })),
-    [skills],
+  const getItemKey = useCallback(
+    (item: InboxItem): string =>
+      item.type === 'skill'
+        ? `skill:${item.skill.dirName}`
+        : item.type === 'patch'
+          ? `patch:${item.patch.fileName}`
+          : `header:${item.label}`,
+    [],
   );
 
+  const listItems: Array<SelectionListItem<InboxItem>> = useMemo(() => {
+    const skills = items.filter((i) => i.type === 'skill');
+    const patches = items.filter((i) => i.type === 'patch');
+    const result: Array<SelectionListItem<InboxItem>> = [];
+
+    // Only show section headers when both types are present
+    const showHeaders = skills.length > 0 && patches.length > 0;
+
+    if (showHeaders) {
+      const header: InboxItem = { type: 'header', label: 'New Skills' };
+      result.push({
+        key: 'header:new-skills',
+        value: header,
+        disabled: true,
+        hideNumber: true,
+      });
+    }
+    for (const item of skills) {
+      result.push({ key: getItemKey(item), value: item });
+    }
+
+    if (showHeaders) {
+      const header: InboxItem = { type: 'header', label: 'Skill Updates' };
+      result.push({
+        key: 'header:skill-updates',
+        value: header,
+        disabled: true,
+        hideNumber: true,
+      });
+    }
+    for (const item of patches) {
+      result.push({ key: getItemKey(item), value: item });
+    }
+
+    return result;
+  }, [items, getItemKey]);
+
   const destinationItems: Array<SelectionListItem<DestinationChoice>> = useMemo(
     () =>
-      DESTINATION_CHOICES.map((choice) => {
+      SKILL_DESTINATION_CHOICES.map((choice) => {
         if (choice.destination === 'project' && !isTrustedFolder) {
           return {
             key: choice.destination,
@@ -139,15 +315,103 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
     [isTrustedFolder],
   );
 
-  const handleSelectSkill = useCallback((skill: InboxSkill) => {
-    setSelectedSkill(skill);
+  const selectedPatchTargetsProjectSkills = useMemo(() => {
+    if (!selectedItem || selectedItem.type !== 'patch') {
+      return false;
+    }
+
+    return selectedItem.targetsProjectSkills;
+  }, [selectedItem]);
+
+  const patchActionItems: Array<SelectionListItem<PatchAction>> = useMemo(
+    () =>
+      PATCH_ACTION_CHOICES.map((choice) => {
+        if (
+          choice.action === 'apply' &&
+          selectedPatchTargetsProjectSkills &&
+          !isTrustedFolder
+        ) {
+          return {
+            key: choice.action,
+            value: {
+              ...choice,
+              description:
+                '.gemini/skills — unavailable until this workspace is trusted',
+            },
+            disabled: true,
+          };
+        }
+
+        return {
+          key: choice.action,
+          value: choice,
+        };
+      }),
+    [isTrustedFolder, selectedPatchTargetsProjectSkills],
+  );
+
+  const skillPreviewItems: Array<SelectionListItem<SkillPreviewAction>> =
+    useMemo(
+      () =>
+        SKILL_PREVIEW_CHOICES.map((choice) => ({
+          key: choice.action,
+          value: choice,
+        })),
+      [],
+    );
+
+  const handleSelectItem = useCallback((item: InboxItem) => {
+    setSelectedItem(item);
     setFeedback(null);
-    setPhase('action');
+    setPhase(item.type === 'skill' ? 'skill-preview' : 'patch-preview');
   }, []);
 
+  const removeItem = useCallback(
+    (item: InboxItem) => {
+      setItems((prev) =>
+        prev.filter((i) => getItemKey(i) !== getItemKey(item)),
+      );
+    },
+    [getItemKey],
+  );
+
+  const handleSkillPreviewAction = useCallback(
+    (choice: SkillPreviewAction) => {
+      if (!selectedItem || selectedItem.type !== 'skill') return;
+
+      if (choice.action === 'move') {
+        setFeedback(null);
+        setPhase('skill-action');
+        return;
+      }
+
+      // Dismiss
+      setFeedback(null);
+      const skill = selectedItem.skill;
+      void (async () => {
+        try {
+          const result = await dismissInboxSkill(config, skill.dirName);
+          setFeedback({ text: result.message, isError: !result.success });
+          if (result.success) {
+            removeItem(selectedItem);
+            setSelectedItem(null);
+            setPhase('list');
+          }
+        } catch (error) {
+          setFeedback({
+            text: `Failed to dismiss skill: ${getErrorMessage(error)}`,
+            isError: true,
+          });
+        }
+      })();
+    },
+    [config, selectedItem, removeItem],
+  );
+
   const handleSelectDestination = useCallback(
     (choice: DestinationChoice) => {
-      if (!selectedSkill) return;
+      if (!selectedItem || selectedItem.type !== 'skill') return;
+      const skill = selectedItem.skill;
 
       if (choice.destination === 'project' && !config.isTrustedFolder()) {
         setFeedback({
@@ -161,16 +425,11 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
 
       void (async () => {
         try {
-          let result: { success: boolean; message: string };
-          if (choice.destination === 'dismiss') {
-            result = await dismissInboxSkill(config, selectedSkill.dirName);
-          } else {
-            result = await moveInboxSkill(
-              config,
-              selectedSkill.dirName,
-              choice.destination,
-            );
-          }
+          const result = await moveInboxSkill(
+            config,
+            skill.dirName,
+            choice.destination,
+          );
 
           setFeedback({ text: result.message, isError: !result.success });
 
@@ -178,17 +437,10 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
             return;
           }
 
-          // Remove the skill from the local list.
-          setSkills((prev) =>
-            prev.filter((skill) => skill.dirName !== selectedSkill.dirName),
-          );
-          setSelectedSkill(null);
+          removeItem(selectedItem);
+          setSelectedItem(null);
           setPhase('list');
 
-          if (choice.destination === 'dismiss') {
-            return;
-          }
-
           try {
             await onReloadSkills();
           } catch (error) {
@@ -197,11 +449,68 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
               isError: true,
             });
           }
+        } catch (error) {
+          setFeedback({
+            text: `Failed to install skill: ${getErrorMessage(error)}`,
+            isError: true,
+          });
+        }
+      })();
+    },
+    [config, selectedItem, onReloadSkills, removeItem],
+  );
+
+  const handleSelectPatchAction = useCallback(
+    (choice: PatchAction) => {
+      if (!selectedItem || selectedItem.type !== 'patch') return;
+      const patch = selectedItem.patch;
+
+      if (
+        choice.action === 'apply' &&
+        !config.isTrustedFolder() &&
+        selectedItem.targetsProjectSkills
+      ) {
+        setFeedback({
+          text: 'Project skill patches are unavailable until this workspace is trusted.',
+          isError: true,
+        });
+        return;
+      }
+
+      setFeedback(null);
+
+      void (async () => {
+        try {
+          let result: { success: boolean; message: string };
+          if (choice.action === 'apply') {
+            result = await applyInboxPatch(config, patch.fileName);
+          } else {
+            result = await dismissInboxPatch(config, patch.fileName);
+          }
+
+          setFeedback({ text: result.message, isError: !result.success });
+
+          if (!result.success) {
+            return;
+          }
+
+          removeItem(selectedItem);
+          setSelectedItem(null);
+          setPhase('list');
+
+          if (choice.action === 'apply') {
+            try {
+              await onReloadSkills();
+            } catch (error) {
+              setFeedback({
+                text: `${result.message} Failed to reload skills: ${getErrorMessage(error)}`,
+                isError: true,
+              });
+            }
+          }
         } catch (error) {
           const operation =
-            choice.destination === 'dismiss'
-              ? 'dismiss skill'
-              : 'install skill';
+            choice.action === 'apply' ? 'apply patch' : 'dismiss patch';
           setFeedback({
             text: `Failed to ${operation}: ${getErrorMessage(error)}`,
             isError: true,
@@ -209,15 +518,18 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
         }
       })();
     },
-    [config, selectedSkill, onReloadSkills],
+    [config, selectedItem, onReloadSkills, removeItem],
   );
 
   useKeypress(
     (key) => {
       if (keyMatchers[Command.ESCAPE](key)) {
-        if (phase === 'action') {
+        if (phase === 'skill-action') {
+          setPhase('skill-preview');
+          setFeedback(null);
+        } else if (phase !== 'list') {
           setPhase('list');
-          setSelectedSkill(null);
+          setSelectedItem(null);
           setFeedback(null);
         } else {
           onClose();
@@ -243,7 +555,7 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
     );
   }
 
-  if (skills.length === 0 && !feedback) {
+  if (items.length === 0 && !feedback) {
     return (
       <Box
         flexDirection="column"
@@ -252,17 +564,18 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
         paddingX={2}
         paddingY={1}
       >
-        <Text bold>Skill Inbox</Text>
+        <Text bold>Memory Inbox</Text>
         <Box marginTop={1}>
-          <Text color={theme.text.secondary}>
-            No extracted skills in inbox.
-          </Text>
+          <Text color={theme.text.secondary}>No items in inbox.</Text>
         </Box>
         <DialogFooter primaryAction="Esc to close" cancelAction="" />
       </Box>
     );
   }
 
+  // Border + paddingX account for 6 chars of width
+  const contentWidth = terminalWidth - 6;
+
   return (
     <Box
       flexDirection="column"
@@ -272,41 +585,87 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
       paddingY={1}
       width="100%"
     >
-      {phase === 'list' ? (
+      {phase === 'list' && (
         <>
           <Text bold>
-            Skill Inbox ({skills.length} skill{skills.length !== 1 ? 's' : ''})
+            Memory Inbox ({items.length} item{items.length !== 1 ? 's' : ''})
           </Text>
           <Text color={theme.text.secondary}>
-            Skills extracted from past sessions. Select one to move or dismiss.
+            Extracted from past sessions. Select one to review.
           </Text>
 
           <Box flexDirection="column" marginTop={1}>
-            <BaseSelectionList<InboxSkill>
-              items={skillItems}
-              onSelect={handleSelectSkill}
+            <BaseSelectionList<InboxItem>
+              items={listItems}
+              onSelect={handleSelectItem}
               isFocused={true}
-              showNumbers={true}
+              showNumbers={false}
               showScrollArrows={true}
               maxItemsToShow={8}
-              renderItem={(item, { titleColor }) => (
-                <Box flexDirection="column" minHeight={2}>
-                  <Text color={titleColor} bold>
-                    {item.value.name}
-                  </Text>
-                  <Box flexDirection="row">
-                    <Text color={theme.text.secondary} wrap="wrap">
-                      {item.value.description}
-                    </Text>
-                    {item.value.extractedAt && (
-                      <Text color={theme.text.secondary}>
-                        {' · '}
-                        {formatDate(item.value.extractedAt)}
+              renderItem={(item, { titleColor }) => {
+                if (item.value.type === 'header') {
+                  return (
+                    <Box marginTop={1}>
+                      <Text color={theme.text.secondary} bold>
+                        {item.value.label}
                       </Text>
-                    )}
+                    </Box>
+                  );
+                }
+                if (item.value.type === 'skill') {
+                  const skill = item.value.skill;
+                  return (
+                    <Box flexDirection="column" minHeight={2}>
+                      <Text color={titleColor} bold>
+                        {skill.name}
+                      </Text>
+                      <Box flexDirection="row">
+                        <Text color={theme.text.secondary} wrap="wrap">
+                          {skill.description}
+                        </Text>
+                        {skill.extractedAt && (
+                          <Text color={theme.text.secondary}>
+                            {' · '}
+                            {formatDate(skill.extractedAt)}
+                          </Text>
+                        )}
+                      </Box>
+                    </Box>
+                  );
+                }
+                const patch = item.value.patch;
+                const fileNames = patch.entries.map((e) =>
+                  getPathBasename(e.targetPath),
+                );
+                const origin = getSkillOriginTag(
+                  patch.entries[0]?.targetPath ?? '',
+                );
+                return (
+                  <Box flexDirection="column" minHeight={2}>
+                    <Box flexDirection="row">
+                      <Text color={titleColor} bold>
+                        {patch.name}
+                      </Text>
+                      {origin && (
+                        <Text color={theme.text.secondary}>
+                          {` [${origin}]`}
+                        </Text>
+                      )}
+                    </Box>
+                    <Box flexDirection="row">
+                      <Text color={theme.text.secondary}>
+                        {fileNames.join(', ')}
+                      </Text>
+                      {patch.extractedAt && (
+                        <Text color={theme.text.secondary}>
+                          {' · '}
+                          {formatDate(patch.extractedAt)}
+                        </Text>
+                      )}
+                    </Box>
                   </Box>
-                </Box>
-              )}
+                );
+              }}
             />
           </Box>
 
@@ -328,9 +687,73 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
             cancelAction="Esc to close"
           />
         </>
-      ) : (
+      )}
+
+      {phase === 'skill-preview' && selectedItem?.type === 'skill' && (
         <>
-          <Text bold>Move &quot;{selectedSkill?.name}&quot;</Text>
+          <Text bold>{selectedItem.skill.name}</Text>
+          <Text color={theme.text.secondary}>
+            Review new skill before installing.
+          </Text>
+
+          {selectedItem.skill.content && (
+            <Box flexDirection="column" marginTop={1}>
+              <Text color={theme.text.secondary} bold>
+                SKILL.md
+              </Text>
+              <DiffRenderer
+                diffContent={newFileDiff(
+                  'SKILL.md',
+                  selectedItem.skill.content,
+                )}
+                filename="SKILL.md"
+                terminalWidth={contentWidth}
+              />
+            </Box>
+          )}
+
+          <Box flexDirection="column" marginTop={1}>
+            <BaseSelectionList<SkillPreviewAction>
+              items={skillPreviewItems}
+              onSelect={handleSkillPreviewAction}
+              isFocused={true}
+              showNumbers={true}
+              renderItem={(item, { titleColor }) => (
+                <Box flexDirection="column" minHeight={2}>
+                  <Text color={titleColor} bold>
+                    {item.value.label}
+                  </Text>
+                  <Text color={theme.text.secondary}>
+                    {item.value.description}
+                  </Text>
+                </Box>
+              )}
+            />
+          </Box>
+
+          {feedback && (
+            <Box marginTop={1}>
+              <Text
+                color={
+                  feedback.isError ? theme.status.error : theme.status.success
+                }
+              >
+                {feedback.isError ? '✗ ' : '✓ '}
+                {feedback.text}
+              </Text>
+            </Box>
+          )}
+
+          <DialogFooter
+            primaryAction="Enter to confirm"
+            cancelAction="Esc to go back"
+          />
+        </>
+      )}
+
+      {phase === 'skill-action' && selectedItem?.type === 'skill' && (
+        <>
+          <Text bold>Move &quot;{selectedItem.skill.name}&quot;</Text>
           <Text color={theme.text.secondary}>
             Choose where to install this skill.
           </Text>
@@ -373,6 +796,81 @@ export const SkillInboxDialog: React.FC<SkillInboxDialogProps> = ({
           />
         </>
       )}
+
+      {phase === 'patch-preview' && selectedItem?.type === 'patch' && (
+        <>
+          <Text bold>{selectedItem.patch.name}</Text>
+          <Box flexDirection="row">
+            <Text color={theme.text.secondary}>
+              Review changes before applying.
+            </Text>
+            {(() => {
+              const origin = getSkillOriginTag(
+                selectedItem.patch.entries[0]?.targetPath ?? '',
+              );
+              return origin ? (
+                <Text color={theme.text.secondary}>{` [${origin}]`}</Text>
+              ) : null;
+            })()}
+          </Box>
+
+          <Box flexDirection="column" marginTop={1}>
+            {selectedItem.patch.entries.map((entry, index) => (
+              <Box
+                key={`${selectedItem.patch.fileName}:${entry.targetPath}:${index}`}
+                flexDirection="column"
+                marginBottom={1}
+              >
+                <Text color={theme.text.secondary} bold>
+                  {entry.targetPath}
+                </Text>
+                <DiffRenderer
+                  diffContent={entry.diffContent}
+                  filename={entry.targetPath}
+                  terminalWidth={contentWidth}
+                />
+              </Box>
+            ))}
+          </Box>
+
+          <Box flexDirection="column" marginTop={1}>
+            <BaseSelectionList<PatchAction>
+              items={patchActionItems}
+              onSelect={handleSelectPatchAction}
+              isFocused={true}
+              showNumbers={true}
+              renderItem={(item, { titleColor }) => (
+                <Box flexDirection="column" minHeight={2}>
+                  <Text color={titleColor} bold>
+                    {item.value.label}
+                  </Text>
+                  <Text color={theme.text.secondary}>
+                    {item.value.description}
+                  </Text>
+                </Box>
+              )}
+            />
+          </Box>
+
+          {feedback && (
+            <Box marginTop={1}>
+              <Text
+                color={
+                  feedback.isError ? theme.status.error : theme.status.success
+                }
+              >
+                {feedback.isError ? '✗ ' : '✓ '}
+                {feedback.text}
+              </Text>
+            </Box>
+          )}
+
+          <DialogFooter
+            primaryAction="Enter to confirm"
+            cancelAction="Esc to go back"
+          />
+        </>
+      )}
     </Box>
   );
 };