feat(desktop): add Integrations settings to install CLI and orchestration skills

Add a new Integrations section in desktop settings that lets users
install the Paseo CLI and orchestration skills directly from the app.

CLI install symlinks the bundled shim to ~/.local/bin and updates the
user's shell rc file if needed. Skills install copies SKILL.md files to
~/.agents/skills/, symlinks into ~/.claude/skills/ for Claude Code, and
copies to ~/.codex/skills/ for Codex. Both use a single status check
code path for install verification and on-load detection.

Also adds a /docs/skills page documenting all six orchestration skills,
extracts shared settings styles (section headers, rows) used across
the daemon, integrations, and shortcuts sections, and reorders the
settings sidebar to group integrations and daemon together.

packages/website/src/routeTree.gen.ts

@@ -25,6 +25,7 @@ import { Route as DocsVoiceRouteImport } from './routes/docs/voice'
 import { Route as DocsUpdatesRouteImport } from './routes/docs/updates'
 import { Route as DocsSecurityRouteImport } from './routes/docs/security'
 import { Route as DocsConfigurationRouteImport } from './routes/docs/configuration'
+import { Route as DocsSkillsRouteImport } from './routes/docs/skills'
 import { Route as DocsCliRouteImport } from './routes/docs/cli'
 import { Route as DocsBestPracticesRouteImport } from './routes/docs/best-practices'
 import { Route as BlogSplatRouteImport } from './routes/blog/$'
@@ -109,6 +110,11 @@ const DocsConfigurationRoute = DocsConfigurationRouteImport.update({
   path: '/configuration',
   getParentRoute: () => DocsRoute,
 } as any)
+const DocsSkillsRoute = DocsSkillsRouteImport.update({
+  id: '/skills',
+  path: '/skills',
+  getParentRoute: () => DocsRoute,
+} as any)
 const DocsCliRoute = DocsCliRouteImport.update({
   id: '/cli',
   path: '/cli',
@@ -140,6 +146,7 @@ export interface FileRoutesByFullPath {
   '/docs/cli': typeof DocsCliRoute
   '/docs/configuration': typeof DocsConfigurationRoute
   '/docs/security': typeof DocsSecurityRoute
+  '/docs/skills': typeof DocsSkillsRoute
   '/docs/updates': typeof DocsUpdatesRoute
   '/docs/voice': typeof DocsVoiceRoute
   '/docs/worktrees': typeof DocsWorktreesRoute
@@ -159,6 +166,7 @@ export interface FileRoutesByTo {
   '/docs/cli': typeof DocsCliRoute
   '/docs/configuration': typeof DocsConfigurationRoute
   '/docs/security': typeof DocsSecurityRoute
+  '/docs/skills': typeof DocsSkillsRoute
   '/docs/updates': typeof DocsUpdatesRoute
   '/docs/voice': typeof DocsVoiceRoute
   '/docs/worktrees': typeof DocsWorktreesRoute
@@ -181,6 +189,7 @@ export interface FileRoutesById {
   '/docs/cli': typeof DocsCliRoute
   '/docs/configuration': typeof DocsConfigurationRoute
   '/docs/security': typeof DocsSecurityRoute
+  '/docs/skills': typeof DocsSkillsRoute
   '/docs/updates': typeof DocsUpdatesRoute
   '/docs/voice': typeof DocsVoiceRoute
   '/docs/worktrees': typeof DocsWorktreesRoute
@@ -204,6 +213,7 @@ export interface FileRouteTypes {
     | '/docs/cli'
     | '/docs/configuration'
     | '/docs/security'
+    | '/docs/skills'
     | '/docs/updates'
     | '/docs/voice'
     | '/docs/worktrees'
@@ -223,6 +233,7 @@ export interface FileRouteTypes {
     | '/docs/cli'
     | '/docs/configuration'
     | '/docs/security'
+    | '/docs/skills'
     | '/docs/updates'
     | '/docs/voice'
     | '/docs/worktrees'
@@ -244,6 +255,7 @@ export interface FileRouteTypes {
     | '/docs/cli'
     | '/docs/configuration'
     | '/docs/security'
+    | '/docs/skills'
     | '/docs/updates'
     | '/docs/voice'
     | '/docs/worktrees'
@@ -377,6 +389,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof DocsConfigurationRouteImport
       parentRoute: typeof DocsRoute
     }
+    '/docs/skills': {
+      id: '/docs/skills'
+      path: '/skills'
+      fullPath: '/docs/skills'
+      preLoaderRoute: typeof DocsSkillsRouteImport
+      parentRoute: typeof DocsRoute
+    }
     '/docs/cli': {
       id: '/docs/cli'
       path: '/cli'
@@ -418,6 +437,7 @@ interface DocsRouteChildren {
   DocsCliRoute: typeof DocsCliRoute
   DocsConfigurationRoute: typeof DocsConfigurationRoute
   DocsSecurityRoute: typeof DocsSecurityRoute
+  DocsSkillsRoute: typeof DocsSkillsRoute
   DocsUpdatesRoute: typeof DocsUpdatesRoute
   DocsVoiceRoute: typeof DocsVoiceRoute
   DocsWorktreesRoute: typeof DocsWorktreesRoute
@@ -429,6 +449,7 @@ const DocsRouteChildren: DocsRouteChildren = {
   DocsCliRoute: DocsCliRoute,
   DocsConfigurationRoute: DocsConfigurationRoute,
   DocsSecurityRoute: DocsSecurityRoute,
+  DocsSkillsRoute: DocsSkillsRoute,
   DocsUpdatesRoute: DocsUpdatesRoute,
   DocsVoiceRoute: DocsVoiceRoute,
   DocsWorktreesRoute: DocsWorktreesRoute,

packages/website/src/routes/docs.tsx

@@ -11,6 +11,7 @@ const navigation = [
   { name: "Voice", href: "/docs/voice" },
   { name: "Git worktrees", href: "/docs/worktrees" },
   { name: "CLI", href: "/docs/cli" },
+  { name: "Skills", href: "/docs/skills" },
   { name: "Configuration", href: "/docs/configuration" },
   { name: "Security", href: "/docs/security" },
   { name: "Best practices", href: "/docs/best-practices" },

packages/website/src/routes/docs/skills.tsx

@@ -0,0 +1,162 @@
+import { createFileRoute } from "@tanstack/react-router";
+import { pageMeta } from "~/meta";
+
+export const Route = createFileRoute("/docs/skills")({
+  head: () => ({
+    meta: pageMeta(
+      "Orchestration Skills - Paseo Docs",
+      "Paseo orchestration skills: teach coding agents to spawn, coordinate, and manage other agents using slash commands.",
+    ),
+  }),
+  component: Skills,
+});
+
+function Code({ children }: { children: React.ReactNode }) {
+  return (
+    <div className="bg-card border border-border rounded-lg p-4 font-mono text-sm overflow-x-auto">
+      {children}
+    </div>
+  );
+}
+
+function Skills() {
+  return (
+    <div className="space-y-10">
+      <div>
+        <h1 className="text-3xl font-medium font-title mb-4">Orchestration Skills</h1>
+        <p className="text-white/60 leading-relaxed">
+          Paseo ships orchestration skills that teach coding agents (Claude Code, Codex) how to use
+          the Paseo CLI to spawn, coordinate, and manage other agents. Skills are slash commands your
+          agent can invoke — they provide the prompts, context, and workflows so agents know how to
+          orchestrate without you writing boilerplate. Install them from the desktop app's
+          Integrations settings or via the CLI.
+        </p>
+      </div>
+
+      {/* Installation */}
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">Installation</h2>
+        <p className="text-white/60 leading-relaxed">Two ways to install:</p>
+        <ul className="text-white/60 space-y-2 list-disc list-inside">
+          <li>
+            <strong>Desktop app:</strong> Settings → Integrations → Install
+          </li>
+          <li>
+            <strong>Manual:</strong> <code className="font-mono">npx skills add getpaseo/paseo</code>{" "}
+            — this installs to <code className="font-mono">~/.agents/skills/</code> and sets up
+            symlinks for each agent.
+          </li>
+        </ul>
+      </section>
+
+      {/* /paseo */}
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">
+          <code className="font-mono">/paseo</code> — CLI Reference
+        </h2>
+        <p className="text-white/60 leading-relaxed">
+          The foundational skill. Loaded automatically by other skills. Contains the full Paseo CLI
+          command reference so agents know how to run commands.
+        </p>
+        <p className="text-white/60 leading-relaxed">
+          Not typically invoked directly by users — it's a reference that other skills depend on.
+        </p>
+      </section>
+
+      {/* /paseo-handoff */}
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">
+          <code className="font-mono">/paseo-handoff</code> — Task Handoff
+        </h2>
+        <p className="text-white/60 leading-relaxed">
+          Hands off your current task to another agent with full context. The receiving agent gets a
+          comprehensive prompt with: task description, relevant files, what's been tried, decisions
+          made, and acceptance criteria.
+        </p>
+        <p className="text-white/60 leading-relaxed">
+          Default provider is Codex. Can specify Claude (sonnet/opus). Supports{" "}
+          <code className="font-mono">--worktree</code> for isolated git branches.
+        </p>
+        <Code>
+          <pre className="text-white/80">{`/paseo-handoff hand off the auth fix to codex in a worktree
+/paseo-handoff hand this to claude opus for review`}</pre>
+        </Code>
+      </section>
+
+      {/* /paseo-loop */}
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">
+          <code className="font-mono">/paseo-loop</code> — Iterative Loops
+        </h2>
+        <p className="text-white/60 leading-relaxed">
+          Runs an agent in a loop with automatic verification until an exit condition is met. Worker
+          runs, verifier checks, repeat until done or max iterations. Supports different providers for
+          worker vs verifier (e.g., Codex implements, Claude verifies).
+        </p>
+        <p className="text-white/60 leading-relaxed">
+          Stop conditions: <code className="font-mono">--max-iterations</code>,{" "}
+          <code className="font-mono">--max-time</code>, or verification passes.
+        </p>
+        <Code>
+          <pre className="text-white/80">{`/paseo-loop fix the failing tests, verify with npm test, max 5 iterations
+/paseo-loop use codex to implement, claude sonnet to verify, loop until tests pass`}</pre>
+        </Code>
+      </section>
+
+      {/* /paseo-orchestrator */}
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">
+          <code className="font-mono">/paseo-orchestrator</code> — Team Orchestration
+        </h2>
+        <p className="text-white/60 leading-relaxed">
+          Builds and manages a team of agents coordinating through a shared chat room. You describe
+          the work, it sets up roles, launches agents, and coordinates through chat. Uses a heartbeat
+          schedule to check progress.
+        </p>
+        <p className="text-white/60 leading-relaxed">
+          Cross-provider: typically Codex for implementation, Claude for review.
+        </p>
+        <Code>
+          <pre className="text-white/80">{`/paseo-orchestrator spin up a team to implement the database migration, codex implements, claude reviews`}</pre>
+        </Code>
+      </section>
+
+      {/* /paseo-chat */}
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">
+          <code className="font-mono">/paseo-chat</code> — Chat Rooms
+        </h2>
+        <p className="text-white/60 leading-relaxed">
+          Use persistent chat rooms for asynchronous agent coordination. Create rooms, post messages,
+          read history, wait for replies. Supports @mentions for specific agents or @everyone.
+        </p>
+        <p className="text-white/60 leading-relaxed">
+          Typically used by the orchestrator skill, but can be used directly.
+        </p>
+        <Code>
+          <pre className="text-white/80">{`/paseo-chat create a room called "backend-refactor" for coordinating the API changes
+/paseo-chat post to backend-refactor: "API endpoints are done, ready for review"`}</pre>
+        </Code>
+      </section>
+
+      {/* /paseo-committee */}
+      <section className="space-y-4">
+        <h2 className="text-xl font-medium">
+          <code className="font-mono">/paseo-committee</code> — Committee Planning
+        </h2>
+        <p className="text-white/60 leading-relaxed">
+          Forms a committee of two high-reasoning agents (Claude Opus + GPT 5.4) to analyze a problem
+          before implementing. Both agents reason in parallel, then plans are merged. Useful when
+          stuck, looping, or facing a hard architectural decision.
+        </p>
+        <p className="text-white/60 leading-relaxed">
+          Agents are prevented from editing code — they only produce a plan.
+        </p>
+        <Code>
+          <pre className="text-white/80">{`/paseo-committee why are the websocket connections dropping under load?
+/paseo-committee plan the auth system migration`}</pre>
+        </Code>
+      </section>
+    </div>
+  );
+}