@localskills/cli 0.1.0 → 0.1.3

package/README.md

@@ -0,0 +1,148 @@
+# @localskills/cli
+
+CLI for [localskills.sh](https://localskills.sh) — install, manage, and publish agent skills for AI coding tools.
+
+## Install
+
+```bash
+npm install -g @localskills/cli
+```
+
+## Supported platforms
+
+| Platform | ID | Global | Project | Method |
+|---|---|---|---|---|
+| Cursor | `cursor` | `~/.cursor/rules/` | `.cursor/rules/` | symlink |
+| Claude Code | `claude` | `~/.claude/skills/` | `.claude/skills/` | symlink |
+| Windsurf | `windsurf` | `~/.codeium/windsurf/memories/` | `.windsurf/rules/` | section (global), symlink (project) |
+| Cline | `cline` | — | `.clinerules/` | symlink |
+| GitHub Copilot | `copilot` | — | `.github/copilot-instructions.md` | section |
+| Codex CLI | `codex` | `~/.codex/AGENTS.md` | `./AGENTS.md` | section |
+| OpenCode | `opencode` | `~/.config/opencode/rules/` | `.opencode/rules/` | symlink |
+| Aider | `aider` | — | `.aider/skills/` | symlink |
+
+The CLI auto-detects which platforms are installed and pre-selects them during interactive flows.
+
+## Commands
+
+### `localskills login`
+
+Authenticate with localskills.sh by pasting your API token.
+
+```bash
+localskills login
+```
+
+### `localskills logout`
+
+Clear stored credentials.
+
+### `localskills whoami`
+
+Show the current authenticated user.
+
+### `localskills install [slug]`
+
+Install a skill to one or more platforms. Without a slug, launches an interactive picker.
+
+```bash
+# Interactive — prompts for skill, platforms, scope, and method
+localskills install
+
+# Direct — skip prompts
+localskills install my-skill -t cursor,claude -g --symlink
+```
+
+**Options:**
+
+| Flag | Description |
+|---|---|
+| `-t, --target <targets...>` | Target platforms (comma-separated) |
+| `-g, --global` | Install globally (home directory) |
+| `-p, --project [dir]` | Install in project directory |
+| `--symlink` | Symlink from cache (default) |
+| `--copy` | Copy file instead of symlinking |
+
+### `localskills uninstall [slug]`
+
+Remove an installed skill from all platforms. Without a slug, launches an interactive picker.
+
+```bash
+localskills uninstall my-skill --purge
+```
+
+**Options:**
+
+| Flag | Description |
+|---|---|
+| `--purge` | Also remove from local cache |
+
+### `localskills pull [slug]`
+
+Update installed skills by fetching the latest content from localskills.sh. Without a slug, updates all installed skills.
+
+```bash
+# Update everything
+localskills pull
+
+# Update one skill
+localskills pull my-skill
+```
+
+Symlinked installations update automatically when the cache is refreshed. Copied and section-based installations are re-written in place.
+
+### `localskills list`
+
+List available skills from localskills.sh.
+
+```bash
+localskills list
+localskills list --public
+```
+
+### `localskills publish [file]`
+
+Publish a local skill file to localskills.sh. Without a file argument, scans your project for unpublished skill files across all supported platform directories.
+
+```bash
+# Scan and publish interactively
+localskills publish
+
+# Publish a specific file
+localskills publish .cursor/rules/my-skill.mdc -n "My Skill" --visibility public
+```
+
+**Options:**
+
+| Flag | Description |
+|---|---|
+| `-t, --team <id>` | Team ID or slug |
+| `-n, --name <name>` | Skill name |
+| `--visibility <level>` | `private`, `public`, or `unlisted` (default: `private`) |
+| `-m, --message <message>` | Version message |
+
+## Installation methods
+
+- **Symlink** (default) — links the skill file from `~/.localskills/cache/` to the target location. Updates propagate automatically via `localskills pull`.
+- **Copy** — writes a standalone copy. Independent of cache but requires re-install to update.
+- **Section** — for single-file platforms (Copilot, Codex, Windsurf global), injects the skill into a shared file between `<!-- localskills:start:slug -->` / `<!-- localskills:end:slug -->` markers.
+
+## Configuration
+
+Config and cache are stored at `~/.localskills/`:
+
+```
+~/.localskills/
+  config.json       # Auth token, installed skills, preferences
+  cache/
+    my-skill/
+      raw.md        # Original content
+      meta.json     # Hash, version, metadata
+      cursor.mdc    # Platform-specific transformed files
+      claude/
+        SKILL.md
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -161,7 +161,7 @@ var require_src = __commonJS({
 });
 
 // src/index.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 
 // src/commands/auth.ts
 import { Command } from "commander";
@@ -314,10 +314,10 @@ var loginCommand = new Command("login").description("Log in to localskills.sh").
     input: process.stdin,
     output: process.stdout
   });
-  const token = await new Promise((resolve3) => {
+  const token = await new Promise((resolve4) => {
     rl.question("Paste your API token: ", (answer) => {
       rl.close();
-      resolve3(answer.trim());
+      resolve4(answer.trim());
     });
   });
   if (!token) {
@@ -345,6 +345,7 @@ var whoamiCommand = new Command("whoami").description("Show current user info").
 import { Command as Command2 } from "commander";
 
 // ../../node_modules/.pnpm/@clack+core@1.0.1/node_modules/@clack/core/dist/index.mjs
+var import_picocolors = __toESM(require_picocolors(), 1);
 var import_sisteransi = __toESM(require_src(), 1);
 import { stdout as R, stdin as q } from "process";
 import * as k from "readline";
@@ -769,9 +770,28 @@ var Wt = class extends x {
     });
   }
 };
+var $t = class extends x {
+  get userInputWithCursor() {
+    if (this.state === "submit") return this.userInput;
+    const e2 = this.userInput;
+    if (this.cursor >= e2.length) return `${this.userInput}\u2588`;
+    const s = e2.slice(0, this.cursor), [i, ...r] = e2.slice(this.cursor);
+    return `${s}${import_picocolors.default.inverse(i)}${r.join("")}`;
+  }
+  get cursor() {
+    return this._cursor;
+  }
+  constructor(e2) {
+    super({ ...e2, initialUserInput: e2.initialUserInput ?? e2.initialValue }), this.on("userInput", (s) => {
+      this._setValue(s);
+    }), this.on("finalize", () => {
+      this.value || (this.value = e2.defaultValue), this.value === void 0 && (this.value = "");
+    });
+  }
+};
 
 // ../../node_modules/.pnpm/@clack+prompts@1.0.1/node_modules/@clack/prompts/dist/index.mjs
-var import_picocolors = __toESM(require_picocolors(), 1);
+var import_picocolors2 = __toESM(require_picocolors(), 1);
 var import_sisteransi2 = __toESM(require_src(), 1);
 import N2 from "process";
 import { readdirSync as de, existsSync as $e, lstatSync as xt2 } from "fs";
@@ -812,26 +832,26 @@ var W2 = (t) => {
   switch (t) {
     case "initial":
     case "active":
-      return import_picocolors.default.cyan(Rt);
+      return import_picocolors2.default.cyan(Rt);
     case "cancel":
-      return import_picocolors.default.red(dt2);
+      return import_picocolors2.default.red(dt2);
     case "error":
-      return import_picocolors.default.yellow($t2);
+      return import_picocolors2.default.yellow($t2);
     case "submit":
-      return import_picocolors.default.green(V);
+      return import_picocolors2.default.green(V);
   }
 };
 var vt2 = (t) => {
   switch (t) {
     case "initial":
     case "active":
-      return import_picocolors.default.cyan(d);
+      return import_picocolors2.default.cyan(d);
     case "cancel":
-      return import_picocolors.default.red(d);
+      return import_picocolors2.default.red(d);
     case "error":
-      return import_picocolors.default.yellow(d);
+      return import_picocolors2.default.yellow(d);
     case "submit":
-      return import_picocolors.default.green(d);
+      return import_picocolors2.default.green(d);
   }
 };
 var pe = (t) => t === 161 || t === 164 || t === 167 || t === 168 || t === 170 || t === 173 || t === 174 || t >= 176 && t <= 180 || t >= 182 && t <= 186 || t >= 188 && t <= 191 || t === 198 || t === 208 || t === 215 || t === 216 || t >= 222 && t <= 225 || t === 230 || t >= 232 && t <= 234 || t === 236 || t === 237 || t === 240 || t === 242 || t === 243 || t >= 247 && t <= 250 || t === 252 || t === 254 || t === 257 || t === 273 || t === 275 || t === 283 || t === 294 || t === 295 || t === 299 || t >= 305 && t <= 307 || t === 312 || t >= 319 && t <= 322 || t === 324 || t >= 328 && t <= 331 || t === 333 || t === 338 || t === 339 || t === 358 || t === 359 || t === 363 || t === 462 || t === 464 || t === 466 || t === 468 || t === 470 || t === 472 || t === 474 || t === 476 || t === 593 || t === 609 || t === 708 || t === 711 || t >= 713 && t <= 715 || t === 717 || t === 720 || t >= 728 && t <= 731 || t === 733 || t === 735 || t >= 768 && t <= 879 || t >= 913 && t <= 929 || t >= 931 && t <= 937 || t >= 945 && t <= 961 || t >= 963 && t <= 969 || t === 1025 || t >= 1040 && t <= 1103 || t === 1105 || t === 8208 || t >= 8211 && t <= 8214 || t === 8216 || t === 8217 || t === 8220 || t === 8221 || t >= 8224 && t <= 8226 || t >= 8228 && t <= 8231 || t === 8240 || t === 8242 || t === 8243 || t === 8245 || t === 8251 || t === 8254 || t === 8308 || t === 8319 || t >= 8321 && t <= 8324 || t === 8364 || t === 8451 || t === 8453 || t === 8457 || t === 8467 || t === 8470 || t === 8481 || t === 8482 || t === 8486 || t === 8491 || t === 8531 || t === 8532 || t >= 8539 && t <= 8542 || t >= 8544 && t <= 8555 || t >= 8560 && t <= 8569 || t === 8585 || t >= 8592 && t <= 8601 || t === 8632 || t === 8633 || t === 8658 || t === 8660 || t === 8679 || t === 8704 || t === 8706 || t === 8707 || t === 8711 || t === 8712 || t === 8715 || t === 8719 || t === 8721 || t === 8725 || t === 8730 || t >= 8733 && t <= 8736 || t === 8739 || t === 8741 || t >= 8743 && t <= 8748 || t === 8750 || t >= 8756 && t <= 8759 || t === 8764 || t === 8765 || t === 8776 || t === 8780 || t === 8786 || t === 8800 || t === 8801 || t >= 8804 && t <= 8807 || t === 8810 || t === 8811 || t === 8814 || t === 8815 || t === 8834 || t === 8835 || t === 8838 || t === 8839 || t === 8853 || t === 8857 || t === 8869 || t === 8895 || t === 8978 || t >= 9312 && t <= 9449 || t >= 9451 && t <= 9547 || t >= 9552 && t <= 9587 || t >= 9600 && t <= 9615 || t >= 9618 && t <= 9621 || t === 9632 || t === 9633 || t >= 9635 && t <= 9641 || t === 9650 || t === 9651 || t === 9654 || t === 9655 || t === 9660 || t === 9661 || t === 9664 || t === 9665 || t >= 9670 && t <= 9672 || t === 9675 || t >= 9678 && t <= 9681 || t >= 9698 && t <= 9701 || t === 9711 || t === 9733 || t === 9734 || t === 9737 || t === 9742 || t === 9743 || t === 9756 || t === 9758 || t === 9792 || t === 9794 || t === 9824 || t === 9825 || t >= 9827 && t <= 9829 || t >= 9831 && t <= 9834 || t === 9836 || t === 9837 || t === 9839 || t === 9886 || t === 9887 || t === 9919 || t >= 9926 && t <= 9933 || t >= 9935 && t <= 9939 || t >= 9941 && t <= 9953 || t === 9955 || t === 9960 || t === 9961 || t >= 9963 && t <= 9969 || t === 9972 || t >= 9974 && t <= 9977 || t === 9979 || t === 9980 || t === 9982 || t === 9983 || t === 10045 || t >= 10102 && t <= 10111 || t >= 11094 && t <= 11097 || t >= 12872 && t <= 12879 || t >= 57344 && t <= 63743 || t >= 65024 && t <= 65039 || t === 65533 || t >= 127232 && t <= 127242 || t >= 127248 && t <= 127277 || t >= 127280 && t <= 127337 || t >= 127344 && t <= 127373 || t === 127375 || t === 127376 || t >= 127387 && t <= 127404 || t >= 917760 && t <= 917999 || t >= 983040 && t <= 1048573 || t >= 1048576 && t <= 1114109;
@@ -851,13 +871,13 @@ var jt = (t, r = {}, s = {}) => {
     if (B2 > I2 || m >= h && m > $) {
       const _2 = t.slice(I2, B2) || t.slice($, m);
       y2 = 0;
-      for (const D of _2.replaceAll(Fe, "")) {
-        const T2 = D.codePointAt(0) || 0;
+      for (const D2 of _2.replaceAll(Fe, "")) {
+        const T2 = D2.codePointAt(0) || 0;
         if (ge(T2) ? w = F : fe(T2) ? w = E : c !== p && pe(T2) ? w = c : w = p, A + w > S2 && (v = Math.min(v, Math.max(I2, $) + y2)), A + w > i) {
           f = true;
           break t;
         }
-        y2 += D.length, A += w;
+        y2 += D2.length, A += w;
       }
       I2 = B2 = 0;
     }
@@ -1009,7 +1029,7 @@ var be = (t, r, s, i, a) => {
   return { lineCount: o, removals: u };
 };
 var X2 = (t) => {
-  const { cursor: r, options: s, style: i } = t, a = t.output ?? process.stdout, o = rt(a), u = t.columnPadding ?? 0, l = t.rowPadding ?? 4, n = o - u, c = nt(a), g = import_picocolors.default.dim("..."), F = t.maxItems ?? Number.POSITIVE_INFINITY, p = Math.max(c - l, 0), E = Math.max(Math.min(F, p), 5);
+  const { cursor: r, options: s, style: i } = t, a = t.output ?? process.stdout, o = rt(a), u = t.columnPadding ?? 0, l = t.rowPadding ?? 4, n = o - u, c = nt(a), g = import_picocolors2.default.dim("..."), F = t.maxItems ?? Number.POSITIVE_INFINITY, p = Math.max(c - l, 0), E = Math.max(Math.min(F, p), 5);
   let $ = 0;
   r >= E - 3 && ($ = Math.max(Math.min(r - E + 3, s.length - E), 0));
   let m = E < s.length && $ > 0, h = E < s.length && $ + E < s.length;
@@ -1024,15 +1044,15 @@ var X2 = (t) => {
   }
   if (v > p) {
     let A = 0, w = 0, _2 = v;
-    const D = r - S2, T2 = (Y, L2) => be(f, _2, Y, L2, p);
-    m ? ({ lineCount: _2, removals: A } = T2(0, D), _2 > p && ({ lineCount: _2, removals: w } = T2(D + 1, f.length))) : ({ lineCount: _2, removals: w } = T2(D + 1, f.length), _2 > p && ({ lineCount: _2, removals: A } = T2(0, D))), A > 0 && (m = true, f.splice(0, A)), w > 0 && (h = true, f.splice(f.length - w, w));
+    const D2 = r - S2, T2 = (Y, L2) => be(f, _2, Y, L2, p);
+    m ? ({ lineCount: _2, removals: A } = T2(0, D2), _2 > p && ({ lineCount: _2, removals: w } = T2(D2 + 1, f.length))) : ({ lineCount: _2, removals: w } = T2(D2 + 1, f.length), _2 > p && ({ lineCount: _2, removals: A } = T2(0, D2))), A > 0 && (m = true, f.splice(0, A)), w > 0 && (h = true, f.splice(f.length - w, w));
   }
   const B2 = [];
   m && B2.push(g);
   for (const A of f) for (const w of A) B2.push(w);
   return h && B2.push(g), B2;
 };
-var R2 = { message: (t = [], { symbol: r = import_picocolors.default.gray(d), secondarySymbol: s = import_picocolors.default.gray(d), output: i = process.stdout, spacing: a = 1, withGuide: o } = {}) => {
+var R2 = { message: (t = [], { symbol: r = import_picocolors2.default.gray(d), secondarySymbol: s = import_picocolors2.default.gray(d), output: i = process.stdout, spacing: a = 1, withGuide: o } = {}) => {
   const u = [], l = o ?? _.withGuide, n = l ? s : "", c = l ? `${r}  ` : "", g = l ? `${s}  ` : "";
   for (let p = 0; p < a; p++) u.push(n);
   const F = Array.isArray(t) ? t : t.split(`
@@ -1046,30 +1066,30 @@ var R2 = { message: (t = [], { symbol: r = import_picocolors.default.gray(d), se
 `)}
 `);
 }, info: (t, r) => {
-  R2.message(t, { ...r, symbol: import_picocolors.default.blue(ft2) });
+  R2.message(t, { ...r, symbol: import_picocolors2.default.blue(ft2) });
 }, success: (t, r) => {
-  R2.message(t, { ...r, symbol: import_picocolors.default.green(Ft2) });
+  R2.message(t, { ...r, symbol: import_picocolors2.default.green(Ft2) });
 }, step: (t, r) => {
-  R2.message(t, { ...r, symbol: import_picocolors.default.green(V) });
+  R2.message(t, { ...r, symbol: import_picocolors2.default.green(V) });
 }, warn: (t, r) => {
-  R2.message(t, { ...r, symbol: import_picocolors.default.yellow(yt2) });
+  R2.message(t, { ...r, symbol: import_picocolors2.default.yellow(yt2) });
 }, warning: (t, r) => {
   R2.warn(t, r);
 }, error: (t, r) => {
-  R2.message(t, { ...r, symbol: import_picocolors.default.red(Et2) });
+  R2.message(t, { ...r, symbol: import_picocolors2.default.red(Et2) });
 } };
 var Ne = (t = "", r) => {
-  (r?.output ?? process.stdout).write(`${import_picocolors.default.gray(x2)}  ${import_picocolors.default.red(t)}
+  (r?.output ?? process.stdout).write(`${import_picocolors2.default.gray(x2)}  ${import_picocolors2.default.red(t)}
 
 `);
 };
 var We = (t = "", r) => {
-  (r?.output ?? process.stdout).write(`${import_picocolors.default.gray(ht2)}  ${t}
+  (r?.output ?? process.stdout).write(`${import_picocolors2.default.gray(ht2)}  ${t}
 `);
 };
 var Le = (t = "", r) => {
-  (r?.output ?? process.stdout).write(`${import_picocolors.default.gray(d)}
-${import_picocolors.default.gray(x2)}  ${t}
+  (r?.output ?? process.stdout).write(`${import_picocolors2.default.gray(d)}
+${import_picocolors2.default.gray(x2)}  ${t}
 
 `);
 };
@@ -1079,13 +1099,13 @@ var Z2 = (t, r) => t.split(`
 var je = (t) => {
   const r = (i, a) => {
     const o = i.label ?? String(i.value);
-    return a === "disabled" ? `${import_picocolors.default.gray(q2)} ${Z2(o, (u) => import_picocolors.default.strikethrough(import_picocolors.default.gray(u)))}${i.hint ? ` ${import_picocolors.default.dim(`(${i.hint ?? "disabled"})`)}` : ""}` : a === "active" ? `${import_picocolors.default.cyan(st2)} ${o}${i.hint ? ` ${import_picocolors.default.dim(`(${i.hint})`)}` : ""}` : a === "selected" ? `${import_picocolors.default.green(U2)} ${Z2(o, import_picocolors.default.dim)}${i.hint ? ` ${import_picocolors.default.dim(`(${i.hint})`)}` : ""}` : a === "cancelled" ? `${Z2(o, (u) => import_picocolors.default.strikethrough(import_picocolors.default.dim(u)))}` : a === "active-selected" ? `${import_picocolors.default.green(U2)} ${o}${i.hint ? ` ${import_picocolors.default.dim(`(${i.hint})`)}` : ""}` : a === "submitted" ? `${Z2(o, import_picocolors.default.dim)}` : `${import_picocolors.default.dim(q2)} ${Z2(o, import_picocolors.default.dim)}`;
+    return a === "disabled" ? `${import_picocolors2.default.gray(q2)} ${Z2(o, (u) => import_picocolors2.default.strikethrough(import_picocolors2.default.gray(u)))}${i.hint ? ` ${import_picocolors2.default.dim(`(${i.hint ?? "disabled"})`)}` : ""}` : a === "active" ? `${import_picocolors2.default.cyan(st2)} ${o}${i.hint ? ` ${import_picocolors2.default.dim(`(${i.hint})`)}` : ""}` : a === "selected" ? `${import_picocolors2.default.green(U2)} ${Z2(o, import_picocolors2.default.dim)}${i.hint ? ` ${import_picocolors2.default.dim(`(${i.hint})`)}` : ""}` : a === "cancelled" ? `${Z2(o, (u) => import_picocolors2.default.strikethrough(import_picocolors2.default.dim(u)))}` : a === "active-selected" ? `${import_picocolors2.default.green(U2)} ${o}${i.hint ? ` ${import_picocolors2.default.dim(`(${i.hint})`)}` : ""}` : a === "submitted" ? `${Z2(o, import_picocolors2.default.dim)}` : `${import_picocolors2.default.dim(q2)} ${Z2(o, import_picocolors2.default.dim)}`;
   }, s = t.required ?? true;
   return new Lt({ options: t.options, signal: t.signal, input: t.input, output: t.output, initialValues: t.initialValues, required: s, cursorAt: t.cursorAt, validate(i) {
     if (s && (i === void 0 || i.length === 0)) return `Please select at least one option.
-${import_picocolors.default.reset(import_picocolors.default.dim(`Press ${import_picocolors.default.gray(import_picocolors.default.bgWhite(import_picocolors.default.inverse(" space ")))} to select, ${import_picocolors.default.gray(import_picocolors.default.bgWhite(import_picocolors.default.inverse(" enter ")))} to submit`))}`;
+${import_picocolors2.default.reset(import_picocolors2.default.dim(`Press ${import_picocolors2.default.gray(import_picocolors2.default.bgWhite(import_picocolors2.default.inverse(" space ")))} to select, ${import_picocolors2.default.gray(import_picocolors2.default.bgWhite(import_picocolors2.default.inverse(" enter ")))} to submit`))}`;
   }, render() {
-    const i = xt(t.output, t.message, `${vt2(this.state)}  `, `${W2(this.state)}  `), a = `${import_picocolors.default.gray(d)}
+    const i = xt(t.output, t.message, `${vt2(this.state)}  `, `${W2(this.state)}  `), a = `${import_picocolors2.default.gray(d)}
 ${i}
 `, o = this.value ?? [], u = (l, n) => {
       if (l.disabled) return r(l, "disabled");
@@ -1094,19 +1114,19 @@ ${i}
     };
     switch (this.state) {
       case "submit": {
-        const l = this.options.filter(({ value: c }) => o.includes(c)).map((c) => r(c, "submitted")).join(import_picocolors.default.dim(", ")) || import_picocolors.default.dim("none"), n = xt(t.output, l, `${import_picocolors.default.gray(d)}  `);
+        const l = this.options.filter(({ value: c }) => o.includes(c)).map((c) => r(c, "submitted")).join(import_picocolors2.default.dim(", ")) || import_picocolors2.default.dim("none"), n = xt(t.output, l, `${import_picocolors2.default.gray(d)}  `);
         return `${a}${n}`;
       }
       case "cancel": {
-        const l = this.options.filter(({ value: c }) => o.includes(c)).map((c) => r(c, "cancelled")).join(import_picocolors.default.dim(", "));
-        if (l.trim() === "") return `${a}${import_picocolors.default.gray(d)}`;
-        const n = xt(t.output, l, `${import_picocolors.default.gray(d)}  `);
+        const l = this.options.filter(({ value: c }) => o.includes(c)).map((c) => r(c, "cancelled")).join(import_picocolors2.default.dim(", "));
+        if (l.trim() === "") return `${a}${import_picocolors2.default.gray(d)}`;
+        const n = xt(t.output, l, `${import_picocolors2.default.gray(d)}  `);
         return `${a}${n}
-${import_picocolors.default.gray(d)}`;
+${import_picocolors2.default.gray(d)}`;
       }
       case "error": {
-        const l = `${import_picocolors.default.yellow(d)}  `, n = this.error.split(`
-`).map((F, p) => p === 0 ? `${import_picocolors.default.yellow(x2)}  ${import_picocolors.default.yellow(F)}` : `   ${F}`).join(`
+        const l = `${import_picocolors2.default.yellow(d)}  `, n = this.error.split(`
+`).map((F, p) => p === 0 ? `${import_picocolors2.default.yellow(x2)}  ${import_picocolors2.default.yellow(F)}` : `   ${F}`).join(`
 `), c = a.split(`
 `).length, g = n.split(`
 `).length + 1;
@@ -1116,17 +1136,17 @@ ${n}
 `;
       }
       default: {
-        const l = `${import_picocolors.default.cyan(d)}  `, n = a.split(`
+        const l = `${import_picocolors2.default.cyan(d)}  `, n = a.split(`
 `).length;
         return `${a}${l}${X2({ output: t.output, options: this.options, cursor: this.cursor, maxItems: t.maxItems, columnPadding: l.length, rowPadding: n + 2, style: u }).join(`
 ${l}`)}
-${import_picocolors.default.cyan(x2)}
+${import_picocolors2.default.cyan(x2)}
 `;
       }
     }
   } }).prompt();
 };
-var Ke = import_picocolors.default.magenta;
+var Ke = import_picocolors2.default.magenta;
 var bt2 = ({ indicator: t = "dots", onCancel: r, output: s = process.stdout, cancelMessage: i, errorMessage: a, frames: o = et2 ? ["\u25D2", "\u25D0", "\u25D3", "\u25D1"] : ["\u2022", "o", "O", "0"], delay: u = et2 ? 80 : 120, signal: l, ...n } = {}) => {
   const c = ct2();
   let g, F, p = false, E = false, $ = "", m, h = performance.now();
@@ -1144,11 +1164,11 @@ var bt2 = ({ indicator: t = "dots", onCancel: r, output: s = process.stdout, can
     const b = J2(m, y2, { hard: true, trim: false }).split(`
 `);
     b.length > 1 && s.write(import_sisteransi2.cursor.up(b.length - 1)), s.write(import_sisteransi2.cursor.to(0)), s.write(import_sisteransi2.erase.down());
-  }, _2 = (b) => b.replace(/\.+$/, ""), D = (b) => {
+  }, _2 = (b) => b.replace(/\.+$/, ""), D2 = (b) => {
     const O2 = (performance.now() - b) / 1e3, j2 = Math.floor(O2 / 60), G2 = Math.floor(O2 % 60);
     return j2 > 0 ? `[${j2}m ${G2}s]` : `[${G2}s]`;
   }, T2 = n.withGuide ?? _.withGuide, Y = (b = "") => {
-    p = true, g = Bt({ output: s }), $ = _2(b), h = performance.now(), T2 && s.write(`${import_picocolors.default.gray(d)}
+    p = true, g = Bt({ output: s }), $ = _2(b), h = performance.now(), T2 && s.write(`${import_picocolors2.default.gray(d)}
 `);
     let O2 = 0, j2 = 0;
     B2(), F = setInterval(() => {
@@ -1157,7 +1177,7 @@ var bt2 = ({ indicator: t = "dots", onCancel: r, output: s = process.stdout, can
       const G2 = f(o[O2]);
       let tt2;
       if (c) tt2 = `${G2}  ${$}...`;
-      else if (t === "timer") tt2 = `${G2}  ${$} ${D(h)}`;
+      else if (t === "timer") tt2 = `${G2}  ${$} ${D2(h)}`;
       else {
         const te = ".".repeat(Math.floor(j2)).slice(0, 3);
         tt2 = `${G2}  ${$}${te}`;
@@ -1168,8 +1188,8 @@ var bt2 = ({ indicator: t = "dots", onCancel: r, output: s = process.stdout, can
   }, L2 = (b = "", O2 = 0, j2 = false) => {
     if (!p) return;
     p = false, clearInterval(F), w();
-    const G2 = O2 === 0 ? import_picocolors.default.green(V) : O2 === 1 ? import_picocolors.default.red(dt2) : import_picocolors.default.red($t2);
-    $ = b ?? $, j2 || (t === "timer" ? s.write(`${G2}  ${$} ${D(h)}
+    const G2 = O2 === 0 ? import_picocolors2.default.green(V) : O2 === 1 ? import_picocolors2.default.red(dt2) : import_picocolors2.default.red($t2);
+    $ = b ?? $, j2 || (t === "timer" ? s.write(`${G2}  ${$} ${D2(h)}
 `) : s.write(`${G2}  ${$}
 `)), A(), g();
   };
@@ -1189,33 +1209,33 @@ var Je = (t) => {
     const a = s.label ?? String(s.value);
     switch (i) {
       case "disabled":
-        return `${import_picocolors.default.gray(H2)} ${lt2(a, import_picocolors.default.gray)}${s.hint ? ` ${import_picocolors.default.dim(`(${s.hint ?? "disabled"})`)}` : ""}`;
+        return `${import_picocolors2.default.gray(H2)} ${lt2(a, import_picocolors2.default.gray)}${s.hint ? ` ${import_picocolors2.default.dim(`(${s.hint ?? "disabled"})`)}` : ""}`;
       case "selected":
-        return `${lt2(a, import_picocolors.default.dim)}`;
+        return `${lt2(a, import_picocolors2.default.dim)}`;
       case "active":
-        return `${import_picocolors.default.green(Q2)} ${a}${s.hint ? ` ${import_picocolors.default.dim(`(${s.hint})`)}` : ""}`;
+        return `${import_picocolors2.default.green(Q2)} ${a}${s.hint ? ` ${import_picocolors2.default.dim(`(${s.hint})`)}` : ""}`;
       case "cancelled":
-        return `${lt2(a, (o) => import_picocolors.default.strikethrough(import_picocolors.default.dim(o)))}`;
+        return `${lt2(a, (o) => import_picocolors2.default.strikethrough(import_picocolors2.default.dim(o)))}`;
       default:
-        return `${import_picocolors.default.dim(H2)} ${lt2(a, import_picocolors.default.dim)}`;
+        return `${import_picocolors2.default.dim(H2)} ${lt2(a, import_picocolors2.default.dim)}`;
     }
   };
   return new Wt({ options: t.options, signal: t.signal, input: t.input, output: t.output, initialValue: t.initialValue, render() {
-    const s = t.withGuide ?? _.withGuide, i = `${W2(this.state)}  `, a = `${vt2(this.state)}  `, o = xt(t.output, t.message, a, i), u = `${s ? `${import_picocolors.default.gray(d)}
+    const s = t.withGuide ?? _.withGuide, i = `${W2(this.state)}  `, a = `${vt2(this.state)}  `, o = xt(t.output, t.message, a, i), u = `${s ? `${import_picocolors2.default.gray(d)}
 ` : ""}${o}
 `;
     switch (this.state) {
       case "submit": {
-        const l = s ? `${import_picocolors.default.gray(d)}  ` : "", n = xt(t.output, r(this.options[this.cursor], "selected"), l);
+        const l = s ? `${import_picocolors2.default.gray(d)}  ` : "", n = xt(t.output, r(this.options[this.cursor], "selected"), l);
         return `${u}${n}`;
       }
       case "cancel": {
-        const l = s ? `${import_picocolors.default.gray(d)}  ` : "", n = xt(t.output, r(this.options[this.cursor], "cancelled"), l);
+        const l = s ? `${import_picocolors2.default.gray(d)}  ` : "", n = xt(t.output, r(this.options[this.cursor], "cancelled"), l);
         return `${u}${n}${s ? `
-${import_picocolors.default.gray(d)}` : ""}`;
+${import_picocolors2.default.gray(d)}` : ""}`;
       }
       default: {
-        const l = s ? `${import_picocolors.default.cyan(d)}  ` : "", n = s ? import_picocolors.default.cyan(x2) : "", c = u.split(`
+        const l = s ? `${import_picocolors2.default.cyan(d)}  ` : "", n = s ? import_picocolors2.default.cyan(x2) : "", c = u.split(`
 `).length, g = s ? 2 : 1;
         return `${u}${l}${X2({ output: t.output, cursor: this.cursor, options: this.options, maxItems: t.maxItems, columnPadding: l.length, rowPadding: c + g, style: (F, p) => r(F, F.disabled ? "disabled" : p ? "active" : "inactive") }).join(`
 ${l}`)}
@@ -1225,7 +1245,36 @@ ${n}
     }
   } }).prompt();
 };
-var Qt = `${import_picocolors.default.gray(d)}  `;
+var Qt = `${import_picocolors2.default.gray(d)}  `;
+var Ze = (t) => new $t({ validate: t.validate, placeholder: t.placeholder, defaultValue: t.defaultValue, initialValue: t.initialValue, output: t.output, signal: t.signal, input: t.input, render() {
+  const r = t?.withGuide ?? _.withGuide, s = `${`${r ? `${import_picocolors2.default.gray(d)}
+` : ""}${W2(this.state)}  `}${t.message}
+`, i = t.placeholder ? import_picocolors2.default.inverse(t.placeholder[0]) + import_picocolors2.default.dim(t.placeholder.slice(1)) : import_picocolors2.default.inverse(import_picocolors2.default.hidden("_")), a = this.userInput ? this.userInputWithCursor : i, o = this.value ?? "";
+  switch (this.state) {
+    case "error": {
+      const u = this.error ? `  ${import_picocolors2.default.yellow(this.error)}` : "", l = r ? `${import_picocolors2.default.yellow(d)}  ` : "", n = r ? import_picocolors2.default.yellow(x2) : "";
+      return `${s.trim()}
+${l}${a}
+${n}${u}
+`;
+    }
+    case "submit": {
+      const u = o ? `  ${import_picocolors2.default.dim(o)}` : "", l = r ? import_picocolors2.default.gray(d) : "";
+      return `${s}${l}${u}`;
+    }
+    case "cancel": {
+      const u = o ? `  ${import_picocolors2.default.strikethrough(import_picocolors2.default.dim(o))}` : "", l = r ? import_picocolors2.default.gray(d) : "";
+      return `${s}${l}${u}${o.trim() ? `
+${l}` : ""}`;
+    }
+    default: {
+      const u = r ? `${import_picocolors2.default.cyan(d)}  ` : "", l = r ? import_picocolors2.default.cyan(x2) : "";
+      return `${s}${u}${a}
+${l}
+`;
+    }
+  }
+} }).prompt();
 
 // src/lib/cache.ts
 import {
@@ -1275,6 +1324,11 @@ function toClaudeMD(content, skill) {
 function toPlainMD(content) {
   return content;
 }
+function stripFrontmatter(content) {
+  const match = content.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+  if (match) return content.slice(match[0].length);
+  return content;
+}
 
 // src/lib/symlink.ts
 import {
@@ -1424,8 +1478,8 @@ function uninstall2(installation, _slug) {
   }
   const parentDir = join3(installation.path, "..");
   try {
-    const { readdirSync: readdirSync2 } = __require("fs");
-    if (existsSync4(parentDir) && readdirSync2(parentDir).length === 0) {
+    const { readdirSync: readdirSync3 } = __require("fs");
+    if (existsSync4(parentDir) && readdirSync3(parentDir).length === 0) {
       rmSync3(parentDir, { recursive: true });
     }
   } catch {
@@ -1492,6 +1546,17 @@ function removeSection(filePath, slug) {
   writeFileSync4(filePath, result ? result + "\n" : "");
   return true;
 }
+function listSections(filePath) {
+  if (!existsSync5(filePath)) return [];
+  const content = readFileSync2(filePath, "utf-8");
+  const regex = /<!-- localskills:start:(.+?) -->/g;
+  const slugs = [];
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    slugs.push(match[1]);
+  }
+  return slugs;
+}
 
 // src/lib/installers/codex.ts
 var descriptor3 = {
@@ -2386,8 +2451,345 @@ ${transformed}`
   Le(`Pull complete. ${updated} updated, ${skipped} up to date.`);
 });
 
+// src/commands/publish.ts
+import { Command as Command6 } from "commander";
+import { readFileSync as readFileSync6, existsSync as existsSync14 } from "fs";
+import { resolve as resolve3, basename as basename2, extname as extname2 } from "path";
+
+// src/lib/scanner.ts
+import { existsSync as existsSync13, readdirSync as readdirSync2, readFileSync as readFileSync5 } from "fs";
+import { join as join12, basename, extname } from "path";
+import { homedir as homedir9 } from "os";
+import { readlinkSync as readlinkSync2, lstatSync as lstatSync2 } from "fs";
+function scanForSkills(projectDir) {
+  const home = homedir9();
+  const cwd = projectDir || process.cwd();
+  const results = [];
+  scanDirectory(join12(home, ".cursor", "rules"), ".mdc", "cursor", "global", results);
+  scanDirectory(join12(cwd, ".cursor", "rules"), ".mdc", "cursor", "project", results);
+  scanClaudeSkills(join12(home, ".claude", "skills"), "global", results);
+  scanClaudeSkills(join12(cwd, ".claude", "skills"), "project", results);
+  scanSingleFile(join12(home, ".codex", "AGENTS.md"), "codex", "global", results);
+  scanSingleFile(join12(cwd, "AGENTS.md"), "codex", "project", results);
+  scanSingleFile(
+    join12(home, ".codeium", "windsurf", "memories", "global_rules.md"),
+    "windsurf",
+    "global",
+    results
+  );
+  scanDirectory(join12(cwd, ".windsurf", "rules"), ".md", "windsurf", "project", results);
+  scanDirectory(join12(cwd, ".clinerules"), ".md", "cline", "project", results);
+  scanSingleFile(
+    join12(cwd, ".github", "copilot-instructions.md"),
+    "copilot",
+    "project",
+    results
+  );
+  scanDirectory(join12(home, ".config", "opencode", "rules"), ".md", "opencode", "global", results);
+  scanDirectory(join12(cwd, ".opencode", "rules"), ".md", "opencode", "project", results);
+  scanDirectory(join12(cwd, ".aider", "skills"), ".md", "aider", "project", results);
+  return results;
+}
+function filterTracked(detected, config) {
+  const trackedPaths = /* @__PURE__ */ new Set();
+  for (const skill of Object.values(config.installed_skills)) {
+    for (const inst of skill.installations) {
+      trackedPaths.add(inst.path);
+    }
+  }
+  const cacheDir = join12(homedir9(), ".localskills", "cache");
+  return detected.filter((skill) => {
+    if (trackedPaths.has(skill.filePath)) return false;
+    try {
+      const stat = lstatSync2(skill.filePath);
+      if (stat.isSymbolicLink()) {
+        const target = readlinkSync2(skill.filePath);
+        if (target.startsWith(cacheDir)) return false;
+      }
+    } catch {
+    }
+    return true;
+  });
+}
+function slugFromFilename(filename) {
+  return basename(filename, extname(filename));
+}
+function nameFromSlug(slug) {
+  return slug.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function scanDirectory(dir, ext, platform, scope, results) {
+  if (!existsSync13(dir)) return;
+  let entries;
+  try {
+    entries = readdirSync2(dir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (!entry.endsWith(ext)) continue;
+    const filePath = join12(dir, entry);
+    try {
+      const raw = readFileSync5(filePath, "utf-8");
+      const content = stripFrontmatter(raw).trim();
+      if (!content) continue;
+      const slug = slugFromFilename(entry);
+      results.push({
+        filePath,
+        platform,
+        scope,
+        suggestedName: nameFromSlug(slug),
+        suggestedSlug: slug,
+        content
+      });
+    } catch {
+    }
+  }
+}
+function scanClaudeSkills(skillsDir, scope, results) {
+  if (!existsSync13(skillsDir)) return;
+  let entries;
+  try {
+    entries = readdirSync2(skillsDir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    const skillFile = join12(skillsDir, entry, "SKILL.md");
+    if (!existsSync13(skillFile)) continue;
+    try {
+      const raw = readFileSync5(skillFile, "utf-8");
+      const content = stripFrontmatter(raw).trim();
+      if (!content) continue;
+      results.push({
+        filePath: skillFile,
+        platform: "claude",
+        scope,
+        suggestedName: nameFromSlug(entry),
+        suggestedSlug: entry,
+        content
+      });
+    } catch {
+    }
+  }
+}
+function scanSingleFile(filePath, platform, scope, results) {
+  if (!existsSync13(filePath)) return;
+  let raw;
+  try {
+    raw = readFileSync5(filePath, "utf-8");
+  } catch {
+    return;
+  }
+  const sections = listSections(filePath);
+  if (sections.length > 0) {
+    for (const slug2 of sections) {
+      const startMarker = `<!-- localskills:start:${slug2} -->`;
+      const endMarker = `<!-- localskills:end:${slug2} -->`;
+      const startIdx = raw.indexOf(startMarker);
+      const endIdx = raw.indexOf(endMarker);
+      if (startIdx === -1 || endIdx === -1) continue;
+      const content2 = raw.slice(startIdx + startMarker.length, endIdx).trim();
+      if (!content2) continue;
+      results.push({
+        filePath,
+        platform,
+        scope,
+        suggestedName: nameFromSlug(slug2),
+        suggestedSlug: slug2,
+        content: content2
+      });
+    }
+    return;
+  }
+  const content = stripFrontmatter(raw).trim();
+  if (!content) return;
+  const slug = slugFromFilename(filePath);
+  results.push({
+    filePath,
+    platform,
+    scope,
+    suggestedName: nameFromSlug(slug),
+    suggestedSlug: slug,
+    content
+  });
+}
+
+// src/commands/publish.ts
+var publishCommand = new Command6("publish").description("Publish local skill files to localskills.sh").argument("[file]", "Path to a specific file to publish").option("-t, --team <id>", "Team ID to publish to").option("-n, --name <name>", "Skill name").option(
+  "--visibility <visibility>",
+  "Visibility: public, private, or unlisted",
+  "private"
+).option("-m, --message <message>", "Version message").action(
+  async (fileArg, opts) => {
+    const client = new ApiClient();
+    if (!client.isAuthenticated()) {
+      console.error("Not authenticated. Run `localskills login` first.");
+      process.exit(1);
+    }
+    const teamsRes = await client.get("/api/tenants");
+    if (!teamsRes.success || !teamsRes.data || teamsRes.data.length === 0) {
+      console.error(
+        "No teams found. Create a team at localskills.sh first."
+      );
+      process.exit(1);
+      return;
+    }
+    const teams = teamsRes.data;
+    if (fileArg) {
+      const filePath = resolve3(fileArg);
+      if (!existsSync14(filePath)) {
+        console.error(`File not found: ${filePath}`);
+        process.exit(1);
+        return;
+      }
+      const raw = readFileSync6(filePath, "utf-8");
+      const content = stripFrontmatter(raw).trim();
+      if (!content) {
+        console.error("File is empty after stripping frontmatter.");
+        process.exit(1);
+        return;
+      }
+      const defaultSlug = basename2(filePath, extname2(filePath));
+      const defaultName = defaultSlug.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+      const skillName = opts.name || defaultName;
+      const visibility = validateVisibility(opts.visibility || "private");
+      const tenantId = await resolveTeam(teams, opts.team);
+      await uploadSkill(client, {
+        name: skillName,
+        content,
+        tenantId,
+        visibility
+      });
+    } else {
+      We("localskills publish");
+      const spinner = bt2();
+      spinner.start("Scanning for skills...");
+      const config = loadConfig();
+      const allDetected = scanForSkills();
+      const detected = filterTracked(allDetected, config);
+      spinner.stop(
+        detected.length > 0 ? `Found ${detected.length} skill file${detected.length !== 1 ? "s" : ""}.` : "No unpublished skill files found."
+      );
+      if (detected.length === 0) {
+        Le("Nothing to publish.");
+        return;
+      }
+      const selected = await je({
+        message: "Select skills to publish",
+        options: detected.map((s) => ({
+          value: s,
+          label: s.suggestedName,
+          hint: `${s.platform}/${s.scope}  ${shortenPath(s.filePath)}`
+        })),
+        required: true
+      });
+      if (Ct(selected)) {
+        Ne("Cancelled.");
+        process.exit(0);
+      }
+      const skills = selected;
+      const tenantId = await resolveTeam(teams, opts.team);
+      for (const skill of skills) {
+        R2.step(`Publishing ${skill.suggestedName}...`);
+        const name = await Ze({
+          message: "Skill name?",
+          initialValue: skill.suggestedName,
+          validate: (v) => {
+            if (!v || v.length < 1) return "Name is required";
+            if (v.length > 100) return "Name must be 100 characters or less";
+          }
+        });
+        if (Ct(name)) {
+          Ne("Cancelled.");
+          process.exit(0);
+        }
+        const visibility = await Je({
+          message: "Visibility?",
+          options: [
+            { value: "private", label: "Private", hint: "Only team members" },
+            { value: "public", label: "Public", hint: "Anyone can install" },
+            { value: "unlisted", label: "Unlisted", hint: "Accessible via direct link" }
+          ],
+          initialValue: "private"
+        });
+        if (Ct(visibility)) {
+          Ne("Cancelled.");
+          process.exit(0);
+        }
+        await uploadSkill(client, {
+          name,
+          content: skill.content,
+          tenantId,
+          visibility
+        });
+      }
+      Le("Done!");
+    }
+  }
+);
+async function resolveTeam(teams, teamFlag) {
+  if (teamFlag) {
+    const match = teams.find((t) => t.id === teamFlag || t.slug === teamFlag);
+    if (!match) {
+      console.error(`Team not found: ${teamFlag}`);
+      process.exit(1);
+    }
+    return match.id;
+  }
+  if (teams.length === 1) {
+    return teams[0].id;
+  }
+  const selected = await Je({
+    message: "Which team?",
+    options: teams.map((t) => ({
+      value: t.id,
+      label: t.name,
+      hint: t.slug
+    }))
+  });
+  if (Ct(selected)) {
+    Ne("Cancelled.");
+    process.exit(0);
+  }
+  return selected;
+}
+async function uploadSkill(client, params) {
+  const spinner = bt2();
+  spinner.start(`Uploading ${params.name}...`);
+  const res = await client.post("/api/skills", {
+    name: params.name,
+    content: params.content,
+    tenantId: params.tenantId,
+    visibility: params.visibility
+  });
+  if (!res.success || !res.data) {
+    spinner.stop(`Failed: ${res.error || "Unknown error"}`);
+    return;
+  }
+  spinner.stop(`Published!`);
+  R2.success(`\u2192 localskills.sh/s/${res.data.slug}`);
+}
+function validateVisibility(value) {
+  if (value === "public" || value === "private" || value === "unlisted") {
+    return value;
+  }
+  console.error(`Invalid visibility: ${value}. Use public, private, or unlisted.`);
+  process.exit(1);
+}
+function shortenPath(filePath) {
+  const home = __require("os").homedir();
+  if (filePath.startsWith(home)) {
+    return "~" + filePath.slice(home.length);
+  }
+  const cwd = process.cwd();
+  if (filePath.startsWith(cwd)) {
+    return "." + filePath.slice(cwd.length);
+  }
+  return filePath;
+}
+
 // src/index.ts
-var program = new Command6();
+var program = new Command7();
 program.name("localskills").description("Install and manage agent skills from localskills.sh").version("0.1.0");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
@@ -2396,4 +2798,5 @@ program.addCommand(installCommand);
 program.addCommand(uninstallCommand);
 program.addCommand(listCommand);
 program.addCommand(pullCommand);
+program.addCommand(publishCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localskills/cli",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "CLI for localskills.sh — install agent skills locally",
   "type": "module",
   "bin": {