skai 0.0.4 → 0.0.6

package/dist/index.js

@@ -446,7 +446,7 @@ function skillTreeToTreeNodes(node, parentPath = "") {
     result.push({
       id,
       label: s.name,
-      hint: s.skill.description,
+      hint: extractShortSummary(s.skill.description),
       skill: s.skill,
       selected: false
     });
@@ -475,6 +475,28 @@ function matchesSkillFilter(skill, filter) {
   }
   return skill.name.toLowerCase() === filterLower;
 }
+function extractShortSummary(description, maxLength = 50) {
+  if (!description) return "";
+  const triggers = [
+    "This skill should be used",
+    "Triggers on tasks",
+    "Use this skill when",
+    "Apply when"
+  ];
+  let summary = description;
+  for (const trigger of triggers) {
+    const index = summary.indexOf(trigger);
+    if (index > 0) {
+      summary = summary.slice(0, index).trim();
+      break;
+    }
+  }
+  summary = summary.replace(/[.,;:]+$/, "").trim();
+  if (summary.length > maxLength) {
+    summary = summary.slice(0, maxLength - 1).trim() + "\u2026";
+  }
+  return summary;
+}
 
 // src/agents.ts
 import * as fs4 from "fs";
@@ -651,6 +673,73 @@ function installSkillForAgent(skill, agent, options) {
     };
   }
 }
+function uninstallSkill(skillName, agent, options) {
+  const basePath = options.global ? agent.globalPath : path5.join(process.cwd(), agent.projectPath);
+  const sanitizedName = sanitizeName(skillName);
+  const targetPath = path5.join(basePath, sanitizedName);
+  if (!isPathSafe(targetPath, basePath)) {
+    return {
+      skillName,
+      agent,
+      success: false,
+      targetPath,
+      error: `Invalid skill name: ${skillName}`
+    };
+  }
+  if (fs5.existsSync(targetPath)) {
+    try {
+      fs5.rmSync(targetPath, { recursive: true, force: true });
+      return { skillName, agent, success: true, targetPath };
+    } catch (error) {
+      return {
+        skillName,
+        agent,
+        success: false,
+        targetPath,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+  return {
+    skillName,
+    agent,
+    success: false,
+    targetPath,
+    error: "Skill not found"
+  };
+}
+function listInstalledSkills(agent, options = {}) {
+  const skills = [];
+  const checkPath = (basePath, scope) => {
+    if (!fs5.existsSync(basePath)) return;
+    try {
+      const entries = fs5.readdirSync(basePath, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith(".")) {
+          skills.push({
+            name: entry.name,
+            path: path5.join(basePath, entry.name),
+            agent,
+            scope
+          });
+        }
+      }
+    } catch {
+    }
+  };
+  if (!options.global) {
+    const projectPath = path5.join(process.cwd(), agent.projectPath);
+    checkPath(projectPath, "project");
+  }
+  if (!options.projectOnly) {
+    checkPath(agent.globalPath, "global");
+  }
+  return skills;
+}
+function getSkillInstallPath(skillName, agent, options) {
+  const basePath = options.global ? agent.globalPath : path5.join(process.cwd(), agent.projectPath);
+  return path5.join(basePath, sanitizeName(skillName));
+}
 
 // src/tree-select.ts
 import * as p from "@clack/prompts";
@@ -976,34 +1065,7 @@ var S_BAR_END = import_picocolors.default.gray("\u2514");
 var S_CHECKBOX_ACTIVE = import_picocolors.default.cyan("\u25FB");
 var S_CHECKBOX_SELECTED = import_picocolors.default.green("\u25FC");
 var S_CHECKBOX_INACTIVE = import_picocolors.default.dim("\u25FB");
-var MAX_HINT_LENGTH = 60;
-function truncateHint(hint, maxLen) {
-  if (!hint) return "";
-  if (hint.length <= maxLen) return hint;
-  return hint.slice(0, maxLen - 1) + "\u2026";
-}
-function wrapText(text, maxWidth) {
-  if (!text) return [];
-  const words = text.split(/\s+/);
-  const lines = [];
-  let currentLine = "";
-  for (const word of words) {
-    if (currentLine.length === 0) {
-      currentLine = word;
-    } else if (currentLine.length + 1 + word.length <= maxWidth) {
-      currentLine += " " + word;
-    } else {
-      lines.push(currentLine);
-      currentLine = word;
-    }
-  }
-  if (currentLine) {
-    lines.push(currentLine);
-  }
-  return lines;
-}
-var DESCRIPTION_INDENT = "       ";
-var DESCRIPTION_MAX_WIDTH = 60;
+var MAX_LABEL_WIDTH = 30;
 function buildSearchableOptions(options) {
   return options.map((opt) => ({
     option: opt,
@@ -1191,21 +1253,11 @@ var SearchableMultiSelectPrompt = class extends x {
         } else {
           checkbox = S_CHECKBOX_INACTIVE;
         }
-        const label = this.searchTerm ? highlightMatch(opt.option.label, this.searchTerm) : opt.option.label;
-        const fullHint = opt.option.hint || "";
-        const needsTruncation = fullHint.length > MAX_HINT_LENGTH;
-        const displayHint = needsTruncation ? truncateHint(fullHint, MAX_HINT_LENGTH) : fullHint;
-        const hint = displayHint ? import_picocolors.default.dim(` (${displayHint})`) : "";
-        const line = isActive ? `${checkbox} ${label}${hint}` : `${checkbox} ${import_picocolors.default.dim(opt.option.label)}${import_picocolors.default.dim(hint)}`;
+        const hint = opt.option.hint || "";
+        const paddedLabel = opt.option.label.padEnd(MAX_LABEL_WIDTH);
+        const highlightedPaddedLabel = this.searchTerm ? highlightMatch(paddedLabel, this.searchTerm) : paddedLabel;
+        const line = isActive ? `${checkbox} ${highlightedPaddedLabel} ${import_picocolors.default.dim(hint)}` : `${checkbox} ${import_picocolors.default.dim(paddedLabel)} ${import_picocolors.default.dim(hint)}`;
         lines.push(`${import_picocolors.default.cyan(S_BAR)}  ${line}`);
-        if (isActive && needsTruncation) {
-          const wrappedLines = wrapText(fullHint, DESCRIPTION_MAX_WIDTH);
-          for (const descLine of wrappedLines) {
-            lines.push(
-              `${import_picocolors.default.cyan(S_BAR)}  ${DESCRIPTION_INDENT}${import_picocolors.default.dim(descLine)}`
-            );
-          }
-        }
       }
       if (belowCount > 0) {
         lines.push(
@@ -1454,24 +1506,13 @@ var SearchableGroupMultiSelectPrompt = class extends x {
           } else {
             checkbox = S_CHECKBOX_INACTIVE;
           }
-          const label = this.searchTerm ? highlightMatch(item.option.option.label, this.searchTerm) : item.option.option.label;
-          const fullHint = item.option.option.hint || "";
-          const needsTruncation = fullHint.length > MAX_HINT_LENGTH;
-          const displayHint = needsTruncation ? truncateHint(fullHint, MAX_HINT_LENGTH) : fullHint;
-          const hint = displayHint ? import_picocolors.default.dim(` (${displayHint})`) : "";
+          const hint = item.option.option.hint || "";
           const isLastInGroup = i + 1 >= visibleItems.length || visibleItems[i + 1].type === "group";
           const indent = isLastInGroup ? `${import_picocolors.default.gray("\u2514")} ` : `${import_picocolors.default.gray("\u2502")} `;
-          const line = isActive ? `${indent}${checkbox} ${label}${hint}` : `${indent}${checkbox} ${import_picocolors.default.dim(item.option.option.label)}${import_picocolors.default.dim(hint)}`;
+          const paddedLabel = item.option.option.label.padEnd(MAX_LABEL_WIDTH);
+          const highlightedPaddedLabel = this.searchTerm ? highlightMatch(paddedLabel, this.searchTerm) : paddedLabel;
+          const line = isActive ? `${indent}${checkbox} ${highlightedPaddedLabel} ${import_picocolors.default.dim(hint)}` : `${indent}${checkbox} ${import_picocolors.default.dim(paddedLabel)} ${import_picocolors.default.dim(hint)}`;
           lines.push(`${import_picocolors.default.cyan(S_BAR)}  ${line}`);
-          if (isActive && needsTruncation) {
-            const descIndent = isLastInGroup ? "  " : `${import_picocolors.default.gray("\u2502")} `;
-            const wrappedLines = wrapText(fullHint, DESCRIPTION_MAX_WIDTH);
-            for (const descLine of wrappedLines) {
-              lines.push(
-                `${import_picocolors.default.cyan(S_BAR)}  ${descIndent}${DESCRIPTION_INDENT}${import_picocolors.default.dim(descLine)}`
-              );
-            }
-          }
         }
       }
       if (belowCount > 0) {
@@ -1856,14 +1897,70 @@ function printSkillTree(node, indent = 0) {
     console.log(chalk.green(`\u2502 ${prefix}\u2022 ${s.name}`) + desc);
   }
 }
-async function main() {
-  const program = new Command();
-  program.name("skai").description("The package manager for AI agent skills").version(getVersion(), "-V, --version", "Display version").argument("[source]", "GitHub repo, URL, or local path to install skills from").option("-g, --global", "Install to user directory instead of project", false).option("-a, --agent <agents...>", "Target specific agents").option("-s, --skill <skills...>", "Install specific skills by name").option("-l, --list", "List available skills without installing", false).option("-y, --yes", "Skip confirmation prompts", false).option("--json", "Output results in JSON format", false).action(async (source, options) => {
-    await run(source, options);
-  });
-  await program.parseAsync(process.argv);
+function formatGitError(error, url) {
+  const msg = error.message.toLowerCase();
+  if (msg.includes("authentication") || msg.includes("401") || msg.includes("403")) {
+    return `Authentication failed for ${url}. Check your credentials or ensure the repository is public.`;
+  }
+  if (msg.includes("not found") || msg.includes("404") || msg.includes("does not exist")) {
+    return `Repository not found: ${url}. Check the URL or owner/repo name.`;
+  }
+  if (msg.includes("timeout") || msg.includes("timed out")) {
+    return `Connection timed out while cloning ${url}. Check your network connection.`;
+  }
+  if (msg.includes("could not resolve host") || msg.includes("network")) {
+    return `Network error while cloning ${url}. Check your internet connection.`;
+  }
+  if (msg.includes("permission denied")) {
+    return `Permission denied when accessing ${url}. The repository may be private.`;
+  }
+  return `Failed to clone repository: ${error.message}`;
+}
+function formatInstallStatus(statuses, isDryRun) {
+  if (statuses.length === 0) return;
+  const grouped = /* @__PURE__ */ new Map();
+  for (const status of statuses) {
+    const key = status.agentName;
+    if (!grouped.has(key)) grouped.set(key, []);
+    grouped.get(key).push(status);
+  }
+  for (const [agent, skills] of grouped) {
+    console.log(chalk.bold(`
+${agent}:`));
+    for (const skill of skills) {
+      let icon;
+      let color2;
+      let suffix = "";
+      switch (skill.status) {
+        case "installed":
+          icon = "\u2713";
+          color2 = chalk.green;
+          suffix = skill.path ? chalk.dim(` \u2192 ${skill.path}`) : "";
+          break;
+        case "would-install":
+          icon = "\u25CB";
+          color2 = chalk.cyan;
+          suffix = skill.path ? chalk.dim(` \u2192 ${skill.path}`) : "";
+          break;
+        case "skipped":
+          icon = "\u2013";
+          color2 = chalk.yellow;
+          suffix = skill.reason ? chalk.dim(` (${skill.reason})`) : "";
+          break;
+        case "failed":
+          icon = "\u2717";
+          color2 = chalk.red;
+          suffix = skill.reason ? chalk.dim(` (${skill.reason})`) : "";
+          break;
+      }
+      console.log(`  ${color2(icon)} ${skill.skillName}${suffix}`);
+    }
+  }
+  if (isDryRun) {
+    console.log(chalk.cyan("\n(dry-run mode - no changes made)"));
+  }
 }
-async function run(source, options) {
+async function runInstall(source, options) {
   let tempDirToClean = null;
   const handleSignal = () => {
     if (tempDirToClean) {
@@ -1881,6 +1978,7 @@ async function run(source, options) {
   if (!source) {
     clack.log.error("Please provide a source (GitHub repo, URL, or local path)");
     clack.log.info("Usage: skai <source> [options]");
+    clack.log.info("");
     clack.log.info("Examples:");
     clack.log.info("  skai pproenca/dot-skills");
     clack.log.info("  skai https://github.com/org/repo");
@@ -1898,6 +1996,9 @@ async function run(source, options) {
       if (!parsed.localPath) {
         throw new Error("Local path not found in parsed source");
       }
+      if (!fs7.existsSync(parsed.localPath)) {
+        throw new Error(`Local path does not exist: ${parsed.localPath}`);
+      }
       skillsBasePath = parsed.localPath;
       clack.log.info(`Using local path: ${skillsBasePath}`);
     } else {
@@ -1914,7 +2015,8 @@ async function run(source, options) {
         spinner2.stop("Repository cloned");
       } catch (error) {
         spinner2.stop("Failed to clone repository");
-        throw error;
+        const formattedError = formatGitError(error, parsed.url || source);
+        throw new Error(formattedError);
       }
     }
     const discoverSpinner = clack.spinner();
@@ -1923,6 +2025,7 @@ async function run(source, options) {
     discoverSpinner.stop(`Found ${skills.length} skill(s)`);
     if (skills.length === 0) {
       clack.log.warn("No skills found in the repository");
+      clack.log.info("Skills must have a SKILL.md file with frontmatter metadata.");
       clack.outro(chalk.yellow("No skills to install"));
       return;
     }
@@ -1956,12 +2059,24 @@ async function run(source, options) {
     }
     let targetAgents;
     if (options.agent && options.agent.length > 0) {
-      targetAgents = options.agent.map((name) => getAgentByName(name)).filter((a) => a !== void 0);
-      if (targetAgents.length === 0) {
-        clack.log.error(`No valid agents found for: ${options.agent.join(", ")}`);
+      const invalidAgents = [];
+      targetAgents = [];
+      for (const name of options.agent) {
+        const agent = getAgentByName(name);
+        if (agent) {
+          targetAgents.push(agent);
+        } else {
+          invalidAgents.push(name);
+        }
+      }
+      if (invalidAgents.length > 0) {
+        clack.log.warn(`Unknown agent(s): ${invalidAgents.join(", ")}`);
         clack.log.info(
           `Available agents: ${getAllAgents().map((a) => a.name).join(", ")}`
         );
+      }
+      if (targetAgents.length === 0) {
+        clack.log.error("No valid agents specified");
         clack.outro(chalk.red("No valid agents"));
         return;
       }
@@ -2053,6 +2168,44 @@ async function run(source, options) {
       }
       isGlobal = scope === "global";
     }
+    if (options.dryRun) {
+      const statuses2 = [];
+      const installOptions2 = { global: isGlobal, yes: options.yes };
+      for (const skill of selectedSkills) {
+        for (const agent of selectedAgents) {
+          const targetPath = getSkillInstallPath(skill.name, agent, installOptions2);
+          if (isSkillInstalled(skill, agent, installOptions2)) {
+            statuses2.push({
+              skillName: skill.name,
+              agentName: agent.displayName,
+              status: "skipped",
+              path: targetPath,
+              reason: "already installed"
+            });
+          } else {
+            statuses2.push({
+              skillName: skill.name,
+              agentName: agent.displayName,
+              status: "would-install",
+              path: targetPath
+            });
+          }
+        }
+      }
+      if (options.json) {
+        const jsonOutput = {
+          dry_run: true,
+          would_install: statuses2.filter((s) => s.status === "would-install").map((s) => ({ skill: s.skillName, agent: s.agentName, path: s.path })),
+          would_skip: statuses2.filter((s) => s.status === "skipped").map((s) => ({ skill: s.skillName, agent: s.agentName, reason: s.reason }))
+        };
+        console.log(JSON.stringify(jsonOutput, null, 2));
+        return;
+      }
+      clack.log.info(chalk.bold("\nDry Run - Installation Preview:"));
+      formatInstallStatus(statuses2, true);
+      clack.outro(chalk.cyan("Dry run complete"));
+      return;
+    }
     if (!options.yes) {
       const summary = [
         `Skills: ${selectedSkills.map((s) => s.name).join(", ")}`,
@@ -2079,20 +2232,41 @@ Installation Summary:
     };
     const installOptions = { global: isGlobal, yes: options.yes };
     const installedSkillNames = [];
+    const statuses = [];
     for (const skill of selectedSkills) {
       for (const agent of selectedAgents) {
+        const targetPath = getSkillInstallPath(skill.name, agent, installOptions);
         if (isSkillInstalled(skill, agent, installOptions)) {
           results.skipped++;
+          statuses.push({
+            skillName: skill.name,
+            agentName: agent.displayName,
+            status: "skipped",
+            path: targetPath,
+            reason: "already installed"
+          });
           continue;
         }
         const result = installSkillForAgent(skill, agent, installOptions);
         if (result.success) {
           results.success++;
+          statuses.push({
+            skillName: skill.name,
+            agentName: agent.displayName,
+            status: "installed",
+            path: result.targetPath
+          });
           if (!installedSkillNames.includes(skill.name)) {
             installedSkillNames.push(skill.name);
           }
         } else {
           results.failed++;
+          statuses.push({
+            skillName: skill.name,
+            agentName: agent.displayName,
+            status: "failed",
+            reason: result.error
+          });
           if (!options.json) {
             clack.log.warn(`Failed to install ${skill.name} to ${agent.displayName}: ${result.error}`);
           }
@@ -2100,6 +2274,9 @@ Installation Summary:
       }
     }
     installSpinner.stop(`Installed ${results.success} skill(s)`);
+    if (!options.json && statuses.length > 0) {
+      formatInstallStatus(statuses, false);
+    }
     const depSpinner = clack.spinner();
     depSpinner.start("Scanning for dependencies...");
     const skillDeps = [];
@@ -2251,6 +2428,220 @@ Installation Summary:
     }
   }
 }
+async function runUninstall(skillNames, options) {
+  clack.intro(chalk.cyan("skai uninstall"));
+  if (skillNames.length === 0) {
+    clack.log.error("Please provide at least one skill name to uninstall");
+    clack.log.info("Usage: skai uninstall <skill> [skill...] [-a <agent>]");
+    clack.outro(chalk.red("No skills specified"));
+    process.exit(EXIT_ERROR);
+  }
+  let targetAgents;
+  if (options.agent && options.agent.length > 0) {
+    targetAgents = options.agent.map((name) => getAgentByName(name)).filter((a) => a !== void 0);
+    if (targetAgents.length === 0) {
+      clack.log.error(`No valid agents found for: ${options.agent.join(", ")}`);
+      clack.log.info(
+        `Available agents: ${getAllAgents().map((a) => a.name).join(", ")}`
+      );
+      clack.outro(chalk.red("No valid agents"));
+      process.exit(EXIT_ERROR);
+    }
+  } else {
+    targetAgents = detectInstalledAgents();
+    if (targetAgents.length === 0) {
+      targetAgents = getAllAgents();
+    }
+  }
+  const toUninstall = [];
+  for (const skillName of skillNames) {
+    for (const agent of targetAgents) {
+      const projectInstalled = listInstalledSkills(agent, { projectOnly: true }).some((s) => s.name === skillName);
+      const globalInstalled = listInstalledSkills(agent, { global: true }).some((s) => s.name === skillName);
+      if (options.global && globalInstalled) {
+        toUninstall.push({ skill: skillName, agent, scope: "global" });
+      } else if (!options.global && projectInstalled) {
+        toUninstall.push({ skill: skillName, agent, scope: "project" });
+      } else if (!options.global && globalInstalled) {
+        toUninstall.push({ skill: skillName, agent, scope: "global" });
+      }
+    }
+  }
+  if (toUninstall.length === 0) {
+    clack.log.warn("No installed skills found matching the specified names");
+    clack.outro(chalk.yellow("Nothing to uninstall"));
+    return;
+  }
+  if (!options.yes) {
+    clack.log.info(chalk.bold("\nSkills to uninstall:"));
+    for (const item of toUninstall) {
+      clack.log.info(`  \u2022 ${item.skill} from ${item.agent.displayName} (${item.scope})`);
+    }
+    const confirmed = await clack.confirm({
+      message: `Uninstall ${toUninstall.length} skill(s)?`
+    });
+    if (clack.isCancel(confirmed) || !confirmed) {
+      clack.outro(chalk.yellow("Cancelled"));
+      return;
+    }
+  }
+  const results = { success: 0, failed: 0 };
+  const uninstalledSkills = [];
+  const errors = [];
+  for (const item of toUninstall) {
+    const installOptions = { global: item.scope === "global", yes: options.yes };
+    const result = uninstallSkill(item.skill, item.agent, installOptions);
+    if (result.success) {
+      results.success++;
+      if (!uninstalledSkills.includes(item.skill)) {
+        uninstalledSkills.push(item.skill);
+      }
+      if (!options.json) {
+        clack.log.info(chalk.green(`\u2713 Uninstalled ${item.skill} from ${item.agent.displayName}`));
+      }
+    } else {
+      results.failed++;
+      errors.push({ skill: item.skill, agent: item.agent.displayName, error: result.error || "Unknown error" });
+      if (!options.json) {
+        clack.log.warn(`\u2717 Failed to uninstall ${item.skill} from ${item.agent.displayName}: ${result.error}`);
+      }
+    }
+  }
+  if (options.json) {
+    const jsonOutput = {
+      skills_uninstalled: uninstalledSkills,
+      errors
+    };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return;
+  }
+  const resultParts = [];
+  if (results.success > 0) resultParts.push(chalk.green(`${results.success} uninstalled`));
+  if (results.failed > 0) resultParts.push(chalk.red(`${results.failed} failed`));
+  clack.outro(resultParts.join(", ") || chalk.green("Done"));
+}
+async function runList(options) {
+  if (!options.json) {
+    clack.intro(chalk.cyan("skai list"));
+  }
+  let targetAgents;
+  if (options.agent && options.agent.length > 0) {
+    targetAgents = options.agent.map((name) => getAgentByName(name)).filter((a) => a !== void 0);
+    if (targetAgents.length === 0 && !options.json) {
+      clack.log.error(`No valid agents found for: ${options.agent.join(", ")}`);
+      clack.log.info(
+        `Available agents: ${getAllAgents().map((a) => a.name).join(", ")}`
+      );
+      clack.outro(chalk.red("No valid agents"));
+      process.exit(EXIT_ERROR);
+    }
+  } else {
+    targetAgents = detectInstalledAgents();
+    if (targetAgents.length === 0) {
+      targetAgents = getAllAgents();
+    }
+  }
+  const allSkills = [];
+  const agentSkillsMap = /* @__PURE__ */ new Map();
+  for (const agent of targetAgents) {
+    const skills = listInstalledSkills(agent, { global: options.global });
+    const projectSkills = [];
+    const globalSkills = [];
+    for (const skill of skills) {
+      allSkills.push({
+        name: skill.name,
+        path: skill.path,
+        agent: agent.displayName,
+        scope: skill.scope
+      });
+      if (skill.scope === "project") {
+        projectSkills.push(skill.name);
+      } else {
+        globalSkills.push(skill.name);
+      }
+    }
+    if (projectSkills.length > 0 || globalSkills.length > 0) {
+      agentSkillsMap.set(agent.displayName, { project: projectSkills, global: globalSkills });
+    }
+  }
+  if (options.json) {
+    const jsonOutput = { skills: allSkills };
+    console.log(JSON.stringify(jsonOutput, null, 2));
+    return;
+  }
+  if (allSkills.length === 0) {
+    clack.log.info("No skills installed");
+    clack.outro(chalk.dim('Use "skai <source>" to install skills'));
+    return;
+  }
+  for (const [agentName, skills] of agentSkillsMap) {
+    console.log(chalk.bold(`
+${agentName}:`));
+    if (skills.project.length > 0) {
+      console.log(chalk.dim("  Project:"));
+      for (const skill of skills.project.sort()) {
+        console.log(chalk.green(`    \u2022 ${skill}`));
+      }
+    }
+    if (skills.global.length > 0) {
+      console.log(chalk.dim("  Global:"));
+      for (const skill of skills.global.sort()) {
+        console.log(chalk.blue(`    \u2022 ${skill}`));
+      }
+    }
+  }
+  clack.outro(chalk.cyan(`${allSkills.length} skill(s) installed`));
+}
+async function runUpdate(_skillNames, _options) {
+  clack.intro(chalk.cyan("skai update"));
+  clack.log.warn("The update command requires tracking skill sources.");
+  clack.log.info("Currently, skai does not track where skills were installed from.");
+  clack.log.info("");
+  clack.log.info("To update a skill, you can:");
+  clack.log.info("  1. Uninstall the existing skill: skai uninstall <skill>");
+  clack.log.info("  2. Reinstall from the source: skai <source>");
+  clack.outro(chalk.yellow("Update not yet implemented"));
+}
+async function main() {
+  const program = new Command();
+  program.name("skai").description("The package manager for AI agent skills").version(getVersion(), "-V, --version", "Display version");
+  program.argument("[source]", "GitHub repo, URL, or local path to install skills from").option("-g, --global", "Install to user directory instead of project", false).option("-a, --agent <agents...>", "Target specific agents").option("-s, --skill <skills...>", "Install specific skills by name").option("-l, --list", "List available skills without installing", false).option("-y, --yes", "Skip confirmation prompts", false).option("--json", "Output results in JSON format", false).option("--dry-run", "Preview installation without making changes", false).action(async (source, options) => {
+    await runInstall(source, options);
+  });
+  program.command("install <source>").description("Install skills from a source").option("-g, --global", "Install to user directory instead of project", false).option("-a, --agent <agents...>", "Target specific agents").option("-s, --skill <skills...>", "Install specific skills by name").option("-l, --list", "List available skills without installing", false).option("-y, --yes", "Skip confirmation prompts", false).option("--json", "Output results in JSON format", false).option("--dry-run", "Preview installation without making changes", false).action(async (source, options) => {
+    await runInstall(source, options);
+  });
+  program.command("uninstall <skills...>").alias("rm").alias("remove").description("Uninstall skills from agents").option("-g, --global", "Uninstall from global directory", false).option("-a, --agent <agents...>", "Target specific agents").option("-y, --yes", "Skip confirmation prompts", false).option("--json", "Output results in JSON format", false).action(async (skills, options) => {
+    await runUninstall(skills, options);
+  });
+  program.command("list").alias("ls").description("List installed skills").option("-g, --global", "List only global skills", false).option("-a, --agent <agents...>", "Target specific agents").option("--json", "Output results in JSON format", false).action(async (options) => {
+    await runList(options);
+  });
+  program.command("update [skills...]").alias("up").description("Update installed skills (coming soon)").option("-g, --global", "Update global skills", false).option("-a, --agent <agents...>", "Target specific agents").option("-y, --yes", "Skip confirmation prompts", false).option("--json", "Output results in JSON format", false).action(async (skills, options) => {
+    await runUpdate(skills, options);
+  });
+  program.addHelpText(
+    "after",
+    `
+Examples:
+  $ skai pproenca/dot-skills              Install skills from GitHub
+  $ skai https://github.com/org/repo      Install from full URL
+  $ skai ./local/skills                   Install from local directory
+  $ skai pproenca/dot-skills -s typescript  Install specific skill
+  $ skai pproenca/dot-skills -a claude-code Install to specific agent
+  $ skai pproenca/dot-skills --dry-run    Preview installation
+  $ skai list                             List installed skills
+  $ skai list -a cursor                   List skills for specific agent
+  $ skai uninstall typescript             Uninstall a skill
+  $ skai uninstall typescript -a cursor   Uninstall from specific agent
+
+Supported Agents:
+  claude-code, cursor, copilot, windsurf, codex, opencode, amp,
+  kilo-code, roo-code, goose, gemini, antigravity, clawdbot, droid
+`
+  );
+  await program.parseAsync(process.argv);
+}
 main().catch((error) => {
   console.error(chalk.red("Fatal error:"), error);
   process.exit(EXIT_ERROR);