skilllib 1.3.1 → 1.7.0

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import {
   add,
+  agentSkill,
   doctor,
   error,
   folders,
@@ -11,11 +12,14 @@ import {
   list,
   newSkill,
   outdated,
+  overview,
   parseArgs,
   projects,
+  refreshAgentSkill,
   remove,
   restore,
   scan,
+  setJsonMode,
   show,
   status,
   sync,
@@ -23,7 +27,7 @@ import {
   unhide,
   update,
   usage
-} from "./chunk-TWQQHXVG.js";
+} from "./chunk-AYAN7Q2X.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
@@ -37,11 +41,11 @@ Set up:
   skilllib folders [add|remove]  Show or change your project folders
   skilllib harnesses [id...]     Show or set the agents you use (claude-code cursor codex zed)
   skilllib import <dir>...       Add skill folders to the library (--force replaces)
-  skilllib import --global       Copy ~/.claude/skills into the library
+  skilllib import --global       Copy your global skills (every agent's folder) into the library
   skilllib global [keep|unkeep <name>...]  Your global skills; mark ones you keep global on purpose
 
-In a project:
-  skilllib status                This project's skills and their status
+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
   skilllib remove <name>...      Remove skills from this project
   skilllib link [--all]          Make every skill here usable by all your agents (adds links)
@@ -64,6 +68,13 @@ Health:
   skilllib restore [name]        Restore something skilllib moved out of the way
   skilllib unhide <path>         Show a hidden project again
 
+Agents:
+  skilllib agent-skill [install|remove]
+                                 Teach your agents to use skilllib, so you can ask them
+                                 "which skills can you use here?" in any repo
+  --json                         Machine-readable output (status list show projects outdated
+                                 usage doctor add remove sync update import agent-skill)
+
 Options: --force (overwrite local edits)  --allow-tracked (link into git-tracked skill folders)  --days N
 `.trim();
 function packageVersion() {
@@ -77,11 +88,14 @@ function packageVersion() {
 async function main() {
   const [command, ...rest] = process.argv.slice(2);
   const args = parseArgs(rest);
+  setJsonMode(args.json);
+  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-H5IQAGAL.js")).tui() : status(args);
+      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-RU255WYX.js")).tui() : overview(args);
     case "ui":
-      return (await import("./tui-H5IQAGAL.js")).tui();
+      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-RU255WYX.js")).tui();
     case "status":
       return status(args);
     case "add":
@@ -107,7 +121,7 @@ async function main() {
     case "scan":
       return scan(args);
     case "projects":
-      return projects();
+      return projects(args);
     case "link":
       return link(args);
     case "tidy":
@@ -132,6 +146,8 @@ async function main() {
       return doctor(args);
     case "usage":
       return usage(args);
+    case "agent-skill":
+      return agentSkill(args);
     case "--version":
     case "-v":
     case "version":