skilllib 1.7.0 → 1.11.0

package/dist/index.js

@@ -2,6 +2,7 @@
 import {
   add,
   agentSkill,
+  apply,
   doctor,
   error,
   folders,
@@ -27,22 +28,24 @@ import {
   unhide,
   update,
   usage
-} from "./chunk-AYAN7Q2X.js";
+} from "./chunk-LO4FMXDE.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
 var HELP = `
-skilllib \u2014 one library of agent skills (Claude Code, Cursor, Codex, Zed), installed per project
+skilllib \u2014 one library of agent skills (Claude Code, Cursor, Codex, Zed, Grok), installed per project
 
   skilllib                       Open the interactive app (run it from anywhere)
 
 Set up:
   skilllib scan [folder...]      Add folders that contain your projects and scan them
   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 harnesses [id...]     Show or set the agents you use (claude-code cursor codex zed grok)
   skilllib import <dir>...       Add skill folders to the library (--force replaces)
   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
+  skilllib global move <name>... --to <repo>...
+                                 Load global skills only in those repos (by path or project name)
 
 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
@@ -65,6 +68,7 @@ Library:
 
 Health:
   skilllib doctor [--fix]        Broken links, duplicates, out-of-date projects
+  skilllib apply <id> [choice]   Apply one issue's fix, or the choice you pick (number or label)
   skilllib restore [name]        Restore something skilllib moved out of the way
   skilllib unhide <path>         Show a hidden project again
 
@@ -73,7 +77,7 @@ Agents:
                                  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)
+                                 usage doctor apply add remove sync update import global move agent-skill)
 
 Options: --force (overwrite local edits)  --allow-tracked (link into git-tracked skill folders)  --days N
 `.trim();
@@ -92,10 +96,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-RU255WYX.js")).tui() : overview(args);
+      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-3LDZ5GOZ.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-RU255WYX.js")).tui();
+      return (await import("./tui-3LDZ5GOZ.js")).tui();
     case "status":
       return status(args);
     case "add":
@@ -144,6 +148,8 @@ async function main() {
       return restore(args);
     case "doctor":
       return doctor(args);
+    case "apply":
+      return apply(args);
     case "usage":
       return usage(args);
     case "agent-skill":

package/dist/json.d.cts

@@ -0,0 +1,222 @@
+type HarnessId = "claude-code" | "cursor" | "codex" | "zed" | "grok";
+
+type AgentSkillState = "installed" | "outdated" | "missing";
+
+/**
+ * Whether a skill folder is shared through git:
+ * - committed: tracked and unchanged, so teammates get it
+ * - changed:   tracked, with uncommitted edits or new files
+ * - new:       not tracked yet, but not ignored (shows in `git status`)
+ * - ignored:   matched by .gitignore, so it only exists on this machine
+ */
+type GitState = "committed" | "changed" | "new" | "ignored";
+
+type SkillState = "ok" | "update available" | "edited locally" | "edited locally, update available" | "folder missing" | "not in library" | "untracked copy of library skill" | "untracked, differs from library" | "local only" | "repo skill" | "repo skill, in library" | "repo skill, differs from library" | "from npx skills";
+type Change = {
+    name: string;
+    /** reset: back to the version it had; its local edits were overwritten (and backed up, see `backedUp`). */
+    action: "installed" | "updated" | "reset" | "removed" | "skipped";
+    reason?: string;
+    from?: number;
+    to?: number;
+    /** Harness folders a link couldn't be written to because git tracks them. */
+    blocked?: string[];
+    /** Harness folders git tracks, left without a link because git doesn't share the real copy (teammates would get a broken link). */
+    uncommitted?: string[];
+    /** Where overwritten local edits went (~/.skilllib/edit-backup/…); `skilllib restore` puts them back. */
+    backedUp?: string;
+};
+
+/**
+ * Where a skill Claude Code can load comes from.
+ * - global: a real folder in ~/.claude/skills (you, or a tool, copied it there)
+ * - skills.sh: a symlink into ~/.agents/skills, installed by `npx skills`
+ * - claude.ai: synced from your claude.ai account
+ * - plugin: shipped inside an enabled Claude Code plugin
+ * - built-in: bundled with an agent (Cursor's ~/.cursor/skills-cursor, Grok's ~/.grok/bundled/skills)
+ * - system: a machine-wide folder an admin manages (/etc/codex/skills)
+ * - skilllib: skilllib's own skill, which `skilllib agent-skill install` puts in your global folders
+ */
+type SourceKind = "global" | "skills.sh" | "claude.ai" | "plugin" | "built-in" | "system" | "skilllib";
+
+/**
+ * - library: added from your skills with skilllib (pinned in skilllib.json)
+ * - repo:    the team's: committed to git (any skill folder), or in .agents/skills
+ * - local:   only on this machine: not committed, not managed by skilllib
+ */
+type ProjectSource = "library" | "repo" | "local";
+/** The repo's own skills (or its subfolders') that share every attribute. */
+type StatusSkillGroup = {
+    source: ProjectSource;
+    skills: string[];
+    /** Folder with the real copy, when it isn't .claude/skills. */
+    dir?: string;
+    version?: number;
+    /** Only when it isn't "ok". */
+    state?: SkillState;
+    /** Newer library version, when there is one. */
+    latest?: number;
+    git?: GitState;
+    /** Only when some of your agents don't load it here. */
+    agents?: HarnessId[];
+};
+/** Global skills that come from the same place and load in the same agents. */
+type StatusGlobalGroup = {
+    source: SourceKind;
+    /** e.g. "railway@claude-plugins-official", "vercel-labs/agent-skills", "~/.claude/skills". */
+    from: string;
+    agents: HarnessId[];
+    skills: string[];
+};
+/**
+ * Problems skilllib found here or in your global skills that share a cause and remedy: a `fix` is a
+ * safe repair (`skilllib doctor --fix` runs it); `choices` need the user to decide.
+ * `skilllib apply <id> [choice]` applies either, one problem at a time.
+ */
+type StatusIssue = {
+    problems: string[];
+    /** One per problem, in the same order: what `skilllib apply` takes. */
+    ids: string[];
+    detail: string;
+    fix?: string;
+    choices?: string[];
+};
+/** `skilllib status --json`: everything your agents can use in this repo. */
+type StatusJson = {
+    project: string;
+    /** The repo's top-level files and folders (folders end in "/"), so an agent can read the right ones in one step. */
+    files: string[];
+    agents: HarnessId[];
+    skills: StatusSkillGroup[];
+    /** Skills in subfolders (monorepo packages), always with their `dir`: agents load them only when they work there. */
+    nested?: StatusSkillGroup[];
+    /** Skills that load in every repo, as this one loads them (its .claude/settings can turn a plugin on or off). */
+    global: StatusGlobalGroup[];
+    issues: StatusIssue[];
+    /** Claude Code uses in this repo per skill, when there were any. */
+    usesHere?: Record<string, number>;
+};
+/** `skilllib list --json`: your library; inside a repo, split into what it has and what it could add. */
+type ListJson = {
+    /** Library skills the current project already has (names only). */
+    inThisProject?: string[];
+    /** The rest, with what's needed to choose: description, and the projects that use it. */
+    skills: {
+        name: string;
+        description: string;
+        projects?: string[];
+    }[];
+};
+/** `skilllib show <name> --json` */
+type ShowJson = {
+    name: string;
+    description: string;
+    path: string;
+    /** Newest version in your library. */
+    latest: number | null;
+    /** Where it came from, e.g. a plugin or an `npx skills` repo; "" when unknown. */
+    origin: string;
+    /** Projects that have it in their skilllib.json. */
+    projects: string[];
+    /** The whole SKILL.md. */
+    skillMd: string;
+};
+/** `skilllib projects --json` */
+type ProjectsJson = {
+    name: string;
+    path: string;
+    skills: {
+        name: string;
+        managed: boolean;
+        state: SkillState;
+        version: number | null;
+        latest: number | null;
+    }[];
+}[];
+/** One skill that `add`, `remove`, `sync` or `update` changed or skipped. */
+type ChangeJson = Change & {
+    /** Where an installed, updated or reset skill now is: the real copy first, then its links. */
+    dirs?: string[];
+};
+/** `skilllib add|remove --json`, and `sync|update --json` without --all. */
+type ChangesJson = ChangeJson[];
+/** `skilllib sync|update --all --json`: the changes in each project. */
+type AllChangesJson = {
+    project: string;
+    path: string;
+    changes: ChangeJson[];
+}[];
+/** `skilllib outdated [--all] --json` */
+type OutdatedJson = {
+    project: string;
+    path: string;
+    skill: string;
+    installed: number;
+    latest: number;
+    state: SkillState;
+}[];
+/** `skilllib import <dir>... --json` */
+type ImportJson = {
+    path: string;
+    /** Missing when the folder has no SKILL.md. */
+    name?: string;
+    status: "added" | "updated" | "unchanged" | "exists" | "no SKILL.md";
+}[];
+/** `skilllib doctor [--fix] --json` */
+type DoctorJson = {
+    id: string;
+    severity: "problem" | "suggestion";
+    title: string;
+    detail: string;
+    /** A safe repair; `doctor --fix` runs it. */
+    fix?: string;
+    /** Fixes that need a decision: `skilllib apply <id> <n>` runs the nth (from 1). */
+    choices?: string[];
+    /** With --fix: what running `fix` did. */
+    fixed?: {
+        ok: boolean;
+        message: string;
+    };
+}[];
+/** `skilllib apply <issue-id> [choice] --json` */
+type ApplyJson = {
+    id: string;
+    applied: string;
+    ok: boolean;
+    message: string;
+};
+/** `skilllib global move <name>... --to <repo>... --json`: one entry per skill. */
+type GlobalMoveJson = {
+    skill: string;
+    /** Added to every repo and no longer global. When false, it still loads globally and `reason` says why. */
+    moved: boolean;
+    reason?: string;
+    projects: {
+        project: string;
+        path: string;
+        change: ChangeJson;
+    }[];
+}[];
+/** `skilllib usage [--days N] --json` */
+type UsageJson = {
+    usageDays: number;
+    source: "Claude Code transcripts";
+    skills: {
+        skill: string;
+        uses: number;
+        lastUsed: string;
+        projects: string[];
+        inLibrary: boolean;
+    }[];
+    unusedLibrarySkills: string[];
+};
+/** `skilllib agent-skill [install|remove] --json` */
+type AgentSkillJson = {
+    state: AgentSkillState;
+    /** Where it's installed (or would be). Not set after `remove`. */
+    dirs?: string[];
+    /** After `remove`: the folders it was removed from. */
+    removed?: string[];
+};
+
+export type { AgentSkillJson, AgentSkillState, AllChangesJson, ApplyJson, ChangeJson, ChangesJson, DoctorJson, GitState, GlobalMoveJson, HarnessId, ImportJson, ListJson, OutdatedJson, ProjectSource, ProjectsJson, ShowJson, SkillState, SourceKind, StatusGlobalGroup, StatusIssue, StatusJson, StatusSkillGroup, UsageJson };

package/dist/json.d.ts

@@ -0,0 +1,222 @@
+type HarnessId = "claude-code" | "cursor" | "codex" | "zed" | "grok";
+
+type AgentSkillState = "installed" | "outdated" | "missing";
+
+/**
+ * Whether a skill folder is shared through git:
+ * - committed: tracked and unchanged, so teammates get it
+ * - changed:   tracked, with uncommitted edits or new files
+ * - new:       not tracked yet, but not ignored (shows in `git status`)
+ * - ignored:   matched by .gitignore, so it only exists on this machine
+ */
+type GitState = "committed" | "changed" | "new" | "ignored";
+
+type SkillState = "ok" | "update available" | "edited locally" | "edited locally, update available" | "folder missing" | "not in library" | "untracked copy of library skill" | "untracked, differs from library" | "local only" | "repo skill" | "repo skill, in library" | "repo skill, differs from library" | "from npx skills";
+type Change = {
+    name: string;
+    /** reset: back to the version it had; its local edits were overwritten (and backed up, see `backedUp`). */
+    action: "installed" | "updated" | "reset" | "removed" | "skipped";
+    reason?: string;
+    from?: number;
+    to?: number;
+    /** Harness folders a link couldn't be written to because git tracks them. */
+    blocked?: string[];
+    /** Harness folders git tracks, left without a link because git doesn't share the real copy (teammates would get a broken link). */
+    uncommitted?: string[];
+    /** Where overwritten local edits went (~/.skilllib/edit-backup/…); `skilllib restore` puts them back. */
+    backedUp?: string;
+};
+
+/**
+ * Where a skill Claude Code can load comes from.
+ * - global: a real folder in ~/.claude/skills (you, or a tool, copied it there)
+ * - skills.sh: a symlink into ~/.agents/skills, installed by `npx skills`
+ * - claude.ai: synced from your claude.ai account
+ * - plugin: shipped inside an enabled Claude Code plugin
+ * - built-in: bundled with an agent (Cursor's ~/.cursor/skills-cursor, Grok's ~/.grok/bundled/skills)
+ * - system: a machine-wide folder an admin manages (/etc/codex/skills)
+ * - skilllib: skilllib's own skill, which `skilllib agent-skill install` puts in your global folders
+ */
+type SourceKind = "global" | "skills.sh" | "claude.ai" | "plugin" | "built-in" | "system" | "skilllib";
+
+/**
+ * - library: added from your skills with skilllib (pinned in skilllib.json)
+ * - repo:    the team's: committed to git (any skill folder), or in .agents/skills
+ * - local:   only on this machine: not committed, not managed by skilllib
+ */
+type ProjectSource = "library" | "repo" | "local";
+/** The repo's own skills (or its subfolders') that share every attribute. */
+type StatusSkillGroup = {
+    source: ProjectSource;
+    skills: string[];
+    /** Folder with the real copy, when it isn't .claude/skills. */
+    dir?: string;
+    version?: number;
+    /** Only when it isn't "ok". */
+    state?: SkillState;
+    /** Newer library version, when there is one. */
+    latest?: number;
+    git?: GitState;
+    /** Only when some of your agents don't load it here. */
+    agents?: HarnessId[];
+};
+/** Global skills that come from the same place and load in the same agents. */
+type StatusGlobalGroup = {
+    source: SourceKind;
+    /** e.g. "railway@claude-plugins-official", "vercel-labs/agent-skills", "~/.claude/skills". */
+    from: string;
+    agents: HarnessId[];
+    skills: string[];
+};
+/**
+ * Problems skilllib found here or in your global skills that share a cause and remedy: a `fix` is a
+ * safe repair (`skilllib doctor --fix` runs it); `choices` need the user to decide.
+ * `skilllib apply <id> [choice]` applies either, one problem at a time.
+ */
+type StatusIssue = {
+    problems: string[];
+    /** One per problem, in the same order: what `skilllib apply` takes. */
+    ids: string[];
+    detail: string;
+    fix?: string;
+    choices?: string[];
+};
+/** `skilllib status --json`: everything your agents can use in this repo. */
+type StatusJson = {
+    project: string;
+    /** The repo's top-level files and folders (folders end in "/"), so an agent can read the right ones in one step. */
+    files: string[];
+    agents: HarnessId[];
+    skills: StatusSkillGroup[];
+    /** Skills in subfolders (monorepo packages), always with their `dir`: agents load them only when they work there. */
+    nested?: StatusSkillGroup[];
+    /** Skills that load in every repo, as this one loads them (its .claude/settings can turn a plugin on or off). */
+    global: StatusGlobalGroup[];
+    issues: StatusIssue[];
+    /** Claude Code uses in this repo per skill, when there were any. */
+    usesHere?: Record<string, number>;
+};
+/** `skilllib list --json`: your library; inside a repo, split into what it has and what it could add. */
+type ListJson = {
+    /** Library skills the current project already has (names only). */
+    inThisProject?: string[];
+    /** The rest, with what's needed to choose: description, and the projects that use it. */
+    skills: {
+        name: string;
+        description: string;
+        projects?: string[];
+    }[];
+};
+/** `skilllib show <name> --json` */
+type ShowJson = {
+    name: string;
+    description: string;
+    path: string;
+    /** Newest version in your library. */
+    latest: number | null;
+    /** Where it came from, e.g. a plugin or an `npx skills` repo; "" when unknown. */
+    origin: string;
+    /** Projects that have it in their skilllib.json. */
+    projects: string[];
+    /** The whole SKILL.md. */
+    skillMd: string;
+};
+/** `skilllib projects --json` */
+type ProjectsJson = {
+    name: string;
+    path: string;
+    skills: {
+        name: string;
+        managed: boolean;
+        state: SkillState;
+        version: number | null;
+        latest: number | null;
+    }[];
+}[];
+/** One skill that `add`, `remove`, `sync` or `update` changed or skipped. */
+type ChangeJson = Change & {
+    /** Where an installed, updated or reset skill now is: the real copy first, then its links. */
+    dirs?: string[];
+};
+/** `skilllib add|remove --json`, and `sync|update --json` without --all. */
+type ChangesJson = ChangeJson[];
+/** `skilllib sync|update --all --json`: the changes in each project. */
+type AllChangesJson = {
+    project: string;
+    path: string;
+    changes: ChangeJson[];
+}[];
+/** `skilllib outdated [--all] --json` */
+type OutdatedJson = {
+    project: string;
+    path: string;
+    skill: string;
+    installed: number;
+    latest: number;
+    state: SkillState;
+}[];
+/** `skilllib import <dir>... --json` */
+type ImportJson = {
+    path: string;
+    /** Missing when the folder has no SKILL.md. */
+    name?: string;
+    status: "added" | "updated" | "unchanged" | "exists" | "no SKILL.md";
+}[];
+/** `skilllib doctor [--fix] --json` */
+type DoctorJson = {
+    id: string;
+    severity: "problem" | "suggestion";
+    title: string;
+    detail: string;
+    /** A safe repair; `doctor --fix` runs it. */
+    fix?: string;
+    /** Fixes that need a decision: `skilllib apply <id> <n>` runs the nth (from 1). */
+    choices?: string[];
+    /** With --fix: what running `fix` did. */
+    fixed?: {
+        ok: boolean;
+        message: string;
+    };
+}[];
+/** `skilllib apply <issue-id> [choice] --json` */
+type ApplyJson = {
+    id: string;
+    applied: string;
+    ok: boolean;
+    message: string;
+};
+/** `skilllib global move <name>... --to <repo>... --json`: one entry per skill. */
+type GlobalMoveJson = {
+    skill: string;
+    /** Added to every repo and no longer global. When false, it still loads globally and `reason` says why. */
+    moved: boolean;
+    reason?: string;
+    projects: {
+        project: string;
+        path: string;
+        change: ChangeJson;
+    }[];
+}[];
+/** `skilllib usage [--days N] --json` */
+type UsageJson = {
+    usageDays: number;
+    source: "Claude Code transcripts";
+    skills: {
+        skill: string;
+        uses: number;
+        lastUsed: string;
+        projects: string[];
+        inLibrary: boolean;
+    }[];
+    unusedLibrarySkills: string[];
+};
+/** `skilllib agent-skill [install|remove] --json` */
+type AgentSkillJson = {
+    state: AgentSkillState;
+    /** Where it's installed (or would be). Not set after `remove`. */
+    dirs?: string[];
+    /** After `remove`: the folders it was removed from. */
+    removed?: string[];
+};
+
+export type { AgentSkillJson, AgentSkillState, AllChangesJson, ApplyJson, ChangeJson, ChangesJson, DoctorJson, GitState, GlobalMoveJson, HarnessId, ImportJson, ListJson, OutdatedJson, ProjectSource, ProjectsJson, ShowJson, SkillState, SourceKind, StatusGlobalGroup, StatusIssue, StatusJson, StatusSkillGroup, UsageJson };