claudekit-cli 3.31.0-dev.4 → 3.31.0-dev.6

package/dist/index.js

@@ -22985,6 +22985,108 @@ var init_versions_command_help = __esm(() => {
   };
 });
 
+// src/domains/help/commands/skill-command-help.ts
+var skillCommandHelp;
+var init_skill_command_help = __esm(() => {
+  skillCommandHelp = {
+    name: "skill",
+    description: "Install, uninstall, and manage ClaudeKit skills across coding agents",
+    usage: "ck skill [options]",
+    examples: [
+      {
+        command: "ck skill --name frontend-design --agent claude-code -g",
+        description: "Install skill to Claude Code globally"
+      },
+      {
+        command: "ck skill --list --installed",
+        description: "Show all installed skills with their locations"
+      }
+    ],
+    optionGroups: [
+      {
+        title: "Mode Options",
+        options: [
+          {
+            flags: "-l, --list",
+            description: "List available skills from ClaudeKit source"
+          },
+          {
+            flags: "--installed",
+            description: "When used with --list, show installed skills instead"
+          },
+          {
+            flags: "-u, --uninstall",
+            description: "Uninstall skill(s) from agent(s)"
+          },
+          {
+            flags: "--sync",
+            description: "Sync registry with filesystem (clean orphaned entries)"
+          }
+        ]
+      },
+      {
+        title: "Installation Options",
+        options: [
+          {
+            flags: "-n, --name <skill>",
+            description: "Skill name to install or uninstall"
+          },
+          {
+            flags: "-a, --agent <agent>",
+            description: "Target agent(s) - can be specified multiple times. Valid: claude-code, cursor, codex, opencode, goose, gemini-cli, antigravity, github-copilot, amp, kilo, roo, windsurf, cline, openhands"
+          },
+          {
+            flags: "-g, --global",
+            description: "Install to user's home directory (available across projects)"
+          },
+          {
+            flags: "--all",
+            description: "Install to all supported agents"
+          },
+          {
+            flags: "-y, --yes",
+            description: "Non-interactive mode (skip confirmations)"
+          }
+        ]
+      },
+      {
+        title: "Uninstall Options",
+        options: [
+          {
+            flags: "-f, --force",
+            description: "Force uninstall even if skill not in registry (requires --agent)"
+          }
+        ]
+      }
+    ],
+    sections: [
+      {
+        title: "Supported Agents",
+        content: `  claude-code     Claude Code CLI
+  cursor          Cursor IDE
+  codex           Codex CLI
+  opencode        OpenCode
+  goose           Goose AI
+  gemini-cli      Gemini CLI
+  antigravity     Antigravity Agent
+  github-copilot  GitHub Copilot
+  amp             Amp
+  kilo            Kilo Code
+  roo             Roo Code
+  windsurf        Windsurf IDE
+  cline           Cline
+  openhands       OpenHands`
+      },
+      {
+        title: "Notes",
+        content: `  • Skills are installed from ~/.claude/skills (ClaudeKit Engineer source)
+  • Registry stored at ~/.claudekit/skill-registry.json
+  • Project installs go to ./<agent>/skills, global to ~/<agent>/skills`
+      }
+    ]
+  };
+});
+
 // src/domains/help/commands/index.ts
 var init_commands2 = __esm(() => {
   init_new_command_help();
@@ -22993,6 +23095,7 @@ var init_commands2 = __esm(() => {
   init_uninstall_command_help();
   init_update_command_help();
   init_versions_command_help();
+  init_skill_command_help();
   init_common_options();
 });
 
@@ -23010,7 +23113,8 @@ var init_help_commands = __esm(() => {
     update: updateCommandHelp,
     versions: versionsCommandHelp,
     doctor: doctorCommandHelp,
-    uninstall: uninstallCommandHelp
+    uninstall: uninstallCommandHelp,
+    skill: skillCommandHelp
   };
 });
 
@@ -48946,6 +49050,7 @@ async function skillCommand(options2) {
     const ctx = {
       options: validOptions,
       cancelled: false,
+      selectedSkills: [],
       selectedAgents: [],
       installGlobally: validOptions.global ?? false,
       availableSkills,
@@ -48968,12 +49073,12 @@ async function skillCommand(options2) {
         $e(import_picocolors21.default.red("Installation failed"));
         process.exit(1);
       }
-      ctx.selectedSkill = skill;
+      ctx.selectedSkills = [skill];
       f2.info(`Skill: ${import_picocolors21.default.cyan(skill.name)}`);
       f2.message(import_picocolors21.default.dim(skill.description));
     } else if (availableSkills.length === 1) {
-      ctx.selectedSkill = availableSkills[0];
-      f2.info(`Skill: ${import_picocolors21.default.cyan(ctx.selectedSkill.name)}`);
+      ctx.selectedSkills = [availableSkills[0]];
+      f2.info(`Skill: ${import_picocolors21.default.cyan(ctx.selectedSkills[0].name)}`);
     } else if (validOptions.yes) {
       f2.error("--name required in non-interactive mode with multiple skills");
       process.exit(1);
@@ -48983,15 +49088,17 @@ async function skillCommand(options2) {
         label: s.name,
         hint: s.description.length > 50 ? `${s.description.slice(0, 47)}...` : s.description
       }));
-      const selected = await ie({
-        message: "Select a skill to install",
-        options: skillChoices
+      const selected = await ae({
+        message: "Select skill(s) to install",
+        options: skillChoices,
+        required: true
       });
       if (lD(selected)) {
         ue("Installation cancelled");
         return;
       }
-      ctx.selectedSkill = selected;
+      ctx.selectedSkills = selected;
+      f2.info(`Selected ${ctx.selectedSkills.length} skill(s)`);
     }
     const validAgentTypes = Object.keys(agents);
     if (validOptions.agent && validOptions.agent.length > 0) {
@@ -49069,60 +49176,71 @@ async function skillCommand(options2) {
       }
       ctx.installGlobally = scope;
     }
-    if (!ctx.selectedSkill) {
-      f2.error("No skill selected");
+    if (ctx.selectedSkills.length === 0) {
+      f2.error("No skills selected");
       process.exit(1);
     }
-    const selectedSkill = ctx.selectedSkill;
     console.log();
     f2.step(import_picocolors21.default.bold("Installation Summary"));
-    const preview = getInstallPreview(selectedSkill, ctx.selectedAgents, {
-      global: ctx.installGlobally
-    });
-    for (const item of preview) {
-      const status = item.exists ? import_picocolors21.default.yellow(" (will overwrite)") : "";
-      f2.message(`  ${import_picocolors21.default.dim("→")} ${item.displayName}: ${import_picocolors21.default.dim(item.path)}${status}`);
+    for (const skill of ctx.selectedSkills) {
+      f2.message(`  ${import_picocolors21.default.cyan(skill.name)}`);
+      const preview = getInstallPreview(skill, ctx.selectedAgents, {
+        global: ctx.installGlobally
+      });
+      for (const item of preview) {
+        const status = item.exists ? import_picocolors21.default.yellow(" (overwrite)") : "";
+        f2.message(`    ${import_picocolors21.default.dim("→")} ${item.displayName}${status}`);
+      }
     }
     console.log();
     if (!validOptions.yes) {
-      const confirmed = await se({ message: "Proceed with installation?" });
+      const confirmed = await se({
+        message: `Install ${ctx.selectedSkills.length} skill(s) to ${ctx.selectedAgents.length} agent(s)?`
+      });
       if (lD(confirmed) || !confirmed) {
         ue("Installation cancelled");
         return;
       }
     }
     const spinner = de();
-    spinner.start("Installing skill...");
-    const results = await installSkillToAgents(selectedSkill, ctx.selectedAgents, {
-      global: ctx.installGlobally
-    });
+    spinner.start(`Installing ${ctx.selectedSkills.length} skill(s)...`);
+    let totalSuccessful = 0;
+    let totalFailed = 0;
+    const allResults = [];
+    for (const skill of ctx.selectedSkills) {
+      const results = await installSkillToAgents(skill, ctx.selectedAgents, {
+        global: ctx.installGlobally
+      });
+      allResults.push({ skill: skill.name, results });
+      totalSuccessful += results.filter((r2) => r2.success).length;
+      totalFailed += results.filter((r2) => !r2.success).length;
+    }
     spinner.stop("Installation complete");
     console.log();
-    const successful = results.filter((r2) => r2.success);
-    const failed = results.filter((r2) => !r2.success);
-    if (successful.length > 0) {
-      f2.success(import_picocolors21.default.green(`Successfully installed to ${successful.length} agent(s)`));
-      for (const r2 of successful) {
-        f2.message(`  ${import_picocolors21.default.green("✓")} ${r2.agentDisplayName}`);
-        f2.message(`    ${import_picocolors21.default.dim(r2.path)}`);
+    for (const { skill, results } of allResults) {
+      const successful = results.filter((r2) => r2.success);
+      const failed = results.filter((r2) => !r2.success);
+      if (successful.length > 0) {
+        f2.success(`${import_picocolors21.default.cyan(skill)} → ${successful.length} agent(s)`);
+        for (const r2 of successful) {
+          f2.message(`  ${import_picocolors21.default.green("✓")} ${r2.agentDisplayName}`);
+        }
       }
-    }
-    if (failed.length > 0) {
-      console.log();
-      f2.error(import_picocolors21.default.red(`Failed to install to ${failed.length} agent(s)`));
-      for (const r2 of failed) {
-        f2.message(`  ${import_picocolors21.default.red("✗")} ${r2.agentDisplayName}`);
-        f2.message(`    ${import_picocolors21.default.dim(r2.error)}`);
+      if (failed.length > 0) {
+        f2.error(`${import_picocolors21.default.cyan(skill)} failed: ${failed.length} agent(s)`);
+        for (const r2 of failed) {
+          f2.message(`  ${import_picocolors21.default.red("✗")} ${r2.agentDisplayName}: ${import_picocolors21.default.dim(r2.error)}`);
+        }
       }
     }
     console.log();
-    if (successful.length === 0 && failed.length === 0) {
+    if (totalSuccessful === 0 && totalFailed === 0) {
       $e(import_picocolors21.default.yellow("No installations performed"));
-    } else if (failed.length > 0 && successful.length === 0) {
+    } else if (totalFailed > 0 && totalSuccessful === 0) {
       $e(import_picocolors21.default.red("Installation failed"));
       process.exit(1);
     } else {
-      $e(import_picocolors21.default.green("Done!"));
+      $e(import_picocolors21.default.green(`Done! ${totalSuccessful} installed, ${totalFailed} failed`));
     }
   } catch (error) {
     logger.error(error instanceof Error ? error.message : "Unknown error");
@@ -49626,7 +49744,7 @@ var import_fs_extra37 = __toESM(require_lib(), 1);
 // package.json
 var package_default = {
   name: "claudekit-cli",
-  version: "3.31.0-dev.4",
+  version: "3.31.0-dev.6",
   description: "CLI tool for bootstrapping and updating ClaudeKit projects",
   type: "module",
   repository: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudekit-cli",
-	"version": "3.31.0-dev.4",
+	"version": "3.31.0-dev.6",
 	"description": "CLI tool for bootstrapping and updating ClaudeKit projects",
 	"type": "module",
 	"repository": {