library-skills 0.0.10 → 0.0.12

package/README.md

@@ -49,11 +49,13 @@ $ npx library-skills
 
 This will scan the dependencies for the current project, find the installed libraries, and ask you which of their skills you want to install in the project.
 
-Then it will add them to the `.agents` directory as symbolic links, so when you update the libraries, the skills are updated too.
+Then it will ask where to install them and add them as symbolic links, so when you update the libraries, the skills are updated too.
+
+By default it selects `.agents/skills`, the agent-neutral target. If the project already has a `.claude/` directory, it selects `.claude/skills` too.
 
 /// tip
 
-If you are using Claude Code, add the `--claude` CLI Option to install the skills in the `.claude/skills` directory too, as Claude Code doesn't support the standard `.agents` directory.
+If you are using Claude Code, select `.claude/skills` when asked for installation targets, as Claude Code doesn't support the standard `.agents` directory. For non-interactive installs, add the `--claude` CLI option to install the skills in `.claude/skills` too.
 
 ///
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "library-skills",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "Library Skills, AI Agents using libraries, as intended, always up to date.",
   "type": "module",
   "exports": {

package/ts/dist/cli.d.ts

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+
+interface Skill {
+    name: string;
+    description: string;
+    path: string;
+    packageName: string;
+    skillDir: string;
+    packageVersion: string;
+}
+
+interface InstallTarget {
+    name: string;
+    path: string;
+}
+
+interface UvWorkspace {
+    root: string;
+    members: string[];
+    currentMember: string | null;
+}
+interface NodeWorkspace {
+    root: string;
+    members: string[];
+    currentMember: string | null;
+}
+
+interface ProjectContext {
+    cwd: string;
+    projectRoot: string;
+    targetEnvironment: string | null;
+    sitePackagesDir: string | null;
+    nodeModulesDir: string | null;
+    workspace: UvWorkspace | null;
+    nodeWorkspace: NodeWorkspace | null;
+    workspaceDependencyFiles: string[];
+    nodeWorkspaceDependencyFiles: string[];
+    dependencyFiles: string[];
+}
+interface InstalledStatus {
+    target: InstallTarget;
+    name: string;
+    type: "symlink" | "directory" | "missing";
+    path: string;
+    targetPath: string | null;
+    status: "up to date" | "broken" | "outdated" | "orphaned" | "name mismatch" | "hand-authored" | "new";
+    skill: Skill | null;
+}
+interface GlobalOptions {
+    claude?: boolean;
+    yes?: boolean;
+    check?: boolean;
+    all?: boolean;
+    skill?: string[];
+}
+interface ListOptions {
+    installed?: boolean;
+    json?: boolean;
+    claude?: boolean;
+    all?: boolean;
+}
+interface ScanOptions {
+    all?: boolean;
+    json?: boolean;
+}
+declare function getProjectContext(cwd?: string): ProjectContext;
+declare function topLevelSkills({ context, skills, includeAll, }: {
+    context: ProjectContext;
+    skills: Skill[];
+    includeAll: boolean;
+}): Skill[];
+declare function displayPath(path: string | null | undefined, projectRoot: string): string;
+declare function printTable(columns: string[], rows: Array<Record<string, string>>): void;
+declare function findCollisions(skills: Skill[]): Set<string>;
+declare function filterInstallableSkills({ skills, selectedNames, includeAll, }: {
+    skills: Skill[];
+    selectedNames: string[];
+    includeAll: boolean;
+}): Skill[];
+declare function installedStatuses({ targets, skills, }: {
+    targets: InstallTarget[];
+    skills: Skill[];
+}): InstalledStatus[];
+declare function installSelected({ skills, targets, projectRoot, copy, }: {
+    skills: Skill[];
+    targets: InstallTarget[];
+    projectRoot: string;
+    copy?: boolean;
+}): number;
+declare function sync(options: GlobalOptions): Promise<void>;
+declare function scanCommand(options: ScanOptions): void;
+declare function listCommand(options: ListOptions): void;
+declare function createProgram(): Command;
+declare function main(argv?: string[]): Promise<void>;
+declare const testing: {
+    filterInstallableSkills: typeof filterInstallableSkills;
+    findCollisions: typeof findCollisions;
+    getProjectContext: typeof getProjectContext;
+    installSelected: typeof installSelected;
+    installedStatuses: typeof installedStatuses;
+    listCommand: typeof listCommand;
+    scanCommand: typeof scanCommand;
+    sync: typeof sync;
+    topLevelSkills: typeof topLevelSkills;
+    displayPath: typeof displayPath;
+    printTable: typeof printTable;
+};
+
+export { createProgram, main, testing };

package/ts/dist/cli.js

@@ -522,6 +522,28 @@ function getNodeTopLevelDeps(projectRoot) {
   if (!existsSync2(packageJson)) {
     return null;
   }
+  return getNodeTopLevelDepsFromFiles([packageJson]);
+}
+function getNodeTopLevelDepsFromFiles(packageJsonFiles) {
+  if (packageJsonFiles.length === 0) {
+    return null;
+  }
+  const deps = /* @__PURE__ */ new Set();
+  let found = false;
+  for (const packageJson of packageJsonFiles) {
+    if (!existsSync2(packageJson)) {
+      continue;
+    }
+    const data = readPackageJson(packageJson);
+    if (data === null) {
+      return null;
+    }
+    found = true;
+    extractNodeTopLevelDeps(data, deps);
+  }
+  return found ? deps : null;
+}
+function readPackageJson(packageJson) {
   let data;
   try {
     data = JSON.parse(readFileSync2(packageJson, "utf8"));
@@ -529,9 +551,11 @@ function getNodeTopLevelDeps(projectRoot) {
     return null;
   }
   if (!isRecord2(data)) {
-    return /* @__PURE__ */ new Set();
+    return {};
   }
-  const deps = /* @__PURE__ */ new Set();
+  return data;
+}
+function extractNodeTopLevelDeps(data, deps) {
   for (const field of [
     "dependencies",
     "devDependencies",
@@ -546,7 +570,6 @@ function getNodeTopLevelDeps(projectRoot) {
       deps.add(normalizePackageName(packageName));
     }
   }
-  return deps;
 }
 function getTopLevelDeps(projectRoot) {
   const dependencySets = [
@@ -561,6 +584,9 @@ function getTopLevelDeps(projectRoot) {
 function getWorkspaceTopLevelDeps(pyprojects) {
   return getPythonTopLevelDepsFromFiles(pyprojects);
 }
+function getNodeWorkspaceTopLevelDeps(packageJsonFiles) {
+  return getNodeTopLevelDepsFromFiles(packageJsonFiles);
+}
 function extractDepsFromSpecs(depSpecs, deps) {
   for (const depSpec of depSpecs) {
     if (typeof depSpec !== "string") {
@@ -634,6 +660,26 @@ function getTargetDirs(projectRoot, options = {}) {
   }
   return targets;
 }
+function getAllTargetDirs(projectRoot) {
+  return getTargetDirs(projectRoot, { includeClaude: true });
+}
+function getDefaultInstallTargetDirs(projectRoot) {
+  const [universal, claude] = getAllTargetDirs(projectRoot);
+  const selected = [];
+  if (existsSync3(join3(projectRoot, ".agents"))) {
+    selected.push(universal);
+  }
+  if (existsSync3(join3(projectRoot, ".claude"))) {
+    selected.push(claude);
+  }
+  return selected.length > 0 ? selected : [universal];
+}
+function getExistingTargetDirs(projectRoot, options = {}) {
+  if (options.includeClaude) {
+    return getTargetDirs(projectRoot, { includeClaude: true });
+  }
+  return getAllTargetDirs(projectRoot).filter((target) => isDirectory2(target.path));
+}
 function installSkill(skill, targetDir, options = {}) {
   const dest = join3(targetDir, skill.name);
   const source = resolve2(skill.skillDir);
@@ -736,6 +782,26 @@ function findUvWorkspace(cwd) {
   }
   return null;
 }
+function findNodeWorkspace(cwd) {
+  for (const directory of ancestors(cwd)) {
+    const packageJson = `${directory}/package.json`;
+    if (!existsSync4(packageJson)) {
+      continue;
+    }
+    const data = readPackageJson2(packageJson);
+    const memberGlobs = getNodeWorkspaceGlobs(data);
+    if (memberGlobs === null) {
+      continue;
+    }
+    const members = findNodeWorkspaceMembers(directory, memberGlobs);
+    return {
+      root: directory,
+      members,
+      currentMember: findCurrentMember(cwd, members)
+    };
+  }
+  return null;
+}
 function workspaceDependencyFiles(workspace) {
   if (workspace.currentMember !== null) {
     return [`${workspace.currentMember}/pyproject.toml`];
@@ -745,6 +811,15 @@ function workspaceDependencyFiles(workspace) {
     ...workspace.members.map((member) => `${member}/pyproject.toml`)
   ].filter((path) => existsSync4(path));
 }
+function nodeWorkspaceDependencyFiles(workspace) {
+  if (workspace.currentMember !== null) {
+    return [`${workspace.currentMember}/package.json`];
+  }
+  return [
+    `${workspace.root}/package.json`,
+    ...workspace.members.map((member) => `${member}/package.json`)
+  ].filter((path) => existsSync4(path));
+}
 function readPyproject(path) {
   try {
     const data = parse3(readFileSync3(path, "utf8"));
@@ -753,6 +828,14 @@ function readPyproject(path) {
     return {};
   }
 }
+function readPackageJson2(path) {
+  try {
+    const data = JSON.parse(readFileSync3(path, "utf8"));
+    return isRecord3(data) ? data : {};
+  } catch {
+    return {};
+  }
+}
 function hasUvWorkspace(data) {
   const tool = data["tool"];
   if (!isRecord3(tool)) {
@@ -789,6 +872,36 @@ function findWorkspaceMembers(root, data) {
   }
   return [...members].sort();
 }
+function getNodeWorkspaceGlobs(data) {
+  const workspaces = data["workspaces"];
+  if (Array.isArray(workspaces)) {
+    return workspaces.filter((value) => typeof value === "string");
+  }
+  if (isRecord3(workspaces)) {
+    const packages = workspaces["packages"];
+    if (Array.isArray(packages)) {
+      return packages.filter((value) => typeof value === "string");
+    }
+  }
+  return null;
+}
+function findNodeWorkspaceMembers(root, memberGlobs) {
+  const includes = memberGlobs.filter((pattern) => !pattern.startsWith("!"));
+  const excludes = memberGlobs.filter((pattern) => pattern.startsWith("!")).map((pattern) => pattern.slice(1));
+  const members = /* @__PURE__ */ new Set();
+  for (const memberGlob of includes) {
+    for (const member of expandMemberGlob(root, memberGlob)) {
+      const relativePath = relative3(root, member).split(sep).join("/");
+      if (isExcluded(relativePath, excludes)) {
+        continue;
+      }
+      if (isFile(`${member}/package.json`)) {
+        members.add(resolve3(member));
+      }
+    }
+  }
+  return [...members].sort();
+}
 function getWorkspaceTable(data) {
   const tool = data["tool"];
   if (!isRecord3(tool)) {
@@ -896,6 +1009,10 @@ function findProjectRoot(cwd) {
   if (workspace !== null) {
     return workspace.root;
   }
+  const nodeWorkspace = findNodeWorkspace(cwd);
+  if (nodeWorkspace !== null) {
+    return nodeWorkspace.root;
+  }
   for (const directory of ancestors2(cwd)) {
     if (isFile2(join4(directory, "pyproject.toml")) || isFile2(join4(directory, "uv.lock")) || venvFromDotVenv(directory) !== null || isFile2(join4(directory, "package.json")) || isDirectory4(join4(directory, "node_modules"))) {
       return directory;
@@ -1023,7 +1140,10 @@ function isDirectory4(path) {
 // ts/src/cli.ts
 function getProjectContext(cwd = process.cwd()) {
   const workspace = findUvWorkspace(cwd);
-  const projectRoot = workspace?.root ?? findProjectRoot(cwd) ?? cwd;
+  const nodeWorkspace = findNodeWorkspace(cwd);
+  const projectRoot = workspace?.root ?? nodeWorkspace?.root ?? findProjectRoot(cwd) ?? cwd;
+  const workspaceFiles = workspace === null ? [] : workspaceDependencyFiles(workspace);
+  const nodeWorkspaceFiles = nodeWorkspace === null ? [] : nodeWorkspaceDependencyFiles(nodeWorkspace);
   const targetEnvironment = findVenv(cwd);
   const sitePackagesDir = targetEnvironment === null ? null : getSitePackagesDir(targetEnvironment);
   const nodeModulesDir = findNodeModules(cwd);
@@ -1034,7 +1154,10 @@ function getProjectContext(cwd = process.cwd()) {
     sitePackagesDir,
     nodeModulesDir,
     workspace,
-    dependencyFiles: workspace ? workspaceDependencyFiles(workspace) : []
+    nodeWorkspace,
+    workspaceDependencyFiles: workspaceFiles,
+    nodeWorkspaceDependencyFiles: nodeWorkspaceFiles,
+    dependencyFiles: [...workspaceFiles, ...nodeWorkspaceFiles]
   };
 }
 function scanContext(context) {
@@ -1077,8 +1200,8 @@ function topLevelSkills({
     return skills;
   }
   const topLevelDeps = getTopLevelDeps(context.projectRoot);
-  const workspaceTopLevelDeps = context.workspace === null ? null : getWorkspaceTopLevelDeps(context.dependencyFiles);
-  const selectedTopLevelDeps = context.workspace === null ? topLevelDeps : workspaceTopLevelDeps;
+  const workspaceTopLevelDeps = getWorkspaceTopLevelDepsForContext(context);
+  const selectedTopLevelDeps = context.workspace === null && context.nodeWorkspace === null ? topLevelDeps : workspaceTopLevelDeps;
   if (selectedTopLevelDeps === null) {
     return skills;
   }
@@ -1086,6 +1209,16 @@ function topLevelSkills({
     (skill) => selectedTopLevelDeps.has(normalizePackageName(skill.packageName))
   );
 }
+function getWorkspaceTopLevelDepsForContext(context) {
+  const dependencySets = [
+    context.workspace === null ? null : getWorkspaceTopLevelDeps(context.workspaceDependencyFiles),
+    context.nodeWorkspace === null ? null : getNodeWorkspaceTopLevelDeps(context.nodeWorkspaceDependencyFiles)
+  ].filter((deps) => deps !== null);
+  if (dependencySets.length === 0) {
+    return null;
+  }
+  return new Set(dependencySets.flatMap((deps) => [...deps]));
+}
 function printWarnings(warnings) {
   for (const warning of warnings) {
     console.log(`Warning: ${warning}`);
@@ -1111,6 +1244,11 @@ function printContext(context) {
     if (context.workspace.currentMember !== null) {
       console.log(`Workspace member: ${context.workspace.currentMember}`);
     }
+  } else if (context.nodeWorkspace !== null) {
+    console.log(`Workspace root: ${context.nodeWorkspace.root}`);
+    if (context.nodeWorkspace.currentMember !== null) {
+      console.log(`Workspace member: ${context.nodeWorkspace.currentMember}`);
+    }
   }
   console.log(
     `Target Python environment: ${context.targetEnvironment ? displayPath(context.targetEnvironment, context.projectRoot) : "not found"}`
@@ -1151,8 +1289,8 @@ function scanJsonPayload({
 }) {
   return {
     project_root: context.projectRoot,
-    workspace_root: context.workspace?.root ?? "",
-    workspace_member: context.workspace?.currentMember ?? "",
+    workspace_root: context.workspace?.root ?? context.nodeWorkspace?.root ?? "",
+    workspace_member: context.workspace?.currentMember ?? context.nodeWorkspace?.currentMember ?? "",
     dependency_files: context.dependencyFiles,
     target_environment: context.targetEnvironment ?? "",
     node_modules: context.nodeModulesDir ?? "",
@@ -1186,6 +1324,19 @@ function findCollisions(skills) {
     [...counts.entries()].filter(([, count]) => count > 1).map(([name]) => name)
   );
 }
+function deduplicateSkills(skills) {
+  const seen = /* @__PURE__ */ new Set();
+  const unique = [];
+  for (const skill of skills) {
+    const key = resolve5(skill.skillDir);
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    unique.push(skill);
+  }
+  return unique;
+}
 function filterInstallableSkills({
   skills,
   selectedNames,
@@ -1295,6 +1446,34 @@ async function selectSkillsInteractive(skills) {
     }))
   });
 }
+async function selectTargetsInteractive({
+  projectRoot,
+  defaultTargets
+}) {
+  const defaultNames = new Set(defaultTargets.map((target) => target.name));
+  return checkbox({
+    message: "Select installation targets (press Space to select, Enter to confirm):",
+    choices: getAllTargetDirs(projectRoot).map((target) => ({
+      name: displayPath(target.path, projectRoot),
+      value: target,
+      checked: defaultNames.has(target.name)
+    })),
+    validate: (selected) => selected.length > 0 || "Please select at least one installation target."
+  });
+}
+async function selectInstallTargets({
+  projectRoot,
+  includeClaude,
+  interactive
+}) {
+  if (!interactive) {
+    return getTargetDirs(projectRoot, { includeClaude });
+  }
+  return selectTargetsInteractive({
+    projectRoot,
+    defaultTargets: getDefaultInstallTargetDirs(projectRoot)
+  });
+}
 async function selectInstalledSkillsInteractive(statuses) {
   const removable = statuses.filter((status) => status.type === "symlink");
   if (removable.length === 0) {
@@ -1341,9 +1520,9 @@ function installSelected({
 async function sync(options) {
   const context = getProjectContext();
   const result = scanContext(context);
-  const targets = getTargetDirs(context.projectRoot, {
+  let targets = options.yes || options.check || options.claude ? getTargetDirs(context.projectRoot, {
     includeClaude: options.claude
-  });
+  }) : getDefaultInstallTargetDirs(context.projectRoot);
   printContext(context);
   console.log();
   printWarnings(result.warnings);
@@ -1394,10 +1573,19 @@ async function sync(options) {
   if (selected.length === 0 && !options.yes && selectedNames.length === 0 && !options.all) {
     const newSkills = visibleStatuses.filter((status) => status.status === "new" && status.skill !== null).map((status) => status.skill);
     if (newSkills.length > 0) {
-      selected = await selectSkillsInteractive(newSkills);
+      selected = await selectSkillsInteractive(deduplicateSkills(newSkills));
     }
   }
   if (selected.length > 0) {
+    targets = await selectInstallTargets({
+      projectRoot: context.projectRoot,
+      includeClaude: options.claude,
+      interactive: !options.yes && !options.claude
+    });
+    if (targets.length === 0) {
+      console.log("No installation targets selected.");
+      return;
+    }
     console.log();
     const installedCount = installSelected({
       skills: selected,
@@ -1438,7 +1626,7 @@ function listCommand(options) {
     skills: result.skills,
     includeAll: Boolean(options.all)
   });
-  const targets = getTargetDirs(context.projectRoot, {
+  const targets = getExistingTargetDirs(context.projectRoot, {
     includeClaude: options.claude
   });
   const statuses = installedStatuses({ targets, skills: result.skills });
@@ -1478,9 +1666,6 @@ async function installCommand(options) {
     skills: result.skills,
     includeAll: Boolean(options.all) || selectedNames.length > 0
   });
-  const targets = getTargetDirs(context.projectRoot, {
-    includeClaude: options.claude
-  });
   printWarnings(result.warnings);
   let selected = filterInstallableSkills({
     skills,
@@ -1494,6 +1679,15 @@ async function installCommand(options) {
     console.log("No skills selected.");
     return;
   }
+  const targets = await selectInstallTargets({
+    projectRoot: context.projectRoot,
+    includeClaude: options.claude,
+    interactive: !options.yes && !options.claude
+  });
+  if (targets.length === 0) {
+    console.log("No installation targets selected.");
+    return;
+  }
   const installedCount = installSelected({
     skills: selected,
     targets,
@@ -1506,7 +1700,7 @@ async function installCommand(options) {
 async function removeCommand(skillNames, options) {
   const context = getProjectContext();
   const result = scanContext(context);
-  const targets = getTargetDirs(context.projectRoot, {
+  const targets = getExistingTargetDirs(context.projectRoot, {
     includeClaude: options.claude
   });
   const statuses = installedStatuses({ targets, skills: result.skills });

package/ts/dist/deps.cjs

@@ -21,6 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var deps_exports = {};
 __export(deps_exports, {
   getNodeTopLevelDeps: () => getNodeTopLevelDeps,
+  getNodeTopLevelDepsFromFiles: () => getNodeTopLevelDepsFromFiles,
+  getNodeWorkspaceTopLevelDeps: () => getNodeWorkspaceTopLevelDeps,
   getPythonTopLevelDeps: () => getPythonTopLevelDeps,
   getPythonTopLevelDepsFromFiles: () => getPythonTopLevelDepsFromFiles,
   getTopLevelDeps: () => getTopLevelDeps,
@@ -98,6 +100,28 @@ function getNodeTopLevelDeps(projectRoot) {
   if (!(0, import_node_fs2.existsSync)(packageJson)) {
     return null;
   }
+  return getNodeTopLevelDepsFromFiles([packageJson]);
+}
+function getNodeTopLevelDepsFromFiles(packageJsonFiles) {
+  if (packageJsonFiles.length === 0) {
+    return null;
+  }
+  const deps = /* @__PURE__ */ new Set();
+  let found = false;
+  for (const packageJson of packageJsonFiles) {
+    if (!(0, import_node_fs2.existsSync)(packageJson)) {
+      continue;
+    }
+    const data = readPackageJson(packageJson);
+    if (data === null) {
+      return null;
+    }
+    found = true;
+    extractNodeTopLevelDeps(data, deps);
+  }
+  return found ? deps : null;
+}
+function readPackageJson(packageJson) {
   let data;
   try {
     data = JSON.parse((0, import_node_fs2.readFileSync)(packageJson, "utf8"));
@@ -105,9 +129,11 @@ function getNodeTopLevelDeps(projectRoot) {
     return null;
   }
   if (!isRecord(data)) {
-    return /* @__PURE__ */ new Set();
+    return {};
   }
-  const deps = /* @__PURE__ */ new Set();
+  return data;
+}
+function extractNodeTopLevelDeps(data, deps) {
   for (const field of [
     "dependencies",
     "devDependencies",
@@ -122,7 +148,6 @@ function getNodeTopLevelDeps(projectRoot) {
       deps.add(normalizePackageName(packageName));
     }
   }
-  return deps;
 }
 function getTopLevelDeps(projectRoot) {
   const dependencySets = [
@@ -137,6 +162,9 @@ function getTopLevelDeps(projectRoot) {
 function getWorkspaceTopLevelDeps(pyprojects) {
   return getPythonTopLevelDepsFromFiles(pyprojects);
 }
+function getNodeWorkspaceTopLevelDeps(packageJsonFiles) {
+  return getNodeTopLevelDepsFromFiles(packageJsonFiles);
+}
 function extractDepsFromSpecs(depSpecs, deps) {
   for (const depSpec of depSpecs) {
     if (typeof depSpec !== "string") {
@@ -184,6 +212,8 @@ var testing = {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getNodeTopLevelDeps,
+  getNodeTopLevelDepsFromFiles,
+  getNodeWorkspaceTopLevelDeps,
   getPythonTopLevelDeps,
   getPythonTopLevelDepsFromFiles,
   getTopLevelDeps,

package/ts/dist/deps.d.cts

@@ -1,8 +1,10 @@
 declare function getPythonTopLevelDeps(projectRoot: string): Set<string> | null;
 declare function getPythonTopLevelDepsFromFiles(pyprojects: string[]): Set<string> | null;
 declare function getNodeTopLevelDeps(projectRoot: string): Set<string> | null;
+declare function getNodeTopLevelDepsFromFiles(packageJsonFiles: string[]): Set<string> | null;
 declare function getTopLevelDeps(projectRoot: string): Set<string> | null;
 declare function getWorkspaceTopLevelDeps(pyprojects: string[]): Set<string> | null;
+declare function getNodeWorkspaceTopLevelDeps(packageJsonFiles: string[]): Set<string> | null;
 declare function extractDepsFromSpecs(depSpecs: unknown[], deps: Set<string>): void;
 declare function extractDepsFromDependencyGroup(groupName: unknown, dependencyGroups: Record<string, unknown>, deps: Set<string>, visited: Set<unknown>): void;
 declare function isRecord(value: unknown): value is Record<string, unknown>;
@@ -12,4 +14,4 @@ declare const testing: {
     isRecord: typeof isRecord;
 };
 
-export { getNodeTopLevelDeps, getPythonTopLevelDeps, getPythonTopLevelDepsFromFiles, getTopLevelDeps, getWorkspaceTopLevelDeps, testing };
+export { getNodeTopLevelDeps, getNodeTopLevelDepsFromFiles, getNodeWorkspaceTopLevelDeps, getPythonTopLevelDeps, getPythonTopLevelDepsFromFiles, getTopLevelDeps, getWorkspaceTopLevelDeps, testing };

package/ts/dist/deps.d.ts

@@ -1,8 +1,10 @@
 declare function getPythonTopLevelDeps(projectRoot: string): Set<string> | null;
 declare function getPythonTopLevelDepsFromFiles(pyprojects: string[]): Set<string> | null;
 declare function getNodeTopLevelDeps(projectRoot: string): Set<string> | null;
+declare function getNodeTopLevelDepsFromFiles(packageJsonFiles: string[]): Set<string> | null;
 declare function getTopLevelDeps(projectRoot: string): Set<string> | null;
 declare function getWorkspaceTopLevelDeps(pyprojects: string[]): Set<string> | null;
+declare function getNodeWorkspaceTopLevelDeps(packageJsonFiles: string[]): Set<string> | null;
 declare function extractDepsFromSpecs(depSpecs: unknown[], deps: Set<string>): void;
 declare function extractDepsFromDependencyGroup(groupName: unknown, dependencyGroups: Record<string, unknown>, deps: Set<string>, visited: Set<unknown>): void;
 declare function isRecord(value: unknown): value is Record<string, unknown>;
@@ -12,4 +14,4 @@ declare const testing: {
     isRecord: typeof isRecord;
 };
 
-export { getNodeTopLevelDeps, getPythonTopLevelDeps, getPythonTopLevelDepsFromFiles, getTopLevelDeps, getWorkspaceTopLevelDeps, testing };
+export { getNodeTopLevelDeps, getNodeTopLevelDepsFromFiles, getNodeWorkspaceTopLevelDeps, getPythonTopLevelDeps, getPythonTopLevelDepsFromFiles, getTopLevelDeps, getWorkspaceTopLevelDeps, testing };

package/ts/dist/deps.js

@@ -62,6 +62,28 @@ function getNodeTopLevelDeps(projectRoot) {
   if (!existsSync(packageJson)) {
     return null;
   }
+  return getNodeTopLevelDepsFromFiles([packageJson]);
+}
+function getNodeTopLevelDepsFromFiles(packageJsonFiles) {
+  if (packageJsonFiles.length === 0) {
+    return null;
+  }
+  const deps = /* @__PURE__ */ new Set();
+  let found = false;
+  for (const packageJson of packageJsonFiles) {
+    if (!existsSync(packageJson)) {
+      continue;
+    }
+    const data = readPackageJson(packageJson);
+    if (data === null) {
+      return null;
+    }
+    found = true;
+    extractNodeTopLevelDeps(data, deps);
+  }
+  return found ? deps : null;
+}
+function readPackageJson(packageJson) {
   let data;
   try {
     data = JSON.parse(readFileSync(packageJson, "utf8"));
@@ -69,9 +91,11 @@ function getNodeTopLevelDeps(projectRoot) {
     return null;
   }
   if (!isRecord(data)) {
-    return /* @__PURE__ */ new Set();
+    return {};
   }
-  const deps = /* @__PURE__ */ new Set();
+  return data;
+}
+function extractNodeTopLevelDeps(data, deps) {
   for (const field of [
     "dependencies",
     "devDependencies",
@@ -86,7 +110,6 @@ function getNodeTopLevelDeps(projectRoot) {
       deps.add(normalizePackageName(packageName));
     }
   }
-  return deps;
 }
 function getTopLevelDeps(projectRoot) {
   const dependencySets = [
@@ -101,6 +124,9 @@ function getTopLevelDeps(projectRoot) {
 function getWorkspaceTopLevelDeps(pyprojects) {
   return getPythonTopLevelDepsFromFiles(pyprojects);
 }
+function getNodeWorkspaceTopLevelDeps(packageJsonFiles) {
+  return getNodeTopLevelDepsFromFiles(packageJsonFiles);
+}
 function extractDepsFromSpecs(depSpecs, deps) {
   for (const depSpec of depSpecs) {
     if (typeof depSpec !== "string") {
@@ -147,6 +173,8 @@ var testing = {
 };
 export {
   getNodeTopLevelDeps,
+  getNodeTopLevelDepsFromFiles,
+  getNodeWorkspaceTopLevelDeps,
   getPythonTopLevelDeps,
   getPythonTopLevelDepsFromFiles,
   getTopLevelDeps,

package/ts/dist/installer.cjs

@@ -23,6 +23,9 @@ __export(installer_exports, {
   CLAUDE_SKILLS_DIR: () => CLAUDE_SKILLS_DIR,
   InstallError: () => InstallError,
   UNIVERSAL_SKILLS_DIR: () => UNIVERSAL_SKILLS_DIR,
+  getAllTargetDirs: () => getAllTargetDirs,
+  getDefaultInstallTargetDirs: () => getDefaultInstallTargetDirs,
+  getExistingTargetDirs: () => getExistingTargetDirs,
   getTargetDirs: () => getTargetDirs,
   installSkill: () => installSkill,
   listInstalledSkills: () => listInstalledSkills,
@@ -52,6 +55,26 @@ function getTargetDirs(projectRoot, options = {}) {
   }
   return targets;
 }
+function getAllTargetDirs(projectRoot) {
+  return getTargetDirs(projectRoot, { includeClaude: true });
+}
+function getDefaultInstallTargetDirs(projectRoot) {
+  const [universal, claude] = getAllTargetDirs(projectRoot);
+  const selected = [];
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(projectRoot, ".agents"))) {
+    selected.push(universal);
+  }
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(projectRoot, ".claude"))) {
+    selected.push(claude);
+  }
+  return selected.length > 0 ? selected : [universal];
+}
+function getExistingTargetDirs(projectRoot, options = {}) {
+  if (options.includeClaude) {
+    return getTargetDirs(projectRoot, { includeClaude: true });
+  }
+  return getAllTargetDirs(projectRoot).filter((target) => isDirectory(target.path));
+}
 function installSkill(skill, targetDir, options = {}) {
   const dest = (0, import_node_path.join)(targetDir, skill.name);
   const source = (0, import_node_path.resolve)(skill.skillDir);
@@ -137,6 +160,9 @@ var testing = {
   CLAUDE_SKILLS_DIR,
   InstallError,
   UNIVERSAL_SKILLS_DIR,
+  getAllTargetDirs,
+  getDefaultInstallTargetDirs,
+  getExistingTargetDirs,
   getTargetDirs,
   installSkill,
   listInstalledSkills,

package/ts/dist/installer.d.cts

@@ -19,6 +19,11 @@ declare class InstallError extends Error {
 declare function getTargetDirs(projectRoot: string, options?: {
     includeClaude?: boolean;
 }): InstallTarget[];
+declare function getAllTargetDirs(projectRoot: string): InstallTarget[];
+declare function getDefaultInstallTargetDirs(projectRoot: string): InstallTarget[];
+declare function getExistingTargetDirs(projectRoot: string, options?: {
+    includeClaude?: boolean;
+}): InstallTarget[];
 declare function installSkill(skill: Skill, targetDir: string, options?: {
     copy?: boolean;
 }): string;
@@ -38,4 +43,4 @@ declare const testing: {
     resolveSymlink: typeof resolveSymlink;
 };
 
-export { CLAUDE_SKILLS_DIR, InstallError, type InstallTarget, type InstalledSkill, UNIVERSAL_SKILLS_DIR, getTargetDirs, installSkill, listInstalledSkills, testing, uninstallSkill };
+export { CLAUDE_SKILLS_DIR, InstallError, type InstallTarget, type InstalledSkill, UNIVERSAL_SKILLS_DIR, getAllTargetDirs, getDefaultInstallTargetDirs, getExistingTargetDirs, getTargetDirs, installSkill, listInstalledSkills, testing, uninstallSkill };

package/ts/dist/installer.d.ts

@@ -19,6 +19,11 @@ declare class InstallError extends Error {
 declare function getTargetDirs(projectRoot: string, options?: {
     includeClaude?: boolean;
 }): InstallTarget[];
+declare function getAllTargetDirs(projectRoot: string): InstallTarget[];
+declare function getDefaultInstallTargetDirs(projectRoot: string): InstallTarget[];
+declare function getExistingTargetDirs(projectRoot: string, options?: {
+    includeClaude?: boolean;
+}): InstallTarget[];
 declare function installSkill(skill: Skill, targetDir: string, options?: {
     copy?: boolean;
 }): string;
@@ -38,4 +43,4 @@ declare const testing: {
     resolveSymlink: typeof resolveSymlink;
 };
 
-export { CLAUDE_SKILLS_DIR, InstallError, type InstallTarget, type InstalledSkill, UNIVERSAL_SKILLS_DIR, getTargetDirs, installSkill, listInstalledSkills, testing, uninstallSkill };
+export { CLAUDE_SKILLS_DIR, InstallError, type InstallTarget, type InstalledSkill, UNIVERSAL_SKILLS_DIR, getAllTargetDirs, getDefaultInstallTargetDirs, getExistingTargetDirs, getTargetDirs, installSkill, listInstalledSkills, testing, uninstallSkill };

package/ts/dist/installer.js

@@ -31,6 +31,26 @@ function getTargetDirs(projectRoot, options = {}) {
   }
   return targets;
 }
+function getAllTargetDirs(projectRoot) {
+  return getTargetDirs(projectRoot, { includeClaude: true });
+}
+function getDefaultInstallTargetDirs(projectRoot) {
+  const [universal, claude] = getAllTargetDirs(projectRoot);
+  const selected = [];
+  if (existsSync(join(projectRoot, ".agents"))) {
+    selected.push(universal);
+  }
+  if (existsSync(join(projectRoot, ".claude"))) {
+    selected.push(claude);
+  }
+  return selected.length > 0 ? selected : [universal];
+}
+function getExistingTargetDirs(projectRoot, options = {}) {
+  if (options.includeClaude) {
+    return getTargetDirs(projectRoot, { includeClaude: true });
+  }
+  return getAllTargetDirs(projectRoot).filter((target) => isDirectory(target.path));
+}
 function installSkill(skill, targetDir, options = {}) {
   const dest = join(targetDir, skill.name);
   const source = resolve(skill.skillDir);
@@ -115,6 +135,9 @@ export {
   CLAUDE_SKILLS_DIR,
   InstallError,
   UNIVERSAL_SKILLS_DIR,
+  getAllTargetDirs,
+  getDefaultInstallTargetDirs,
+  getExistingTargetDirs,
   getTargetDirs,
   installSkill,
   listInstalledSkills,

package/ts/dist/python-env.cjs

@@ -53,6 +53,26 @@ function findUvWorkspace(cwd) {
   }
   return null;
 }
+function findNodeWorkspace(cwd) {
+  for (const directory of ancestors(cwd)) {
+    const packageJson = `${directory}/package.json`;
+    if (!(0, import_node_fs.existsSync)(packageJson)) {
+      continue;
+    }
+    const data = readPackageJson(packageJson);
+    const memberGlobs = getNodeWorkspaceGlobs(data);
+    if (memberGlobs === null) {
+      continue;
+    }
+    const members = findNodeWorkspaceMembers(directory, memberGlobs);
+    return {
+      root: directory,
+      members,
+      currentMember: findCurrentMember(cwd, members)
+    };
+  }
+  return null;
+}
 function readPyproject(path) {
   try {
     const data = (0, import_smol_toml.parse)((0, import_node_fs.readFileSync)(path, "utf8"));
@@ -61,6 +81,14 @@ function readPyproject(path) {
     return {};
   }
 }
+function readPackageJson(path) {
+  try {
+    const data = JSON.parse((0, import_node_fs.readFileSync)(path, "utf8"));
+    return isRecord(data) ? data : {};
+  } catch {
+    return {};
+  }
+}
 function hasUvWorkspace(data) {
   const tool = data["tool"];
   if (!isRecord(tool)) {
@@ -97,6 +125,36 @@ function findWorkspaceMembers(root, data) {
   }
   return [...members].sort();
 }
+function getNodeWorkspaceGlobs(data) {
+  const workspaces = data["workspaces"];
+  if (Array.isArray(workspaces)) {
+    return workspaces.filter((value) => typeof value === "string");
+  }
+  if (isRecord(workspaces)) {
+    const packages = workspaces["packages"];
+    if (Array.isArray(packages)) {
+      return packages.filter((value) => typeof value === "string");
+    }
+  }
+  return null;
+}
+function findNodeWorkspaceMembers(root, memberGlobs) {
+  const includes = memberGlobs.filter((pattern) => !pattern.startsWith("!"));
+  const excludes = memberGlobs.filter((pattern) => pattern.startsWith("!")).map((pattern) => pattern.slice(1));
+  const members = /* @__PURE__ */ new Set();
+  for (const memberGlob of includes) {
+    for (const member of expandMemberGlob(root, memberGlob)) {
+      const relativePath = (0, import_node_path.relative)(root, member).split(import_node_path.sep).join("/");
+      if (isExcluded(relativePath, excludes)) {
+        continue;
+      }
+      if (isFile(`${member}/package.json`)) {
+        members.add((0, import_node_path.resolve)(member));
+      }
+    }
+  }
+  return [...members].sort();
+}
 function getWorkspaceTable(data) {
   const tool = data["tool"];
   if (!isRecord(tool)) {
@@ -204,6 +262,10 @@ function findProjectRoot(cwd) {
   if (workspace !== null) {
     return workspace.root;
   }
+  const nodeWorkspace = findNodeWorkspace(cwd);
+  if (nodeWorkspace !== null) {
+    return nodeWorkspace.root;
+  }
   for (const directory of ancestors2(cwd)) {
     if (isFile2((0, import_node_path2.join)(directory, "pyproject.toml")) || isFile2((0, import_node_path2.join)(directory, "uv.lock")) || venvFromDotVenv(directory) !== null || isFile2((0, import_node_path2.join)(directory, "package.json")) || isDirectory2((0, import_node_path2.join)(directory, "node_modules"))) {
       return directory;

package/ts/dist/python-env.js

@@ -25,6 +25,26 @@ function findUvWorkspace(cwd) {
   }
   return null;
 }
+function findNodeWorkspace(cwd) {
+  for (const directory of ancestors(cwd)) {
+    const packageJson = `${directory}/package.json`;
+    if (!existsSync(packageJson)) {
+      continue;
+    }
+    const data = readPackageJson(packageJson);
+    const memberGlobs = getNodeWorkspaceGlobs(data);
+    if (memberGlobs === null) {
+      continue;
+    }
+    const members = findNodeWorkspaceMembers(directory, memberGlobs);
+    return {
+      root: directory,
+      members,
+      currentMember: findCurrentMember(cwd, members)
+    };
+  }
+  return null;
+}
 function readPyproject(path) {
   try {
     const data = parse(readFileSync(path, "utf8"));
@@ -33,6 +53,14 @@ function readPyproject(path) {
     return {};
   }
 }
+function readPackageJson(path) {
+  try {
+    const data = JSON.parse(readFileSync(path, "utf8"));
+    return isRecord(data) ? data : {};
+  } catch {
+    return {};
+  }
+}
 function hasUvWorkspace(data) {
   const tool = data["tool"];
   if (!isRecord(tool)) {
@@ -69,6 +97,36 @@ function findWorkspaceMembers(root, data) {
   }
   return [...members].sort();
 }
+function getNodeWorkspaceGlobs(data) {
+  const workspaces = data["workspaces"];
+  if (Array.isArray(workspaces)) {
+    return workspaces.filter((value) => typeof value === "string");
+  }
+  if (isRecord(workspaces)) {
+    const packages = workspaces["packages"];
+    if (Array.isArray(packages)) {
+      return packages.filter((value) => typeof value === "string");
+    }
+  }
+  return null;
+}
+function findNodeWorkspaceMembers(root, memberGlobs) {
+  const includes = memberGlobs.filter((pattern) => !pattern.startsWith("!"));
+  const excludes = memberGlobs.filter((pattern) => pattern.startsWith("!")).map((pattern) => pattern.slice(1));
+  const members = /* @__PURE__ */ new Set();
+  for (const memberGlob of includes) {
+    for (const member of expandMemberGlob(root, memberGlob)) {
+      const relativePath = relative(root, member).split(sep).join("/");
+      if (isExcluded(relativePath, excludes)) {
+        continue;
+      }
+      if (isFile(`${member}/package.json`)) {
+        members.add(resolve(member));
+      }
+    }
+  }
+  return [...members].sort();
+}
 function getWorkspaceTable(data) {
   const tool = data["tool"];
   if (!isRecord(tool)) {
@@ -176,6 +234,10 @@ function findProjectRoot(cwd) {
   if (workspace !== null) {
     return workspace.root;
   }
+  const nodeWorkspace = findNodeWorkspace(cwd);
+  if (nodeWorkspace !== null) {
+    return nodeWorkspace.root;
+  }
   for (const directory of ancestors2(cwd)) {
     if (isFile2(join(directory, "pyproject.toml")) || isFile2(join(directory, "uv.lock")) || venvFromDotVenv(directory) !== null || isFile2(join(directory, "package.json")) || isDirectory2(join(directory, "node_modules"))) {
       return directory;