bf-skills 1.0.0 → 1.0.2

package/dist/cli.mjs

@@ -41,6 +41,17 @@ function readFrontmatter(filePath) {
     return {};
   }
 }
+function shortTagline(raw) {
+  if (!raw) return "";
+  const flat = raw.replace(/\s+/g, " ").trim();
+  const periodIdx = flat.indexOf(". ");
+  const first = periodIdx > 0 ? flat.slice(0, periodIdx) : flat;
+  const text = first.replace(/^This\s+skill\s+should\s+be\s+used\s+when\s+the\s+user\s+(asks?\s+(to|about|for)\s+)?/i, "").replace(/^(Complete\s+(guide\s+for|reference\s+for|skill\s+for)?|Comprehensive\s+|Full-?(stack\s+|spectrum\s+|cycle\s+)?|Unified\s+|Expert\s+skill\s+(for|covering)\s+)/i, "").replace(/^(Use\s+(when|for|whenever)|Covers\s+|Trigger(s)?\s*(when|on)|Designed\s+to)\s+/i, "").replace(/\s+skill$/i, "").trim();
+  const result = text || first;
+  if (result.length <= 60) return result;
+  const cut = result.lastIndexOf(" ", 57);
+  return (cut > 15 ? result.slice(0, cut) : result.slice(0, 57)) + "\u2026";
+}
 function walkForSkills(dir, results) {
   if (!fs.existsSync(dir)) return;
   const entries = fs.readdirSync(dir, { withFileTypes: true });
@@ -51,7 +62,7 @@ function walkForSkills(dir, results) {
     if (fs.existsSync(skillMd)) {
       const fm = readFrontmatter(skillMd);
       const name = fm["name"] || entry.name;
-      const description = fm["description"] || "";
+      const description = shortTagline(fm["description"] || "");
       results.push({ name, description, dir: skillDir });
     }
   }
@@ -80,6 +91,7 @@ function copyDir(src, dest) {
   fs2.mkdirSync(dest, { recursive: true });
   const entries = fs2.readdirSync(src, { withFileTypes: true });
   for (const entry of entries) {
+    if (entry.name === ".git" || entry.name === ".DS_Store") continue;
     const srcPath = path2.join(src, entry.name);
     const destPath = path2.join(dest, entry.name);
     if (entry.isDirectory()) {
@@ -89,46 +101,70 @@ function copyDir(src, dest) {
     }
   }
 }
-function installSkill(skill, agent, global) {
-  const basePath = global ? agent.globalPath : path2.join(process.cwd(), agent.projectPath);
-  const destDir = path2.join(basePath, skill.name);
-  fs2.mkdirSync(basePath, { recursive: true });
-  if (fs2.existsSync(destDir)) {
-    fs2.rmSync(destDir, { recursive: true, force: true });
+function removePath(p4) {
+  if (fs2.existsSync(p4)) {
+    fs2.rmSync(p4, { recursive: true, force: true });
+  }
+}
+function installSkill(skillDir, skillName, agents, isGlobal) {
+  if (agents.length === 0) throw new Error("No install targets selected");
+  const resolvePath = (agent) => isGlobal ? path2.join(agent.globalPath, skillName) : path2.join(process.cwd(), agent.projectPath, skillName);
+  const primaryDest = resolvePath(agents[0]);
+  fs2.mkdirSync(path2.dirname(primaryDest), { recursive: true });
+  removePath(primaryDest);
+  copyDir(skillDir, primaryDest);
+  const installed = [primaryDest];
+  for (const agent of agents.slice(1)) {
+    const dest = resolvePath(agent);
+    fs2.mkdirSync(path2.dirname(dest), { recursive: true });
+    removePath(dest);
+    const rel = path2.relative(path2.dirname(dest), primaryDest);
+    fs2.symlinkSync(rel, dest);
+    installed.push(dest);
   }
-  copyDir(skill.dir, destDir);
-  return destDir;
+  return installed;
 }
-function removeSkill(name, agent, global) {
-  const basePath = global ? agent.globalPath : path2.join(process.cwd(), agent.projectPath);
-  const destDir = path2.join(basePath, name);
-  if (!fs2.existsSync(destDir)) return false;
-  fs2.rmSync(destDir, { recursive: true, force: true });
-  return true;
+function removeSkill(name, agents, isGlobal) {
+  const removed = [];
+  for (const agent of agents) {
+    const p4 = isGlobal ? path2.join(agent.globalPath, name) : path2.join(process.cwd(), agent.projectPath, name);
+    if (fs2.existsSync(p4)) {
+      fs2.rmSync(p4, { recursive: true, force: true });
+      removed.push(p4);
+    }
+  }
+  return removed;
 }
-function listInstalledSkills(agent, global) {
-  const basePath = global ? agent.globalPath : path2.join(process.cwd(), agent.projectPath);
+function listInstalledSkills(agent, isGlobal) {
+  const basePath = isGlobal ? agent.globalPath : path2.join(process.cwd(), agent.projectPath);
   if (!fs2.existsSync(basePath)) return [];
-  return fs2.readdirSync(basePath, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+  return fs2.readdirSync(basePath, { withFileTypes: true }).filter((e) => e.isDirectory() || e.isSymbolicLink()).map((e) => e.name);
 }
 
 // src/lib/agents.ts
 import os from "os";
 import path3 from "path";
 var AGENTS = [
+  {
+    id: "general",
+    label: ".agents/skills  (general agents)",
+    projectPath: ".agents/skills",
+    globalPath: path3.join(os.homedir(), ".agents", "skills")
+  },
   {
     id: "claude-code",
-    label: "Claude Code",
+    label: ".claude/skills  (Claude Code)",
     projectPath: ".claude/skills",
     globalPath: path3.join(os.homedir(), ".claude", "skills")
   },
   {
-    id: "general",
-    label: "General agents",
-    projectPath: ".agents/skills",
-    globalPath: path3.join(os.homedir(), ".agents", "skills")
+    id: "root",
+    label: "skills/  (root folder)",
+    projectPath: "skills",
+    globalPath: path3.join(os.homedir(), "skills")
   }
 ];
+var DEFAULT_AGENT_IDS = ["general", "claude-code"];
 function getAgentById(id) {
   return AGENTS.find((a) => a.id === id);
 }
@@ -187,6 +223,37 @@ async function runInstall(source, opts) {
     process.exit(1);
   }
   p.intro(`${pc.bold("bf-skills")}`);
+  let targetAgents;
+  if (opts.agent) {
+    if (opts.agent === "all") {
+      targetAgents = [...AGENTS];
+    } else {
+      const found = getAgentById(opts.agent);
+      if (!found) {
+        p.log.error(`Unknown agent "${opts.agent}". Use: general, claude-code, root, or all`);
+        process.exit(1);
+      }
+      targetAgents = [found];
+    }
+  } else if (opts.yes) {
+    targetAgents = AGENTS.filter((a) => DEFAULT_AGENT_IDS.includes(a.id));
+  } else {
+    const chosen = await p.multiselect({
+      message: "Install to:  (\u2191\u2193 move   Space toggle   Enter confirm)",
+      options: AGENTS.map((a) => ({
+        value: a.id,
+        label: a.label,
+        hint: opts.global ? a.globalPath : path4.join(process.cwd(), a.projectPath)
+      })),
+      initialValues: DEFAULT_AGENT_IDS,
+      required: true
+    });
+    if (p.isCancel(chosen)) {
+      p.cancel("Installation cancelled.");
+      process.exit(0);
+    }
+    targetAgents = AGENTS.filter((a) => chosen.includes(a.id));
+  }
   let repoPath;
   let tmpDir;
   const isLocal = !repoUrl.startsWith("http") && !repoUrl.startsWith("git@");
@@ -213,7 +280,6 @@ async function runInstall(source, opts) {
     cleanup(tmpDir);
     process.exit(1);
   }
-  p.log.info(`Found ${allSkills.length} skill${allSkills.length === 1 ? "" : "s"}`);
   let selectedSkills;
   if (opts.skills && opts.skills.length > 0) {
     selectedSkills = [];
@@ -225,17 +291,15 @@ async function runInstall(source, opts) {
         process.exit(1);
       }
       selectedSkills.push(match);
-      p.log.step(`Installing ${COLORS.blue}${match.name}${COLORS.reset}`);
     }
   } else if (opts.yes) {
     selectedSkills = allSkills;
   } else {
     const selected = await p.multiselect({
-      message: "Select skills to install  (space to toggle, enter to confirm)",
+      message: `Select skills  (${allSkills.length} available)`,
       options: allSkills.map((s) => ({
         value: s.name,
-        label: pc.bold(s.name.padEnd(30)) + pc.dim(s.description),
-        hint: s.description
+        label: pc.bold(s.name.padEnd(28)) + pc.dim(s.description)
       })),
       required: true
     });
@@ -246,53 +310,20 @@ async function runInstall(source, opts) {
     }
     selectedSkills = allSkills.filter((s) => selected.includes(s.name));
   }
-  let targetAgents;
-  if (opts.agent) {
-    if (opts.agent === "both") {
-      targetAgents = [...AGENTS];
-    } else {
-      const found = getAgentById(opts.agent);
-      if (!found) {
-        p.log.error(`Unknown agent "${opts.agent}". Use: claude-code, general, or both`);
-        cleanup(tmpDir);
-        process.exit(1);
-      }
-      targetAgents = [found];
-    }
-  } else if (opts.yes) {
-    targetAgents = [AGENTS[0]];
-  } else {
-    const agentChoice = await p.select({
-      message: "Install to:",
-      options: [
-        { value: "claude-code", label: `${pc.bold("Claude Code")}  ${pc.dim("(~/.claude/skills/)")}` },
-        { value: "general", label: `${pc.bold("General agents")}  ${pc.dim("(~/.agents/skills/)")}` },
-        { value: "both", label: `${pc.bold("Both")}` }
-      ]
-    });
-    if (p.isCancel(agentChoice)) {
-      p.cancel("Installation cancelled.");
-      cleanup(tmpDir);
-      process.exit(0);
-    }
-    targetAgents = agentChoice === "both" ? [...AGENTS] : [getAgentById(agentChoice)];
-  }
   const spinner2 = p.spinner();
   spinner2.start(`Installing ${selectedSkills.length} skill${selectedSkills.length === 1 ? "" : "s"}...`);
-  const installed = [];
+  const results = [];
   for (const skill of selectedSkills) {
-    for (const agent of targetAgents) {
-      const dest = installSkill(skill, agent, opts.global);
-      installed.push(`${skill.name}  \u2192  ${dest}`);
-    }
+    const paths = installSkill(skill.dir, skill.name, targetAgents, opts.global);
+    results.push(...paths.map(
+      (dest, i) => `${pc.bold(skill.name)}  \u2192  ${pc.dim(dest)}${i > 0 ? pc.dim(" (symlink)") : ""}`
+    ));
   }
   spinner2.stop(`Done \u2014 ${selectedSkills.length} skill${selectedSkills.length === 1 ? "" : "s"} installed`);
-  for (const line of installed) {
+  for (const line of results) {
     p.log.step(line);
   }
-  p.outro(
-    `${pc.dim("$ npx bf-skills list")}  ${pc.dim("$ npx bf-skills remove <name>")}`
-  );
+  p.outro(`${pc.dim("$ npx bf-skills list")}    ${pc.dim("$ npx bf-skills remove <name>")}`);
   cleanup(tmpDir);
   showFooter();
 }
@@ -311,11 +342,11 @@ function runList(opts) {
   let total = 0;
   for (const agent of AGENTS) {
     const skills = listInstalledSkills(agent, opts.global);
-    const pathLabel = opts.global ? agent.globalPath : `./${agent.projectPath}`;
+    const basePath = opts.global ? agent.globalPath : `./${agent.projectPath}`;
     if (skills.length === 0) {
-      p2.log.info(`${pc2.bold(agent.label)}  ${pc2.dim(pathLabel)}  \u2014 no skills installed`);
+      p2.log.info(`${pc2.bold(agent.label)}  ${pc2.dim(basePath)}  \u2014 no skills installed`);
     } else {
-      p2.log.step(`${pc2.bold(agent.label)}  ${pc2.dim(pathLabel)}`);
+      p2.log.step(`${pc2.bold(agent.label)}  ${pc2.dim(basePath)}`);
       for (const name of skills) {
         console.log(`    ${pc2.dim("\u2022")} ${name}`);
       }
@@ -332,19 +363,14 @@ import pc3 from "picocolors";
 function runRemove(name, opts) {
   showLogo();
   p3.intro(`${pc3.bold("bf-skills remove")}`);
-  let removed = false;
-  for (const agent of AGENTS) {
-    const didRemove = removeSkill(name, agent, opts.global);
-    if (didRemove) {
-      const pathLabel = opts.global ? agent.globalPath : `./${agent.projectPath}`;
-      p3.log.step(`Removed ${pc3.bold(name)} from ${pc3.dim(pathLabel)}`);
-      removed = true;
-    }
-  }
-  if (!removed) {
-    p3.log.error(`Skill "${name}" not found in any agent skills directory.`);
+  const removed = removeSkill(name, AGENTS, opts.global);
+  if (removed.length === 0) {
+    p3.log.error(`Skill "${name}" not found in any target directory.`);
     p3.outro("Nothing removed.");
   } else {
+    for (const p_ of removed) {
+      p3.log.step(`Removed ${pc3.bold(name)}  from  ${pc3.dim(p_)}`);
+    }
     p3.outro(`Done \u2014 ${pc3.bold(name)} removed`);
   }
   showFooter();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bf-skills",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "BF Skills installer — Building the Future of Business with AI",
   "type": "module",
   "engines": {