add-skill 1.0.15 → 1.0.17

package/README.md

@@ -3,7 +3,7 @@
 Install agent skills onto your coding agents from any git repository.
 
 <!-- agent-list:start -->
-Supports **Opencode**, **Claude Code**, **Codex**, **Cursor**, and [11 more](#available-agents).
+Supports **Opencode**, **Claude Code**, **Codex**, **Cursor**, and [10 more](#available-agents).
 <!-- agent-list:end -->
 
 ## Quick Start
@@ -95,7 +95,6 @@ Skills can be installed to any of these supported agents. Use `-g, --global` to
 | GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` |
 | Clawdbot | `skills/` | `~/.clawdbot/skills/` |
 | Droid | `.factory/skills/` | `~/.factory/skills/` |
-| Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` |
 | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
 <!-- available-agents:end -->
 

package/dist/index.js

@@ -5,12 +5,22 @@ import { program } from "commander";
 import * as p from "@clack/prompts";
 import chalk from "chalk";
 
-// src/git.ts
-import simpleGit from "simple-git";
-import { join, normalize, resolve, sep } from "path";
-import { mkdtemp, rm } from "fs/promises";
-import { tmpdir } from "os";
+// src/source-parser.ts
+import { isAbsolute, resolve } from "path";
+function isLocalPath(input) {
+  return isAbsolute(input) || input.startsWith("./") || input.startsWith("../") || input === "." || input === ".." || // Windows absolute paths like C:\ or D:\
+  /^[a-zA-Z]:[/\\]/.test(input);
+}
 function parseSource(input) {
+  if (isLocalPath(input)) {
+    const resolvedPath = resolve(input);
+    return {
+      type: "local",
+      url: resolvedPath,
+      // Store resolved path in url for consistency
+      localPath: resolvedPath
+    };
+  }
   const githubTreeMatch = input.match(
     /github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/
   );
@@ -52,7 +62,7 @@ function parseSource(input) {
     };
   }
   const shorthandMatch = input.match(/^([^/]+)\/([^/]+)(?:\/(.+))?$/);
-  if (shorthandMatch && !input.includes(":")) {
+  if (shorthandMatch && !input.includes(":") && !input.startsWith(".") && !input.startsWith("/")) {
     const [, owner, repo, subpath] = shorthandMatch;
     return {
       type: "github",
@@ -65,6 +75,12 @@ function parseSource(input) {
     url: input
   };
 }
+
+// src/git.ts
+import simpleGit from "simple-git";
+import { join, normalize, resolve as resolve2, sep } from "path";
+import { mkdtemp, rm } from "fs/promises";
+import { tmpdir } from "os";
 async function cloneRepo(url) {
   const tempDir = await mkdtemp(join(tmpdir(), "add-skill-"));
   const git = simpleGit();
@@ -72,8 +88,8 @@ async function cloneRepo(url) {
   return tempDir;
 }
 async function cleanupTempDir(dir) {
-  const normalizedDir = normalize(resolve(dir));
-  const normalizedTmpDir = normalize(resolve(tmpdir()));
+  const normalizedDir = normalize(resolve2(dir));
+  const normalizedTmpDir = normalize(resolve2(tmpdir()));
   if (!normalizedDir.startsWith(normalizedTmpDir + sep) && normalizedDir !== normalizedTmpDir) {
     throw new Error("Attempted to clean up directory outside of temp directory");
   }
@@ -193,7 +209,7 @@ function getSkillDisplayName(skill) {
 
 // src/installer.ts
 import { mkdir, cp, access, readdir as readdir2 } from "fs/promises";
-import { join as join4, basename as basename2, normalize as normalize2, resolve as resolve2, sep as sep2 } from "path";
+import { join as join4, basename as basename2, normalize as normalize2, resolve as resolve3, sep as sep2 } from "path";
 
 // src/agents.ts
 import { homedir } from "os";
@@ -352,8 +368,8 @@ function sanitizeName(name) {
   return sanitized;
 }
 function isPathSafe(basePath, targetPath) {
-  const normalizedBase = normalize2(resolve2(basePath));
-  const normalizedTarget = normalize2(resolve2(targetPath));
+  const normalizedBase = normalize2(resolve3(basePath));
+  const normalizedTarget = normalize2(resolve3(targetPath));
   return normalizedTarget.startsWith(normalizedBase + sep2) || normalizedTarget === normalizedBase;
 }
 async function installSkillForAgent(skill, agentType, options = {}) {
@@ -468,7 +484,7 @@ function track(data) {
 // package.json
 var package_default = {
   name: "add-skill",
-  version: "1.0.15",
+  version: "1.0.17",
   description: "Install agent skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)",
   type: "module",
   bin: {
@@ -527,7 +543,7 @@ var package_default = {
 // src/index.ts
 var version = package_default.version;
 setVersion(version);
-program.name("add-skill").description("Install skills onto coding agents (OpenCode, Claude Code, Codex, Cursor, Antigravity, Github Copilot, Roo Code)").version(version).argument("<source>", "Git repo URL, GitHub shorthand (owner/repo), or direct path to skill").option("-g, --global", "Install skill globally (user-level) instead of project-level").option("-a, --agent <agents...>", "Specify agents to install to (opencode, claude-code, codex, cursor, antigravity, gitub-copilot, roo)").option("-s, --skill <skills...>", "Specify skill names to install (skip selection prompt)").option("-l, --list", "List available skills in the repository without installing").option("-y, --yes", "Skip confirmation prompts").configureOutput({
+program.name("add-skill").description("Install skills onto coding agents (OpenCode, Claude Code, Codex, Cursor, Antigravity, Github Copilot, Roo Code)").version(version).argument("<source>", "Git repo URL, GitHub shorthand (owner/repo), local path (./path), or direct path to skill").option("-g, --global", "Install skill globally (user-level) instead of project-level").option("-a, --agent <agents...>", "Specify agents to install to (opencode, claude-code, codex, cursor, antigravity, gitub-copilot, roo)").option("-s, --skill <skills...>", "Specify skill names to install (skip selection prompt)").option("-l, --list", "List available skills in the repository without installing").option("-y, --yes", "Skip confirmation prompts").configureOutput({
   outputError: (str, write) => {
     if (str.includes("missing required argument")) {
       console.log();
@@ -557,12 +573,26 @@ async function main(source, options) {
     const spinner2 = p.spinner();
     spinner2.start("Parsing source...");
     const parsed = parseSource(source);
-    spinner2.stop(`Source: ${chalk.cyan(parsed.url)}${parsed.subpath ? ` (${parsed.subpath})` : ""}`);
-    spinner2.start("Cloning repository...");
-    tempDir = await cloneRepo(parsed.url);
-    spinner2.stop("Repository cloned");
+    spinner2.stop(`Source: ${chalk.cyan(parsed.type === "local" ? parsed.localPath : parsed.url)}${parsed.subpath ? ` (${parsed.subpath})` : ""}`);
+    let skillsDir;
+    if (parsed.type === "local") {
+      spinner2.start("Validating local path...");
+      const { existsSync: existsSync2 } = await import("fs");
+      if (!existsSync2(parsed.localPath)) {
+        spinner2.stop(chalk.red("Path not found"));
+        p.outro(chalk.red(`Local path does not exist: ${parsed.localPath}`));
+        process.exit(1);
+      }
+      skillsDir = parsed.localPath;
+      spinner2.stop("Local path validated");
+    } else {
+      spinner2.start("Cloning repository...");
+      tempDir = await cloneRepo(parsed.url);
+      skillsDir = tempDir;
+      spinner2.stop("Repository cloned");
+    }
     spinner2.start("Discovering skills...");
-    const skills = await discoverSkills(tempDir, parsed.subpath);
+    const skills = await discoverSkills(skillsDir, parsed.subpath);
     if (skills.length === 0) {
       spinner2.stop(chalk.red("No skills found"));
       p.outro(chalk.red("No valid skills found. Skills require a SKILL.md with name and description."));
@@ -653,7 +683,8 @@ async function main(source, options) {
           const selected = await p.multiselect({
             message: "Select agents to install skills to",
             options: allAgentChoices,
-            required: true
+            required: true,
+            initialValues: Object.keys(agents)
           });
           if (p.isCancel(selected)) {
             p.cancel("Installation cancelled");
@@ -706,18 +737,32 @@ async function main(source, options) {
       }
       installGlobally = scope;
     }
-    console.log();
-    p.log.step(chalk.bold("Installation Summary"));
+    const summaryLines = [];
+    const maxAgentLen = Math.max(...targetAgents.map((a) => agents[a].displayName.length));
+    const overwriteStatus = /* @__PURE__ */ new Map();
     for (const skill of selectedSkills) {
-      p.log.message(`  ${chalk.cyan(getSkillDisplayName(skill))}`);
+      const agentStatus = /* @__PURE__ */ new Map();
       for (const agent of targetAgents) {
-        const path = getInstallPath(skill.name, agent, { global: installGlobally });
-        const installed = await isSkillInstalled(skill.name, agent, { global: installGlobally });
-        const status = installed ? chalk.yellow(" (will overwrite)") : "";
-        p.log.message(`    ${chalk.dim("\u2192")} ${agents[agent].displayName}: ${chalk.dim(path)}${status}`);
+        agentStatus.set(agent, await isSkillInstalled(skill.name, agent, { global: installGlobally }));
+      }
+      overwriteStatus.set(skill.name, agentStatus);
+    }
+    for (const skill of selectedSkills) {
+      if (summaryLines.length > 0) summaryLines.push("");
+      summaryLines.push(chalk.bold.cyan(getSkillDisplayName(skill)));
+      summaryLines.push("");
+      summaryLines.push(`  ${chalk.bold("Agent".padEnd(maxAgentLen + 2))}${chalk.bold("Directory")}`);
+      for (const agent of targetAgents) {
+        const fullPath = getInstallPath(skill.name, agent, { global: installGlobally });
+        const basePath = fullPath.replace(/\/[^/]+$/, "/");
+        const installed = overwriteStatus.get(skill.name)?.get(agent) ?? false;
+        const status = installed ? chalk.yellow(" (overwrite)") : "";
+        const agentName = agents[agent].displayName.padEnd(maxAgentLen + 2);
+        summaryLines.push(`  ${agentName}${chalk.dim(basePath)}${status}`);
       }
     }
     console.log();
+    p.note(summaryLines.join("\n"), "Installation Summary");
     if (!options.yes) {
       const confirmed = await p.confirm({ message: "Proceed with installation?" });
       if (p.isCancel(confirmed) || !confirmed) {
@@ -744,8 +789,15 @@ async function main(source, options) {
     const failed = results.filter((r) => !r.success);
     const skillFiles = {};
     for (const skill of selectedSkills) {
-      const relativePath = skill.path.replace(tempDir + "/", "");
-      skillFiles[skill.name] = relativePath + "/SKILL.md";
+      let relativePath;
+      if (tempDir && skill.path === tempDir) {
+        relativePath = "SKILL.md";
+      } else if (tempDir && skill.path.startsWith(tempDir + "/")) {
+        relativePath = skill.path.slice(tempDir.length + 1) + "/SKILL.md";
+      } else {
+        relativePath = skill.name + "/SKILL.md";
+      }
+      skillFiles[skill.name] = relativePath;
     }
     track({
       event: "install",
@@ -758,16 +810,25 @@ async function main(source, options) {
     if (successful.length > 0) {
       const bySkill = /* @__PURE__ */ new Map();
       for (const r of successful) {
-        const agents2 = bySkill.get(r.skill) || [];
-        agents2.push(r.agent);
-        bySkill.set(r.skill, agents2);
+        const skillAgents = bySkill.get(r.skill) || [];
+        skillAgents.push(r.agent);
+        bySkill.set(r.skill, skillAgents);
       }
       const skillCount = bySkill.size;
       const agentCount = new Set(successful.map((r) => r.agent)).size;
-      p.log.success(chalk.green(`Installed ${skillCount} skill${skillCount !== 1 ? "s" : ""} to ${agentCount} agent${agentCount !== 1 ? "s" : ""}`));
-      for (const [skill, agents2] of bySkill) {
-        p.log.message(`  ${chalk.green("\u2713")} ${skill} ${chalk.dim("\u2192")} ${chalk.dim(agents2.join(", "))}`);
+      const resultLines = [];
+      for (const [skill, skillAgents] of bySkill) {
+        resultLines.push(`${chalk.green("\u2713")} ${chalk.bold(skill)}`);
+        for (const agent of skillAgents) {
+          resultLines.push(`  ${chalk.dim(agent)}`);
+        }
+        resultLines.push("");
+      }
+      if (resultLines.length > 0 && resultLines[resultLines.length - 1] === "") {
+        resultLines.pop();
       }
+      const title = chalk.green(`Installed ${skillCount} skill${skillCount !== 1 ? "s" : ""} to ${agentCount} agent${agentCount !== 1 ? "s" : ""}`);
+      p.note(resultLines.join("\n"), title);
     }
     if (failed.length > 0) {
       console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-skill",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Install agent skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)",
   "type": "module",
   "bin": {