fix(docs): final pass correctness fixes (SD-2873)

- Drop /getting-started/ai redirect: a real Getting Started AI page
  now exists at that URL; the old redirect was sending it elsewhere.
- Fix editor.doc.insert snippet on the Getting Started AI page: the
  real shape is { target, value, type: 'html' }, not { target, html }.
- Document Engine overview was wrong about the CLI: it runs in
  persistent sessions (open/run/save/close), not one-shot commands.
- Add Diffing as a fourth Where-to-next card on Document Engine
  overview. It's a sibling of Document API/SDKs/CLI, not nested.
- Drop CLI Skills from the AI overview path-picker. Skills are not
  shipped yet (the page itself says so). Promoting them in the
  primary path table is misleading; keep the page reachable but
  don't route new users there.

Author: caio-pizzol

apps/docs/ai/overview.mdx

@@ -7,15 +7,12 @@ keywords: "ai, mcp, llm tools, document automation, superdoc, agents"
 
 SuperDoc gives AI models structured access to Word documents. Three integration paths, depending on how you work.
 
-<CardGroup cols={3}>
+<CardGroup cols={2}>
   <Card title="MCP Server" icon="plug" href="/ai/mcp/overview">
     Connect coding agents (Claude Code, Cursor, Windsurf) to .docx files. Install once, edit documents through natural language.
   </Card>
   <Card title="LLM Tools" icon="wrench" href="/ai/agents/llm-tools">
-    Embed document editing in your app. Nine intent tools for OpenAI, Anthropic, and Vercel AI SDK — search, edit, format, comment, and more.
-  </Card>
-  <Card title="CLI Skills" icon="terminal" href="/ai/agents/skills">
-    Reusable prompt templates that pair with the SuperDoc CLI. Give any agent structured document operations through shell commands.
+    Embed document editing in your app. Nine intent tools for OpenAI, Anthropic, and Vercel AI SDK: search, edit, format, comment, and more.
   </Card>
 </CardGroup>
 
@@ -25,5 +22,4 @@ SuperDoc gives AI models structured access to Word documents. Three integration
 |---|---|
 | Let a coding agent edit .docx files | [MCP Server](/ai/mcp/overview) |
 | Build AI document editing into your product | [LLM Tools](/ai/agents/llm-tools) |
-| Give a shell-based agent document skills | [CLI Skills](/ai/agents/skills) |
 | Stream model output into a live editor | [Streaming pattern](/ai/agents/integrations#streaming-generated-text-into-a-visible-editor) |

apps/docs/docs.json

@@ -453,10 +453,6 @@
       "source": "/extensions/creating-extensions",
       "destination": "/advanced/custom-extensions"
     },
-    {
-      "source": "/getting-started/ai",
-      "destination": "/ai/overview"
-    },
     {
       "source": "/getting-started/ai-agents",
       "destination": "/ai/agents/llm-tools"

apps/docs/document-engine/overview.mdx

@@ -29,7 +29,7 @@ The Document API is the operation contract. It defines every document action Sup
 
 - The **browser editor** exposes those operations as `editor.doc.*`.
 - The **SDKs** manage a CLI process and expose the same operations as typed Node and Python methods.
-- The **CLI** runs each operation as a one-shot command, with arguments and JSON output.
+- The **CLI** runs in persistent sessions: open a document, run operations, save and close. Each operation takes arguments and emits JSON output.
 
 All three call the same underlying engine. A redline written by your backend, a CI script, and a browser editor produce the same result on the same `.docx` file.
 
@@ -46,14 +46,17 @@ All three call the same underlying engine. A redline written by your backend, a
 
 ## Where to next
 
-<CardGroup cols={3}>
+<CardGroup cols={2}>
   <Card title="Document API" icon="code" href="/document-api/overview">
-    The operation contract — every method the editor and SDKs share
+    The operation contract. Every method the editor and SDKs share.
   </Card>
   <Card title="SDKs" icon="box" href="/document-engine/sdks">
     Node and Python typed methods for backend automation
   </Card>
   <Card title="CLI" icon="terminal" href="/document-engine/cli">
     Scriptable DOCX operations from the shell
   </Card>
+  <Card title="Diffing" icon="git-compare" href="/document-engine/diffing">
+    Compare two DOCX files. Produce a redlined third document.
+  </Card>
 </CardGroup>

apps/docs/getting-started/ai.mdx

@@ -70,7 +70,7 @@ Render the document in the browser editor for selection and visual feedback. Gen
 
 ```javascript
 const html = await callYourLLM(prompt);
-editor.doc.insert({ target: cursor, html });
+editor.doc.insert({ target: cursor, value: html, type: 'html' });
 ```
 
 [Streaming editor pattern →](/ai/agents/integrations)