skilllib 1.12.1 → 1.13.0

package/dist/{chunk-LORSEDNW.js → chunk-C6TSR7NT.js}

@@ -139,6 +139,77 @@ import { join as join6, resolve as resolve4 } from "path";
 // src/harnesses.ts
 import { existsSync } from "fs";
 import { delimiter, join as join2 } from "path";
+var EXTRAS = [
+  { id: "github-copilot", name: "GitHub Copilot", short: "Cp", icon: "\u25D0", color: "#E8E8E8", project: [".agents/skills", ".claude/skills", ".github/skills"], global: [".agents/skills", ".claude/skills", ".copilot/skills"], detect: [".copilot"], bin: "copilot" },
+  { id: "gemini-cli", name: "Gemini CLI", short: "Ge", icon: "\u2726", color: "#8AB4F8", project: [".agents/skills", ".gemini/skills"], global: [".agents/skills", ".gemini/skills"], detect: [], bin: "gemini" },
+  { id: "opencode", name: "OpenCode", short: "Oc", icon: "\u2318", color: "#A78BFA", project: [".agents/skills", ".claude/skills", ".opencode/skills"], global: [".agents/skills", ".claude/skills", ".config/opencode/skills"], detect: [".config/opencode", ".opencode"], bin: "opencode" },
+  { id: "antigravity", name: "Antigravity", short: "Ag", icon: "\u25B2", color: "#34A853", project: [".agents/skills", ".agent/skills"], global: [".gemini/config/skills", ".gemini/antigravity/skills"], detect: [".gemini/antigravity"], bin: "agy", app: "Antigravity" },
+  { id: "antigravity-ide", name: "Antigravity IDE", short: "Ai", icon: "\u25B2", color: "#34A853", project: [".agents/skills", ".agent/skills"], global: [".gemini/antigravity-ide/skills"], detect: [".gemini/antigravity-ide"], app: "Antigravity IDE" },
+  { id: "antigravity-cli", name: "Antigravity CLI", short: "Ac", icon: "\u25B2", color: "#34A853", project: [".agents/skills", ".agent/skills"], global: [".gemini/antigravity-cli/skills"], detect: [".gemini/antigravity-cli"], bin: "agy" },
+  { id: "windsurf", name: "Windsurf", short: "Ws", icon: "\u224B", color: "#0EA5E9", project: [".windsurf/skills"], global: [".codeium/windsurf/skills"], detect: [".codeium/windsurf"], bin: "windsurf", app: "Windsurf" },
+  { id: "devin", name: "Devin", short: "Dv", icon: "\u0394", color: "#7C6AF7", project: [".agents/skills", ".devin/skills", ".windsurf/skills"], global: [".agents/skills", ".config/devin/skills"], detect: [".config/devin"], bin: "devin" },
+  { id: "cline", name: "Cline", short: "Cl", icon: "\u25A3", color: "#22C55E", project: [".agents/skills"], global: [".agents/skills"], detect: [".cline"], bin: "cline" },
+  { id: "amp", name: "Amp", short: "Am", icon: "\u26A1", color: "#F5C16C", project: [".agents/skills"], global: [".config/agents/skills"], detect: [".config/amp"], bin: "amp" },
+  { id: "droid", name: "Factory Droid", short: "Dr", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills", ".factory/skills"], detect: [".factory"], bin: "droid" },
+  { id: "openclaw", name: "OpenClaw", short: "Ow", icon: "\xB7", color: "#8A93A6", project: ["skills"], global: [".openclaw/skills"], detect: [".openclaw", ".clawdbot", ".moltbot"], bin: "openclaw" },
+  { id: "continue", name: "Continue", short: "Cn", icon: "\xB7", color: "#8A93A6", project: [".continue/skills"], global: [".continue/skills"], detect: [".continue"] },
+  { id: "augment", name: "Augment", short: "Au", icon: "\xB7", color: "#8A93A6", project: [".augment/skills"], global: [".augment/skills"], detect: [".augment"] },
+  { id: "junie", name: "Junie", short: "Ju", icon: "\xB7", color: "#8A93A6", project: [".junie/skills"], global: [".junie/skills"], detect: [".junie"], bin: "junie" },
+  { id: "roo", name: "Roo Code", short: "Ro", icon: "\xB7", color: "#8A93A6", project: [".roo/skills"], global: [".roo/skills"], detect: [".roo"] },
+  { id: "goose", name: "Goose", short: "Gs", icon: "\xB7", color: "#8A93A6", project: [".goose/skills"], global: [".config/goose/skills"], detect: [".config/goose"], bin: "goose" },
+  { id: "openhands", name: "OpenHands", short: "Oh", icon: "\xB7", color: "#8A93A6", project: [".openhands/skills"], global: [".openhands/skills"], detect: [".openhands"] },
+  { id: "crush", name: "Crush", short: "Cr", icon: "\xB7", color: "#8A93A6", project: [".crush/skills"], global: [".config/crush/skills"], detect: [".config/crush"], bin: "crush" },
+  { id: "pi", name: "Pi", short: "Pi", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills", ".pi/agent/skills"], detect: [".pi/agent"], bin: "pi" },
+  { id: "kimi-code-cli", name: "Kimi Code CLI", short: "Ki", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills"], detect: [".kimi"], bin: "kimi" },
+  { id: "kilo", name: "Kilo Code", short: "Kl", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".kilo/skills", ".kilocode/skills"], detect: [".kilo", ".kilocode"] },
+  { id: "kiro-cli", name: "Kiro CLI", short: "Kr", icon: "\xB7", color: "#8A93A6", project: [".kiro/skills"], global: [".kiro/skills"], detect: [".kiro"], bin: "kiro" },
+  { id: "qwen-code", name: "Qwen Code", short: "Qw", icon: "\xB7", color: "#8A93A6", project: [".qwen/skills"], global: [".qwen/skills"], detect: [".qwen"], bin: "qwen" },
+  { id: "warp", name: "Warp", short: "Wp", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills"], detect: [".warp"], app: "Warp" },
+  { id: "replit", name: "Replit", short: "Rp", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".config/agents/skills"], detect: [] },
+  { id: "trae", name: "Trae", short: "Tr", icon: "\xB7", color: "#8A93A6", project: [".trae/skills"], global: [".trae/skills"], detect: [".trae"], app: "Trae" },
+  { id: "mux", name: "Mux", short: "Mx", icon: "\xB7", color: "#8A93A6", project: [".mux/skills"], global: [".mux/skills"], detect: [".mux"] },
+  { id: "mistral-vibe", name: "Mistral Vibe", short: "Mv", icon: "\xB7", color: "#8A93A6", project: [".vibe/skills"], global: [".vibe/skills"], detect: [".vibe"], bin: "vibe" },
+  { id: "qoder", name: "Qoder", short: "Qd", icon: "\xB7", color: "#8A93A6", project: [".qoder/skills"], global: [".qoder/skills"], detect: [".qoder"] },
+  { id: "zencoder", name: "Zencoder", short: "Ze", icon: "\xB7", color: "#8A93A6", project: [".zencoder/skills"], global: [".zencoder/skills"], detect: [".zencoder"] },
+  { id: "neovate", name: "Neovate", short: "Nv", icon: "\xB7", color: "#8A93A6", project: [".neovate/skills"], global: [".neovate/skills"], detect: [".neovate"] },
+  { id: "adal", name: "AdaL", short: "Ad", icon: "\xB7", color: "#8A93A6", project: [".adal/skills"], global: [".adal/skills"], detect: [".adal"] },
+  { id: "bob", name: "IBM Bob", short: "Bb", icon: "\xB7", color: "#8A93A6", project: [".bob/skills"], global: [".bob/skills"], detect: [".bob"] },
+  { id: "aider-desk", name: "AiderDesk", short: "Adk", icon: "\xB7", color: "#8A93A6", project: [".aider-desk/skills"], global: [".aider-desk/skills"], detect: [".aider-desk"] },
+  { id: "codebuddy", name: "CodeBuddy", short: "Cb", icon: "\xB7", color: "#8A93A6", project: [".codebuddy/skills"], global: [".codebuddy/skills"], detect: [".codebuddy"] },
+  { id: "command-code", name: "Command Code", short: "Cm", icon: "\xB7", color: "#8A93A6", project: [".commandcode/skills"], global: [".commandcode/skills"], detect: [".commandcode"] },
+  { id: "cortex", name: "Cortex Code", short: "Ct", icon: "\xB7", color: "#8A93A6", project: [".cortex/skills"], global: [".snowflake/cortex/skills"], detect: [".snowflake/cortex"] },
+  { id: "hermes-agent", name: "Hermes Agent", short: "He", icon: "\xB7", color: "#8A93A6", project: [".hermes/skills"], global: [".hermes/skills"], detect: [".hermes"] },
+  { id: "iflow-cli", name: "iFlow CLI", short: "If", icon: "\xB7", color: "#8A93A6", project: [".iflow/skills"], global: [".iflow/skills"], detect: [".iflow"] },
+  { id: "kode", name: "Kode", short: "Kd", icon: "\xB7", color: "#8A93A6", project: [".kode/skills"], global: [".kode/skills"], detect: [".kode"] },
+  { id: "mcpjam", name: "MCPJam", short: "Mj", icon: "\xB7", color: "#8A93A6", project: [".mcpjam/skills"], global: [".mcpjam/skills"], detect: [".mcpjam"] },
+  { id: "minimax-code", name: "MiniMax Code", short: "Mm", icon: "\xB7", color: "#8A93A6", project: [".minimax/skills"], global: [".minimax/skills"], detect: [".minimax"] },
+  { id: "pochi", name: "Pochi", short: "Po", icon: "\xB7", color: "#8A93A6", project: [".pochi/skills"], global: [".pochi/skills"], detect: [".pochi"] },
+  { id: "rovodev", name: "Rovo Dev", short: "Rv", icon: "\xB7", color: "#8A93A6", project: [".rovodev/skills"], global: [".rovodev/skills"], detect: [".rovodev"] },
+  { id: "tabnine-cli", name: "Tabnine CLI", short: "Tn", icon: "\xB7", color: "#8A93A6", project: [".tabnine/agent/skills"], global: [".tabnine/agent/skills"], detect: [".tabnine"] },
+  { id: "zcode", name: "ZCode", short: "Zc", icon: "\xB7", color: "#8A93A6", project: [".zcode/skills"], global: [".zcode/skills"], detect: [".zcode"], app: "ZCode" },
+  { id: "autohand-code", name: "Autohand Code", short: "Ah", icon: "\xB7", color: "#8A93A6", project: [".autohand/skills"], global: [".autohand/skills"], detect: [".autohand"] },
+  { id: "codearts-agent", name: "CodeArts Agent", short: "Ca", icon: "\xB7", color: "#8A93A6", project: [".codeartsdoer/skills"], global: [".codeartsdoer/skills"], detect: [".codeartsdoer"] },
+  { id: "codemaker", name: "CodeMaker", short: "Mk", icon: "\xB7", color: "#8A93A6", project: [".codemaker/skills"], global: [".codemaker/skills"], detect: [".codemaker"] },
+  { id: "codestudio", name: "CodeStudio", short: "Cs", icon: "\xB7", color: "#8A93A6", project: [".codestudio/skills"], global: [".codestudio/skills"], detect: [".codestudio"] },
+  { id: "deepagents", name: "Deep Agents", short: "Da", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".deepagents/agent/skills"], detect: [".deepagents"] },
+  { id: "dexto", name: "Dexto", short: "Dx", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills"], detect: [".dexto"] },
+  { id: "firebender", name: "Firebender", short: "Fb", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".firebender/skills"], detect: [".firebender"] },
+  { id: "forgecode", name: "ForgeCode", short: "Fc", icon: "\xB7", color: "#8A93A6", project: [".forge/skills"], global: [".forge/skills"], detect: [".forge"] },
+  { id: "fx", name: "fx", short: "Fx", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills"], detect: [".fx"] },
+  { id: "inference-sh", name: "inference.sh", short: "In", icon: "\xB7", color: "#8A93A6", project: [".inferencesh/skills"], global: [".inferencesh/skills"], detect: [".inferencesh"] },
+  { id: "jazz", name: "Jazz", short: "Jz", icon: "\xB7", color: "#8A93A6", project: [".jazz/skills"], global: [".jazz/skills"], detect: [".jazz"] },
+  { id: "kimchi", name: "Kimchi", short: "Kc", icon: "\xB7", color: "#8A93A6", project: [".kimchi/skills"], global: [".config/kimchi/harness/skills"], detect: [".config/kimchi"] },
+  { id: "lingma", name: "Lingma", short: "Lg", icon: "\xB7", color: "#8A93A6", project: [".lingma/skills"], global: [".lingma/skills"], detect: [".lingma"] },
+  { id: "loaf", name: "Loaf", short: "Lf", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills"], detect: [".loaf"] },
+  { id: "moxby", name: "Moxby", short: "Mb", icon: "\xB7", color: "#8A93A6", project: [".moxby/skills"], global: [".moxby/skills"], detect: [".moxby"] },
+  { id: "ona", name: "Ona", short: "On", icon: "\xB7", color: "#8A93A6", project: [".ona/skills"], global: [".ona/skills"], detect: [".ona"] },
+  { id: "posit-assistant", name: "Posit Assistant", short: "Pa", icon: "\xB7", color: "#8A93A6", project: [".posit/assistant/skills"], global: [".posit/assistant/skills"], detect: [".posit"] },
+  { id: "reasonix", name: "Reasonix", short: "Rx", icon: "\xB7", color: "#8A93A6", project: [".reasonix/skills"], global: [".reasonix/skills"], detect: [".reasonix"] },
+  { id: "sarvam-code", name: "Sarvam Code", short: "Sv", icon: "\xB7", color: "#8A93A6", project: [".agents/skills"], global: [".agents/skills"], detect: [".sarvam"] },
+  { id: "terramind", name: "Terramind", short: "Tm", icon: "\xB7", color: "#8A93A6", project: [".terramind/skills"], global: [".terramind/skills"], detect: [".terramind"] },
+  { id: "tinycloud", name: "TinyCloud", short: "Ty", icon: "\xB7", color: "#8A93A6", project: [".tinycloud/skills"], global: [".tinycloud/skills"], detect: [".tinycloud"] }
+];
+var FEATURED_HARNESSES = ["claude-code", "cursor", "codex", "zed", "grok"];
 var home = userHome;
 var HARNESSES = [
   {
@@ -196,7 +267,19 @@ var HARNESSES = [
     // The first folder is where global links for Grok go, so those links stay out of ~/.grok/skills.
     globalDirs: () => [join2(home(), ".agents", "skills"), join2(grokDir(), "skills"), join2(home(), ".claude", "skills"), join2(home(), ".cursor", "skills")],
     installed: () => existsSync(grokDir()) || onPath("grok") || hasApp("Grok")
-  }
+  },
+  ...EXTRAS.map(
+    (e) => ({
+      id: e.id,
+      name: e.name,
+      short: e.short,
+      icon: e.icon,
+      color: e.color,
+      projectDirs: [...e.project],
+      globalDirs: () => e.global.map((g) => join2(home(), g)),
+      installed: () => e.detect.some((d) => existsSync(join2(home(), d))) || ("bin" in e && e.bin ? onPath(e.bin) : false) || ("app" in e && e.app ? hasApp(e.app) : false)
+    })
+  )
 ];
 function onPath(bin) {
   const exts = process.platform === "win32" ? ["", ".exe", ".cmd", ".bat"] : [""];
@@ -215,20 +298,59 @@ function preference(dir) {
   const i = PREFERRED_DIRS.indexOf(dir);
   return i === -1 ? PREFERRED_DIRS.length : i;
 }
-function cost(dirs) {
-  return dirs.length * 100 + dirs.reduce((sum, d) => sum + preference(d), 0);
+function projectDirsInUse(enabled) {
+  return ALL_PROJECT_DIRS.filter((d) => d !== "skills" || enabled.includes("openclaw"));
+}
+function cover(enabled, universe, reads, pref) {
+  const left = new Set(enabled);
+  const chosen = [];
+  while (left.size) {
+    let best = null;
+    let bestCount = 0;
+    let bestPref = Infinity;
+    for (const dir of universe) {
+      if (chosen.includes(dir)) continue;
+      const count = [...left].filter((id) => reads(id).includes(dir)).length;
+      if (count === 0) continue;
+      const p = pref(dir);
+      if (count > bestCount || count === bestCount && (p < bestPref || p === bestPref && (best === null || dir < best))) {
+        best = dir;
+        bestCount = count;
+        bestPref = p;
+      }
+    }
+    if (!best) break;
+    chosen.push(best);
+    for (const id of [...left]) if (reads(id).includes(best)) left.delete(id);
+  }
+  return chosen;
 }
 function installDirs(enabled, keep) {
   if (enabled.length === 0) return [keep ?? PROJECT_SKILLS_DIR];
-  let best = [];
-  for (let mask = 1; mask < 1 << ALL_PROJECT_DIRS.length; mask++) {
-    const dirs = ALL_PROJECT_DIRS.filter((_, i) => mask & 1 << i).sort((a, b) => preference(a) - preference(b));
-    if (keep && !dirs.includes(keep)) continue;
-    if (!enabled.every((id) => harness(id).projectDirs.some((d) => dirs.includes(d)))) continue;
-    if (best.length === 0 || cost(dirs) < cost(best)) best = dirs;
-  }
-  const primary = keep ?? best[0];
-  return [primary, ...best.filter((d) => d !== primary)];
+  const reads = (id) => harness(id).projectDirs;
+  const rest = keep ? enabled.filter((id) => !reads(id).includes(keep)) : enabled;
+  const chosen = [.../* @__PURE__ */ new Set([...keep ? [keep] : [], ...cover(rest, ALL_PROJECT_DIRS, reads, preference)])];
+  const primary = keep ?? [...chosen].sort((a, b) => preference(a) - preference(b) || a.localeCompare(b))[0];
+  return [primary, ...chosen.filter((d) => d !== primary).sort((a, b) => preference(a) - preference(b) || a.localeCompare(b))];
+}
+function globalPreference(dir) {
+  const agents = realPath(join2(userHome(), ".agents", "skills"));
+  const claude2 = realPath(join2(claudeDir(), "skills"));
+  const real = realPath(dir);
+  if (real === agents) return 0;
+  if (real === claude2) return 1;
+  return 2;
+}
+function globalInstallDirs(enabled) {
+  if (enabled.length === 0) return [];
+  const reads = (id) => harness(id).globalDirs();
+  const chosen = cover(enabled, [...new Set(enabled.flatMap(reads))], reads, globalPreference);
+  const claude2 = join2(claudeDir(), "skills");
+  const agents = join2(userHome(), ".agents", "skills");
+  const primary = chosen.find((d) => realPath(d) === realPath(claude2)) ?? chosen.find((d) => realPath(d) === realPath(agents)) ?? chosen[0];
+  if (!primary) return [];
+  const dirs = [primary, ...chosen.filter((d) => realPath(d) !== realPath(primary))];
+  return dirs.filter((d, i) => dirs.findIndex((o) => realPath(o) === realPath(d)) === i);
 }
 
 // src/project.ts
@@ -478,7 +600,7 @@ function repoOf(root) {
   const seen = changedAt(config);
   let repo = null;
   if (out2[0] === "") {
-    const urls = (gitIn(root, ["config", "--get-regexp", "^remote\\..*\\.url$"]) ?? "").split("\n").filter(Boolean).map((l) => l.split(" "));
+    const urls = (gitIn(root, ["config", "--get-regexp", "^remote\\..*\\.url$"]) ?? "").split("\n").filter(Boolean).map((l) => [l.slice(0, l.indexOf(" ")), l.slice(l.indexOf(" ") + 1)]);
     const url = (urls.find(([k]) => k === "remote.origin.url") ?? urls[0])?.[1];
     const remote = url ? normalizeRemote(url) : void 0;
     repo = { file: pinsFileFor(root, remote, folder), folder, common, ...remote ? { remote } : {}, root };
@@ -639,7 +761,7 @@ function findProjects(dir, depth = 4) {
   if (depth < 0 || !existsSync5(dir)) return [];
   if (isProjectCandidate(dir)) {
     const isRepo = existsSync5(join6(dir, ".git"));
-    const hasSkills = ALL_PROJECT_DIRS.some((d) => skillDirsIn(join6(dir, d)).length > 0) || existsSync5(join6(dir, MANIFEST_FILE));
+    const hasSkills = projectDirsInUse(enabledHarnesses()).some((d) => skillDirsIn(join6(dir, d)).length > 0) || existsSync5(join6(dir, MANIFEST_FILE));
     if (isRepo || hasSkills) return [dir];
   }
   let entries = [];
@@ -1112,7 +1234,7 @@ function blindSaid(name, blind, label = basename4) {
   return `${who} only ${blind.length === 1 ? "sees" : "see"} the global copy: ${fixes.join("; ")}, or keep ${name} global (skilllib global keep)`;
 }
 function dependencyDirs(root, name, dep) {
-  const untracked = ALL_PROJECT_DIRS.find((d) => d !== GROK_SKILLS_DIR && existsSync7(join8(root, d, name, "SKILL.md")) && !isLink(join8(root, d, name)));
+  const untracked = projectDirsInUse(enabledHarnesses()).find((d) => d !== GROK_SKILLS_DIR && existsSync7(join8(root, d, name, "SKILL.md")) && !isLink(join8(root, d, name)));
   const primary = dep ? dep.dir ?? PROJECT_SKILLS_DIR : untracked ?? installDirs(enabledHarnesses())[0];
   const wanted = installDirs(enabledHarnesses(), primary);
   const real = (d) => realpathOrNull(join8(root, d));
@@ -1177,7 +1299,7 @@ function projectStatus(root) {
   const lock = projectSkillsLock(root);
   const unmanaged = [];
   const byName = /* @__PURE__ */ new Map();
-  for (const dir of ALL_PROJECT_DIRS.filter((d) => writableDir(root, d))) {
+  for (const dir of projectDirsInUse(enabled).filter((d) => writableDir(root, d))) {
     for (const path of skillDirsIn(join8(root, dir))) {
       const name = basename4(path);
       if (seen.has(name)) continue;
@@ -1395,8 +1517,8 @@ function addSkill(root, name, { force = false, version, allowTracked = false, pe
   if (moving && !keep) return { name, action: "skipped", reason: `your library has no copy of the version it pins, so its pin can't move as it is: skilllib update ${name} first` };
   const target = keep ?? (version === void 0 ? latestVersion(name) : getVersion(name, version));
   if (!target) return { name, action: "skipped", reason: version === void 0 ? "not in the library" : `version ${version} doesn't exist` };
-  const plan = addPlan(root, name, target.hash, force);
-  if ("reason" in plan) return { name, action: "skipped", reason: plan.reason };
+  const plan = addPlan(root, name, target.hash, moving ? false : force);
+  if ("reason" in plan) return { name, action: "skipped", reason: moving ? `${withoutForceHint(plan.reason)}, so its pin can't move: save the edits to your library first` : plan.reason };
   const { manifest, recorded, primary, wantedLinks, to, local } = plan;
   const mine = pinsWhere(root, recorded, personal);
   if (typeof mine === "string") return { name, action: "skipped", reason: mine };
@@ -1754,12 +1876,7 @@ function shippedSkill() {
   return readFileSync5(new URL("../skills/skilllib/SKILL.md", import.meta.url), "utf-8");
 }
 function agentSkillDirs(enabled = enabledHarnesses()) {
-  const claudeSkills = join9(claudeDir(), "skills");
-  const agentsSkills = join9(userHome(), ".agents", "skills");
-  const needsClaude = enabled.some((id) => harness(id).globalDirs().includes(claudeSkills));
-  const needsAgents = enabled.some((id) => !harness(id).globalDirs().includes(claudeSkills));
-  const dirs = [...needsClaude ? [claudeSkills] : [], ...needsAgents ? [agentsSkills] : []];
-  return dirs.filter((d, i) => dirs.findIndex((o) => realPath(o) === realPath(d)) === i).map((d) => join9(d, AGENT_SKILL_NAME));
+  return globalInstallDirs(enabled).map((d) => join9(d, AGENT_SKILL_NAME));
 }
 function isOurs(dir) {
   return existsSync8(join9(dir, OWN_SKILL_MARKER));
@@ -1790,7 +1907,7 @@ function installAgentSkill(enabled = enabledHarnesses()) {
   return { ok: true, dirs: [primary, ...links] };
 }
 function removeAgentSkill() {
-  const all = agentSkillDirs(["claude-code", "codex"]);
+  const all = [...new Set(HARNESSES.flatMap((h) => h.globalDirs().map((d) => join9(d, AGENT_SKILL_NAME))))];
   const removed = all.filter((d) => entryExists(d) && (isOurs(d) || isDangling(d)));
   for (const d of removed) {
     if (!entryExists(d)) continue;
@@ -1807,9 +1924,9 @@ function refreshAgentSkill() {
 }
 
 // src/commands.ts
-import { existsSync as existsSync14, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync7, rmSync as rmSync7 } from "fs";
 import { parseArgs as parseFlags } from "util";
-import { basename as basename10, join as join15, resolve as resolve8, sep as sep9 } from "path";
+import { basename as basename11, join as join16, resolve as resolve9, sep as sep10 } from "path";
 
 // src/git.ts
 import { execFileSync as execFileSync3 } from "child_process";
@@ -2209,11 +2326,28 @@ function namesIn(dirs) {
   }
   return [...names].sort();
 }
-var PROJECT_TIDY_DIRS = ALL_PROJECT_DIRS.filter((d) => d !== GROK_SKILLS_DIR);
-var repoTidyDirs = (root) => PROJECT_TIDY_DIRS.filter((d) => notWritable(root, d) === null);
+var CLASSIC_TIDY = [PROJECT_SKILLS_DIR, AGENTS_SKILLS_DIR, ".cursor/skills", ".codex/skills"];
+var tidyDirs = () => {
+  const enabled = enabledHarnesses();
+  const fromEnabled = enabled.flatMap((id) => harness(id).projectDirs);
+  return [.../* @__PURE__ */ new Set([...CLASSIC_TIDY, ...fromEnabled])].filter((d) => d !== GROK_SKILLS_DIR && (d !== "skills" || enabled.includes("openclaw")));
+};
+var repoTidyDirs = (root) => tidyDirs().filter((d) => notWritable(root, d) === null);
 function globalTidyDirs() {
   const own = realPath(join12(grokDir(), "skills"));
-  return globalSkillDirs().filter((d) => realPath(d) !== own);
+  const allowed = new Set(
+    [
+      join12(userHome(), ".agents", "skills"),
+      join12(claudeDir(), "skills"),
+      join12(userHome(), ".cursor", "skills"),
+      join12(userHome(), ".codex", "skills"),
+      ...enabledHarnesses().flatMap((id) => harness(id).globalDirs())
+    ].map((d) => realPath(d))
+  );
+  return globalSkillDirs().filter((d) => {
+    const real = realPath(d);
+    return real !== own && allowed.has(real);
+  });
 }
 function runsFrom(id, dirsWithCopy, readsOf) {
   const reads = readsOf(id).filter((d) => dirsWithCopy.includes(d));
@@ -2400,6 +2534,8 @@ function intoLibrary(path, force = false) {
   if (r.status === "exists") throw new Error(`${r.name}: your library has a different ${r.name}; update or delete it first`);
   return r.name;
 }
+var pinsOf = (where, personal) => personal ? "your personal pins" : `${where}'s skilllib.json`;
+var newPinsOf = (root, where) => pinsOf(where, !existsSync12(join13(root, MANIFEST_FILE)) && personalPinsFile(root) !== null);
 function track(root, name) {
   const c = addSkill(root, name);
   if (c.action === "skipped") throw new Error(`${name}: ${c.reason}`);
@@ -2462,8 +2598,8 @@ function applyAll(plans, git2) {
 }
 function brokenLinksIn(root, opened) {
   const where = basename7(root);
-  const tidyDirs = repoTidyDirs(root);
-  const hasCopy = (name) => tidyDirs.some((d) => !isLink(join13(root, d, name)) && existsSync12(join13(root, d, name, "SKILL.md")));
+  const tidyDirs2 = repoTidyDirs(root);
+  const hasCopy = (name) => tidyDirs2.some((d) => !isLink(join13(root, d, name)) && existsSync12(join13(root, d, name, "SKILL.md")));
   const mends = (project, dir, name) => {
     const dep = pinsIn(project)[name];
     return !!dep && (dep.links ?? []).includes(dir) && !syncBlocker(project, name, dep) && versionForHash(name, dep.hash) !== null;
@@ -2483,7 +2619,7 @@ function brokenLinksIn(root, opened) {
   const seen = /* @__PURE__ */ new Set();
   const aliased = (dir) => (realNative(join13(root, dir)) ?? "") !== join13(realRoot, dir);
   const packageFolders = packageSkillFolders(root).map((f) => ({ dir: f.location, top: false })).sort((a, b) => Number(aliased(a.dir)) - Number(aliased(b.dir)));
-  const folders2 = [...ALL_PROJECT_DIRS.map((dir) => ({ dir, top: true })), ...packageFolders].flatMap(({ dir, top }) => {
+  const folders2 = [...projectDirsInUse(enabledHarnesses()).map((dir) => ({ dir, top: true })), ...packageFolders].flatMap(({ dir, top }) => {
     const real = realNative(join13(root, dir)) ?? join13(root, dir);
     if (seen.has(real)) return [];
     seen.add(real);
@@ -2865,7 +3001,7 @@ function findIssues(roots, machine, libraryNames, statusOf = projectStatus, load
   }
   const agentSkill2 = agentSkillState();
   if (agentSkill2 !== "installed") {
-    const install = {
+    const install2 = {
       label: agentSkill2 === "missing" ? "Install the skilllib skill for your agents" : "Update the skilllib skill",
       hint: "one global skill, in ~/.claude/skills (and ~/.agents/skills)",
       run: () => {
@@ -2880,7 +3016,7 @@ function findIssues(roots, machine, libraryNames, statusOf = projectStatus, load
       title: agentSkill2 === "missing" ? "Your agents don't know about skilllib" : "The skilllib skill for your agents is out of date",
       detail: "The skilllib skill lets you ask your agents which skills they can use here, where each comes from, and which of your skills a repo should add.",
       at: rows(null, ["skilllib"]),
-      ...agentSkill2 === "missing" ? { choices: [install] } : { fix: install }
+      ...agentSkill2 === "missing" ? { choices: [install2] } : { fix: install2 }
     });
   }
   return issues;
@@ -2937,7 +3073,7 @@ function repoIssues(root, ctx) {
       detail: `${s.state === "folder missing" ? "The folder is missing, and no" : "The copy is another version, and no"} version in Your skills has the content it pins (pinned from another library?). ${untrackable(s) ? `${untrackable(s)}, so skilllib can't install it here.` : `Install your newest v${s.latest}; ${s.personal ? "your personal pins" : `${where}'s skilllib.json`} then pin${s.personal ? "" : "s"} it.`}`,
       at: rows(root, [s.name]),
       // It changes what the shared skilllib.json pins: a choice, never run by `doctor --fix`.
-      ...untrackable(s) ? {} : { choices: [{ label: `Install your newest (v${s.latest})`, hint: `${where}'s skilllib.json pins it`, run: () => `${s.name}: installed v${track(root, s.name).to}` }] }
+      ...untrackable(s) ? {} : { choices: [{ label: `Install your newest (v${s.latest})`, hint: s.personal ? "your personal pins pin it" : `${where}'s skilllib.json pins it`, run: () => `${s.name}: installed v${track(root, s.name).to}` }] }
     });
   if (restorable.length > 0) {
     ctx.issues.push({
@@ -2957,7 +3093,7 @@ function repoIssues(root, ctx) {
   if (drifted.length) {
     const seen = drifted.some((s) => isShared(gitOf(root)?.of(relativeTo(root, s.path))));
     const yours = drifted.some((s) => untrackable(s));
-    const install = {
+    const install2 = {
       label: "Install the pinned versions",
       hint: seen ? "git will see the copies change" : "your library keeps every version",
       run: () => summarize(where, "synced", syncProject(root, { names: drifted.map((s) => s.name) }))
@@ -2968,7 +3104,7 @@ function repoIssues(root, ctx) {
       title: `${where}: ${plural(drifted.length, "skill")} not at the pinned version`,
       detail: `${drifted.map((s) => s.name).join(", ")}: each copy is another version from your library. sync installs the pinned one.${yours ? ` ${[...new Set(drifted.flatMap((s) => untrackable(s) ? [untrackable(s)] : []))].map((why) => `${drifted.filter((s) => untrackable(s) === why).map((s) => s.name).join(", ")}: ${why}`).join("; ")}, so skilllib can't pin the version that's there; ${drifted.filter((s) => untrackable(s)).length === 1 ? "it may be edits you copied into Your skills on purpose, and stays" : "they may be edits you copied into Your skills on purpose, and stay"} unless you choose this.` : ""}`,
       at: rows(root, drifted.map((s) => s.name)),
-      ...seen || yours ? { choices: [install] } : { fix: install }
+      ...seen || yours ? { choices: [install2] } : { fix: install2 }
     });
   }
   for (const s of unstuck.filter((s2) => s2.state === "folder missing" && s2.latest === null))
@@ -2981,12 +3117,12 @@ function repoIssues(root, ctx) {
       // Editing skilllib.json is the team's call: a choice, never run by `doctor --fix`.
       choices: [
         {
-          label: "Remove it from skilllib.json",
+          label: s.personal ? "Remove it from your personal pins" : "Remove it from skilllib.json",
           hint: `${where} stops pinning it`,
           run: () => {
             const r = removeSkill(root, s.name);
             if (r.action !== "removed") throw new Error(`${s.name}: ${r.reason}`);
-            return `${s.name}: removed from ${where}'s skilllib.json`;
+            return `${s.name}: removed from ${pinsOf(where, s.personal)}`;
           }
         }
       ]
@@ -3003,7 +3139,7 @@ function repoIssues(root, ctx) {
       choices: [
         {
           label: "Update to the newest versions",
-          hint: isShared(gitOf(root)?.of(MANIFEST_FILE)) ? "git will see the new copies and skilllib.json" : "replaces each copy with your library's newest",
+          hint: behind.some((s) => !s.personal) && isShared(gitOf(root)?.of(MANIFEST_FILE)) ? "git will see the new copies and skilllib.json" : "replaces each copy with your library's newest",
           run: () => summarize(where, "updated", updateProject(root, behind.map((s) => s.name)))
         }
       ]
@@ -3086,7 +3222,7 @@ function repoIssues(root, ctx) {
   if (partial.length) {
     const missing2 = [...new Set(partial.flatMap((s) => s.visibility.filter((v) => v.paths === 0).map((v) => v.id)))];
     const tracked = [...new Set(blindHere.flatMap(({ would }) => would.blocked))];
-    const manifestShared = partial.some((s) => s.managed) && isShared(gitOf(root)?.of(MANIFEST_FILE));
+    const manifestShared = partial.some((s) => s.managed && !s.personal) && isShared(gitOf(root)?.of(MANIFEST_FILE));
     const run = (allowTracked) => () => {
       if (allowTracked) allowTrackedLinks(root);
       const r = linkAll(root, { allowTracked, names: partial.map((s) => s.name) });
@@ -3162,9 +3298,9 @@ function repoIssues(root, ctx) {
         id: `adopt:${root}:${s.name}`,
         severity: "suggestion",
         title: `${s.name} in ${where} isn't tracked`,
-        detail: "It's identical to the library copy; track it (in skilllib.json) so future library changes reach it.",
+        detail: `It's identical to the library copy; track it (in ${newPinsOf(root, where)}) so future library changes reach it.`,
         at: rows(root, [s.name]),
-        choices: [{ label: "Track it", hint: `adds it to ${where}'s skilllib.json`, run: () => `${track(root, s.name).name} tracked in ${where}` }]
+        choices: [{ label: "Track it", hint: `adds it to ${newPinsOf(root, where)}`, run: () => `${track(root, s.name).name} tracked in ${where}` }]
       });
     } else if (s.state === "untracked, differs from library" || s.state === "repo skill, differs from library") {
       const teams = s.state.startsWith("repo skill") || committed(s) || !!untrackable(s);
@@ -3226,7 +3362,7 @@ function repoIssues(root, ctx) {
         id: `not-in-lib:${root}:${s.name}`,
         severity: "suggestion",
         title: `${s.name} in ${where} is tracked, but no longer in your library`,
-        detail: `${where}'s skilllib.json pins it, but your library has no copy: if the folder goes, sync can't restore it, and your other repos can't add it. Copy ${where}'s copy back into the library.`,
+        detail: `${s.personal ? "Your personal pins have" : `${where}'s skilllib.json pins`} it, but your library has no copy: if the folder goes, sync can't restore it, and your other repos can't add it. Copy ${where}'s copy back into the library.`,
         at: rows(root, [s.name]),
         choices: [
           {
@@ -3623,12 +3759,217 @@ function usesByProject(uses, projectOf) {
   return byProject;
 }
 
+// src/install.ts
+import { execFileSync as execFileSync5 } from "child_process";
+import { createWriteStream, existsSync as existsSync14, lstatSync as lstatSync5, mkdirSync as mkdirSync9, mkdtempSync, readdirSync as readdirSync11, rmSync as rmSync6, statSync as statSync7 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { basename as basename9, join as join15, resolve as resolve8, sep as sep9 } from "path";
+import { Readable } from "stream";
+import { pipeline } from "stream/promises";
+var SEARCH_API = process.env.SKILLLIB_SKILLS_API || "https://skills.sh";
+var MAX_BYTES = 32 * 1024 * 1024;
+var SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", ".next", "coverage"]);
+async function searchSkills(query) {
+  const url = `${SEARCH_API}/api/search?${new URLSearchParams({ q: query, limit: "20" })}`;
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`skills.sh search failed (${res.status})`);
+  const data = await res.json();
+  return (data.skills ?? []).map((s) => ({
+    name: s.name || s.skillId || s.id || "",
+    source: s.source || "",
+    skillId: s.skillId || s.name || "",
+    installs: s.installs ?? 0
+  }));
+}
+var NAME = /^[A-Za-z0-9_.-]+$/;
+function parseInstallSpec(input) {
+  const trimmed = input.trim().replace(/\/+$/, "");
+  if (!trimmed) return null;
+  if (trimmed.startsWith(".") || trimmed.startsWith("/") || trimmed.startsWith("~") || /^[A-Za-z]:[\\/]/.test(trimmed)) {
+    return { local: trimmed.replace(/^~(?=$|[\\/])/, userHome()) };
+  }
+  let text = trimmed;
+  try {
+    const url = new URL(trimmed);
+    const host = url.hostname.replace(/^www\./, "");
+    const parts2 = url.pathname.split("/").filter(Boolean);
+    if (host === "skills.sh" && parts2.length >= 2) text = parts2.length >= 3 ? `${parts2[0]}/${parts2[1]}@${parts2.slice(2).join("/")}` : `${parts2[0]}/${parts2[1]}`;
+    else if (host === "github.com" && parts2.length >= 2) {
+      const repo = parts2[1].replace(/\.git$/, "");
+      if (parts2[2] === "tree" && parts2.length >= 5) return namePair(parts2[0], repo, parts2.slice(4).join("/"));
+      return namePair(parts2[0], repo);
+    } else return null;
+  } catch {
+  }
+  const at = text.split("@");
+  if (at.length === 2 && at[0]?.includes("/") && at[1] && at[0].split("/").length === 2) {
+    const [owner, repo] = at[0].split("/");
+    return namePair(owner, repo, at[1]);
+  }
+  const parts = text.split("/");
+  if (parts.length === 2) return namePair(parts[0], parts[1]);
+  if (parts.length >= 3) return namePair(parts[0], parts[1], parts.slice(2).join("/"));
+  return null;
+}
+function namePair(owner, repo, skill) {
+  if (!NAME.test(owner) || !NAME.test(repo) || owner === "." || repo === "." || owner === ".." || repo === "..") return null;
+  return skill ? { owner, repo, skill } : { owner, repo };
+}
+function escapes(root, path) {
+  const base = realpathOrNull(root);
+  const real = realpathOrNull(path);
+  if (!base || !real) return true;
+  return real !== base && !real.startsWith(base + sep9);
+}
+function findSkillDirs(root, depth = 0) {
+  if (depth > 6 || !isDir(root)) return [];
+  if (isSkillDir(root)) return escapes(root, root) ? [] : [root];
+  let names = [];
+  try {
+    names = readdirSync11(root);
+  } catch {
+    return [];
+  }
+  return names.filter((n) => !n.startsWith(".") && !SKIP.has(n)).flatMap((n) => {
+    const path = join15(root, n);
+    const st = lstatSync5(path, { throwIfNoEntry: false });
+    if (!st?.isDirectory()) return [];
+    if (st.isSymbolicLink() && escapes(root, path)) return [];
+    return findSkillDirs(path, depth + 1);
+  });
+}
+function skillNamed(dirs, skill) {
+  if (!skill) return dirs;
+  const want = skill.split("/").filter(Boolean).pop();
+  return dirs.filter((d) => basename9(d) === want || readSkillInfo(d).name === want);
+}
+async function downloadGitHub(owner, repo) {
+  const dest = mkdtempSync(join15(tmpdir2(), "skilllib-"));
+  const archive = join15(dest, "repo.tar.gz");
+  const url = `https://codeload.github.com/${owner}/${repo}/tar.gz/HEAD`;
+  let res;
+  try {
+    res = await fetch(url, { redirect: "follow" });
+  } catch (err) {
+    rmSync6(dest, { recursive: true, force: true });
+    throw new Error(`couldn't download ${owner}/${repo} (${err instanceof Error ? err.message : err})`);
+  }
+  if (!res.ok || !res.body) {
+    rmSync6(dest, { recursive: true, force: true });
+    throw new Error(res.status === 404 ? `${owner}/${repo} not found on GitHub` : `couldn't download ${owner}/${repo} (${res.status})`);
+  }
+  const host = new URL(res.url).hostname;
+  if (host !== "codeload.github.com" && host !== "github.com") {
+    rmSync6(dest, { recursive: true, force: true });
+    throw new Error(`refusing to download ${owner}/${repo} from ${host}`);
+  }
+  let bytes = 0;
+  try {
+    await pipeline(
+      Readable.from(
+        (async function* () {
+          const reader = res.body.getReader();
+          for (; ; ) {
+            const { done, value } = await reader.read();
+            if (done) return;
+            bytes += value.byteLength;
+            if (bytes > MAX_BYTES) throw new Error(`${owner}/${repo} is larger than ${MAX_BYTES / 1024 / 1024}MB`);
+            yield value;
+          }
+        })()
+      ),
+      createWriteStream(archive)
+    );
+    execFileSync5("tar", ["-xzf", archive, "-C", dest], { stdio: "ignore" });
+  } catch (err) {
+    rmSync6(dest, { recursive: true, force: true });
+    if (err instanceof Error && /larger than|couldn't download/.test(err.message)) throw err;
+    throw new Error(`couldn't extract ${owner}/${repo}`);
+  }
+  rmSync6(archive, { force: true });
+  const top = readdirSync11(dest);
+  const root = top.length === 1 && statSync7(join15(dest, top[0])).isDirectory() ? join15(dest, top[0]) : dest;
+  return { tmp: dest, root };
+}
+function installGlobal(name, { force = false } = {}) {
+  const latest = latestVersion(name);
+  if (!latest) return { ok: false, reason: "not in the library" };
+  const parents = globalInstallDirs(enabledHarnesses());
+  if (!parents.length) return { ok: false, reason: "no agents chosen yet (skilllib harnesses)" };
+  const [primary, ...links] = parents;
+  const dest = join15(primary, name);
+  if (entryExists(dest) && !isLink(dest) && !isDir(dest)) return { ok: false, reason: `${dest} is a file` };
+  const there = treeHash(dest);
+  if (there && there !== latest.hash && versionForHash(name, there) === null && !force) {
+    return { ok: false, reason: `${name} is already global, with edits that aren't in your library (pass --force to replace them)` };
+  }
+  if (there !== latest.hash) {
+    if (isLink(dest)) rmSync6(dest, { force: true });
+    mkdirSync9(primary, { recursive: true });
+    copySkill(versionDir(name, latest.version), dest);
+  }
+  const wrote = [dest];
+  for (const dir of links) {
+    const link2 = join15(dir, name);
+    if (isLink(link2) && realpathOrNull(link2) === null) rmSync6(link2, { force: true });
+    else if (entryExists(link2)) {
+      if (realpathOrNull(link2) === realpathOrNull(dest)) wrote.push(link2);
+      continue;
+    }
+    mkdirSync9(dir, { recursive: true });
+    linkDir(realpathOrNull(dest) ?? dest, join15(realpathOrNull(dir) ?? dir, name));
+    wrote.push(link2);
+  }
+  setKeepGlobal([name], true);
+  return { ok: true, dirs: wrote };
+}
+function installFound(dirs, source, { force = false, global = false, allowTracked = false } = {}) {
+  const root = global ? null : projectHere();
+  const label = source.startsWith("/") || source.startsWith(".") ? source : `skills.sh: ${source}`;
+  return dirs.map((dir) => {
+    const imported = importSkill(dir, { force });
+    if (imported.status !== "exists") recordOrigin(imported.name, label);
+    const row = { name: imported.name, source, status: imported.status };
+    if (imported.status === "exists") {
+      row.reason = "the library already has a different version (pass --force)";
+      return row;
+    }
+    if (global) {
+      const placed = installGlobal(imported.name, { force });
+      if (!placed.ok) {
+        row.status = "skipped";
+        row.reason = placed.reason;
+      } else row.global = placed.dirs;
+      return row;
+    }
+    if (!root) return row;
+    row.project = addSkill(root, imported.name, { force, allowTracked });
+    if (row.project.action === "skipped") {
+      row.status = "skipped";
+      row.reason = row.project.reason;
+    }
+    return row;
+  });
+}
+async function resolveInstallDir(spec) {
+  if ("local" in spec) {
+    const path = resolve8(spec.local);
+    if (!existsSync14(path)) throw new Error(`${path} doesn't exist`);
+    const dirs2 = isSkillDir(path) ? [path] : findSkillDirs(path);
+    return { dirs: dirs2, source: path, many: dirs2.length > 1 };
+  }
+  const got = await downloadGitHub(spec.owner, spec.repo);
+  const source = spec.skill ? `${spec.owner}/${spec.repo}@${spec.skill}` : `${spec.owner}/${spec.repo}`;
+  const dirs = skillNamed(findSkillDirs(got.root), spec.skill);
+  return { tmp: got.tmp, dirs, source, many: !spec.skill && dirs.length > 1 };
+}
+
 // src/move.ts
-import { basename as basename9 } from "path";
+import { basename as basename10 } from "path";
 function moveGlobalSkills(skills, roots, {
   group,
   allowTracked = false,
-  label = basename9,
+  label = basename10,
   allowTrackedHint = "re-run with --allow-tracked"
 } = {}) {
   const byName = /* @__PURE__ */ new Map();
@@ -3747,9 +4088,9 @@ function projectOfFactory(projects2) {
   const sorted2 = [...projects2].sort((a, b) => b.length - a.length);
   return (cwd) => {
     if (!cwd) return null;
-    const known = sorted2.find((p) => cwd === p || cwd.startsWith(p + sep9));
+    const known = sorted2.find((p) => cwd === p || cwd.startsWith(p + sep10));
     if (known) return known;
-    const repo = cwd.split(`${sep9}.claude${sep9}worktrees${sep9}`)[0];
+    const repo = cwd.split(`${sep10}.claude${sep10}worktrees${sep10}`)[0];
     return isProjectCandidate(repo) ? repo : null;
   };
 }
@@ -3763,7 +4104,7 @@ var projectsFor = (args) => {
   if (!args.all) return [requireProject()];
   const { readable, unreadable } = readableRoots(visibleProjects());
   for (const u of unreadable) {
-    error(`${basename10(u.root)}: ${u.reason}`);
+    error(`${basename11(u.root)}: ${u.reason}`);
     process.exitCode = 1;
   }
   return readable;
@@ -3775,7 +4116,7 @@ function requireProject() {
   if (!isProjectCandidate(findProjectRoot())) {
     const top = findProjectRoot();
     if (realPath(top) !== realPath(userHome())) throw new Error(`${tildify(top)} is skilllib's or an agent's own folder, not a project. Run this inside a project.`);
-    const stray = existsSync14(join15(userHome(), MANIFEST_FILE)) ? `, though ${tildify(join15(userHome(), MANIFEST_FILE))} makes it look like one` : "";
+    const stray = existsSync15(join16(userHome(), MANIFEST_FILE)) ? `, though ${tildify(join16(userHome(), MANIFEST_FILE))} makes it look like one` : "";
     throw new Error(`Your home folder isn't a project${stray}: skills added here would load in every repo. Run this inside a project.`);
   }
   throw new Error("Not in a git repo. Run this inside a project (or `git init` first).");
@@ -3797,7 +4138,7 @@ async function status(args) {
   const root = requireProject();
   const skills = projectStatus(root);
   const nested = nestedSkills(root);
-  info(`${basename10(root)} ${dim(tildify(root))}
+  info(`${basename11(root)} ${dim(tildify(root))}
 `);
   if (skills.length === 0 && nested.length === 0) info("No skills in this project yet. Add one from your library with: skilllib add <name>");
   const usage2 = await usageBySkill(args.days, root);
@@ -3870,7 +4211,7 @@ async function list(args) {
     const installs = /* @__PURE__ */ new Map();
     for (const project of visibleProjects()) {
       for (const name of Object.keys(pinsIn(project))) {
-        installs.set(name, [...installs.get(name) ?? [], basename10(project)]);
+        installs.set(name, [...installs.get(name) ?? [], basename11(project)]);
       }
     }
     const usage2 = await usageBySkill(args.days);
@@ -3913,7 +4254,7 @@ function teamStateIn(root, extraDirs = []) {
 function projects(args) {
   const { readable: roots, unreadable } = readableRoots(visibleProjects());
   for (const u of unreadable) {
-    error(`${basename10(u.root)}: ${u.reason}`);
+    error(`${basename11(u.root)}: ${u.reason}`);
     process.exitCode = 1;
   }
   if (args.json) {
@@ -3922,7 +4263,7 @@ function projects(args) {
       roots.map((root) => {
         const teamState = teamStateIn(root);
         return {
-          name: basename10(root),
+          name: basename11(root),
           path: root,
           skills: projectStatus(root).map((s) => ({ name: s.name, managed: s.managed, state: teamState(s), version: s.version, latest: s.latest }))
         };
@@ -3940,7 +4281,7 @@ function projects(args) {
       const usual = /* @__PURE__ */ new Set(["ok", "local only", "repo skill", "repo skill, in library", "from npx skills"]);
       const attention = skills.filter((s) => !usual.has(teamState(s))).length;
       return {
-        Project: basename10(root),
+        Project: basename11(root),
         Path: dim(tildify(root)),
         Skills: skills.map((s) => s.name).join(", ") || dim("none"),
         "Local only": String(skills.filter((s) => teamState(s) === "local only").length),
@@ -3958,7 +4299,7 @@ function add(args) {
   printChanges(root, changes, args);
   const pins = readManifest(root).skills;
   const done = changes.filter((c) => c.action !== "skipped" && pins[c.name]);
-  if (!args.json && done.some((c) => pins[c.name].personal))
+  if (!args.json && args.personal === void 0 && done.some((c) => c.action === "installed" && !c.moved && pins[c.name].personal))
     info(dim(`Pinned in your personal pins (${tildify(personalPinsDir())}) and kept out of git. --shared pins in skilllib.json for the team.`));
   rememberProjects([root]);
 }
@@ -3975,11 +4316,11 @@ function changeEach(args, change, nothing) {
     const changes = change(root);
     if (changes.some(incomplete)) process.exitCode = 1;
     if (!args.json) {
-      if (args.all) info(`${basename10(root)} ${dim(tildify(root))}`);
+      if (args.all) info(`${basename11(root)} ${dim(tildify(root))}`);
       if (changes.length === 0) nothing(root);
       else printChanges(root, changes, args);
     }
-    return { project: basename10(root), path: root, changes: withDirs(root, changes) };
+    return { project: basename11(root), path: root, changes: withDirs(root, changes) };
   });
   if (args.json) args.all ? json("changes --all", results) : json("changes", results[0].changes);
   return roots;
@@ -4010,7 +4351,7 @@ function update(args) {
 function outdated(args) {
   const roots = projectsFor(args);
   const behind = roots.flatMap(
-    (root) => projectStatus(root).filter((s) => s.state.endsWith("update available") && s.latest !== null && s.version !== null).map((s) => ({ project: basename10(root), path: root, skill: s.name, installed: s.version, latest: s.latest, state: s.state }))
+    (root) => projectStatus(root).filter((s) => s.state.endsWith("update available") && s.latest !== null && s.version !== null).map((s) => ({ project: basename11(root), path: root, skill: s.name, installed: s.version, latest: s.latest, state: s.state }))
   );
   if (args.json) return json("outdated", behind);
   const rows2 = behind.map((b) => ({ Project: b.project, Skill: b.skill, Installed: `v${b.installed}`, Latest: `v${b.latest}`, Status: colorState(b.state) }));
@@ -4021,7 +4362,7 @@ function outdated(args) {
 }
 function importSkills(args) {
   if (args.global && args.positional.length) throw new Error("skilllib import --global takes no folders: it imports all your global skills");
-  const dirs = args.global ? yourGlobals().map((m) => m.path) : args.positional.map((p) => resolve8(p));
+  const dirs = args.global ? yourGlobals().map((m) => m.path) : args.positional.map((p) => resolve9(p));
   if (dirs.length === 0) {
     throw new Error("Usage: skilllib import <skill-dir>... [--force] | skilllib import --global");
   }
@@ -4041,11 +4382,11 @@ function importSkills(args) {
       continue;
     }
     success(`${name} ${dim(result === "unchanged" ? "already in library" : result === "added" ? "added to library" : "library updated")}`);
-    const root = resolve8(dir, "..", "..", "..");
+    const root = resolve9(dir, "..", "..", "..");
     const dep = projectHere(root) === root ? readManifest(root).skills[name] : void 0;
-    if (dep && realpathOrNull(join15(root, dep.dir ?? PROJECT_SKILLS_DIR, name)) === realpathOrNull(dir) && dep.hash !== treeHash(dir)) {
+    if (dep && realpathOrNull(join16(root, dep.dir ?? PROJECT_SKILLS_DIR, name)) === realpathOrNull(dir) && dep.hash !== treeHash(dir)) {
       const change = addSkill(root, name);
-      if (change.action !== "skipped") info(dim(`  ${basename10(root)} now depends on ${name} v${change.to}`));
+      if (change.action !== "skipped") info(dim(`  ${basename11(root)} now depends on ${name} v${change.to}`));
     }
   }
   if (args.json) json("import", results);
@@ -4061,14 +4402,14 @@ function scan(args) {
   const library = new Set(librarySkills().map((s) => s.name));
   const skillNames = (root) => [
     // Not a folder that links out of the repo: what's in it isn't the repo's (as in status).
-    .../* @__PURE__ */ new Set([...ALL_PROJECT_DIRS.filter((d) => !notWritable(root, d)).flatMap((d) => skillDirsIn(join15(root, d))).map((d) => basename10(d)), ...nestedSkills(root).map((s) => s.name)])
+    .../* @__PURE__ */ new Set([...projectDirsInUse(enabledHarnesses()).filter((d) => !notWritable(root, d)).flatMap((d) => skillDirsIn(join16(root, d))).map((d) => basename11(d)), ...nestedSkills(root).map((s) => s.name)])
   ];
   const withSkills = found.filter((root) => skillNames(root).length > 0);
   info(`Scanned ${roots.map((r) => tildify(r)).join(", ")}: ${found.length} project${found.length === 1 ? "" : "s"}, ${withSkills.length} with skills
 `);
   table(
     withSkills.map((root) => ({
-      Project: basename10(root),
+      Project: basename11(root),
       Path: dim(tildify(root)),
       Skills: skillNames(root).map((n) => library.has(n) ? n : yellow(n)).join(", ")
     }))
@@ -4125,7 +4466,7 @@ function newSkill(args) {
   if (!r.ok) {
     throw new Error(`Can't create ${name}: ${r.reason}`);
   }
-  success(`Created ${tildify(join15(r.dir, "SKILL.md"))}`);
+  success(`Created ${tildify(join16(r.dir, "SKILL.md"))}`);
 }
 function restore(args) {
   const backups = [...listBackups(), ...pluginBackups()];
@@ -4238,7 +4579,7 @@ async function usage(args) {
     return json("usage", {
       usageDays: args.days,
       source: "Claude Code transcripts",
-      skills: summaries.map((s) => ({ skill: s.skill, uses: s.uses, lastUsed: s.lastUsed, projects: [...s.projects].map((p) => basename10(p)), inLibrary: library.has(s.skill) })),
+      skills: summaries.map((s) => ({ skill: s.skill, uses: s.uses, lastUsed: s.lastUsed, projects: [...s.projects].map((p) => basename11(p)), inLibrary: library.has(s.skill) })),
       unusedLibrarySkills: unused
     });
   }
@@ -4246,13 +4587,13 @@ async function usage(args) {
     info(`No skill usage in Claude Code transcripts from the last ${args.days} days.`);
     return;
   }
-  info(`Skill usage, last ${args.days} days ${dim(`(from ${tildify(join15(claudeDir(), "projects"))})`)}
+  info(`Skill usage, last ${args.days} days ${dim(`(from ${tildify(join16(claudeDir(), "projects"))})`)}
 `);
   table(
     summaries.map((s) => ({
       Skill: s.skill,
       Uses: String(s.uses),
-      Projects: [...s.projects].map((p) => basename10(p)).join(", ") || dim("-"),
+      Projects: [...s.projects].map((p) => basename11(p)).join(", ") || dim("-"),
       "Last used": lastUsed(s),
       Library: library.has(s.skill) ? green("yes") : dim("no")
     }))
@@ -4264,7 +4605,7 @@ async function usage(args) {
 }
 function show(args) {
   const name = args.positional[0];
-  const dir = name ? join15(libraryDir(), name) : "";
+  const dir = name ? join16(libraryDir(), name) : "";
   if (!name || !isSkillDir(dir)) {
     throw new Error(name ? `${name} is not in the library` : "Usage: skilllib show <skill-name>");
   }
@@ -4276,8 +4617,8 @@ function show(args) {
       path: dir,
       latest: latestVersion(name)?.version ?? null,
       origin: libraryOrigins()[name] ?? "",
-      projects: projectsUsing(name).map((p) => basename10(p)),
-      skillMd: readFileSync7(join15(dir, "SKILL.md"), "utf-8")
+      projects: projectsUsing(name).map((p) => basename11(p)),
+      skillMd: readFileSync7(join16(dir, "SKILL.md"), "utf-8")
     });
   }
   info(`${name} ${dim(tildify(dir))}`);
@@ -4299,7 +4640,7 @@ function harnessesCommand(args) {
   }
   const enabled = enabledHarnesses();
   for (const h of HARNESSES) {
-    info(`${enabled.includes(h.id) ? green("\u25C9") : dim("\u25CB")} ${h.name.padEnd(12)} ${dim(`reads ${h.projectDirs.join(", ")}${h.installed() ? " \xB7 detected" : ""}`)}`);
+    info(`${enabled.includes(h.id) ? green("\u25C9") : dim("\u25CB")} ${h.name.padEnd(18)} ${dim(`reads ${h.projectDirs.join(", ")}${h.installed() ? " \xB7 detected" : ""}`)}`);
   }
   info(dim(`
 New installs go to ${installDirs(enabled).join(" (real copy) + ")}${installDirs(enabled).length > 1 ? " (link)" : ""}.`));
@@ -4308,7 +4649,7 @@ function link(args) {
   const roots = projectsFor(args);
   for (const root of roots) {
     const res = linkAll(root, { allowTracked: args.allowTracked });
-    const label = args.all ? `${basename10(root)}: ` : "";
+    const label = args.all ? `${basename11(root)}: ` : "";
     if (res.linked.length) success(`${label}linked ${res.linked.length} skill(s) for your other agents`);
     else if (!args.all && !res.blocked.length && !res.uncommitted.length && !res.inTheWay.length) {
       const missing = projectStatus(root).filter((s) => s.state === "folder missing").map((s) => s.name);
@@ -4354,11 +4695,11 @@ ${unreviewed} not reviewed. Keep one global on purpose: skilllib global keep <na
 }
 function repoRoot(repo) {
   const looksLikePath = /[\\/]/.test(repo) || repo.startsWith(".") || repo.startsWith("~");
-  const named = looksLikePath ? [] : visibleProjects().filter((p) => basename10(p) === repo);
+  const named = looksLikePath ? [] : visibleProjects().filter((p) => basename11(p) === repo);
   if (named.length === 1) return named[0];
   if (named.length > 1) throw new Error(`Several projects are named ${repo}: ${named.map(tildify).join(", ")}. Pass its path.`);
   const path = expandHome(repo);
-  if (!existsSync14(path)) throw new Error(`No project ${repo} (pass its path, or see skilllib projects)`);
+  if (!existsSync15(path)) throw new Error(`No project ${repo} (pass its path, or see skilllib projects)`);
   const root = projectHere(path);
   if (root !== path) throw new Error(root ? `${tildify(path)} is inside ${tildify(root)}: pass the repo's top folder` : `${tildify(path)} isn't in a git repo`);
   return root;
@@ -4380,22 +4721,22 @@ function moveGlobal(args, names, yours) {
         moved,
         ...reason ? { reason } : {},
         ...left ? { left } : {},
-        projects: changes.map(([root, c]) => ({ project: basename10(root), path: root, change: withDirs(root, [c])[0] }))
+        projects: changes.map(([root, c]) => ({ project: basename11(root), path: root, change: withDirs(root, [c])[0] }))
       }))
     );
   }
   for (const m of moves) {
-    if (m.moved) success(`${m.name} now loads only in ${m.changes.map(([r]) => basename10(r)).join(", ")} (the global copy is in skilllib restore)`);
+    if (m.moved) success(`${m.name} now loads only in ${m.changes.map(([r]) => basename11(r)).join(", ")} (the global copy is in skilllib restore)`);
     else error(`${m.name}: ${m.reason}`);
-    for (const [root, c] of m.changes) warnHeldLinks(root, c, `in ${basename10(root)}`);
+    for (const [root, c] of m.changes) warnHeldLinks(root, c, `in ${basename11(root)}`);
     if (m.left) warn(`${m.name}: ${m.left.join(", ")} now point${m.left.length === 1 ? "s" : ""} at nothing (the repo's own copy serves that package): remove ${m.left.length === 1 ? "it" : "them"}`);
   }
-  const toCommit = [...new Set(moves.filter((m) => m.moved).flatMap((m) => m.changes.map(([r]) => r)))].filter((r) => existsSync14(join15(r, MANIFEST_FILE)));
-  if (toCommit.length) info(dim(`Commit skilllib.json and the skill folders in ${toCommit.map((r) => basename10(r)).join(", ")}.`));
+  const toCommit = [...new Set(moves.filter((m) => m.moved).flatMap((m) => m.changes.filter(([r]) => pinsIn(r)[m.name] && !pinsIn(r)[m.name].personal).map(([r]) => r)))];
+  if (toCommit.length) info(dim(`Commit skilllib.json and the skill folders in ${toCommit.map((r) => basename11(r)).join(", ")}.`));
 }
 function tidy(args) {
   const names = args.positional;
-  const keepFor = (base) => args.keep ? Object.fromEntries(names.map((n) => [n, base ? resolve8(base, args.keep) : expandHome(args.keep)])) : {};
+  const keepFor = (base) => args.keep ? Object.fromEntries(names.map((n) => [n, base ? resolve9(base, args.keep) : expandHome(args.keep)])) : {};
   if (args.keep && !names.length) {
     throw new Error("Usage: skilllib tidy <name>... --keep <folder>");
   }
@@ -4404,13 +4745,13 @@ function tidy(args) {
   for (const name of names) {
     const where = targets.map((root) => ({ root, ...foldersOf(root, name) })).filter((w) => w.all.length);
     if (!where.length) {
-      problems.push(`${name}: no skill by that name ${args.global ? "in your global folders" : args.all ? "in your projects" : `in ${basename10(targets[0])}`}`);
+      problems.push(`${name}: no skill by that name ${args.global ? "in your global folders" : args.all ? "in your projects" : `in ${basename11(targets[0])}`}`);
       continue;
     }
     if (!args.keep) continue;
     for (const { root, real } of where) {
       if (real.includes(keepFor(root)[name])) continue;
-      const label = root ? `${basename10(root)} \xB7 ` : "";
+      const label = root ? `${basename11(root)} \xB7 ` : "";
       problems.push(
         `${label}${name}: no copy in ${args.keep}; ${real.length ? `pick one of: ${real.map((d) => folderLabel(root, d)).join(", ")}` : "it has no real copy to keep"}`
       );
@@ -4420,7 +4761,7 @@ function tidy(args) {
     throw new Error(problems.join("\n"));
   }
   const reports = targets.map(
-    (root) => root === null ? { label: "global folders", report: planGlobalTidy({ keep: keepFor(null) }) } : { label: basename10(root), report: planProjectTidy(root, { keep: keepFor(root) }) }
+    (root) => root === null ? { label: "global folders", report: planGlobalTidy({ keep: keepFor(null) }) } : { label: basename11(root), report: planProjectTidy(root, { keep: keepFor(root) }) }
   );
   let held = 0;
   let changed = 0;
@@ -4452,7 +4793,7 @@ function tidy(args) {
   }
   if (args.dryRun) info(dim("\nNothing changed (--dry-run)."));
   else if (changed) info(dim(`
-Replaced copies are in ${tildify(join15(skilllibHome(), "tidy-backup"))}; \`skilllib restore\` puts them back.`));
+Replaced copies are in ${tildify(join16(skilllibHome(), "tidy-backup"))}; \`skilllib restore\` puts them back.`));
   if (held) {
     process.exitCode = 1;
     info(dim(`${held} change${held === 1 ? "" : "s"} held back because git would see them. Re-run with --allow-git to make them.`));
@@ -4483,11 +4824,108 @@ function agentSkill(args) {
   else if (state === "outdated") warn("The skilllib skill is out of date. Run `skilllib agent-skill install` to update it.");
   else info("Your agents don't know about skilllib yet. Run `skilllib agent-skill install` so you can ask them about your skills.");
 }
+function installsOf(n) {
+  if (n >= 1e6) return `${(n / 1e6).toFixed(1).replace(/\.0$/, "")}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(1).replace(/\.0$/, "")}K`;
+  return String(n);
+}
+async function search(args) {
+  const query = args.positional.join(" ").trim();
+  if (!query) throw new Error("Usage: skilllib search <query>");
+  const hits = await searchSkills(query);
+  if (args.json) return json("search", hits);
+  if (!hits.length) return info(`No skills on skills.sh for \u201C${query}\u201D.`);
+  table(hits.map((h) => ({ Skill: h.name, Source: h.source, Installs: dim(installsOf(h.installs)) })));
+  info(dim("\nInstall one: skilllib install <source>   e.g. skilllib install owner/repo@skill"));
+}
+async function install(args) {
+  if (!args.positional.length) {
+    throw new Error("Usage: skilllib install <owner/repo[@skill] | url | folder>... [--global] [--all] [--force]\nSearch first: skilllib search <query>");
+  }
+  const results = [];
+  for (const input of args.positional) {
+    const spec = parseInstallSpec(input);
+    if (!spec) {
+      const hits = await searchSkills(input).catch(() => []);
+      const exact = hits.filter((h) => h.skillId === input || h.name === input);
+      const pick = exact.length === 1 ? exact[0] : hits.length === 1 ? hits[0] : void 0;
+      if (!pick || !pick.source.includes("/")) {
+        process.exitCode = 1;
+        if (args.json) results.push({ name: input, source: input, status: "skipped", reason: hits.length ? `several matches: ${hits.slice(0, 8).map((h) => `${h.source}@${h.skillId}`).join(", ")}` : "not a GitHub repo, skills.sh URL, or folder" });
+        else if (hits.length) {
+          warn(`\u201C${input}\u201D matches several skills. Pass one of these:`);
+          for (const h of hits.slice(0, 8)) info(`  skilllib install ${h.source}@${h.skillId} ${dim(installsOf(h.installs))}`);
+        } else error(`${input}: not a GitHub repo, skills.sh URL, or folder. Try skilllib search ${input}`);
+        continue;
+      }
+      args.positional.push(`${pick.source}@${pick.skillId}`);
+      continue;
+    }
+    let resolved;
+    try {
+      resolved = await resolveInstallDir(spec);
+    } catch (err) {
+      process.exitCode = 1;
+      const reason = err instanceof Error ? err.message : String(err);
+      if (args.json) results.push({ name: input, source: input, status: "skipped", reason });
+      else error(reason);
+      continue;
+    }
+    try {
+      if (!resolved.dirs.length) {
+        process.exitCode = 1;
+        const reason = "skill" in spec && spec.skill ? `no skill named ${spec.skill} in ${spec.owner}/${spec.repo}` : "no SKILL.md found";
+        if (args.json) results.push({ name: input, source: resolved.source, status: "skipped", reason });
+        else error(`${resolved.source}: ${reason}`);
+        continue;
+      }
+      if (resolved.many && !args.all) {
+        process.exitCode = 1;
+        const names = resolved.dirs.map((d) => basename11(d));
+        const reason = `${names.length} skills. Pass @name, or --all. ${names.slice(0, 12).join(", ")}`;
+        if (args.json) results.push({ name: input, source: resolved.source, status: "skipped", reason });
+        else {
+          warn(`${resolved.source} has ${names.length} skills. Install one, or all of them:`);
+          const base = "owner" in spec ? `${spec.owner}/${spec.repo}` : resolved.source;
+          for (const name of names.slice(0, 12)) info(`  skilllib install ${base}@${name}`);
+          if (names.length > 12) info(dim(`  \u2026 and ${names.length - 12} more`));
+          info(dim(`  skilllib install ${base} --all`));
+        }
+        continue;
+      }
+      const installed = installFound(resolved.dirs, "owner" in spec ? `${spec.owner}/${spec.repo}` : resolved.source, {
+        force: args.force,
+        global: args.global,
+        allowTracked: args.allowTracked
+      });
+      results.push(...installed);
+      if (!args.json) {
+        for (const row of installed) {
+          if (row.status === "exists" || row.status === "skipped") {
+            process.exitCode = 1;
+            warn(`${row.name}: ${row.reason}`);
+          } else {
+            const where = row.global ? `global ${row.global.map((d) => tildify(d)).join(", ")}` : row.project ? `this project (${row.project.action})` : "your library";
+            success(`${row.name} ${row.status === "unchanged" ? "already in your library" : "installed"} \u2192 ${where}`);
+          }
+        }
+        if (!args.global && !projectHere() && installed.some((r) => r.status !== "exists" && r.status !== "skipped")) {
+          info(dim("Not in a project, so nothing was added here. In a repo: skilllib add <name>. Everywhere: skilllib install <source> --global"));
+        }
+      }
+    } finally {
+      if (resolved.tmp) rmSync7(resolved.tmp, { recursive: true, force: true });
+    }
+  }
+  if (args.json) json("install", results);
+  else if (results.some((r) => r.project && r.project.action !== "skipped")) info(dim("Commit skilllib.json and the skill folders."));
+}
 
 export {
   realPath,
   skilllibHome,
   PROJECT_SKILLS_DIR,
+  FEATURED_HARNESSES,
   HARNESSES,
   harness,
   installDirs,
@@ -4497,11 +4935,14 @@ export {
   versionHistory,
   forgetLatest,
   latestVersion,
+  versionForHash,
   projectHere,
   readManifest,
+  personalPinsFile,
   knownProjects,
   rememberProjects,
   readableRoots,
+  pinsIn,
   setJsonMode,
   isJsonMode,
   json,
@@ -4600,5 +5041,7 @@ export {
   link,
   globalCommand,
   tidy,
-  agentSkill
+  agentSkill,
+  search,
+  install
 };