skilllib 1.11.7 → 1.12.0

package/dist/index.js

@@ -31,7 +31,7 @@ import {
   unhide,
   update,
   usage
-} from "./chunk-PKQPUIN3.js";
+} from "./chunk-57EEPVXJ.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
@@ -53,6 +53,8 @@ Set up:
 In a project (a git repo or a folder with skilllib.json; never your home folder):
   skilllib status                This project's skills, which agents load them, and issues
   skilllib add <name>...         Install library skills where your harnesses look
+                                 (pinned in skilllib.json when the repo has one, else in your
+                                 personal pins, kept out of git; --personal / --shared to choose)
   skilllib remove <name>...      Remove skills from this project
   skilllib link [--all]          Make every skill here usable by all your agents (adds links)
   skilllib tidy [--all|--global] One real copy per skill, plus only the links your agents need
@@ -96,7 +98,7 @@ var FLAGS_OF = {
   "": ["days"],
   ui: [],
   status: ["days"],
-  add: ["force", "allow-tracked"],
+  add: ["force", "allow-tracked", "personal", "shared"],
   remove: ["force"],
   sync: ["all", "force"],
   update: ["all", "force", "allow-tracked"],
@@ -138,10 +140,10 @@ async function main() {
   if (!["--version", "-v", "version", "help", "--help", "-h"].includes(command ?? "")) refreshAgentSkill();
   switch (command) {
     case void 0:
-      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-B5PF3J3E.js")).tui() : overview(args);
+      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-BCCAP7GJ.js")).tui() : overview(args);
     case "ui":
       if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("`skilllib ui` needs an interactive terminal. Agents and scripts: use `skilllib status --json`.");
-      return (await import("./tui-B5PF3J3E.js")).tui();
+      return (await import("./tui-BCCAP7GJ.js")).tui();
     case "status":
       return status(args);
     case "add":

package/dist/json.d.cts

@@ -33,6 +33,8 @@ type Change = {
     inTheWay?: string[];
     /** Where overwritten local edits went (~/.skilllib/edit-backup/…); `skilllib restore` puts them back. */
     backedUp?: string;
+    /** The pin moved: to your personal pins, or to the repo's skilllib.json. */
+    moved?: "personal" | "shared";
 };
 
 /**
@@ -67,6 +69,8 @@ type StatusSkillGroup = {
     git?: GitState;
     /** Only when some of your agents don't load it here. */
     agents?: HarnessId[];
+    /** In your personal pins (~/.skilllib/pins): only on your machines, kept out of git. */
+    personal?: true;
 };
 /** Global skills that come from the same place and load in the same agents. */
 type StatusGlobalGroup = {
@@ -145,6 +149,8 @@ type ProjectsJson = {
 type ChangeJson = Change & {
     /** Where an installed, updated or reset skill now is: the real copy first, then its links. */
     dirs?: string[];
+    /** Pinned in your personal pins, kept out of git: nothing to commit. */
+    personal?: true;
 };
 /** `skilllib add|remove --json`, and `sync|update --json` without --all. */
 type ChangesJson = ChangeJson[];

package/dist/json.d.ts

@@ -33,6 +33,8 @@ type Change = {
     inTheWay?: string[];
     /** Where overwritten local edits went (~/.skilllib/edit-backup/…); `skilllib restore` puts them back. */
     backedUp?: string;
+    /** The pin moved: to your personal pins, or to the repo's skilllib.json. */
+    moved?: "personal" | "shared";
 };
 
 /**
@@ -67,6 +69,8 @@ type StatusSkillGroup = {
     git?: GitState;
     /** Only when some of your agents don't load it here. */
     agents?: HarnessId[];
+    /** In your personal pins (~/.skilllib/pins): only on your machines, kept out of git. */
+    personal?: true;
 };
 /** Global skills that come from the same place and load in the same agents. */
 type StatusGlobalGroup = {
@@ -145,6 +149,8 @@ type ProjectsJson = {
 type ChangeJson = Change & {
     /** Where an installed, updated or reset skill now is: the real copy first, then its links. */
     dirs?: string[];
+    /** Pinned in your personal pins, kept out of git: nothing to commit. */
+    personal?: true;
 };
 /** `skilllib add|remove --json`, and `sync|update --json` without --all. */
 type ChangesJson = ChangeJson[];

package/dist/{tui-B5PF3J3E.js → tui-BCCAP7GJ.js}

@@ -84,7 +84,7 @@ import {
   versionHistory,
   visibleProjects,
   withoutForceHint
-} from "./chunk-PKQPUIN3.js";
+} from "./chunk-57EEPVXJ.js";
 
 // src/tui/index.tsx
 import { render } from "ink";
@@ -347,6 +347,7 @@ function shortOf(found) {
     unavailable: "Pinned, not in your library",
     pin: "Pinned version not in your library",
     "out-of-sync": "Not the pinned version",
+    shadowed: "Pinned twice",
     update: "Out of date",
     uncommitted: "Commit it first",
     local: "Not in your library",
@@ -443,6 +444,17 @@ function globalFixes(m) {
     { label: "Delete it", preview: `Remove ${m.where}/${m.name}. A backup is kept in Settings \u203A Backups.`, run: (w) => w.ops.deleteGlobal(m) }
   ];
 }
+function pinFix(w, repo, s) {
+  if (s.source !== "lib" || !w.library.some((l) => l.name === s.name)) return null;
+  if (s.personal)
+    return { label: "Pin it for the team", preview: `Move ${s.name}'s pin into ${repo}'s skilllib.json. Git will see skilllib.json and ${s.dir}/${s.name}: commit them to share it.`, run: (w2) => w2.ops.pin(repo, s.name, false) };
+  if (s.inGit || isShared(s.git)) return null;
+  return {
+    label: "Make it personal",
+    preview: `Move ${s.name}'s pin out of ${repo}'s skilllib.json into your personal pins, and keep its copy out of git.${project(w, repo).manifest === "committed" ? " Git will see skilllib.json change: once that's committed, teammates no longer get it." : ""}`,
+    run: (w2) => w2.ops.pin(repo, s.name, true)
+  };
+}
 function machineActions(m) {
   if (m.broken) return [];
   return m.source === "global" ? globalFixes(m) : m.source === "skilllib" ? [removeAgentSkillFix()] : [];
@@ -759,7 +771,7 @@ var bySeverity = (a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity]
 function tag(u) {
   const s = u.local;
   if (s?.source === "lib") {
-    return [`lib v${s.version}`, color.accent];
+    return [s.personal ? `personal v${s.version}` : `lib v${s.version}`, color.accent];
   }
   if (s) return [s.source, color.blue];
   if (u.source === "global") return [u.machine?.kept ? "global \u2713" : "global", color.yellow];
@@ -951,7 +963,7 @@ function skillActions(w, p, u, ui) {
     // Its folder gone: all that's left to remove is the skilllib.json entry (the label Health offers too).
     label: s?.missing ? "Remove it from skilllib.json" : "Remove from repo",
     preview: (s?.missing ? `${p}'s skilllib.json stops pinning ${u.name}. There's no folder to delete.` : s?.source === "lib" ? `Delete ${s.dir}/${u.name} in ${p}.${inLibrary ? " Your library keeps it." : ""}` : `Move ${s?.dir}/${u.name} in ${p} to Settings \u203A Backups.`) + (s?.others ? ` The copy in ${s.others.join(", ")} stays.` : "") + // A managed skill's removal edits skilllib.json too.
-    (gitSees(s) || (s?.source === "lib" && project(w, p).manifest === "committed" ? " Git will see skilllib.json change." : "")),
+    (gitSees(s) || (s?.source === "lib" && !s.personal && project(w, p).manifest === "committed" ? " Git will see skilllib.json change." : "")),
     run: (w2) => w2.ops.remove(p, u.name)
   };
   if (s?.source === "lib")
@@ -962,6 +974,7 @@ function skillActions(w, p, u, ui) {
         { label: "Edit in library", action: () => ui.edit(w.ops.libraryFile(u.name)) },
         versionsOption(w, p, u.name, s.version, ui)
       ] : [],
+      ...((f) => f ? [fixOption(f)] : [])(pinFix(w, p, s)),
       fixOption(remove),
       reviewOption(w, u.name, ui, p)
     ];
@@ -1564,34 +1577,39 @@ function App({ initial, reload, loadUsage: loadUsage2 }) {
     if (isNameChar(input, key)) return setFocus("list"), setQuery(query + input.toLowerCase());
     if (key.backspace || key.delete) return setQuery(query.slice(0, -1));
     if (input === "?") return setModal({ kind: "help" });
-    if (focus === "detail") {
-      const lines = (detail?.body ?? []).flatMap((l) => l.row ? [l.row] : l.option !== void 0 ? [[l.option]] : []);
-      const at = lines.findIndex((r) => r.includes(detailCursor));
-      const col = at < 0 ? 0 : lines[at].indexOf(detailCursor);
-      const goLine = (i) => lines[i] && setDetailCursor(lines[i][Math.min(col, lines[i].length - 1)]);
-      if (key.escape) return setFocus("list");
-      if (key.upArrow) return goLine(Math.max(0, at - 1));
-      if (key.downArrow) return goLine(at + 1);
-      if (key.leftArrow) return col > 0 ? setDetailCursor(lines[at][col - 1]) : setFocus("list");
-      if (key.rightArrow) return lines[at]?.[col + 1] !== void 0 ? setDetailCursor(lines[at][col + 1]) : void 0;
-      if ((key.return || input === " ") && detail?.options[detailCursor]) return choose(detail.options[detailCursor]);
-      return;
-    }
-    if (focus === "sidebar") {
-      if (key.upArrow || key.downArrow) {
-        const d = key.upArrow ? -1 : 1;
-        let i = sideAt + d;
-        while (sideRows[i]?.header) i += d;
-        const next = sideRows[i];
-        if (!next) return;
-        if (next.key === "help") return setOnHelp(true);
-        return next.go(), setOnHelp(false), setFocus("sidebar");
-      }
-      if (key.return && onHelp) return setModal({ kind: "help" });
-      if (key.rightArrow || key.return) return setOnHelp(false), setFocus("list");
-      if (key.escape) return setSideQuery("");
-      return;
+    if (focus === "detail") return detailKeys(input, key);
+    if (focus === "sidebar") return sidebarKeys(key);
+    return listKeys(input, key);
+  });
+  function detailKeys(input, key) {
+    const lines = (detail?.body ?? []).flatMap((l) => l.row ? [l.row] : l.option !== void 0 ? [[l.option]] : []);
+    const at = lines.findIndex((r) => r.includes(detailCursor));
+    const col = at < 0 ? 0 : lines[at].indexOf(detailCursor);
+    const goLine = (i) => lines[i] && setDetailCursor(lines[i][Math.min(col, lines[i].length - 1)]);
+    if (key.escape) return setFocus("list");
+    if (key.upArrow) return goLine(Math.max(0, at - 1));
+    if (key.downArrow) return goLine(at + 1);
+    if (key.leftArrow) return col > 0 ? setDetailCursor(lines[at][col - 1]) : setFocus("list");
+    if (key.rightArrow) return lines[at]?.[col + 1] !== void 0 ? setDetailCursor(lines[at][col + 1]) : void 0;
+    if ((key.return || input === " ") && detail?.options[detailCursor]) return choose(detail.options[detailCursor]);
+    return;
+  }
+  function sidebarKeys(key) {
+    if (key.upArrow || key.downArrow) {
+      const d = key.upArrow ? -1 : 1;
+      let i = sideAt + d;
+      while (sideRows[i]?.header) i += d;
+      const next = sideRows[i];
+      if (!next) return;
+      if (next.key === "help") return setOnHelp(true);
+      return next.go(), setOnHelp(false), setFocus("sidebar");
     }
+    if (key.return && onHelp) return setModal({ kind: "help" });
+    if (key.rightArrow || key.return) return setOnHelp(false), setFocus("list");
+    if (key.escape) return setSideQuery("");
+    return;
+  }
+  function listKeys(input, key) {
     if (!sidebar && (key.leftArrow || key.rightArrow)) {
       const i = PLACES.findIndex(([p]) => p === place) + (key.leftArrow ? -1 : 1);
       if (PLACES[i]) goPlace(PLACES[i][0]);
@@ -1625,44 +1643,13 @@ function App({ initial, reload, loadUsage: loadUsage2 }) {
     if (place === "projects" && !open) return key.return ? (setOpen(current.name), setQuery(""), setChip("all")) : void 0;
     if (key.return && detail) return setFocus("detail"), setDetailCursor(0);
     if (input === " ") return fixSelected();
-  });
+  }
   function modalKeys(input, key) {
     const m = modal;
     if (m.kind === "help") return setModal(null);
-    if (m.kind === "agents") {
-      if (key.escape && !m.then) return setModal(null);
-      if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
-      if (key.downArrow) return setModal({ ...m, cursor: Math.min(HARNESSES.length - 1, m.cursor + 1) });
-      if (input === " ") {
-        const id = HARNESSES[m.cursor].id;
-        return setModal({ ...m, selected: m.selected.includes(id) ? m.selected.filter((x) => x !== id) : [...m.selected, id] });
-      }
-      if (key.return) {
-        setModal(null);
-        apply((w) => w.ops.setAgents(m.selected));
-        m.then?.();
-      }
-      return;
-    }
-    if (m.kind === "input") {
-      if (key.escape) return setModal(null);
-      if (key.return) {
-        const value = m.value.trim() || m.placeholder;
-        setModal(null);
-        return value ? m.submit(value) : void 0;
-      }
-      if (key.backspace || key.delete) return setModal({ ...m, value: m.value.slice(0, -1) });
-      if (key.ctrl && input === "u") return setModal({ ...m, value: "" });
-      if (input && !key.ctrl && !key.meta) return setModal({ ...m, value: m.value + input });
-      return;
-    }
-    if (m.kind === "menu") {
-      if (key.escape) return setModal(null);
-      if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
-      if (key.downArrow) return setModal({ ...m, cursor: Math.min(m.options.length - 1, m.cursor + 1) });
-      if (key.return && m.options[m.cursor]) return setModal(null), choose(m.options[m.cursor]);
-      return;
-    }
+    if (m.kind === "agents") return agentsKeys(m, input, key);
+    if (m.kind === "input") return inputKeys(m, input, key);
+    if (m.kind === "menu") return menuKeys(m, key);
     if (key.escape) return setModal(null), m.kind === "confirm" && m.toast && setToast(m.toast);
     if (m.kind === "confirm") {
       if (key.return || input === "y") {
@@ -1672,78 +1659,115 @@ function App({ initial, reload, loadUsage: loadUsage2 }) {
       }
       return;
     }
-    if (m.kind === "repos") {
-      const repos = (m.only ?? world.projects.map((p) => p.name)).filter((r) => !m.query || matches(r, m.query));
-      if (isNameChar(input, key)) return setModal({ ...m, query: m.query + input.toLowerCase(), cursor: 0 });
-      if (key.backspace || key.delete) return setModal({ ...m, query: m.query.slice(0, -1), cursor: 0 });
-      if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
-      if (key.downArrow) return setModal({ ...m, cursor: Math.min(repos.length - 1, m.cursor + 1) });
-      if (input === " ") {
-        const picked = new Set(m.picked);
-        const r = repos[m.cursor];
-        if (!r) return;
-        if (!picked.delete(r)) picked.add(r);
-        return setModal({ ...m, picked });
-      }
-      if (key.return) {
-        if (!m.picked.size && !m.fix.allowNone) return setToast("Tick at least one repo with space, or esc to cancel");
-        setModal(null);
-        setFocus("list");
-        apply((w) => m.fix.pickRepos(w, [...m.picked]));
-      }
-      return;
+    if (m.kind === "repos") return reposKeys(m, input, key);
+    if (m.kind === "fixall") return fixallKeys(m, input, key);
+    if (m.kind === "add") return addKeys(m, input, key);
+  }
+  function agentsKeys(m, input, key) {
+    if (key.escape && !m.then) return setModal(null);
+    if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
+    if (key.downArrow) return setModal({ ...m, cursor: Math.min(HARNESSES.length - 1, m.cursor + 1) });
+    if (input === " ") {
+      const id = HARNESSES[m.cursor].id;
+      return setModal({ ...m, selected: m.selected.includes(id) ? m.selected.filter((x) => x !== id) : [...m.selected, id] });
     }
-    if (m.kind === "fixall") {
-      if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
-      if (key.downArrow) return setModal({ ...m, cursor: Math.min(m.items.length - 1, m.cursor + 1) });
-      if (input === " ") return setModal({ ...m, items: m.items.map((it, i) => i === m.cursor ? { ...it, on: !it.on } : it) });
-      if (key.return) {
-        setModal(null);
-        const chosen = m.items.filter((it) => it.on);
-        apply((w) => runAll(w, chosen.map((it) => it.fix)));
-      }
-      return;
+    if (key.return) {
+      setModal(null);
+      apply((w) => w.ops.setAgents(m.selected));
+      m.then?.();
     }
-    if (m.kind === "add") {
-      const rows = addRows(world, m.target, m.query);
-      const cursor2 = addCursor(rows, m.cursor);
-      const step = (d) => {
-        let i = cursor2 + d;
-        while (rows[i]?.header) i += d;
-        return rows[i] ? setModal({ ...m, cursor: i }) : void 0;
-      };
-      if (key.upArrow) return step(-1);
-      if (key.downArrow) return step(1);
-      if (key.backspace || key.delete) return setModal({ ...m, query: m.query.slice(0, -1), cursor: 0 });
-      const members = rows[cursor2]?.members;
-      if (input === " " && members) {
-        const picked = new Set(m.picked);
-        const all2 = members.every((n) => picked.has(n));
-        for (const n of members) all2 ? picked.delete(n) : picked.add(n);
-        return setModal({ ...m, picked });
-      }
-      if (key.return && m.target && m.picked.size) {
-        const [target, names] = [m.target, [...m.picked]];
-        setModal(null);
-        return apply((w) => w.ops.addTo([target], names));
-      }
-      if (key.return && rows[cursor2]?.agent) {
-        setModal(null);
-        return ui.copy(writeSkillPrompt(world, m.query, m.target), "a prompt for an agent to write the skill");
-      }
-      if (key.return && rows[cursor2]?.run) {
-        const row = rows[cursor2];
-        if (row.create && !/^[a-z0-9]/.test(m.query)) return setToast("Type the new skill's name first");
-        setModal(null);
-        if (!row.create) return apply(row.run);
-        const created = row.run(world);
-        if (isFailure(created)) return setToast(`\u2717 ${said2(created)}`);
-        return edit(world.ops.libraryFile(m.query), row.afterEdit);
-      }
-      if (isNameChar(input, key)) return setModal({ ...m, query: m.query + input.toLowerCase(), cursor: 0 });
+    return;
+  }
+  function inputKeys(m, input, key) {
+    if (key.escape) return setModal(null);
+    if (key.return) {
+      const value = m.value.trim() || m.placeholder;
+      setModal(null);
+      return value ? m.submit(value) : void 0;
     }
+    if (key.backspace || key.delete) return setModal({ ...m, value: m.value.slice(0, -1) });
+    if (key.ctrl && input === "u") return setModal({ ...m, value: "" });
+    if (input && !key.ctrl && !key.meta) return setModal({ ...m, value: m.value + input });
+    return;
   }
-  const toastMax = Math.max(1, Math.min(Math.max(3, Math.floor(termRows / 3)), termRows - 8 - (sidebar ? 0 : 1)));
+  function menuKeys(m, key) {
+    if (key.escape) return setModal(null);
+    if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
+    if (key.downArrow) return setModal({ ...m, cursor: Math.min(m.options.length - 1, m.cursor + 1) });
+    if (key.return && m.options[m.cursor]) return setModal(null), choose(m.options[m.cursor]);
+    return;
+  }
+  function reposKeys(m, input, key) {
+    const repos = (m.only ?? world.projects.map((p) => p.name)).filter((r) => !m.query || matches(r, m.query));
+    if (isNameChar(input, key)) return setModal({ ...m, query: m.query + input.toLowerCase(), cursor: 0 });
+    if (key.backspace || key.delete) return setModal({ ...m, query: m.query.slice(0, -1), cursor: 0 });
+    if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
+    if (key.downArrow) return setModal({ ...m, cursor: Math.min(repos.length - 1, m.cursor + 1) });
+    if (input === " ") {
+      const picked = new Set(m.picked);
+      const r = repos[m.cursor];
+      if (!r) return;
+      if (!picked.delete(r)) picked.add(r);
+      return setModal({ ...m, picked });
+    }
+    if (key.return) {
+      if (!m.picked.size && !m.fix.allowNone) return setToast("Tick at least one repo with space, or esc to cancel");
+      setModal(null);
+      setFocus("list");
+      apply((w) => m.fix.pickRepos(w, [...m.picked]));
+    }
+    return;
+  }
+  function fixallKeys(m, input, key) {
+    if (key.upArrow) return setModal({ ...m, cursor: Math.max(0, m.cursor - 1) });
+    if (key.downArrow) return setModal({ ...m, cursor: Math.min(m.items.length - 1, m.cursor + 1) });
+    if (input === " ") return setModal({ ...m, items: m.items.map((it, i) => i === m.cursor ? { ...it, on: !it.on } : it) });
+    if (key.return) {
+      setModal(null);
+      const chosen = m.items.filter((it) => it.on);
+      apply((w) => runAll(w, chosen.map((it) => it.fix)));
+    }
+    return;
+  }
+  function addKeys(m, input, key) {
+    const rows = addRows(world, m.target, m.query);
+    const cursor2 = addCursor(rows, m.cursor);
+    const step = (d) => {
+      let i = cursor2 + d;
+      while (rows[i]?.header) i += d;
+      return rows[i] ? setModal({ ...m, cursor: i }) : void 0;
+    };
+    if (key.upArrow) return step(-1);
+    if (key.downArrow) return step(1);
+    if (key.backspace || key.delete) return setModal({ ...m, query: m.query.slice(0, -1), cursor: 0 });
+    const members = rows[cursor2]?.members;
+    if (input === " " && members) {
+      const picked = new Set(m.picked);
+      const all2 = members.every((n) => picked.has(n));
+      for (const n of members) all2 ? picked.delete(n) : picked.add(n);
+      return setModal({ ...m, picked });
+    }
+    if (key.return && m.target && m.picked.size) {
+      const [target, names] = [m.target, [...m.picked]];
+      setModal(null);
+      return apply((w) => w.ops.addTo([target], names));
+    }
+    if (key.return && rows[cursor2]?.agent) {
+      setModal(null);
+      return ui.copy(writeSkillPrompt(world, m.query, m.target), "a prompt for an agent to write the skill");
+    }
+    if (key.return && rows[cursor2]?.run) {
+      const row = rows[cursor2];
+      if (row.create && !/^[a-z0-9]/.test(m.query)) return setToast("Type the new skill's name first");
+      setModal(null);
+      if (!row.create) return apply(row.run);
+      const created = row.run(world);
+      if (isFailure(created)) return setToast(`\u2717 ${said2(created)}`);
+      return edit(world.ops.libraryFile(m.query), row.afterEdit);
+    }
+    if (isNameChar(input, key)) return setModal({ ...m, query: m.query + input.toLowerCase(), cursor: 0 });
+  }
+  const toastMax = Math.max(1, Math.min(Math.max(3, Math.floor(termRows * 0.4)), termRows - 8 - (sidebar ? 0 : 1)));
   const toastLines = toast && modal?.kind !== "confirm" ? wrap(toast, termCols - 2, toastMax).map((l) => " " + l) : [];
   const bottomH = Math.max(1, toastLines.length);
   const confirmLines = modal?.kind === "confirm" ? wrap(modal.fix.preview, columns - 6, 6) : [];
@@ -1979,7 +2003,7 @@ function App({ initial, reload, loadUsage: loadUsage2 }) {
       list,
       split ? side : null
     ] });
-  const hints = modal?.kind === "confirm" ? "enter apply \xB7 esc cancel" : modal?.kind === "repos" || modal?.kind === "fixall" ? "space tick \xB7 enter apply \xB7 esc cancel" : modal?.kind === "agents" ? "space tick \xB7 enter save" : modal?.kind === "menu" ? "\u2191\u2193 choose \xB7 enter do it \xB7 esc cancel" : modal?.kind === "add" ? modal.target ? "space tick \xB7 enter add \xB7 esc cancel" : "enter add \xB7 esc cancel" : modal ? "any key closes" : focus === "detail" ? "\u2191\u2193 \u2190\u2192 choose \xB7 enter apply \xB7 esc back" : focus === "sidebar" ? "\u2191\u2193 choose \xB7 enter open \xB7 type to filter repos" : place === "projects" && !open ? `type to filter \xB7 enter open \xB7 ${sidebar ? "\u2190 sidebar" : "\u2190\u2192 places"} \xB7 ? keys` : place === "settings" ? `enter toggle \xB7 ${sidebar ? "\u2190 sidebar" : "\u2190\u2192 places"} \xB7 ? keys` : `type to filter \xB7 space \u2605 fix \xB7 enter actions \xB7 tab tabs${sidebar ? " \xB7 esc back" : `${dashboard ? " \xB7 esc all projects" : ""} \xB7 ? keys`}`;
+  const hints = modal?.kind === "confirm" ? "enter apply \xB7 esc cancel" : modal?.kind === "repos" || modal?.kind === "fixall" ? "space tick \xB7 enter apply \xB7 esc cancel" : modal?.kind === "agents" ? "space tick \xB7 enter save" : modal?.kind === "menu" ? "\u2191\u2193 choose \xB7 enter do it \xB7 esc cancel" : modal?.kind === "input" ? "enter confirm \xB7 ctrl+u clear \xB7 esc cancel" : modal?.kind === "add" ? modal.target ? "space tick \xB7 enter add \xB7 esc cancel" : "enter add \xB7 esc cancel" : modal ? "any key closes" : focus === "detail" ? "\u2191\u2193 \u2190\u2192 choose \xB7 enter apply \xB7 esc back" : focus === "sidebar" ? "\u2191\u2193 choose \xB7 enter open \xB7 type to filter repos" : place === "projects" && !open ? `type to filter \xB7 enter open \xB7 ${sidebar ? "\u2190 sidebar" : "\u2190\u2192 places"} \xB7 ? keys` : place === "settings" ? `enter toggle \xB7 ${sidebar ? "\u2190 sidebar" : "\u2190\u2192 places"} \xB7 ? keys` : `type to filter \xB7 space \u2605 fix \xB7 enter actions \xB7 tab tabs${sidebar ? " \xB7 esc back" : `${dashboard ? " \xB7 esc all projects" : ""} \xB7 ? keys`}`;
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", width: termCols, height: termRows, children: [
     sidebar ? null : topBar,
     /* @__PURE__ */ jsxs2(Box2, { children: [
@@ -2090,6 +2114,7 @@ function localSkill(root, s, git) {
   const state = git ? git.of(relativeTo(root, s.path)) : null;
   const others = otherCopies(root, s.name, s.location);
   const own = other[s.state]?.source === "untracked" && isShared(state) ? { source: "repo" } : {};
+  const inGit = s.managed && (isShared(state) || (readManifest(root).skills[s.name]?.links ?? []).some((d) => isShared(git?.of(`${d}/${s.name}`))));
   return {
     name: s.name,
     source: "lib",
@@ -2097,7 +2122,7 @@ function localSkill(root, s, git) {
     path: s.path,
     // Agents that actually load it here: visibility lists every agent you use, with `paths: 0` for the blind ones.
     agents: s.visibility.filter((v) => v.paths > 0).map((v) => v.id),
-    ...s.managed ? { version: s.version ?? void 0, ...managed[s.state] } : { ...other[s.state], ...own },
+    ...s.managed ? { version: s.version ?? void 0, ...s.personal ? { personal: true } : {}, ...inGit ? { inGit: true } : {}, ...managed[s.state] } : { ...other[s.state], ...own },
     ...s.source ? { origin: `npx skills: ${s.source}` } : {},
     ...others.length ? { others } : {},
     git: state
@@ -2349,6 +2374,11 @@ function realOps(roots, backups, machine, libraryNames) {
       const c = updateProject(rootOf(repo), [name])[0];
       return c ? orForce(c, repo, "Update anyway", () => updateProject(rootOf(repo), [name], { force: true })[0]) : `${name} is up to date`;
     },
+    pin: (repo, name, personal) => {
+      const c = addSkill(rootOf(repo), name, { personal });
+      if (c.action === "skipped") return failed(said3(c, repo));
+      return personal ? `${name} is now personal in ${repo}: only on your machines, kept out of git` : `${name} is now pinned in ${repo}'s skilllib.json for the team`;
+    },
     copyToLibrary: (repo, name) => ((s) => s ? toLibrary(s.path) : failed(`${name} isn't in ${repo} any more`))(find(repo, name)),
     deleteGlobal: (m) => {
       if (!entryExists(m.path)) return `${tildify(m.path)} is already gone`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skilllib",
-  "version": "1.11.7",
+  "version": "1.12.0",
   "description": "Manage your agent skills like dependencies. One library for all your skills; each repo gets only the ones it needs, and every agent can see them. Works with Claude Code, Cursor, Codex, Zed and Grok.",
   "keywords": [
     "agent-skills",

package/skills/skilllib/SKILL.md

@@ -6,7 +6,7 @@ allowed-tools: Bash(skilllib:*)
 
 # skilllib
 
-The user manages agent skills with the `skilllib` CLI. Their **library** (`~/.skilllib/library`, "my skills", "the registry") holds versioned skills that load nowhere until added to a repo. A repo pins its skills in `skilllib.json`.
+The user manages agent skills with the `skilllib` CLI. Their **library** (`~/.skilllib/library`, "my skills", "the registry") holds versioned skills that load nowhere until added to a repo. A repo pins its skills in `skilllib.json` (shared, committed), or in the user's personal pins (`~/.skilllib/pins`, kept out of git: `personal: true` in the output).
 
 Always pass `--json` (one line of JSON on stdout; messages go to stderr). A failure exits 1 with `{"error": "..."}` as that line. `link`, `tidy`, `global` (its listing, `keep` and `unkeep`), `restore`, `new`, `folders`, `harnesses`, `scan` and `unhide` print messages only (read the exit code). Unknown flags are errors. Never run bare `skilllib` or `skilllib ui`: that's an interactive app.
 
@@ -25,7 +25,7 @@ Also: `usage --json` (Claude Code usage only, so "unused" is a hint; each skill
 
 ## Changing (ask first unless the user asked for this exact change)
 
-`add <name>...` · `remove <name>...` (skills skilllib manages, `source: library`) · `update [name...]` · `sync` (installs what `skilllib.json` pins; takes no names). Pass several names in one call. Their result is `[{name, action, from, to, dirs, reason, blocked, uncommitted, inTheWay, backedUp}]`, which is the whole result: there's no need to check files afterwards. `import <dir>...` (into the library) prints `[{path, name, status}]` and exits 1 if a folder was skipped (`exists`, `no SKILL.md`). `doctor --fix` prints doctor's issues, each fix with `fixed: {ok, message}`.
+`add <name>...` (pins in `skilllib.json` when the repo has one, else in personal pins; `--personal` / `--shared` choose, and move an existing pin without changing its version) · `remove <name>...` (skills skilllib manages, `source: library`) · `update [name...]` · `sync` (installs what `skilllib.json` pins; takes no names). Pass several names in one call. Their result is `[{name, action, from, to, dirs, reason, blocked, uncommitted, inTheWay, backedUp}]`, which is the whole result: there's no need to check files afterwards. `import <dir>...` (into the library) prints `[{path, name, status}]` and exits 1 if a folder was skipped (`exists`, `no SKILL.md`). `doctor --fix` prints doctor's issues, each fix with `fixed: {ok, message}`.
 
 - `skipped` + `reason`: nothing changed for that skill, and the command exits 1; tell the user. `--force` overwrites local edits (`backedUp` says where they went; `skilllib restore <name>` brings them back), but only use it with their OK.
 - `removed` + `reason`: removed from skilllib.json, but something was left as it is (its copy behind a folder that links out of the repo, a file of the user's, or a link in such a folder). Tell the user what the reason says is still there.
@@ -33,7 +33,7 @@ Also: `usage --json` (Claude Code usage only, so "unused" is a hint; each skill
 - `inTheWay`: something else is where a link goes (a file, or another copy), so that agent may not run this copy there, and the command exits 1. Tell the user what's there; once they move it, `skilllib link` adds the link. (A skills folder that's a file or links out of the repo makes the skill `skipped` instead, with the reason.)
 - `blocked`: git tracks that folder. Re-run with `--allow-tracked` (for that command only) only with their OK.
 - `uncommitted`: git tracks that folder but not the skill's real copy, so a link there would break for teammates; `--allow-tracked` doesn't change that. Once the copy is committed, `link --allow-tracked` adds it.
-- Changes apply from the agent's next session. Remind the user to commit `skilllib.json` and the folders in `dirs`.
+- Changes apply from the agent's next session. For a change without `personal`, remind the user to commit `skilllib.json` and the folders in `dirs`; a `personal` one has nothing to commit.
 
 **Prefer per-repo skills to global ones.** A global skill loads in every repo, for every agent. When `usage --json` shows one used in only a few repos, propose moving it there: