playbooks 0.1.6 → 0.1.7

package/dist/index.js

@@ -8,7 +8,7 @@ import { program } from "commander";
 // package.json
 var package_default = {
   name: "playbooks",
-  version: "0.1.6",
+  version: "0.1.7",
   description: "Install agent skills, MCPs and docs into your coding agents from any git repository.",
   type: "module",
   bin: {
@@ -104,83 +104,296 @@ var package_default = {
   packageManager: "npm@10.8.2"
 };
 
-// src/flows/url-markdown-output.ts
-var output = null;
-function setUrlMarkdownOutput(next) {
-  output = next;
-}
-function consumeUrlMarkdownOutput() {
-  const current = output;
-  output = null;
-  return current;
+// src/agents.ts
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var home = homedir();
+var codexHome = process.env.CODEX_HOME?.trim() || join(home, ".codex");
+var agents = {
+  amp: {
+    name: "amp",
+    displayName: "Amp",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: join(home, ".config/agents/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".config/amp"));
+    }
+  },
+  antigravity: {
+    name: "antigravity",
+    displayName: "Antigravity",
+    skillsDir: ".agent/skills",
+    globalSkillsDir: join(home, ".gemini/antigravity/global_skills"),
+    detectInstalled: async () => {
+      return existsSync(join(process.cwd(), ".agent")) || existsSync(join(home, ".gemini/antigravity"));
+    }
+  },
+  "claude-code": {
+    name: "claude-code",
+    displayName: "Claude Code",
+    skillsDir: ".claude/skills",
+    globalSkillsDir: join(home, ".claude/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".claude"));
+    }
+  },
+  clawdbot: {
+    name: "clawdbot",
+    displayName: "Clawdbot",
+    skillsDir: "skills",
+    globalSkillsDir: join(home, ".clawdbot/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".clawdbot"));
+    }
+  },
+  cline: {
+    name: "cline",
+    displayName: "Cline",
+    skillsDir: ".cline/skills",
+    globalSkillsDir: join(home, ".cline/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".cline"));
+    }
+  },
+  codex: {
+    name: "codex",
+    displayName: "Codex",
+    skillsDir: ".codex/skills",
+    globalSkillsDir: join(codexHome, "skills"),
+    detectInstalled: async () => {
+      return existsSync(codexHome) || existsSync("/etc/codex");
+    }
+  },
+  "command-code": {
+    name: "command-code",
+    displayName: "Command Code",
+    skillsDir: ".commandcode/skills",
+    globalSkillsDir: join(home, ".commandcode/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".commandcode"));
+    }
+  },
+  continue: {
+    name: "continue",
+    displayName: "Continue",
+    skillsDir: ".continue/skills",
+    globalSkillsDir: join(home, ".continue/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(process.cwd(), ".continue")) || existsSync(join(home, ".continue"));
+    }
+  },
+  crush: {
+    name: "crush",
+    displayName: "Crush",
+    skillsDir: ".crush/skills",
+    globalSkillsDir: join(home, ".config/crush/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".config/crush"));
+    }
+  },
+  cursor: {
+    name: "cursor",
+    displayName: "Cursor",
+    skillsDir: ".cursor/skills",
+    globalSkillsDir: join(home, ".cursor/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".cursor"));
+    }
+  },
+  droid: {
+    name: "droid",
+    displayName: "Droid",
+    skillsDir: ".factory/skills",
+    globalSkillsDir: join(home, ".factory/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".factory"));
+    }
+  },
+  "gemini-cli": {
+    name: "gemini-cli",
+    displayName: "Gemini CLI",
+    skillsDir: ".gemini/skills",
+    globalSkillsDir: join(home, ".gemini/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".gemini"));
+    }
+  },
+  "github-copilot": {
+    name: "github-copilot",
+    displayName: "GitHub Copilot",
+    skillsDir: ".github/skills",
+    globalSkillsDir: join(home, ".copilot/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(process.cwd(), ".github")) || existsSync(join(home, ".copilot"));
+    }
+  },
+  goose: {
+    name: "goose",
+    displayName: "Goose",
+    skillsDir: ".goose/skills",
+    globalSkillsDir: join(home, ".config/goose/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".config/goose"));
+    }
+  },
+  kilo: {
+    name: "kilo",
+    displayName: "Kilo Code",
+    skillsDir: ".kilocode/skills",
+    globalSkillsDir: join(home, ".kilocode/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".kilocode"));
+    }
+  },
+  "kiro-cli": {
+    name: "kiro-cli",
+    displayName: "Kiro CLI",
+    skillsDir: ".kiro/skills",
+    globalSkillsDir: join(home, ".kiro/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".kiro"));
+    }
+  },
+  mcpjam: {
+    name: "mcpjam",
+    displayName: "MCPJam",
+    skillsDir: ".mcpjam/skills",
+    globalSkillsDir: join(home, ".mcpjam/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".mcpjam"));
+    }
+  },
+  opencode: {
+    name: "opencode",
+    displayName: "OpenCode",
+    skillsDir: ".opencode/skills",
+    globalSkillsDir: join(home, ".config/opencode/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".config/opencode")) || existsSync(join(home, ".claude/skills"));
+    }
+  },
+  openhands: {
+    name: "openhands",
+    displayName: "OpenHands",
+    skillsDir: ".openhands/skills",
+    globalSkillsDir: join(home, ".openhands/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".openhands"));
+    }
+  },
+  pi: {
+    name: "pi",
+    displayName: "Pi",
+    skillsDir: ".pi/skills",
+    globalSkillsDir: join(home, ".pi/agent/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".pi/agent"));
+    }
+  },
+  qoder: {
+    name: "qoder",
+    displayName: "Qoder",
+    skillsDir: ".qoder/skills",
+    globalSkillsDir: join(home, ".qoder/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".qoder"));
+    }
+  },
+  "qwen-code": {
+    name: "qwen-code",
+    displayName: "Qwen Code",
+    skillsDir: ".qwen/skills",
+    globalSkillsDir: join(home, ".qwen/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".qwen"));
+    }
+  },
+  roo: {
+    name: "roo",
+    displayName: "Roo Code",
+    skillsDir: ".roo/skills",
+    globalSkillsDir: join(home, ".roo/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".roo"));
+    }
+  },
+  trae: {
+    name: "trae",
+    displayName: "Trae",
+    skillsDir: ".trae/skills",
+    globalSkillsDir: join(home, ".trae/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".trae"));
+    }
+  },
+  windsurf: {
+    name: "windsurf",
+    displayName: "Windsurf",
+    skillsDir: ".windsurf/skills",
+    globalSkillsDir: join(home, ".codeium/windsurf/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".codeium/windsurf"));
+    }
+  },
+  zencoder: {
+    name: "zencoder",
+    displayName: "Zencoder",
+    skillsDir: ".zencoder/skills",
+    globalSkillsDir: join(home, ".zencoder/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".zencoder"));
+    }
+  },
+  neovate: {
+    name: "neovate",
+    displayName: "Neovate",
+    skillsDir: ".neovate/skills",
+    globalSkillsDir: join(home, ".neovate/skills"),
+    detectInstalled: async () => {
+      return existsSync(join(home, ".neovate"));
+    }
+  }
+};
+async function detectInstalledAgents() {
+  const installed = [];
+  for (const [type, config] of Object.entries(agents)) {
+    if (await config.detectInstalled()) {
+      installed.push(type);
+    }
+  }
+  return installed;
 }
 
-// src/telemetry.ts
-import { createHmac } from "crypto";
-var API_BASE = process.env.PLAYBOOKS_API_URL?.trim() || "https://playbooks.com/api";
-var TELEMETRY_URL = process.env.PLAYBOOKS_TELEMETRY_URL?.trim() || `${API_BASE}/skill/t`;
-var cliVersion = null;
-function isCI() {
-  return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.CIRCLECI || process.env.TRAVIS || process.env.BUILDKITE || process.env.JENKINS_URL || process.env.TEAMCITY_VERSION);
+// src/flows/find-skill.ts
+import { existsSync as existsSync3 } from "fs";
+import { mkdtemp as mkdtemp2 } from "fs/promises";
+import { tmpdir as tmpdir3 } from "os";
+import { join as join4 } from "path";
+
+// src/git.ts
+import { mkdtemp, rm as rm2 } from "fs/promises";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join2 } from "path";
+import simpleGit from "simple-git";
+
+// src/temp-registry.ts
+import { rmSync } from "fs";
+import { rm } from "fs/promises";
+import { tmpdir } from "os";
+import { normalize, resolve, sep } from "path";
+var tempDirs = /* @__PURE__ */ new Set();
+var handlersInstalled = false;
+function isTempPathSafe(dir) {
+  const normalizedDir = normalize(resolve(dir));
+  const normalizedTmpDir = normalize(resolve(tmpdir()));
+  return normalizedDir.startsWith(normalizedTmpDir + sep) || normalizedDir === normalizedTmpDir;
 }
-function isEnabled() {
-  return !process.env.DISABLE_TELEMETRY && !process.env.DO_NOT_TRACK && !process.env.PLAYBOOKS_DISABLE_TELEMETRY;
+function registerTempDir(dir) {
+  tempDirs.add(dir);
 }
-function setVersion(version2) {
-  cliVersion = version2;
-}
-function buildHeaders(body) {
-  const headers = {
-    "Content-Type": "application/json",
-    "User-Agent": "playbooks-cli"
-  };
-  if (cliVersion) {
-    headers["X-Playbooks-Version"] = cliVersion;
-  }
-  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-  headers["X-Playbooks-Timestamp"] = timestamp;
-  const secret = process.env.PLAYBOOKS_TELEMETRY_SECRET;
-  if (secret) {
-    const signature = createHmac("sha256", secret).update(`${timestamp}.${body}`).digest("hex");
-    headers["X-Playbooks-Signature"] = signature;
-  }
-  return headers;
-}
-function trackInstall(payload) {
-  if (!isEnabled()) return;
-  try {
-    const body = JSON.stringify({
-      ...payload,
-      version: cliVersion ?? void 0,
-      ci: isCI() || void 0
-    });
-    fetch(TELEMETRY_URL, {
-      method: "POST",
-      headers: buildHeaders(body),
-      body
-    }).catch(() => {
-    });
-  } catch {
-  }
-}
-
-// src/temp-registry.ts
-import { rmSync } from "fs";
-import { rm } from "fs/promises";
-import { tmpdir } from "os";
-import { normalize, resolve, sep } from "path";
-var tempDirs = /* @__PURE__ */ new Set();
-var handlersInstalled = false;
-function isTempPathSafe(dir) {
-  const normalizedDir = normalize(resolve(dir));
-  const normalizedTmpDir = normalize(resolve(tmpdir()));
-  return normalizedDir.startsWith(normalizedTmpDir + sep) || normalizedDir === normalizedTmpDir;
-}
-function registerTempDir(dir) {
-  tempDirs.add(dir);
-}
-function unregisterTempDir(dir) {
-  tempDirs.delete(dir);
+function unregisterTempDir(dir) {
+  tempDirs.delete(dir);
 }
 function cleanupAllTempDirsSync() {
   const dirs = Array.from(tempDirs);
@@ -211,19 +424,9 @@ function setupTempDirCleanup() {
   });
 }
 
-// src/tui/App.tsx
-import { render } from "ink";
-
-// src/tui/context/navigation.tsx
-import React, { createContext, useCallback, useContext, useMemo, useState } from "react";
-
 // src/git.ts
-import { mkdtemp, rm as rm2 } from "fs/promises";
-import { tmpdir as tmpdir2 } from "os";
-import { join } from "path";
-import simpleGit from "simple-git";
 async function cloneRepo(url, ref) {
-  const tempDir = await mkdtemp(join(tmpdir2(), "add-skill-"));
+  const tempDir = await mkdtemp(join2(tmpdir2(), "add-skill-"));
   registerTempDir(tempDir);
   const git = simpleGit();
   const cloneOptions = ref ? ["--depth", "1", "--branch", ref] : ["--depth", "1"];
@@ -246,517 +449,713 @@ async function cleanupTempDir(dir) {
   }
 }
 
-// src/tui/context/navigation.tsx
-import { jsx } from "react/jsx-runtime";
-var NavigationContext = createContext(null);
-function useNavigation() {
-  const ctx = useContext(NavigationContext);
-  if (!ctx) throw new Error("NavigationContext not found");
-  return ctx;
-}
-function NavigationProvider({
-  children,
-  initialInvocation,
-  initialScreen
-}) {
-  const [screen, setScreen] = useState(initialScreen);
-  const [stack, setStack] = useState([initialScreen]);
-  const [flashes, setFlashes] = useState([]);
-  const [invocation, setInvocation] = useState(initialInvocation);
-  const [addSkill, setAddSkill] = useState({});
-  const [findSkill, setFindSkill] = useState({ status: "idle" });
-  const [isTextInputActive, setTextInputActive] = useState(false);
-  const [textInputEscMode, setTextInputEscMode] = useState("back");
-  const [navAction, setNavAction] = useState("reset");
-  const [lastSource, setLastSource] = useState(initialInvocation.source ?? null);
-  const backHandlerRef = React.useRef(null);
-  const flashTimersRef = React.useRef(/* @__PURE__ */ new Map());
-  const navigateTo = useCallback((s) => {
-    setNavAction("push");
-    setStack((prev) => [...prev, s]);
-    setScreen(s);
-  }, []);
-  const resetTo = useCallback((s) => {
-    setNavAction("reset");
-    setStack([s]);
-    setScreen(s);
-  }, []);
-  const goBack = useCallback(() => {
-    setNavAction("pop");
-    let target;
-    if (stack.length <= 1) {
-      target = stack[0] ?? "main";
-      setStack([target]);
-    } else {
-      const next = stack.slice(0, -1);
-      target = next[next.length - 1] ?? "main";
-      setStack(next);
-    }
-    setScreen(target);
-  }, [stack]);
-  const setFlash = useCallback((msg) => {
-    if (msg === null) {
-      for (const timer2 of flashTimersRef.current.values()) {
-        clearTimeout(timer2);
-      }
-      flashTimersRef.current.clear();
-      setFlashes([]);
-      return;
+// src/playbooks-api.ts
+var API_BASE = process.env.PLAYBOOKS_API_URL?.trim() || "https://playbooks.com/api";
+var USER_AGENT = "playbooks-cli";
+async function searchSkills(query, mode, limit = 10) {
+  const url = new URL(`${API_BASE}/skills`);
+  url.searchParams.set("search", query);
+  url.searchParams.set("limit", String(limit));
+  url.searchParams.set("mode", mode);
+  const response = await fetch(url.toString(), {
+    headers: {
+      "User-Agent": USER_AGENT
     }
-    const id = Date.now() + Math.random();
-    setFlashes((prev) => [...prev, { id, text: msg }]);
-    const timer = setTimeout(() => {
-      setFlashes((prev) => prev.filter((f) => f.id !== id));
-      flashTimersRef.current.delete(id);
-    }, 5e3);
-    flashTimersRef.current.set(id, timer);
-  }, []);
-  React.useEffect(() => {
-    return () => {
-      for (const timer of flashTimersRef.current.values()) {
-        clearTimeout(timer);
-      }
-      flashTimersRef.current.clear();
-    };
-  }, []);
-  React.useEffect(() => {
-    if (!addSkill.tempDir) return;
-    if (screen.startsWith("add-") || screen.startsWith("find-")) return;
-    cleanupTempDir(addSkill.tempDir).catch(() => {
-    });
-  }, [addSkill.tempDir, screen]);
-  const updateAddSkill = useCallback((patch) => {
-    setAddSkill((prev) => ({ ...prev, ...patch }));
-  }, []);
-  const resetAddSkill = useCallback(() => {
-    setAddSkill({});
-  }, []);
-  const updateFindSkill = useCallback((patch) => {
-    setFindSkill((prev) => ({ ...prev, ...patch }));
-  }, []);
-  const resetFindSkill = useCallback(() => {
-    setFindSkill({ status: "idle" });
-  }, []);
-  const value = useMemo(
-    () => ({
-      screen,
-      setScreen,
-      navigateTo,
-      resetTo,
-      goBack,
-      stack,
-      flashes,
-      setFlash,
-      navAction,
-      lastSource,
-      setLastSource,
-      getBackHandler: () => backHandlerRef.current,
-      setBackHandler: (fn) => {
-        backHandlerRef.current = fn;
-      },
-      invocation,
-      setInvocation,
-      addSkill,
-      setAddSkill,
-      updateAddSkill,
-      resetAddSkill,
-      findSkill,
-      setFindSkill,
-      updateFindSkill,
-      resetFindSkill,
-      isTextInputActive,
-      setTextInputActive,
-      textInputEscMode,
-      setTextInputEscMode
-    }),
-    [
-      screen,
-      stack,
-      flashes,
-      navAction,
-      navigateTo,
-      resetTo,
-      goBack,
-      setFlash,
-      lastSource,
-      invocation,
-      addSkill,
-      updateAddSkill,
-      resetAddSkill,
-      findSkill,
-      updateFindSkill,
-      resetFindSkill,
-      isTextInputActive,
-      textInputEscMode
-    ]
-  );
-  return /* @__PURE__ */ jsx(NavigationContext.Provider, { value, children });
+  });
+  let payload = null;
+  try {
+    payload = await response.json();
+  } catch {
+    payload = null;
+  }
+  if (!response.ok || !payload?.success) {
+    const message = payload?.error || `Search failed (${response.status})`;
+    throw new Error(message);
+  }
+  return Array.isArray(payload.data) ? payload.data : [];
 }
-
-// src/tui/ui/BrandHeader.tsx
-import { Box, Text } from "ink";
-import React2 from "react";
-import { jsx as jsx2, jsxs } from "react/jsx-runtime";
-var TARGET_TEXT = "playbooks";
-var TAGLINE = "Give your agents context to make them smarter.";
-var TEXT_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
-function randomChar(chars) {
-  const pool = Array.isArray(chars) ? chars : chars.split("");
-  return pool[Math.floor(Math.random() * pool.length)] ?? "";
+async function requestUrlMarkdown(url) {
+  const endpoint = new URL(`${API_BASE}/url`);
+  const response = await fetch(endpoint.toString(), {
+    method: "POST",
+    headers: {
+      "User-Agent": USER_AGENT,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ url })
+  });
+  let payload = null;
+  try {
+    payload = await response.json();
+  } catch {
+    payload = null;
+  }
+  if (!response.ok && response.status !== 202) {
+    const message = payload?.error || `Request failed (${response.status})`;
+    throw new Error(message);
+  }
+  return payload ?? { success: false, error: `Request failed (${response.status})` };
 }
-function buildScrambleText(target, settles, progress) {
-  const letters = target.split("");
-  return letters.map((char, index) => {
-    if (char === " ") return char;
-    const settle = settles[index] ?? 1;
-    if (progress >= settle) return char;
-    return randomChar(TEXT_CHARS);
-  }).join("");
-}
-function BrandHeader() {
-  const [title, setTitle] = React2.useState(
-    () => TARGET_TEXT.split("").map((char) => char === " " ? " " : randomChar(TEXT_CHARS)).join("")
-  );
-  const hasAnimated = React2.useRef(false);
-  const textSettles = React2.useRef([]);
-  React2.useEffect(() => {
-    if (hasAnimated.current) return;
-    hasAnimated.current = true;
-    textSettles.current = TARGET_TEXT.split("").map(
-      (char) => char === " " ? 0 : 0.2 + Math.random() * 0.6
-    );
-    const steps = 18;
-    const interval = 50;
-    let step = 0;
-    const tick = () => {
-      const progress = Math.min(1, step / steps);
-      setTitle(buildScrambleText(TARGET_TEXT, textSettles.current, progress));
-      step += 1;
-      if (step > steps) {
-        setTitle(TARGET_TEXT);
-        return false;
-      }
-      return true;
-    };
-    tick();
-    const timer = setInterval(() => {
-      if (!tick()) {
-        clearInterval(timer);
+async function pollUrlMarkdown(jobId, timeoutMs = 6e4, pollIntervalMs = 1e3) {
+  const endpoint = new URL(`${API_BASE}/url`);
+  endpoint.searchParams.set("jobId", jobId);
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const response = await fetch(endpoint.toString(), {
+      headers: {
+        "User-Agent": USER_AGENT
       }
-    }, interval);
-    return () => {
-      clearInterval(timer);
-    };
-  }, []);
-  return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, flexDirection: "column", children: [
-    /* @__PURE__ */ jsx2(Text, { bold: true, children: title }),
-    /* @__PURE__ */ jsx2(Text, { dimColor: true, children: TAGLINE })
-  ] });
-}
-
-// src/tui/ui/FlashBar.tsx
-import { Box as Box2, Text as Text2 } from "ink";
-import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
-function classify(msg) {
-  const m = msg.toLowerCase();
-  if (/(error|failed|unable|denied|invalid|cannot|not found)/i.test(msg)) return "error";
-  if (/(deleted|linked|unlinked|updated|created|saved|enabled|disabled|added|removed|✓)/i.test(msg))
-    return "success";
-  if (/(warn|deprecated|missing|retry|timeout)/i.test(msg)) return "warning";
-  return "info";
-}
-function FlashBar({ align = "left" }) {
-  const { flashes } = useNavigation();
-  if (flashes.length === 0) return /* @__PURE__ */ jsx3(Box2, { height: 1 });
-  return /* @__PURE__ */ jsx3(
-    Box2,
-    {
-      flexDirection: "column",
-      paddingX: 1,
-      paddingY: 0,
-      gap: 0,
-      justifyContent: align === "center" ? "center" : "flex-start",
-      children: flashes.map((flash) => {
-        const kind = classify(flash.text);
-        const color = kind === "success" ? "green" : kind === "error" ? "red" : kind === "warning" ? "yellow" : "cyan";
-        const label = kind === "success" ? "\u2713" : kind === "error" ? "x" : kind === "warning" ? "!" : "i";
-        return /* @__PURE__ */ jsxs2(Text2, { color, children: [
-          "[",
-          label,
-          "] ",
-          flash.text
-        ] }, flash.id);
-      })
-    }
-  );
-}
-
-// src/tui/screens/AddConfirm.tsx
-import { join as join7 } from "path";
-import { Box as Box8, Text as Text8 } from "ink";
-import React3 from "react";
-
-// src/agents.ts
-import { existsSync } from "fs";
-import { homedir } from "os";
-import { join as join2 } from "path";
-var home = homedir();
-var codexHome = process.env.CODEX_HOME?.trim() || join2(home, ".codex");
-var agents = {
-  amp: {
-    name: "amp",
-    displayName: "Amp",
-    skillsDir: ".agents/skills",
-    globalSkillsDir: join2(home, ".config/agents/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".config/amp"));
-    }
-  },
-  antigravity: {
-    name: "antigravity",
-    displayName: "Antigravity",
-    skillsDir: ".agent/skills",
-    globalSkillsDir: join2(home, ".gemini/antigravity/global_skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(process.cwd(), ".agent")) || existsSync(join2(home, ".gemini/antigravity"));
+    });
+    let payload = null;
+    try {
+      payload = await response.json();
+    } catch {
+      payload = null;
     }
-  },
-  "claude-code": {
-    name: "claude-code",
-    displayName: "Claude Code",
-    skillsDir: ".claude/skills",
-    globalSkillsDir: join2(home, ".claude/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".claude"));
+    if (payload?.success && payload.data) {
+      return payload.data;
     }
-  },
-  clawdbot: {
-    name: "clawdbot",
-    displayName: "Clawdbot",
-    skillsDir: "skills",
-    globalSkillsDir: join2(home, ".clawdbot/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".clawdbot"));
+    if (payload?.success && payload.pending) {
+      await new Promise((resolve5) => setTimeout(resolve5, pollIntervalMs));
+      continue;
     }
-  },
-  cline: {
-    name: "cline",
-    displayName: "Cline",
-    skillsDir: ".cline/skills",
-    globalSkillsDir: join2(home, ".cline/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".cline"));
+    const message = payload?.error || `Request failed (${response.status})`;
+    throw new Error(message);
+  }
+  throw new Error("Timed out waiting for markdown");
+}
+async function fetchUrlMarkdown(url) {
+  const response = await requestUrlMarkdown(url);
+  if (response.success && response.data) {
+    return response.data;
+  }
+  if (response.jobId) {
+    return await pollUrlMarkdown(response.jobId);
+  }
+  const message = response.error || "Failed to fetch markdown";
+  throw new Error(message);
+}
+
+// src/skills.ts
+import { existsSync as existsSync2 } from "fs";
+import { readFile, readdir, stat } from "fs/promises";
+import { basename, dirname, join as join3 } from "path";
+import matter from "gray-matter";
+var SKIP_DIRS = ["node_modules", ".git", ".github", "dist", "build", "__pycache__"];
+var DENIED_SEGMENTS = /* @__PURE__ */ new Set([
+  ".git",
+  "node_modules",
+  ".github",
+  "playbooks",
+  "context",
+  "prompts",
+  "backups",
+  "backup",
+  "dist",
+  "deprecated"
+]);
+var normalizePath = (value) => value.replace(/^\/+/, "");
+var normalizeRoot = (value) => normalizePath(value).replace(/^\.\//, "").replace(/^\/+/, "").replace(/\/+$/, "");
+var isDeniedPath = (path) => {
+  const cleaned = normalizePath(path);
+  const segments = cleaned.split("/").map((segment) => segment.toLowerCase());
+  for (const segment of segments) {
+    if (!segment) continue;
+    if (segment === ".claude-plugin") {
+      continue;
     }
-  },
-  codex: {
-    name: "codex",
-    displayName: "Codex",
-    skillsDir: ".codex/skills",
-    globalSkillsDir: join2(codexHome, "skills"),
-    detectInstalled: async () => {
-      return existsSync(codexHome) || existsSync("/etc/codex");
+    if (DENIED_SEGMENTS.has(segment)) {
+      return true;
     }
-  },
-  "command-code": {
-    name: "command-code",
-    displayName: "Command Code",
-    skillsDir: ".commandcode/skills",
-    globalSkillsDir: join2(home, ".commandcode/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".commandcode"));
+  }
+  return false;
+};
+async function hasSkillMd(dir) {
+  try {
+    if (isDeniedPath(dir)) return false;
+    const skillPath = join3(dir, "SKILL.md");
+    const stats = await stat(skillPath);
+    return stats.isFile();
+  } catch {
+    return false;
+  }
+}
+async function parseSkillMd(skillMdPath) {
+  try {
+    if (isDeniedPath(skillMdPath)) return null;
+    const content = await readFile(skillMdPath, "utf-8");
+    const { data } = matter(content);
+    if (!data.name || !data.description) {
+      return null;
     }
-  },
-  continue: {
-    name: "continue",
-    displayName: "Continue",
-    skillsDir: ".continue/skills",
-    globalSkillsDir: join2(home, ".continue/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(process.cwd(), ".continue")) || existsSync(join2(home, ".continue"));
+    return {
+      name: data.name,
+      description: data.description,
+      path: dirname(skillMdPath),
+      rawContent: content,
+      metadata: data.metadata
+    };
+  } catch {
+    return null;
+  }
+}
+async function findSkillDirs(dir, depth = 0, maxDepth = 5) {
+  const skillDirs = [];
+  if (depth > maxDepth) return skillDirs;
+  if (isDeniedPath(dir)) return skillDirs;
+  try {
+    if (await hasSkillMd(dir)) {
+      skillDirs.push(dir);
     }
-  },
-  crush: {
-    name: "crush",
-    displayName: "Crush",
-    skillsDir: ".crush/skills",
-    globalSkillsDir: join2(home, ".config/crush/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".config/crush"));
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory() && !SKIP_DIRS.includes(entry.name)) {
+        const subDirs = await findSkillDirs(join3(dir, entry.name), depth + 1, maxDepth);
+        skillDirs.push(...subDirs);
+      }
     }
-  },
-  cursor: {
-    name: "cursor",
-    displayName: "Cursor",
-    skillsDir: ".cursor/skills",
-    globalSkillsDir: join2(home, ".cursor/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".cursor"));
-    }
-  },
-  droid: {
-    name: "droid",
-    displayName: "Droid",
-    skillsDir: ".factory/skills",
-    globalSkillsDir: join2(home, ".factory/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".factory"));
-    }
-  },
-  "gemini-cli": {
-    name: "gemini-cli",
-    displayName: "Gemini CLI",
-    skillsDir: ".gemini/skills",
-    globalSkillsDir: join2(home, ".gemini/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".gemini"));
-    }
-  },
-  "github-copilot": {
-    name: "github-copilot",
-    displayName: "GitHub Copilot",
-    skillsDir: ".github/skills",
-    globalSkillsDir: join2(home, ".copilot/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(process.cwd(), ".github")) || existsSync(join2(home, ".copilot"));
-    }
-  },
-  goose: {
-    name: "goose",
-    displayName: "Goose",
-    skillsDir: ".goose/skills",
-    globalSkillsDir: join2(home, ".config/goose/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".config/goose"));
-    }
-  },
-  kilo: {
-    name: "kilo",
-    displayName: "Kilo Code",
-    skillsDir: ".kilocode/skills",
-    globalSkillsDir: join2(home, ".kilocode/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".kilocode"));
+  } catch {
+  }
+  return skillDirs;
+}
+async function readMarketplacePluginRoots(basePath) {
+  const filePath = join3(basePath, ".claude-plugin", "marketplace.json");
+  if (!existsSync2(filePath)) return [];
+  try {
+    const raw = await readFile(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    const roots = (parsed.plugins ?? []).map((plugin) => typeof plugin.source === "string" ? plugin.source : null).filter(Boolean);
+    return roots.map((root) => normalizeRoot(root)).filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+async function collectSkillsFromRoot(root, seenSlugs, skills) {
+  if (!root || !existsSync2(root) || isDeniedPath(root)) return;
+  const skillDirs = await findSkillDirs(root);
+  for (const skillDir of skillDirs) {
+    const skill = await parseSkillMd(join3(skillDir, "SKILL.md"));
+    if (!skill) continue;
+    const slug = basename(skill.path).toLowerCase();
+    if (seenSlugs.has(slug)) continue;
+    skills.push(skill);
+    seenSlugs.add(slug);
+  }
+}
+async function listPluginSkillRoots(basePath) {
+  const pluginsDir = join3(basePath, "plugins");
+  if (!existsSync2(pluginsDir)) return [];
+  try {
+    const entries = await readdir(pluginsDir, { withFileTypes: true });
+    const roots = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const candidate = join3(pluginsDir, entry.name, "skills");
+      if (existsSync2(candidate)) {
+        roots.push(candidate);
+      }
     }
-  },
-  "kiro-cli": {
-    name: "kiro-cli",
-    displayName: "Kiro CLI",
-    skillsDir: ".kiro/skills",
-    globalSkillsDir: join2(home, ".kiro/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".kiro"));
+    return roots;
+  } catch {
+    return [];
+  }
+}
+async function discoverSkills(basePath, subpath) {
+  const skills = [];
+  const seenSlugs = /* @__PURE__ */ new Set();
+  const searchPath = subpath ? join3(basePath, subpath) : basePath;
+  if (await hasSkillMd(searchPath)) {
+    const skill = await parseSkillMd(join3(searchPath, "SKILL.md"));
+    if (skill) {
+      skills.push(skill);
+      return skills;
     }
-  },
-  mcpjam: {
-    name: "mcpjam",
-    displayName: "MCPJam",
-    skillsDir: ".mcpjam/skills",
-    globalSkillsDir: join2(home, ".mcpjam/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".mcpjam"));
+  }
+  const marketplaceRoots = await readMarketplacePluginRoots(searchPath);
+  for (const root of marketplaceRoots) {
+    const skillsRoot = root.toLowerCase().endsWith("/skills") ? root : `${root}/skills`;
+    await collectSkillsFromRoot(join3(searchPath, skillsRoot), seenSlugs, skills);
+  }
+  await collectSkillsFromRoot(join3(searchPath, "skills"), seenSlugs, skills);
+  const pluginRoots = await listPluginSkillRoots(searchPath);
+  for (const root of pluginRoots) {
+    await collectSkillsFromRoot(root, seenSlugs, skills);
+  }
+  await collectSkillsFromRoot(join3(searchPath, ".claude-plugin"), seenSlugs, skills);
+  const agentRoots = [
+    join3(searchPath, ".agent/skills"),
+    join3(searchPath, ".agents/skills"),
+    join3(searchPath, ".cline/skills"),
+    join3(searchPath, ".commandcode/skills"),
+    join3(searchPath, ".continue/skills"),
+    join3(searchPath, ".cursor/skills"),
+    join3(searchPath, ".factory/skills"),
+    join3(searchPath, ".github/skills"),
+    join3(searchPath, ".goose/skills"),
+    join3(searchPath, ".kilocode/skills"),
+    join3(searchPath, ".kiro/skills"),
+    join3(searchPath, ".neovate/skills"),
+    join3(searchPath, ".openhands/skills"),
+    join3(searchPath, ".pi/skills"),
+    join3(searchPath, ".qoder/skills"),
+    join3(searchPath, ".roo/skills"),
+    join3(searchPath, ".trae/skills"),
+    join3(searchPath, ".windsurf/skills"),
+    join3(searchPath, ".zencoder/skills")
+  ];
+  for (const root of agentRoots) {
+    await collectSkillsFromRoot(root, seenSlugs, skills);
+  }
+  if (skills.length === 0) {
+    const allSkillDirs = await findSkillDirs(searchPath);
+    for (const skillDir of allSkillDirs) {
+      const skill = await parseSkillMd(join3(skillDir, "SKILL.md"));
+      if (!skill) continue;
+      const slug = basename(skill.path).toLowerCase();
+      if (seenSlugs.has(slug)) continue;
+      skills.push(skill);
+      seenSlugs.add(slug);
     }
-  },
-  opencode: {
-    name: "opencode",
-    displayName: "OpenCode",
-    skillsDir: ".opencode/skills",
-    globalSkillsDir: join2(home, ".config/opencode/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".config/opencode")) || existsSync(join2(home, ".claude/skills"));
+  }
+  return skills;
+}
+function getSkillDisplayName(skill) {
+  return skill.name || basename(skill.path);
+}
+
+// src/flows/find-skill.ts
+async function searchSkillDirectory(query, mode, limit = 10) {
+  const trimmed = query.trim();
+  if (!trimmed) {
+    return { mode, results: [], fallback: false };
+  }
+  if (mode === "semantic") {
+    try {
+      const results2 = await searchSkills(trimmed, "semantic", limit);
+      return { mode: "semantic", results: results2, fallback: false };
+    } catch {
+      const results2 = await searchSkills(trimmed, "lexical", limit);
+      return { mode: "lexical", results: results2, fallback: true };
     }
-  },
-  openhands: {
-    name: "openhands",
-    displayName: "OpenHands",
-    skillsDir: ".openhands/skills",
-    globalSkillsDir: join2(home, ".openhands/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".openhands"));
+  }
+  const results = await searchSkills(trimmed, "lexical", limit);
+  return { mode: "lexical", results, fallback: false };
+}
+var normalizeSkillPath = (value) => value.replace(/^\/+/, "").replace(/\\/g, "/");
+var toSkillDir = (skillPath) => {
+  const normalized = normalizeSkillPath(skillPath);
+  const cleaned = normalized.replace(/\/?SKILL\.md$/i, "").replace(/\/+$/, "");
+  return cleaned;
+};
+var ensureSkillMdPath = (skillPath) => {
+  const normalized = normalizeSkillPath(skillPath);
+  if (/\/?SKILL\.md$/i.test(normalized)) {
+    return normalized;
+  }
+  if (!normalized) {
+    return "SKILL.md";
+  }
+  return `${normalized.replace(/\/+$/, "")}/SKILL.md`;
+};
+var sanitizeRepoDir = (owner, repo) => `${owner}-${repo}`.toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
+async function prepareSkillsFromSearchResults(selected) {
+  if (selected.length === 0) {
+    throw new Error("Select at least one skill to install.");
+  }
+  const tempDir = await mkdtemp2(join4(tmpdir3(), "playbooks-search-"));
+  registerTempDir(tempDir);
+  try {
+    const repoMap = /* @__PURE__ */ new Map();
+    for (const result of selected) {
+      if (!result.repoOwner || !result.repoName || !result.path) {
+        throw new Error(`Missing repository data for ${result.name}.`);
+      }
+      const key = `${result.repoOwner.toLowerCase()}/${result.repoName.toLowerCase()}`;
+      const existing = repoMap.get(key);
+      if (existing) {
+        existing.entries.push(result);
+      } else {
+        repoMap.set(key, {
+          owner: result.repoOwner,
+          repo: result.repoName,
+          repoUrl: `https://github.com/${result.repoOwner}/${result.repoName}.git`,
+          entries: [result]
+        });
+      }
     }
-  },
-  pi: {
-    name: "pi",
-    displayName: "Pi",
-    skillsDir: ".pi/skills",
-    globalSkillsDir: join2(home, ".pi/agent/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".pi/agent"));
+    const repoDirs = /* @__PURE__ */ new Map();
+    const usedDirs = /* @__PURE__ */ new Set();
+    for (const [key, repoInfo] of repoMap) {
+      let dirName = sanitizeRepoDir(repoInfo.owner, repoInfo.repo);
+      let suffix = 1;
+      while (usedDirs.has(dirName)) {
+        dirName = `${sanitizeRepoDir(repoInfo.owner, repoInfo.repo)}-${suffix}`;
+        suffix += 1;
+      }
+      usedDirs.add(dirName);
+      const repoDir = join4(tempDir, dirName);
+      await cloneRepoTo(repoInfo.repoUrl, repoDir);
+      repoDirs.set(key, repoDir);
     }
-  },
-  qoder: {
-    name: "qoder",
-    displayName: "Qoder",
-    skillsDir: ".qoder/skills",
-    globalSkillsDir: join2(home, ".qoder/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".qoder"));
+    const skills = [];
+    const originBySkillName = /* @__PURE__ */ new Map();
+    for (const result of selected) {
+      if (!result.repoOwner || !result.repoName || !result.path) {
+        continue;
+      }
+      const repoKey = `${result.repoOwner.toLowerCase()}/${result.repoName.toLowerCase()}`;
+      const repoDir = repoDirs.get(repoKey);
+      if (!repoDir) {
+        throw new Error(`Missing clone for ${result.repoOwner}/${result.repoName}.`);
+      }
+      const skillDir = toSkillDir(result.path);
+      const subpath = skillDir ? skillDir : void 0;
+      const discovered = await discoverSkills(repoDir, subpath);
+      if (discovered.length === 0) {
+        throw new Error(`Skill not found in ${result.repoOwner}/${result.repoName}.`);
+      }
+      const expectedPath = join4(repoDir, skillDir);
+      const fallbackSkill = discovered[0];
+      if (!fallbackSkill) {
+        throw new Error(`Skill not found in ${result.repoOwner}/${result.repoName}.`);
+      }
+      const skill = discovered.find((entry) => entry.path === expectedPath) ?? fallbackSkill;
+      if (!existsSync3(join4(skill.path, "SKILL.md"))) {
+        throw new Error(`SKILL.md missing for ${result.name}.`);
+      }
+      skills.push(skill);
+      const displayName = getSkillDisplayName(skill);
+      originBySkillName.set(displayName, {
+        sourceType: "github",
+        source: `${result.repoOwner}/${result.repoName}`,
+        sourceUrl: `https://github.com/${result.repoOwner}/${result.repoName}.git`,
+        skillPath: ensureSkillMdPath(result.path)
+      });
     }
-  },
-  "qwen-code": {
-    name: "qwen-code",
-    displayName: "Qwen Code",
-    skillsDir: ".qwen/skills",
-    globalSkillsDir: join2(home, ".qwen/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".qwen"));
+    return { tempDir, skills, originBySkillName };
+  } catch (error) {
+    try {
+      await cleanupTempDir(tempDir);
+    } catch {
     }
-  },
-  roo: {
-    name: "roo",
-    displayName: "Roo Code",
-    skillsDir: ".roo/skills",
-    globalSkillsDir: join2(home, ".roo/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".roo"));
-    }
-  },
-  trae: {
-    name: "trae",
-    displayName: "Trae",
-    skillsDir: ".trae/skills",
-    globalSkillsDir: join2(home, ".trae/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".trae"));
-    }
-  },
-  windsurf: {
-    name: "windsurf",
-    displayName: "Windsurf",
-    skillsDir: ".windsurf/skills",
-    globalSkillsDir: join2(home, ".codeium/windsurf/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".codeium/windsurf"));
-    }
-  },
-  zencoder: {
-    name: "zencoder",
-    displayName: "Zencoder",
-    skillsDir: ".zencoder/skills",
-    globalSkillsDir: join2(home, ".zencoder/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".zencoder"));
+    throw error;
+  }
+}
+
+// src/flows/url-markdown-output.ts
+var output = null;
+function setUrlMarkdownOutput(next) {
+  output = next;
+}
+function consumeUrlMarkdownOutput() {
+  const current = output;
+  output = null;
+  return current;
+}
+
+// src/telemetry.ts
+import { createHmac } from "crypto";
+var API_BASE2 = process.env.PLAYBOOKS_API_URL?.trim() || "https://playbooks.com/api";
+var TELEMETRY_URL = process.env.PLAYBOOKS_TELEMETRY_URL?.trim() || `${API_BASE2}/skill/t`;
+var cliVersion = null;
+function isCI() {
+  return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.CIRCLECI || process.env.TRAVIS || process.env.BUILDKITE || process.env.JENKINS_URL || process.env.TEAMCITY_VERSION);
+}
+function isEnabled() {
+  return !process.env.DISABLE_TELEMETRY && !process.env.DO_NOT_TRACK && !process.env.PLAYBOOKS_DISABLE_TELEMETRY;
+}
+function setVersion(version2) {
+  cliVersion = version2;
+}
+function buildHeaders(body) {
+  const headers = {
+    "Content-Type": "application/json",
+    "User-Agent": "playbooks-cli"
+  };
+  if (cliVersion) {
+    headers["X-Playbooks-Version"] = cliVersion;
+  }
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  headers["X-Playbooks-Timestamp"] = timestamp;
+  const secret = process.env.PLAYBOOKS_TELEMETRY_SECRET;
+  if (secret) {
+    const signature = createHmac("sha256", secret).update(`${timestamp}.${body}`).digest("hex");
+    headers["X-Playbooks-Signature"] = signature;
+  }
+  return headers;
+}
+function trackInstall(payload) {
+  if (!isEnabled()) return;
+  try {
+    const body = JSON.stringify({
+      ...payload,
+      version: cliVersion ?? void 0,
+      ci: isCI() || void 0
+    });
+    fetch(TELEMETRY_URL, {
+      method: "POST",
+      headers: buildHeaders(body),
+      body
+    }).catch(() => {
+    });
+  } catch {
+  }
+}
+
+// src/tui/App.tsx
+import { render } from "ink";
+
+// src/tui/context/navigation.tsx
+import React, { createContext, useCallback, useContext, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+var NavigationContext = createContext(null);
+function useNavigation() {
+  const ctx = useContext(NavigationContext);
+  if (!ctx) throw new Error("NavigationContext not found");
+  return ctx;
+}
+function NavigationProvider({
+  children,
+  initialInvocation,
+  initialScreen
+}) {
+  const [screen, setScreen] = useState(initialScreen);
+  const [stack, setStack] = useState([initialScreen]);
+  const [flashes, setFlashes] = useState([]);
+  const [invocation, setInvocation] = useState(initialInvocation);
+  const [addSkill, setAddSkill] = useState({});
+  const [findSkill, setFindSkill] = useState({ status: "idle" });
+  const [isTextInputActive, setTextInputActive] = useState(false);
+  const [textInputEscMode, setTextInputEscMode] = useState("back");
+  const [navAction, setNavAction] = useState("reset");
+  const [lastSource, setLastSource] = useState(initialInvocation.source ?? null);
+  const backHandlerRef = React.useRef(null);
+  const flashTimersRef = React.useRef(/* @__PURE__ */ new Map());
+  const navigateTo = useCallback((s) => {
+    setNavAction("push");
+    setStack((prev) => [...prev, s]);
+    setScreen(s);
+  }, []);
+  const resetTo = useCallback((s) => {
+    setNavAction("reset");
+    setStack([s]);
+    setScreen(s);
+  }, []);
+  const goBack = useCallback(() => {
+    setNavAction("pop");
+    let target;
+    if (stack.length <= 1) {
+      target = stack[0] ?? "main";
+      setStack([target]);
+    } else {
+      const next = stack.slice(0, -1);
+      target = next[next.length - 1] ?? "main";
+      setStack(next);
     }
-  },
-  neovate: {
-    name: "neovate",
-    displayName: "Neovate",
-    skillsDir: ".neovate/skills",
-    globalSkillsDir: join2(home, ".neovate/skills"),
-    detectInstalled: async () => {
-      return existsSync(join2(home, ".neovate"));
+    setScreen(target);
+  }, [stack]);
+  const setFlash = useCallback((msg) => {
+    if (msg === null) {
+      for (const timer2 of flashTimersRef.current.values()) {
+        clearTimeout(timer2);
+      }
+      flashTimersRef.current.clear();
+      setFlashes([]);
+      return;
     }
-  }
-};
-async function detectInstalledAgents() {
-  const installed = [];
-  for (const [type, config] of Object.entries(agents)) {
-    if (await config.detectInstalled()) {
-      installed.push(type);
+    const id = Date.now() + Math.random();
+    setFlashes((prev) => [...prev, { id, text: msg }]);
+    const timer = setTimeout(() => {
+      setFlashes((prev) => prev.filter((f) => f.id !== id));
+      flashTimersRef.current.delete(id);
+    }, 5e3);
+    flashTimersRef.current.set(id, timer);
+  }, []);
+  React.useEffect(() => {
+    return () => {
+      for (const timer of flashTimersRef.current.values()) {
+        clearTimeout(timer);
+      }
+      flashTimersRef.current.clear();
+    };
+  }, []);
+  React.useEffect(() => {
+    if (!addSkill.tempDir) return;
+    if (screen.startsWith("add-") || screen.startsWith("find-")) return;
+    cleanupTempDir(addSkill.tempDir).catch(() => {
+    });
+  }, [addSkill.tempDir, screen]);
+  const updateAddSkill = useCallback((patch) => {
+    setAddSkill((prev) => ({ ...prev, ...patch }));
+  }, []);
+  const resetAddSkill = useCallback(() => {
+    setAddSkill({});
+  }, []);
+  const updateFindSkill = useCallback((patch) => {
+    setFindSkill((prev) => ({ ...prev, ...patch }));
+  }, []);
+  const resetFindSkill = useCallback(() => {
+    setFindSkill({ status: "idle" });
+  }, []);
+  const value = useMemo(
+    () => ({
+      screen,
+      setScreen,
+      navigateTo,
+      resetTo,
+      goBack,
+      stack,
+      flashes,
+      setFlash,
+      navAction,
+      lastSource,
+      setLastSource,
+      getBackHandler: () => backHandlerRef.current,
+      setBackHandler: (fn) => {
+        backHandlerRef.current = fn;
+      },
+      invocation,
+      setInvocation,
+      addSkill,
+      setAddSkill,
+      updateAddSkill,
+      resetAddSkill,
+      findSkill,
+      setFindSkill,
+      updateFindSkill,
+      resetFindSkill,
+      isTextInputActive,
+      setTextInputActive,
+      textInputEscMode,
+      setTextInputEscMode
+    }),
+    [
+      screen,
+      stack,
+      flashes,
+      navAction,
+      navigateTo,
+      resetTo,
+      goBack,
+      setFlash,
+      lastSource,
+      invocation,
+      addSkill,
+      updateAddSkill,
+      resetAddSkill,
+      findSkill,
+      updateFindSkill,
+      resetFindSkill,
+      isTextInputActive,
+      textInputEscMode
+    ]
+  );
+  return /* @__PURE__ */ jsx(NavigationContext.Provider, { value, children });
+}
+
+// src/tui/ui/BrandHeader.tsx
+import { Box, Text } from "ink";
+import React2 from "react";
+import { jsx as jsx2, jsxs } from "react/jsx-runtime";
+var TARGET_TEXT = "playbooks";
+var TAGLINE = "Give your agents context to make them smarter.";
+var TEXT_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+function randomChar(chars) {
+  const pool = Array.isArray(chars) ? chars : chars.split("");
+  return pool[Math.floor(Math.random() * pool.length)] ?? "";
+}
+function buildScrambleText(target, settles, progress) {
+  const letters = target.split("");
+  return letters.map((char, index) => {
+    if (char === " ") return char;
+    const settle = settles[index] ?? 1;
+    if (progress >= settle) return char;
+    return randomChar(TEXT_CHARS);
+  }).join("");
+}
+function BrandHeader() {
+  const [title, setTitle] = React2.useState(
+    () => TARGET_TEXT.split("").map((char) => char === " " ? " " : randomChar(TEXT_CHARS)).join("")
+  );
+  const hasAnimated = React2.useRef(false);
+  const textSettles = React2.useRef([]);
+  React2.useEffect(() => {
+    if (hasAnimated.current) return;
+    hasAnimated.current = true;
+    textSettles.current = TARGET_TEXT.split("").map(
+      (char) => char === " " ? 0 : 0.2 + Math.random() * 0.6
+    );
+    const steps = 18;
+    const interval = 50;
+    let step = 0;
+    const tick = () => {
+      const progress = Math.min(1, step / steps);
+      setTitle(buildScrambleText(TARGET_TEXT, textSettles.current, progress));
+      step += 1;
+      if (step > steps) {
+        setTitle(TARGET_TEXT);
+        return false;
+      }
+      return true;
+    };
+    tick();
+    const timer = setInterval(() => {
+      if (!tick()) {
+        clearInterval(timer);
+      }
+    }, interval);
+    return () => {
+      clearInterval(timer);
+    };
+  }, []);
+  return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, flexDirection: "column", children: [
+    /* @__PURE__ */ jsx2(Text, { bold: true, children: title }),
+    /* @__PURE__ */ jsx2(Text, { dimColor: true, children: TAGLINE })
+  ] });
+}
+
+// src/tui/ui/FlashBar.tsx
+import { Box as Box2, Text as Text2 } from "ink";
+import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
+function classify(msg) {
+  const m = msg.toLowerCase();
+  if (/(error|failed|unable|denied|invalid|cannot|not found)/i.test(msg)) return "error";
+  if (/(deleted|linked|unlinked|updated|created|saved|enabled|disabled|added|removed|✓)/i.test(msg))
+    return "success";
+  if (/(warn|deprecated|missing|retry|timeout)/i.test(msg)) return "warning";
+  return "info";
+}
+function FlashBar({ align = "left" }) {
+  const { flashes } = useNavigation();
+  if (flashes.length === 0) return /* @__PURE__ */ jsx3(Box2, { height: 1 });
+  return /* @__PURE__ */ jsx3(
+    Box2,
+    {
+      flexDirection: "column",
+      paddingX: 1,
+      paddingY: 0,
+      gap: 0,
+      justifyContent: align === "center" ? "center" : "flex-start",
+      children: flashes.map((flash) => {
+        const kind = classify(flash.text);
+        const color = kind === "success" ? "green" : kind === "error" ? "red" : kind === "warning" ? "yellow" : "cyan";
+        const label = kind === "success" ? "\u2713" : kind === "error" ? "x" : kind === "warning" ? "!" : "i";
+        return /* @__PURE__ */ jsxs2(Text2, { color, children: [
+          "[",
+          label,
+          "] ",
+          flash.text
+        ] }, flash.id);
+      })
     }
-  }
-  return installed;
+  );
 }
 
+// src/tui/screens/AddConfirm.tsx
+import { join as join8 } from "path";
+import { Box as Box8, Text as Text8 } from "ink";
+import React3 from "react";
+
 // src/cli-utils.ts
 import { homedir as homedir2 } from "os";
 function shortenPath(fullPath, cwd) {
@@ -783,12 +1182,12 @@ import chalk from "chalk";
 
 // src/installer/install.ts
 import { access, mkdir as mkdir2, rm as rm4, writeFile } from "fs/promises";
-import { basename, join as join5 } from "path";
+import { basename as basename2, join as join7 } from "path";
 
 // src/installer/files.ts
-import { cp, lstat, mkdir, readdir, readlink, rm as rm3, symlink } from "fs/promises";
+import { cp, lstat, mkdir, readdir as readdir2, readlink, rm as rm3, symlink } from "fs/promises";
 import { platform } from "os";
-import { join as join3, relative, resolve as resolve2 } from "path";
+import { join as join5, relative, resolve as resolve2 } from "path";
 var EXCLUDE_FILES = /* @__PURE__ */ new Set(["README.md", "metadata.json"]);
 var isExcluded = (name) => {
   if (EXCLUDE_FILES.has(name)) return true;
@@ -816,7 +1215,7 @@ async function createSymlink(target, linkPath) {
         }
       }
     }
-    const linkDir = join3(linkPath, "..");
+    const linkDir = join5(linkPath, "..");
     await mkdir(linkDir, { recursive: true });
     const relativePath = relative(linkDir, target);
     const symlinkType = platform() === "win32" ? "junction" : void 0;
@@ -828,13 +1227,13 @@ async function createSymlink(target, linkPath) {
 }
 async function copyDirectory(src, dest) {
   await mkdir(dest, { recursive: true });
-  const entries = await readdir(src, { withFileTypes: true });
+  const entries = await readdir2(src, { withFileTypes: true });
   for (const entry of entries) {
     if (isExcluded(entry.name)) {
       continue;
     }
-    const srcPath = join3(src, entry.name);
-    const destPath = join3(dest, entry.name);
+    const srcPath = join5(src, entry.name);
+    const destPath = join5(dest, entry.name);
     if (entry.isDirectory()) {
       await copyDirectory(srcPath, destPath);
     } else {
@@ -848,7 +1247,7 @@ async function copySkillDirectory(src, dest) {
 
 // src/installer/paths.ts
 import { homedir as homedir3 } from "os";
-import { join as join4, normalize as normalize2, resolve as resolve3, sep as sep2 } from "path";
+import { join as join6, normalize as normalize2, resolve as resolve3, sep as sep2 } from "path";
 var AGENTS_DIR = ".agents";
 var SKILLS_SUBDIR = "skills";
 function sanitizeSkillName(name) {
@@ -870,7 +1269,7 @@ function isPathSafe(basePath, targetPath) {
 }
 function getCanonicalSkillsBase(options = {}) {
   const baseDir = options.global ? homedir3() : options.cwd || process.cwd();
-  return join4(baseDir, AGENTS_DIR, SKILLS_SUBDIR);
+  return join6(baseDir, AGENTS_DIR, SKILLS_SUBDIR);
 }
 function getCanonicalSkillsDir(global, cwd) {
   return getCanonicalSkillsBase({ global, cwd });
@@ -878,7 +1277,7 @@ function getCanonicalSkillsDir(global, cwd) {
 function getCanonicalPath(skillName, options = {}) {
   const sanitized = sanitizeSkillName(skillName);
   const canonicalBase = getCanonicalSkillsDir(options.global ?? false, options.cwd);
-  const canonicalPath = join4(canonicalBase, sanitized);
+  const canonicalPath = join6(canonicalBase, sanitized);
   if (!isPathSafe(canonicalBase, canonicalPath)) {
     throw new Error("Invalid skill name: potential path traversal detected");
   }
@@ -890,9 +1289,9 @@ function getInstallTargets(rawSkillName, agentType, options = {}) {
   const cwd = options.cwd || process.cwd();
   const skillName = sanitizeSkillName(rawSkillName);
   const canonicalBase = getCanonicalSkillsDir(isGlobal, cwd);
-  const canonicalDir = join4(canonicalBase, skillName);
-  const agentBase = isGlobal ? agent.globalSkillsDir : join4(cwd, agent.skillsDir);
-  const agentDir = join4(agentBase, skillName);
+  const canonicalDir = join6(canonicalBase, skillName);
+  const agentBase = isGlobal ? agent.globalSkillsDir : join6(cwd, agent.skillsDir);
+  const agentDir = join6(agentBase, skillName);
   return {
     skillName,
     canonicalBase,
@@ -906,7 +1305,7 @@ function getInstallTargets(rawSkillName, agentType, options = {}) {
 async function installSkillForAgent(skill, agentType, options = {}) {
   const isGlobal = options.global ?? false;
   const cwd = options.cwd || process.cwd();
-  const rawSkillName = skill.name || basename(skill.path);
+  const rawSkillName = skill.name || basename2(skill.path);
   const { canonicalBase, canonicalDir, agentBase, agentDir } = getInstallTargets(
     rawSkillName,
     agentType,
@@ -947,232 +1346,45 @@ async function installSkillForAgent(skill, agentType, options = {}) {
         await rm4(agentDir, { recursive: true, force: true });
       } catch {
       }
-      await mkdir2(agentDir, { recursive: true });
-      await copySkillDirectory(skill.path, agentDir);
-      return {
-        success: true,
-        path: agentDir,
-        canonicalPath: canonicalDir,
-        mode: "symlink",
-        symlinkFailed: true
-      };
-    }
-    return {
-      success: true,
-      path: agentDir,
-      canonicalPath: canonicalDir,
-      mode: "symlink"
-    };
-  } catch (error) {
-    return {
-      success: false,
-      path: agentDir,
-      mode: installMode,
-      error: error instanceof Error ? error.message : "Unknown error"
-    };
-  }
-}
-async function isSkillInstalled(skillName, agentType, options = {}) {
-  const agent = agents[agentType];
-  const sanitized = sanitizeSkillName(skillName);
-  const targetBase = options.global ? agent.globalSkillsDir : join5(options.cwd || process.cwd(), agent.skillsDir);
-  const skillDir = join5(targetBase, sanitized);
-  if (!isPathSafe(targetBase, skillDir)) {
-    return false;
-  }
-  try {
-    await access(skillDir);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// src/skills.ts
-import { existsSync as existsSync2 } from "fs";
-import { readFile, readdir as readdir2, stat } from "fs/promises";
-import { basename as basename2, dirname, join as join6 } from "path";
-import matter from "gray-matter";
-var SKIP_DIRS = ["node_modules", ".git", ".github", "dist", "build", "__pycache__"];
-var DENIED_SEGMENTS = /* @__PURE__ */ new Set([
-  ".git",
-  "node_modules",
-  ".github",
-  "playbooks",
-  "context",
-  "prompts",
-  "backups",
-  "backup",
-  "dist",
-  "deprecated"
-]);
-var normalizePath = (value) => value.replace(/^\/+/, "");
-var normalizeRoot = (value) => normalizePath(value).replace(/^\.\//, "").replace(/^\/+/, "").replace(/\/+$/, "");
-var isDeniedPath = (path) => {
-  const cleaned = normalizePath(path);
-  const segments = cleaned.split("/").map((segment) => segment.toLowerCase());
-  for (const segment of segments) {
-    if (!segment) continue;
-    if (segment === ".claude-plugin") {
-      continue;
-    }
-    if (DENIED_SEGMENTS.has(segment)) {
-      return true;
-    }
-  }
-  return false;
-};
-async function hasSkillMd(dir) {
-  try {
-    if (isDeniedPath(dir)) return false;
-    const skillPath = join6(dir, "SKILL.md");
-    const stats = await stat(skillPath);
-    return stats.isFile();
-  } catch {
-    return false;
-  }
-}
-async function parseSkillMd(skillMdPath) {
-  try {
-    if (isDeniedPath(skillMdPath)) return null;
-    const content = await readFile(skillMdPath, "utf-8");
-    const { data } = matter(content);
-    if (!data.name || !data.description) {
-      return null;
-    }
-    return {
-      name: data.name,
-      description: data.description,
-      path: dirname(skillMdPath),
-      rawContent: content,
-      metadata: data.metadata
-    };
-  } catch {
-    return null;
-  }
-}
-async function findSkillDirs(dir, depth = 0, maxDepth = 5) {
-  const skillDirs = [];
-  if (depth > maxDepth) return skillDirs;
-  if (isDeniedPath(dir)) return skillDirs;
-  try {
-    if (await hasSkillMd(dir)) {
-      skillDirs.push(dir);
-    }
-    const entries = await readdir2(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (entry.isDirectory() && !SKIP_DIRS.includes(entry.name)) {
-        const subDirs = await findSkillDirs(join6(dir, entry.name), depth + 1, maxDepth);
-        skillDirs.push(...subDirs);
-      }
-    }
-  } catch {
-  }
-  return skillDirs;
-}
-async function readMarketplacePluginRoots(basePath) {
-  const filePath = join6(basePath, ".claude-plugin", "marketplace.json");
-  if (!existsSync2(filePath)) return [];
-  try {
-    const raw = await readFile(filePath, "utf-8");
-    const parsed = JSON.parse(raw);
-    const roots = (parsed.plugins ?? []).map((plugin) => typeof plugin.source === "string" ? plugin.source : null).filter(Boolean);
-    return roots.map((root) => normalizeRoot(root)).filter(Boolean);
-  } catch {
-    return [];
-  }
-}
-async function collectSkillsFromRoot(root, seenSlugs, skills) {
-  if (!root || !existsSync2(root) || isDeniedPath(root)) return;
-  const skillDirs = await findSkillDirs(root);
-  for (const skillDir of skillDirs) {
-    const skill = await parseSkillMd(join6(skillDir, "SKILL.md"));
-    if (!skill) continue;
-    const slug = basename2(skill.path).toLowerCase();
-    if (seenSlugs.has(slug)) continue;
-    skills.push(skill);
-    seenSlugs.add(slug);
-  }
-}
-async function listPluginSkillRoots(basePath) {
-  const pluginsDir = join6(basePath, "plugins");
-  if (!existsSync2(pluginsDir)) return [];
-  try {
-    const entries = await readdir2(pluginsDir, { withFileTypes: true });
-    const roots = [];
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const candidate = join6(pluginsDir, entry.name, "skills");
-      if (existsSync2(candidate)) {
-        roots.push(candidate);
-      }
-    }
-    return roots;
-  } catch {
-    return [];
-  }
-}
-async function discoverSkills(basePath, subpath) {
-  const skills = [];
-  const seenSlugs = /* @__PURE__ */ new Set();
-  const searchPath = subpath ? join6(basePath, subpath) : basePath;
-  if (await hasSkillMd(searchPath)) {
-    const skill = await parseSkillMd(join6(searchPath, "SKILL.md"));
-    if (skill) {
-      skills.push(skill);
-      return skills;
-    }
-  }
-  const marketplaceRoots = await readMarketplacePluginRoots(searchPath);
-  for (const root of marketplaceRoots) {
-    const skillsRoot = root.toLowerCase().endsWith("/skills") ? root : `${root}/skills`;
-    await collectSkillsFromRoot(join6(searchPath, skillsRoot), seenSlugs, skills);
-  }
-  await collectSkillsFromRoot(join6(searchPath, "skills"), seenSlugs, skills);
-  const pluginRoots = await listPluginSkillRoots(searchPath);
-  for (const root of pluginRoots) {
-    await collectSkillsFromRoot(root, seenSlugs, skills);
-  }
-  await collectSkillsFromRoot(join6(searchPath, ".claude-plugin"), seenSlugs, skills);
-  const agentRoots = [
-    join6(searchPath, ".agent/skills"),
-    join6(searchPath, ".agents/skills"),
-    join6(searchPath, ".cline/skills"),
-    join6(searchPath, ".commandcode/skills"),
-    join6(searchPath, ".continue/skills"),
-    join6(searchPath, ".cursor/skills"),
-    join6(searchPath, ".factory/skills"),
-    join6(searchPath, ".github/skills"),
-    join6(searchPath, ".goose/skills"),
-    join6(searchPath, ".kilocode/skills"),
-    join6(searchPath, ".kiro/skills"),
-    join6(searchPath, ".neovate/skills"),
-    join6(searchPath, ".openhands/skills"),
-    join6(searchPath, ".pi/skills"),
-    join6(searchPath, ".qoder/skills"),
-    join6(searchPath, ".roo/skills"),
-    join6(searchPath, ".trae/skills"),
-    join6(searchPath, ".windsurf/skills"),
-    join6(searchPath, ".zencoder/skills")
-  ];
-  for (const root of agentRoots) {
-    await collectSkillsFromRoot(root, seenSlugs, skills);
-  }
-  if (skills.length === 0) {
-    const allSkillDirs = await findSkillDirs(searchPath);
-    for (const skillDir of allSkillDirs) {
-      const skill = await parseSkillMd(join6(skillDir, "SKILL.md"));
-      if (!skill) continue;
-      const slug = basename2(skill.path).toLowerCase();
-      if (seenSlugs.has(slug)) continue;
-      skills.push(skill);
-      seenSlugs.add(slug);
+      await mkdir2(agentDir, { recursive: true });
+      await copySkillDirectory(skill.path, agentDir);
+      return {
+        success: true,
+        path: agentDir,
+        canonicalPath: canonicalDir,
+        mode: "symlink",
+        symlinkFailed: true
+      };
     }
+    return {
+      success: true,
+      path: agentDir,
+      canonicalPath: canonicalDir,
+      mode: "symlink"
+    };
+  } catch (error) {
+    return {
+      success: false,
+      path: agentDir,
+      mode: installMode,
+      error: error instanceof Error ? error.message : "Unknown error"
+    };
   }
-  return skills;
 }
-function getSkillDisplayName(skill) {
-  return skill.name || basename2(skill.path);
+async function isSkillInstalled(skillName, agentType, options = {}) {
+  const agent = agents[agentType];
+  const sanitized = sanitizeSkillName(skillName);
+  const targetBase = options.global ? agent.globalSkillsDir : join7(options.cwd || process.cwd(), agent.skillsDir);
+  const skillDir = join7(targetBase, sanitized);
+  if (!isPathSafe(targetBase, skillDir)) {
+    return false;
+  }
+  try {
+    await access(skillDir);
+    return true;
+  } catch {
+    return false;
+  }
 }
 
 // src/flows/plan-summary.ts
@@ -1374,7 +1586,7 @@ function AddConfirmScreen() {
   }, [lines]);
   const agentPaths = targetAgents.length > 0 ? targetAgents.map((agent) => {
     const config = agents[agent];
-    const base = addSkill.installGlobally ? config.globalSkillsDir : join7(cwd, config.skillsDir);
+    const base = addSkill.installGlobally ? config.globalSkillsDir : join8(cwd, config.skillsDir);
     return shortenPath(base, cwd);
   }) : [];
   return /* @__PURE__ */ jsxs6(Box8, { flexDirection: "column", padding: 1, children: [
@@ -1416,13 +1628,13 @@ import React5 from "react";
 import { createHash } from "crypto";
 import { mkdir as mkdir3, readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
 import { homedir as homedir4 } from "os";
-import { dirname as dirname2, join as join8 } from "path";
+import { dirname as dirname2, join as join9 } from "path";
 var AGENTS_DIR2 = ".agents";
 var LOCK_FILE = ".skill-lock.json";
 var CURRENT_VERSION = 3;
 function getSkillLockPath(options = {}) {
   const baseDir = options.global ? homedir4() : options.cwd || process.cwd();
-  return join8(baseDir, AGENTS_DIR2, LOCK_FILE);
+  return join9(baseDir, AGENTS_DIR2, LOCK_FILE);
 }
 async function readSkillLock(options = {}) {
   const lockPath = getSkillLockPath(options);
@@ -1932,7 +2144,7 @@ function AddInstallScreen() {
 }
 
 // src/tui/screens/AddMode.tsx
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 import { Box as Box11 } from "ink";
 import React7 from "react";
 
@@ -2003,7 +2215,7 @@ function AddModeScreen() {
   const targetAgents = addSkill.targetAgents ?? [];
   const agentPaths = targetAgents.length > 0 ? targetAgents.map((agent) => {
     const config = agents[agent];
-    const base = addSkill.installGlobally ? config.globalSkillsDir : join9(cwd, config.skillsDir);
+    const base = addSkill.installGlobally ? config.globalSkillsDir : join10(cwd, config.skillsDir);
     return shortenPath(base, cwd);
   }) : [];
   const copyHint = agentPaths.length > 0 ? `Copy into: ${formatList(agentPaths, 3)}` : "Copy: duplicate into each agent folder";
@@ -2150,10 +2362,10 @@ function AddScopeScreen() {
 }
 
 // src/tui/screens/AddSkillSelect.tsx
-import { existsSync as existsSync4 } from "fs";
-import { mkdir as mkdir4, mkdtemp as mkdtemp2, writeFile as writeFile3 } from "fs/promises";
-import { tmpdir as tmpdir3 } from "os";
-import { basename as basename3, join as join11 } from "path";
+import { existsSync as existsSync5 } from "fs";
+import { mkdir as mkdir4, mkdtemp as mkdtemp3, writeFile as writeFile3 } from "fs/promises";
+import { tmpdir as tmpdir4 } from "os";
+import { basename as basename3, join as join12 } from "path";
 import { Box as Box15, Text as Text13 } from "ink";
 import React11 from "react";
 
@@ -2467,9 +2679,9 @@ async function resolveRemoteSkill(url) {
 }
 
 // src/marketplace.ts
-import { existsSync as existsSync3, statSync } from "fs";
+import { existsSync as existsSync4, statSync } from "fs";
 import { readFile as readFile3 } from "fs/promises";
-import { dirname as dirname3, join as join10, posix } from "path";
+import { dirname as dirname3, join as join11, posix } from "path";
 function toRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return null;
   return value;
@@ -2534,14 +2746,14 @@ function isMarketplaceInput(input) {
   return input.toLowerCase().endsWith("marketplace.json");
 }
 function resolveLocalMarketplacePath(input) {
-  if (!existsSync3(input)) return null;
+  if (!existsSync4(input)) return null;
   const stats = statSync(input);
   if (stats.isFile() && input.toLowerCase().endsWith("marketplace.json")) {
     return input;
   }
   if (stats.isDirectory()) {
-    const candidate = join10(input, ".claude-plugin", "marketplace.json");
-    if (existsSync3(candidate)) return candidate;
+    const candidate = join11(input, ".claude-plugin", "marketplace.json");
+    if (existsSync4(candidate)) return candidate;
   }
   return null;
 }
@@ -2669,8 +2881,8 @@ function resolvePluginSource(plugin, context) {
   const src = plugin.source;
   if (typeof src === "string") {
     if (context.kind === "local" && context.baseDir) {
-      const base = join10(context.baseDir, pluginRoot);
-      return { kind: "local", localDir: join10(base, src), overrides };
+      const base = join11(context.baseDir, pluginRoot);
+      return { kind: "local", localDir: join11(base, src), overrides };
     }
     if (context.kind === "github" && context.gh) {
       const basePath = posix.join(context.gh.basePath || "", pluginRoot || "");
@@ -2901,11 +3113,11 @@ function AddSkillSelectScreen() {
           if (!resolved) {
             throw new Error("Unable to fetch SKILL.md from that URL.");
           }
-          const tempDir2 = await mkdtemp2(join11(tmpdir3(), "playbooks-skill-"));
+          const tempDir2 = await mkdtemp3(join12(tmpdir4(), "playbooks-skill-"));
           registerTempDir(tempDir2);
           tempDirForCleanup = tempDir2;
           await mkdir4(tempDir2, { recursive: true });
-          await writeFile3(join11(tempDir2, "SKILL.md"), resolved.remoteSkill.content, "utf-8");
+          await writeFile3(join12(tempDir2, "SKILL.md"), resolved.remoteSkill.content, "utf-8");
           const skill = {
             name: resolved.remoteSkill.installName,
             description: resolved.remoteSkill.description,
@@ -2938,7 +3150,7 @@ function AddSkillSelectScreen() {
             throw new Error("Local path is missing.");
           }
           skillsDir = parsed.localPath;
-          if (!existsSync4(skillsDir)) {
+          if (!existsSync5(skillsDir)) {
             throw new Error(`Local path does not exist: ${skillsDir}`);
           }
         } else {
@@ -3321,220 +3533,6 @@ function AddTargetsScreen() {
 // src/tui/screens/FindSkillResults.tsx
 import { Box as Box18, Text as Text16 } from "ink";
 import React15 from "react";
-
-// src/flows/find-skill.ts
-import { existsSync as existsSync5 } from "fs";
-import { mkdtemp as mkdtemp3 } from "fs/promises";
-import { tmpdir as tmpdir4 } from "os";
-import { join as join12 } from "path";
-
-// src/playbooks-api.ts
-var API_BASE2 = process.env.PLAYBOOKS_API_URL?.trim() || "https://playbooks.com/api";
-var USER_AGENT = "playbooks-cli";
-async function searchSkills(query, mode, limit = 10) {
-  const url = new URL(`${API_BASE2}/skills`);
-  url.searchParams.set("search", query);
-  url.searchParams.set("limit", String(limit));
-  url.searchParams.set("mode", mode);
-  const response = await fetch(url.toString(), {
-    headers: {
-      "User-Agent": USER_AGENT
-    }
-  });
-  let payload = null;
-  try {
-    payload = await response.json();
-  } catch {
-    payload = null;
-  }
-  if (!response.ok || !payload?.success) {
-    const message = payload?.error || `Search failed (${response.status})`;
-    throw new Error(message);
-  }
-  return Array.isArray(payload.data) ? payload.data : [];
-}
-async function requestUrlMarkdown(url) {
-  const endpoint = new URL(`${API_BASE2}/url`);
-  const response = await fetch(endpoint.toString(), {
-    method: "POST",
-    headers: {
-      "User-Agent": USER_AGENT,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify({ url })
-  });
-  let payload = null;
-  try {
-    payload = await response.json();
-  } catch {
-    payload = null;
-  }
-  if (!response.ok && response.status !== 202) {
-    const message = payload?.error || `Request failed (${response.status})`;
-    throw new Error(message);
-  }
-  return payload ?? { success: false, error: `Request failed (${response.status})` };
-}
-async function pollUrlMarkdown(jobId, timeoutMs = 6e4, pollIntervalMs = 1e3) {
-  const endpoint = new URL(`${API_BASE2}/url`);
-  endpoint.searchParams.set("jobId", jobId);
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    const response = await fetch(endpoint.toString(), {
-      headers: {
-        "User-Agent": USER_AGENT
-      }
-    });
-    let payload = null;
-    try {
-      payload = await response.json();
-    } catch {
-      payload = null;
-    }
-    if (payload?.success && payload.data) {
-      return payload.data;
-    }
-    if (payload?.success && payload.pending) {
-      await new Promise((resolve5) => setTimeout(resolve5, pollIntervalMs));
-      continue;
-    }
-    const message = payload?.error || `Request failed (${response.status})`;
-    throw new Error(message);
-  }
-  throw new Error("Timed out waiting for markdown");
-}
-async function fetchUrlMarkdown(url) {
-  const response = await requestUrlMarkdown(url);
-  if (response.success && response.data) {
-    return response.data;
-  }
-  if (response.jobId) {
-    return await pollUrlMarkdown(response.jobId);
-  }
-  const message = response.error || "Failed to fetch markdown";
-  throw new Error(message);
-}
-
-// src/flows/find-skill.ts
-async function searchSkillDirectory(query, mode, limit = 10) {
-  const trimmed = query.trim();
-  if (!trimmed) {
-    return { mode, results: [], fallback: false };
-  }
-  if (mode === "semantic") {
-    try {
-      const results2 = await searchSkills(trimmed, "semantic", limit);
-      return { mode: "semantic", results: results2, fallback: false };
-    } catch {
-      const results2 = await searchSkills(trimmed, "lexical", limit);
-      return { mode: "lexical", results: results2, fallback: true };
-    }
-  }
-  const results = await searchSkills(trimmed, "lexical", limit);
-  return { mode: "lexical", results, fallback: false };
-}
-var normalizeSkillPath = (value) => value.replace(/^\/+/, "").replace(/\\/g, "/");
-var toSkillDir = (skillPath) => {
-  const normalized = normalizeSkillPath(skillPath);
-  const cleaned = normalized.replace(/\/?SKILL\.md$/i, "").replace(/\/+$/, "");
-  return cleaned;
-};
-var ensureSkillMdPath = (skillPath) => {
-  const normalized = normalizeSkillPath(skillPath);
-  if (/\/?SKILL\.md$/i.test(normalized)) {
-    return normalized;
-  }
-  if (!normalized) {
-    return "SKILL.md";
-  }
-  return `${normalized.replace(/\/+$/, "")}/SKILL.md`;
-};
-var sanitizeRepoDir = (owner, repo) => `${owner}-${repo}`.toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
-async function prepareSkillsFromSearchResults(selected) {
-  if (selected.length === 0) {
-    throw new Error("Select at least one skill to install.");
-  }
-  const tempDir = await mkdtemp3(join12(tmpdir4(), "playbooks-search-"));
-  registerTempDir(tempDir);
-  try {
-    const repoMap = /* @__PURE__ */ new Map();
-    for (const result of selected) {
-      if (!result.repoOwner || !result.repoName || !result.path) {
-        throw new Error(`Missing repository data for ${result.name}.`);
-      }
-      const key = `${result.repoOwner.toLowerCase()}/${result.repoName.toLowerCase()}`;
-      const existing = repoMap.get(key);
-      if (existing) {
-        existing.entries.push(result);
-      } else {
-        repoMap.set(key, {
-          owner: result.repoOwner,
-          repo: result.repoName,
-          repoUrl: `https://github.com/${result.repoOwner}/${result.repoName}.git`,
-          entries: [result]
-        });
-      }
-    }
-    const repoDirs = /* @__PURE__ */ new Map();
-    const usedDirs = /* @__PURE__ */ new Set();
-    for (const [key, repoInfo] of repoMap) {
-      let dirName = sanitizeRepoDir(repoInfo.owner, repoInfo.repo);
-      let suffix = 1;
-      while (usedDirs.has(dirName)) {
-        dirName = `${sanitizeRepoDir(repoInfo.owner, repoInfo.repo)}-${suffix}`;
-        suffix += 1;
-      }
-      usedDirs.add(dirName);
-      const repoDir = join12(tempDir, dirName);
-      await cloneRepoTo(repoInfo.repoUrl, repoDir);
-      repoDirs.set(key, repoDir);
-    }
-    const skills = [];
-    const originBySkillName = /* @__PURE__ */ new Map();
-    for (const result of selected) {
-      if (!result.repoOwner || !result.repoName || !result.path) {
-        continue;
-      }
-      const repoKey = `${result.repoOwner.toLowerCase()}/${result.repoName.toLowerCase()}`;
-      const repoDir = repoDirs.get(repoKey);
-      if (!repoDir) {
-        throw new Error(`Missing clone for ${result.repoOwner}/${result.repoName}.`);
-      }
-      const skillDir = toSkillDir(result.path);
-      const subpath = skillDir ? skillDir : void 0;
-      const discovered = await discoverSkills(repoDir, subpath);
-      if (discovered.length === 0) {
-        throw new Error(`Skill not found in ${result.repoOwner}/${result.repoName}.`);
-      }
-      const expectedPath = join12(repoDir, skillDir);
-      const fallbackSkill = discovered[0];
-      if (!fallbackSkill) {
-        throw new Error(`Skill not found in ${result.repoOwner}/${result.repoName}.`);
-      }
-      const skill = discovered.find((entry) => entry.path === expectedPath) ?? fallbackSkill;
-      if (!existsSync5(join12(skill.path, "SKILL.md"))) {
-        throw new Error(`SKILL.md missing for ${result.name}.`);
-      }
-      skills.push(skill);
-      const displayName = getSkillDisplayName(skill);
-      originBySkillName.set(displayName, {
-        sourceType: "github",
-        source: `${result.repoOwner}/${result.repoName}`,
-        sourceUrl: `https://github.com/${result.repoOwner}/${result.repoName}.git`,
-        skillPath: ensureSkillMdPath(result.path)
-      });
-    }
-    return { tempDir, skills, originBySkillName };
-  } catch (error) {
-    try {
-      await cleanupTempDir(tempDir);
-    } catch {
-    }
-    throw error;
-  }
-}
-
-// src/tui/screens/FindSkillResults.tsx
 import { jsx as jsx20, jsxs as jsxs16 } from "react/jsx-runtime";
 var formatStars = (value) => {
   if (!value || value <= 0) return "";
@@ -5148,6 +5146,7 @@ var version = package_default.version;
 setVersion(version);
 setupTempDirCleanup();
 program.name("playbooks").description("Playbooks CLI").version(version);
+program.addHelpCommand();
 var applyAddSkillOptions = (cmd) => cmd.option("-g, --global", "Install globally (user-level) instead of project-level").option(
   "-a, --agent <agents...>",
   "Target agents to install to (claude-code, codex, cursor, opencode, and more)"
@@ -5170,6 +5169,45 @@ async function launch(invocation, initialScreen) {
 function initialAddSkillScreen(source) {
   return source ? "add-skill-select" : "add-source";
 }
+function formatAgentListMarkdown() {
+  const entries = Object.values(agents).map((agent) => ({ name: agent.name, displayName: agent.displayName })).sort((a, b) => a.displayName.localeCompare(b.displayName));
+  const lines = ["# Supported agents", ""];
+  for (const entry of entries) {
+    lines.push(`- ${entry.displayName} (\`${entry.name}\`)`);
+  }
+  return lines.join("\n");
+}
+function formatFindSkillMarkdown(query, outcome) {
+  const lines = [`# Skill search results for "${query}"`];
+  lines.push("Ordered by best match; official sources recommended.");
+  if (outcome.fallback) {
+    lines.push("_Note: semantic search unavailable. Showing fast results._");
+  }
+  if (outcome.results.length === 0) {
+    lines.push("", "_No results._");
+    return lines.join("\n");
+  }
+  lines.push("");
+  for (const result of outcome.results.slice(0, 10)) {
+    const description = result.shortDescription ?? result.description ?? "";
+    const repo = result.repoOwner && result.repoName ? `${result.repoOwner}/${result.repoName}` : null;
+    const skillName = result.skillSlug ?? result.name;
+    if (!repo || !skillName) {
+      continue;
+    }
+    const tag = result.isOfficial ? "[official]" : "[community]";
+    lines.push(`- ${tag} npx playbooks add skill ${repo} --skill ${skillName}`);
+    if (description) {
+      lines.push(`  ${truncateLine(description, 140)}`);
+    }
+  }
+  return lines.join("\n");
+}
+function truncateLine(value, maxLength) {
+  if (value.length <= maxLength) return value;
+  const sliced = value.slice(0, Math.max(0, maxLength - 1)).trimEnd();
+  return sliced ? `${sliced}\u2026` : value.slice(0, maxLength);
+}
 applyAddSkillOptions(
   program.command("add-skill [source]", { hidden: true }).description("Legacy: use playbooks add skill").action(async (source, options) => {
     await launch({ intent: "add-skill", source, options }, initialAddSkillScreen(source));
@@ -5185,6 +5223,9 @@ var listCmd = program.command("list").description("List installed resources");
 listCmd.command("skill").description("List installed skills").action(async () => {
   await launch({ intent: "list", options: {} }, "list");
 });
+listCmd.command("agents").description("List supported agents").action(() => {
+  console.log(formatAgentListMarkdown());
+});
 var manageCmd = program.command("manage").description("Remove installed resources");
 manageCmd.command("skill").description("Remove installed skills").action(async () => {
   await launch({ intent: "manage", options: {} }, "manage");
@@ -5217,8 +5258,20 @@ skillCmd.action(async (source, options) => {
   );
 });
 var findCmd = program.command("find").description("Search the playbooks directory");
-findCmd.command("skill").description("Find skills").action(async () => {
-  await launch({ intent: "find-skill", options: {} }, "find-skill-search");
+findCmd.command("skill [query]").description("Find skills").option("--semantic", "Use semantic search (falls back to fast search)").action(async (query, options) => {
+  if (!query) {
+    await launch({ intent: "find-skill", options: {} }, "find-skill-search");
+    return;
+  }
+  const mode = options.semantic ? "semantic" : "lexical";
+  try {
+    const outcome = await searchSkillDirectory(query, mode, 10);
+    console.log(formatFindSkillMarkdown(query, outcome));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Search failed.";
+    console.error(message);
+    process.exit(1);
+  }
 });
 program.command("get <url> [outKeyword] [outPath]").description("Fetch a URL as markdown").option("--json", "Output JSON metadata instead of raw markdown").action(
   async (url, outKeyword, outPath, options) => {