From f4118fd1cfd1c167235e7ee0aedf17a99a4a3581 Mon Sep 17 00:00:00 2001
From: Rajat Saxena <hi@sub.rajatsaxena.dev>
Date: Thu, 5 Nov 2026 09:20:14 +0530
Subject: [PATCH] Suggest AI agent next steps after connecting a repository

After Finish setup, the Repository connected screen now pitches porting
docs with a coding agent: copyable frontlit-skills install command, a
ready-made prompt (frontlit-docs, or frontlit-pages for pages-only), and
a link to the frontlit-skills repo.
---
 .../content/documentation-connect-parts.tsx   | 88 +++++++++++++++++++
 .../content/documentation-source.tsx          |  2 +
 2 files changed, 90 insertions(+)

diff --git a/apps/web/components/content/documentation-connect-parts.tsx b/apps/web/components/content/documentation-connect-parts.tsx
index 983e6241..c010f580 100644
--- a/apps/web/components/content/documentation-connect-parts.tsx
+++ b/apps/web/components/content/documentation-connect-parts.tsx
@@ -5,11 +5,15 @@ import {
   Check,
   ChevronRight,
   CircleAlert,
+  Copy,
+  ExternalLink,
   File,
   Folder,
   Info,
+  Sparkles,
   TriangleAlert,
 } from "lucide-react";
+import { toast } from "sonner";
 import { cn } from "@/lib/utils";
 
 export const WIZARD_STEPS = ["Repository", "Folder", "Review", "Connect"] as const;
@@ -418,3 +422,87 @@ export function PublishMap({
     </div>
   );
 }
+
+const SKILLS_REPO = "https://github.com/codelitdev/frontlit-skills";
+const SKILLS_INSTALL = "npx skills add codelitdev/frontlit-skills";
+
+function CopyLine({
+  label,
+  copyLabel,
+  value,
+}: {
+  label: string;
+  copyLabel: string;
+  value: string;
+}) {
+  return (
+    <div className="space-y-1">
+      <span className="text-muted-foreground text-xs">{label}</span>
+      <div className="flex items-center gap-2 rounded-md border border-border bg-background py-1.5 pr-1.5 pl-3">
+        <code className="min-w-0 flex-1 break-words font-mono text-[12.5px]">
+          {value}
+        </code>
+        <button
+          type="button"
+          aria-label={copyLabel}
+          className="grid size-7 shrink-0 place-items-center rounded text-muted-foreground hover:bg-muted hover:text-foreground focus-visible:shadow-[var(--shadow-focus)] focus-visible:outline-none"
+          onClick={() => {
+            void navigator.clipboard
+              .writeText(value)
+              .then(() => toast.success("Copied"));
+          }}
+        >
+          <Copy className="size-3.5" />
+        </button>
+      </div>
+    </div>
+  );
+}
+
+/** Shown once a repository is connected: hand the rest to a coding agent. */
+export function AgentNextStep({ docs }: { docs: boolean }) {
+  const prompt = docs
+    ? "Use the frontlit-docs skill to move our docs to FrontLit and open a pull request."
+    : "Use the frontlit-pages skill to add a pricing page and link it from the header.";
+  return (
+    <div className="space-y-3 rounded-[0.625rem] border border-border bg-muted/40 px-4 py-3.5 text-sm">
+      <div className="flex gap-3">
+        <Sparkles className="mt-0.5 size-[18px] shrink-0 text-primary" />
+        <div>
+          <p className="font-semibold">
+            {docs
+              ? "Let your AI agent move your docs"
+              : "Let your AI agent build your pages"}
+          </p>
+          <p className="mt-0.5 text-muted-foreground">
+            Install FrontLit skills in Claude Code, Codex, Cursor or any coding agent.
+            It
+            {docs
+              ? " ports your existing docs (Docusaurus, Mintlify, GitBook, Markdown and more),"
+              : " writes pages that follow FrontLit's rules,"}{" "}
+            checks its work and opens a pull request. Nothing goes live until you merge.
+          </p>
+        </div>
+      </div>
+      <CopyLine
+        label="1. Install the skills"
+        copyLabel="Copy install command"
+        value={SKILLS_INSTALL}
+      />
+      <CopyLine
+        label="2. Ask your agent, in your repository"
+        copyLabel="Copy prompt"
+        value={prompt}
+      />
+      <a
+        href={SKILLS_REPO}
+        target="_blank"
+        rel="noreferrer"
+        className="inline-flex items-center gap-1 font-semibold text-[13px] text-primary underline-offset-2 hover:underline"
+      >
+        Claude Code and Codex plugins, and more examples
+        <ExternalLink className="size-3.5" />
+      </a>
+    </div>
+  );
+}
diff --git a/apps/web/components/content/documentation-source.tsx b/apps/web/components/content/documentation-source.tsx
index baa62a37..f63c92ac 100644
--- a/apps/web/components/content/documentation-source.tsx
+++ b/apps/web/components/content/documentation-source.tsx
@@ -11,6 +11,7 @@ import {
 import { Badge } from "@/components/ui/codelit/badge";
 import { Button } from "@/components/ui/codelit/button";
 import {
+  AgentNextStep,
   Callout,
   Code,
   ConsentRow,
@@ -1567,6 +1568,7 @@ export function DocumentationSource({
             </SummaryRow>
           )}
         </SummaryCard>
+        <AgentNextStep docs={connectedInfo.docs} />
       </>
     );
     wizardFooter = (