install-agent-skill 1.2.4 → 1.2.7

package/bin/add-skill.modular.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * install-agent-skill
+ * Vercel-Style CLI - Modular Entry Point v2.1
+ */
+
+import { c, step, fatal, intro, outro } from "./lib/ui.js";
+import { command, params, flags, VERSION } from "./lib/config.js";
+
+// --- MAIN ---
+async function main() {
+    // Basic command routing
+    let cmdModule;
+
+    try {
+        switch (command) {
+            case "list":
+            case "ls":
+                cmdModule = await import("./lib/commands/list.js");
+                await cmdModule.run();
+                break;
+            case "init":
+                cmdModule = await import("./lib/commands/init.js");
+                await cmdModule.run();
+                break;
+            case "install":
+            case "add":
+            case "i":
+                cmdModule = await import("./lib/commands/install.js");
+                await cmdModule.run(params[0]);
+                break;
+            case "uninstall":
+            case "remove":
+            case "rm":
+                cmdModule = await import("./lib/commands/uninstall.js");
+                await cmdModule.run(params[0]);
+                break;
+            case "update":
+                cmdModule = await import("./lib/commands/update.js");
+                await cmdModule.run(params[0]);
+                break;
+            case "lock":
+                cmdModule = await import("./lib/commands/lock.js");
+                await cmdModule.run();
+                break;
+            case "verify":
+                cmdModule = await import("./lib/commands/verify.js");
+                await cmdModule.run();
+                break;
+            case "doctor":
+                cmdModule = await import("./lib/commands/doctor.js");
+                await cmdModule.run();
+                break;
+            case "cache":
+                cmdModule = await import("./lib/commands/cache.js");
+                await cmdModule.run(params[0]);
+                break;
+            case "validate":
+            case "check":
+                cmdModule = await import("./lib/commands/validate.js");
+                await cmdModule.run(params[0]);
+                break;
+            case "analyze":
+                cmdModule = await import("./lib/commands/analyze.js");
+                await cmdModule.run(params[0]);
+                break;
+            case "info":
+            case "show":
+                cmdModule = await import("./lib/commands/info.js");
+                await cmdModule.run(params[0]);
+                break;
+            case "help":
+            case "--help":
+            case "-h":
+                cmdModule = await import("./lib/commands/help.js");
+                await cmdModule.run();
+                break;
+            case "--version":
+            case "-V":
+                console.log(VERSION);
+                break;
+            default:
+                // Handle direct install via org/repo syntax
+                if (command.includes("/")) {
+                    cmdModule = await import("./lib/commands/install.js");
+                    await cmdModule.run(command);
+                } else {
+                    console.log(`Unknown command: ${command}`);
+                    cmdModule = await import("./lib/commands/help.js");
+                    await cmdModule.run();
+                }
+        }
+    } catch (err) {
+        console.error(c.red("\nError: " + err.message));
+        if (process.env.DEBUG) console.error(err.stack);
+        process.exit(1);
+    }
+}
+
+main().catch(err => {
+    console.error(c.red("\nFatal Error: " + err.message));
+    process.exit(1);
+});

package/bin/add-skill.v2.js

@@ -10,9 +10,9 @@ import os from "os";
 import { execSync } from "child_process";
 import crypto from "crypto";
 import prompts from "prompts";
-import { multiselect, isCancel, cancel, intro, outro, select, confirm } from "@clack/prompts";
+import { multiselect, isCancel, cancel, intro, outro, select, confirm, log, spinner } from "@clack/prompts";
 import kleur from "kleur";
-import ora from "ora";
+
 import boxen from "boxen";
 import { createRequire } from "module";
 
@@ -250,24 +250,54 @@ async function runInstall(spec) {
     if (!spec) { fatal("Missing skill spec. Usage: add-skill <org/repo>"); return; }
     const { org, repo, skill: singleSkill, ref } = parseSkillSpec(spec);
     if (!org || !repo) { fatal("Invalid spec. Format: org/repo or org/repo#skill"); return; }
+
+    // Start Clack UI session
+    intro(c.bgCyan(c.black(" add-skill ")));
+
     const url = `https://github.com/${org}/${repo}.git`;
-    stepLine();
-    console.log(` ${c.gray(S.branch)}  ${c.bgCyan().black(" skills ")}`);
-    stepLine();
-    step(`Source: ${c.cyan(url)}`, S.diamond, "green");
-    stepLine();
-    const spinner = ora({ text: "Cloning repository", prefixText: ` ${c.gray(S.branch)}  ${c.cyan(S.diamondFilled)} `, color: "cyan" }).start();
+    log.info(`Source: ${c.cyan(url)}`);
+
+    const s = spinner();
+    s.start("Cloning repository");
+
     const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "add-skill-"));
-    try { execSync(`git clone --depth=1 ${url} "${tmp}"`, { stdio: "pipe" }); if (ref) execSync(`git -C "${tmp}" checkout ${ref}`, { stdio: "pipe" }); } catch { spinner.stop(); console.log(` ${c.gray(S.branch)}  ${c.red(S.cross)}  ${c.red("Failed to clone")}`); fs.rmSync(tmp, { recursive: true, force: true }); return; }
-    spinner.stop(); step("Repository cloned", S.check, "green");
+    try {
+        execSync(`git clone --depth=1 ${url} "${tmp}"`, { stdio: "pipe" });
+        if (ref) execSync(`git -C "${tmp}" checkout ${ref}`, { stdio: "pipe" });
+    } catch {
+        s.stop("Failed to clone", 1);
+        log.error("Failed to clone repository");
+        fs.rmSync(tmp, { recursive: true, force: true });
+        cancel("Operation cancelled");
+        return;
+    }
+    s.stop("Repository cloned");
+
     const skillsInRepo = [];
-    for (const e of fs.readdirSync(tmp)) { const sp = path.join(tmp, e); if (fs.statSync(sp).isDirectory() && fs.existsSync(path.join(sp, "SKILL.md"))) { const m = parseSkillMdFrontmatter(path.join(sp, "SKILL.md")); skillsInRepo.push({ title: e + (m.description ? c.dim(` (${m.description.substring(0, 40)}...)`) : ""), value: e, selected: singleSkill ? e === singleSkill : true }); } }
-    if (skillsInRepo.length === 0) { step(c.yellow("No valid skills found"), S.diamond, "yellow"); fs.rmSync(tmp, { recursive: true, force: true }); return; }
-    stepLine(); step(`Found ${skillsInRepo.length} skills`, S.diamond); stepLine();
+    for (const e of fs.readdirSync(tmp)) {
+        const sp = path.join(tmp, e);
+        if (fs.statSync(sp).isDirectory() && fs.existsSync(path.join(sp, "SKILL.md"))) {
+            const m = parseSkillMdFrontmatter(path.join(sp, "SKILL.md"));
+            skillsInRepo.push({
+                title: e + (m.description ? c.dim(` (${m.description.substring(0, 40)}...)`) : ""),
+                value: e,
+                selected: singleSkill ? e === singleSkill : true
+            });
+        }
+    }
+
+    if (skillsInRepo.length === 0) {
+        log.warn("No valid skills found in repository");
+        fs.rmSync(tmp, { recursive: true, force: true });
+        cancel("Operation cancelled");
+        return;
+    }
+
+    log.info(`Found ${skillsInRepo.length} skills`);
 
     // Use @clack/prompts for multiselect
     const skillsR = await multiselect({
-        message: 'Select skills to install',
+        message: 'Select skills to install (Press Space to select, Enter to continue)',
         options: skillsInRepo.map(s => ({
             label: s.title,
             value: s.value,
@@ -284,46 +314,66 @@ async function runInstall(spec) {
     }
 
     const selectedSkills = skillsR;
-    if (selectedSkills.length === 0) { console.log(`\n ${c.yellow("Cancelled.")}`); fs.rmSync(tmp, { recursive: true, force: true }); return; }
+    if (selectedSkills.length === 0) {
+        log.warn("No skills selected");
+        fs.rmSync(tmp, { recursive: true, force: true });
+        cancel("Operation cancelled");
+        return;
+    }
 
+    // Agent selection
     stepLine();
-    // Re-use standard prompts for scope for now, or could switch to clack select too, 
-    // but focusing on the requested "green square" UI which is multiselect.
-    // To match style, let's use clack select for scope too.
+    step("Detected 5 agents", S.diamond);
 
-    const scopeR = await select({
-        message: 'Installation scope',
+    const agentsR = await multiselect({
+        message: 'Select agents to install skills to',
         options: [
-            { label: 'Project (current directory)', value: 'project' },
-            { label: 'Global', value: 'global' }
+            { label: 'Antigravity (.agent/skills)', value: 'antigravity', selected: true },
+            { label: c.dim('Claude Code'), value: 'claude', hint: c.dim('(not supported)') },
+            { label: c.dim('Codex'), value: 'codex', hint: c.dim('(not supported)') },
+            { label: c.dim('Gemini CLI'), value: 'gemini', hint: c.dim('(not supported)') },
+            { label: c.dim('Windsurf'), value: 'windsurf', hint: c.dim('(not supported)') }
         ],
-        initialValue: 'project'
+        required: true
     });
 
-    if (isCancel(scopeR)) {
+    if (isCancel(agentsR)) {
         cancel('Operation cancelled.');
         fs.rmSync(tmp, { recursive: true, force: true });
         return;
     }
 
-    const targetScope = scopeR === "global" ? GLOBAL_DIR : WORKSPACE;
+    const selectedAgents = agentsR;
+    if (selectedAgents.includes('antigravity') === false) {
+        log.warn("Antigravity is currently the only supported agent. Selecting it automatically.");
+    }
+
+    // For now, we only support Antigravity, effectively just checking if we continue
+    const targetScope = WORKSPACE;
 
-    stepLine(); step("Installation Summary", S.diamond); stepLine();
-    let boxContent = ""; for (const sn of selectedSkills) boxContent += `${c.cyan(sn)}\n  ${c.dim(targetScope)}\n\n`;
-    const box = boxen(boxContent.trim(), { padding: 1, borderStyle: "round", borderColor: "gray", dimBorder: true });
-    box.split("\n").forEach(l => console.log(` ${c.gray(S.branch)}      ${l}`));
+    log.info("Installing skills...");
+    fs.mkdirSync(targetScope, { recursive: true });
+
+    // Install loop
+    const sInstall = spinner();
+    sInstall.start("Copying files");
 
-    stepLine(); fs.mkdirSync(targetScope, { recursive: true });
     for (const sn of selectedSkills) {
         const src = path.join(tmp, sn), dest = path.join(targetScope, sn);
         if (fs.existsSync(dest)) fs.rmSync(dest, { recursive: true, force: true });
         fs.cpSync(src, dest, { recursive: true });
         const hash = merkleHash(dest);
         fs.writeFileSync(path.join(dest, ".skill-source.json"), JSON.stringify({ repo: `${org}/${repo}`, skill: sn, ref: ref || null, checksum: hash, installedAt: new Date().toISOString() }, null, 2));
-        step(`Installed: ${c.bold(sn)}`, S.check, "green");
     }
+    sInstall.stop("Files copied");
+
+    for (const sn of selectedSkills) {
+        log.success(`Installed ${c.bold(sn)}`);
+    }
+
     fs.rmSync(tmp, { recursive: true, force: true });
-    stepLine(); console.log(` ${c.cyan("Done!")}`); console.log();
+
+    outro("Done!");
 }
 
 async function runUninstall(skillName) {
@@ -348,12 +398,13 @@ async function runUpdate(skillName) {
     const meta = JSON.parse(fs.readFileSync(metaFile, "utf-8"));
     if (!meta.repo || meta.repo === "local") fatal("Cannot update local skill");
     stepLine();
-    const spinner = ora({ text: `Updating ${skillName}`, prefixText: ` ${c.gray(S.branch)}  ${c.cyan(S.diamondFilled)} `, color: "cyan" }).start();
+    const s = spinner();
+    s.start(`Updating ${skillName}`);
     try {
         if (!DRY) { createBackup(targetDir, skillName); fs.rmSync(targetDir, { recursive: true, force: true }); }
         const spec = `${meta.repo}#${meta.skill}${meta.ref ? "@" + meta.ref : ""}`;
-        if (DRY) { spinner.stop(); step(`Would update: ${skillName}`, S.diamond); } else { await runInstall(spec); }
-    } catch (err) { spinner.stop(); step(`Failed: ${err.message}`, S.cross, "red"); }
+        if (DRY) { s.stop(); step(`Would update: ${skillName}`, S.diamond); } else { await runInstall(spec); s.stop(); }
+    } catch (err) { s.stop(`Failed: ${err.message}`, 1); step(`Failed: ${err.message}`, S.cross, "red"); }
 }
 
 function runLock() {

package/bin/lib/commands/install.js

@@ -7,11 +7,11 @@ import path from "path";
 import os from "os";
 import { execSync } from "child_process";
 import prompts from "prompts";
-import ora from "ora";
+
 import boxen from "boxen";
 import { parseSkillSpec, merkleHash } from "../helpers.js";
 import { parseSkillMdFrontmatter } from "../skills.js";
-import { step, stepLine, S, c, fatal } from "../ui.js";
+import { step, stepLine, S, c, fatal, spinner } from "../ui.js";
 import { WORKSPACE, GLOBAL_DIR } from "../config.js";
 
 /**
@@ -36,11 +36,8 @@ export async function run(spec) {
     stepLine();
     step("Source: " + c.cyan(url), S.diamond);
 
-    const spinner = ora({
-        text: "Cloning repository",
-        prefixText: ` ${c.gray(S.branch)}  ${c.cyan(S.diamondFilled)} `,
-        color: "cyan"
-    }).start();
+    const s = spinner();
+    s.start("Cloning repository");
 
     const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "add-skill-"));
 
@@ -48,14 +45,13 @@ export async function run(spec) {
         execSync(`git clone --depth=1 ${url} "${tmp}"`, { stdio: "pipe" });
         if (ref) execSync(`git -C "${tmp}" checkout ${ref}`, { stdio: "pipe" });
     } catch {
-        spinner.stop();
+        s.stop("Failed to clone");
         step(c.red("Failed to clone"), S.cross, "red");
         fs.rmSync(tmp, { recursive: true, force: true });
         return;
     }
 
-    spinner.stop();
-    step("Repository cloned", S.check, "green");
+    s.stop("Repository cloned");
 
     // Find skills in repo
     const skillsInRepo = [];
@@ -109,7 +105,7 @@ export async function run(spec) {
                 value: s.value,
                 selected: true  // Pre-select all by default
             })),
-            hint: "- Space to toggle. Return to submit",
+            hint: "- Press Space to select, Enter to continue",
             instructions: false
         });
 
@@ -122,20 +118,32 @@ export async function run(spec) {
         selectedSkills = skillsR.skills;
     }
 
-    // Scope selection
+    // Agent selection
     stepLine();
-    const scopeR = await prompts({
-        type: "select",
-        name: "scope",
-        message: "Installation scope",
+    step("Detected 5 agents", S.diamond);
+
+    const agentsR = await prompts({
+        type: "multiselect",
+        name: "agents",
+        message: "Select agents to install skills to",
         choices: [
-            { title: "Project (current directory)", value: "project" },
-            { title: "Global", value: "global" }
+            { title: "Antigravity (.agent/skills)", value: "antigravity", selected: true },
+            { title: c.dim("Claude Code"), value: "claude", disabled: true },
+            { title: c.dim("Codex"), value: "codex", disabled: true },
+            { title: c.dim("Gemini CLI"), value: "gemini", disabled: true },
+            { title: c.dim("Windsurf"), value: "windsurf", disabled: true }
         ],
-        initial: 0
+        hint: "- Space to toggle. Enter to submit",
+        instructions: false
     });
 
-    const targetScope = scopeR.scope === "global" ? GLOBAL_DIR : WORKSPACE;
+    if (!agentsR.agents || agentsR.agents.length === 0) {
+        console.log(`\n ${c.yellow("No agents selected.")}`);
+        fs.rmSync(tmp, { recursive: true, force: true });
+        return;
+    }
+
+    const targetScope = WORKSPACE;
 
     // Summary
     stepLine();

package/bin/lib/commands/update.js

@@ -4,9 +4,9 @@
 
 import fs from "fs";
 import path from "path";
-import ora from "ora";
+
 import { resolveScope, createBackup } from "../helpers.js";
-import { step, stepLine, S, c, fatal } from "../ui.js";
+import { step, stepLine, S, c, fatal, spinner } from "../ui.js";
 import { DRY } from "../config.js";
 
 /**
@@ -29,11 +29,8 @@ export async function run(skillName) {
 
     stepLine();
 
-    const spinner = ora({
-        text: `Updating ${skillName}`,
-        prefixText: ` ${c.gray(S.branch)}  ${c.cyan(S.diamondFilled)} `,
-        color: "cyan"
-    }).start();
+    const s = spinner();
+    s.start(`Updating ${skillName}`);
 
     try {
         if (!DRY) {
@@ -44,15 +41,15 @@ export async function run(skillName) {
         const spec = `${meta.repo}#${meta.skill}${meta.ref ? "@" + meta.ref : ""}`;
 
         if (DRY) {
-            spinner.stop();
+            s.stop();
             step(`Would update: ${skillName}`);
         } else {
             // Dynamically import install command
             const { run: install } = await import("./install.js");
             await install(spec);
+            s.stop();
         }
     } catch (err) {
-        spinner.stop();
-        step(`Failed: ${err.message}`, S.cross, "red");
+        s.stop(`Failed: ${err.message}`);
     }
 }

package/bin/lib/ui.js

@@ -3,6 +3,9 @@
  */
 
 import kleur from "kleur";
+import { intro, outro, spinner, multiselect, select, confirm, isCancel, cancel, text } from "@clack/prompts";
+
+export { intro, outro, spinner, multiselect, select, confirm, isCancel, cancel, text };
 
 // --- Symbols ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "install-agent-skill",
-  "version": "1.2.4",
+  "version": "1.2.7",
   "description": "Enterprise-grade Agent Skill Manager with Antigravity Skills support, Progressive Disclosure detection, and semantic routing validation",
   "license": "MIT",
   "author": "DataGuruIn <contact@dataguruin.com>",
@@ -14,7 +14,7 @@
   },
   "type": "module",
   "bin": {
-    "add-skill": "./bin/add-skill.v2.js"
+    "add-skill": "./bin/add-skill.modular.js"
   },
   "files": [
     "bin/",