install-agent-skill 1.2.3 → 1.2.6

package/README.bigtech.md

@@ -1,11 +1,11 @@
 <p align="center">
   <img src="https://raw.githubusercontent.com/dataguruin/add-skill/main/.github/logo.svg" height="128">
-  <h1 align="center">add-skill</h1>
+  <h1 align="center">install-agent-skill</h1>
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/v/@dataguruin/add-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/d18m/@dataguruin/add-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="npm downloads"></a>
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/v/install-agent-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/d18m/install-agent-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="npm downloads"></a>
   <a href="https://github.com/dataguruin/add-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dataguruin/add-skill?style=flat&colorA=18181b&colorB=7c3aed" alt="license"></a>
 </p>
 
@@ -26,10 +26,10 @@
 
 ## What is add-skill?
 
-`add-skill` is a CLI tool for managing **Agent Skills**—immutable, verifiable intelligence artifacts that extend your AI agent's capabilities. Think of it as `npm` for AI agents.
+`install-agent-skill` is a CLI tool for managing **Agent Skills**—immutable, verifiable intelligence artifacts that extend your AI agent's capabilities. Think of it as `npm` for AI agents.
 
 ```bash
-npx -y add-agent-skill install dataguruin/coinpika-agent-skills#coinpika-doctrine-pack
+npx -y install-agent-skill install dataguruin/coinpika-agent-skills#coinpika-doctrine-pack
 ```
 
 Skills are **data, not code**. They won't execute on your system—they're read by your agent to enhance its behavior.
@@ -40,16 +40,16 @@ Skills are **data, not code**. They won't execute on your system—they're read
 
 ```bash
 # Using npm
-npm install -g add-agent-skill
+npm install -g install-agent-skill
 
 # Using pnpm
-pnpm add -g add-agent-skill
+pnpm add -g install-agent-skill
 
 # Using Yarn
-yarn global add add-agent-skill
+yarn global add install-agent-skill
 
 # Or run directly with npx
-npx -y add-agent-skill <command>
+npx -y install-agent-skill <command>
 ```
 
 > **Requirements:** Node.js 18.0.0 or later
@@ -61,7 +61,7 @@ npx -y add-agent-skill <command>
 ### 1. Initialize your workspace
 
 ```bash
-npx -y add-agent-skill init
+npx -y install-agent-skill init
 ```
 
 This creates the `.agent/skills` directory structure in your project.
@@ -72,22 +72,22 @@ Install from GitHub with optional version pinning:
 
 ```bash
 # Latest version
-npx -y add-agent-skill install dataguruin/coinpika-agent-skills#coinpika-pr-reviewer
+npx -y install-agent-skill install dataguruin/coinpika-agent-skills#coinpika-pr-reviewer
 
 # Specific version
-npx -y add-agent-skill install dataguruin/coinpika-agent-skills#coinpika-doctrine-pack@v1.0.0
+npx -y install-agent-skill install dataguruin/coinpika-agent-skills#coinpika-doctrine-pack@v1.0.0
 ```
 
 ### 3. List installed skills
 
 ```bash
-npx -y add-agent-skill list
+npx -y install-agent-skill list
 ```
 
 ### 4. Validate compliance
 
 ```bash
-npx -y add-agent-skill validate
+npx -y install-agent-skill validate
 ```
 
 ---
@@ -132,10 +132,10 @@ Pin exact versions for reproducible builds across your team:
 
 ```bash
 # Generate lockfile
-npx -y add-agent-skill lock
+npx -y install-agent-skill lock
 
 # Install from lockfile
-npx -y add-agent-skill install --locked
+npx -y install-agent-skill install --locked
 ```
 
 ### Security by Design

package/README.md

@@ -1,8 +1,8 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/add--skill-v1.2.2-000000?style=for-the-badge&logo=npm&logoColor=white" alt="add-skill v1.2.2" />
+  <img src="https://img.shields.io/badge/install--agent--skill-v1.2.3-000000?style=for-the-badge&logo=npm&logoColor=white" alt="install-agent-skill v1.2.3" />
 </p>
 
-<h1 align="center">add-skill</h1>
+<h1 align="center">install-agent-skill</h1>
 
 <p align="center">
   <strong>The package manager for AI agent skills.</strong><br/>
@@ -10,8 +10,8 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/v/@dataguruin/add-skill?style=flat-square&color=000000" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/@dataguruin/add-skill"><img src="https://img.shields.io/npm/dm/@dataguruin/add-skill?style=flat-square&color=000000" alt="npm downloads"></a>
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/v/install-agent-skill?style=flat-square&color=000000" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/install-agent-skill"><img src="https://img.shields.io/npm/dm/install-agent-skill?style=flat-square&color=000000" alt="npm downloads"></a>
   <a href="https://github.com/dataguruin/add-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dataguruin/add-skill?style=flat-square&color=000000" alt="license"></a>
 </p>
 
@@ -26,10 +26,10 @@
 
 ## What is add-skill?
 
-**add-skill** is a CLI tool for managing Agent Skills—intelligent artifacts that extend your AI coding agent's capabilities.
+**install-agent-skill** is a CLI tool for managing Agent Skills—intelligent artifacts that extend your AI coding agent's capabilities.
 
 ```bash
-npx -y add-agent-skill dataguruin/agent-skills
+npx -y install-agent-skill dataguruin/agent-skills
 ```
 
 ```
@@ -65,13 +65,13 @@ Skills are **data, not code**—they're read by your agent to enhance its behavi
 
 ```bash
 # Using npx (recommended)
-npx -y add-agent-skill <org/repo>
+npx -y install-agent-skill <org/repo>
 
 # Global install
-npm install -g add-agent-skill
+npm install -g install-agent-skill
 
 # Or with pnpm
-pnpm add -g add-agent-skill
+pnpm add -g install-agent-skill
 ```
 
 > **Requires** Node.js 18+
@@ -83,7 +83,7 @@ pnpm add -g add-agent-skill
 ### Install skills from GitHub
 
 ```bash
-npx -y add-agent-skill dataguruin/agent-skills
+npx -y install-agent-skill dataguruin/agent-skills
 ```
 
 Interactive prompts let you select which skills to install.
@@ -91,7 +91,7 @@ Interactive prompts let you select which skills to install.
 ### List installed skills
 
 ```bash
-npx -y add-agent-skill list
+npx -y install-agent-skill list
 ```
 
 ```
@@ -113,7 +113,7 @@ npx -y add-agent-skill list
 ### Check health
 
 ```bash
-npx -y add-agent-skill doctor
+npx -y install-agent-skill doctor
 ```
 
 ```
@@ -187,7 +187,7 @@ skill/
 ### Antigravity Compatibility Score
 
 ```bash
-npx -y add-agent-skill analyze coinpika-doctrine-pack
+npx -y install-agent-skill analyze coinpika-doctrine-pack
 ```
 
 ```

package/bin/add-skill.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * @dataguruin/add-skill
  * Vercel-Style CLI - Exact Match with @clack/prompts

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

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * add-agent-skill
+ * install-agent-skill
  * Vercel-Style CLI - Full Port v2.0
  */
 
@@ -10,6 +10,7 @@ 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, log, spinner } from "@clack/prompts";
 import kleur from "kleur";
 import ora from "ora";
 import boxen from "boxen";
@@ -47,7 +48,25 @@ const OFFLINE = flags.has("--offline");
 
 // --- THEME & SYMBOLS ---
 const S = { branch: "│", diamond: "◇", diamondFilled: "◆", check: "✓", cross: "x", arrow: "→" };
-const c = { cyan: kleur.cyan, gray: kleur.gray, green: kleur.green, red: kleur.red, yellow: kleur.yellow, magenta: kleur.magenta, bold: kleur.bold, dim: kleur.dim };
+const c = {
+    cyan: kleur.cyan,
+    gray: kleur.gray,
+    green: kleur.green,
+    red: kleur.red,
+    yellow: kleur.yellow,
+    magenta: kleur.magenta,
+    blue: kleur.blue,
+    white: kleur.white,
+    black: kleur.black,
+    bgCyan: kleur.bgCyan,
+    bgRed: kleur.bgRed,
+    bgGreen: kleur.bgGreen,
+    bgYellow: kleur.bgYellow,
+    bold: kleur.bold,
+    dim: kleur.dim,
+    italic: kleur.italic,
+    underline: kleur.underline
+};
 
 // --- UI Helpers ---
 function step(text, icon = S.diamond, color = "gray") {
@@ -231,41 +250,117 @@ 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.bgCyan().black(" skills ")}`);
-    console.log();
-    console.log(`  ${c.green(S.diamond)}  Source: ${c.cyan(url)}`);
-    console.log(`  ${c.gray(S.branch)}`);
-    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(); console.log(`  ${c.gray(S.branch)}  ${c.green(S.check)}  Repository cloned`);
+    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();
-    const skillsR = await prompts({ type: "multiselect", name: "skills", message: "Select skills to install", choices: skillsInRepo, hint: "- Space to select. Return to submit", instructions: false });
-    if (!skillsR.skills || skillsR.skills.length === 0) { console.log(`\n ${c.yellow("Cancelled.")}`); fs.rmSync(tmp, { recursive: true, force: true }); return; }
-    stepLine();
-    const scopeR = await prompts({ type: "select", name: "scope", message: "Installation scope", choices: [{ title: "Project (current directory)", value: "project" }, { title: "Global", value: "global" }], initial: 0 });
-    const targetScope = scopeR.scope === "global" ? GLOBAL_DIR : WORKSPACE;
-    stepLine(); step("Installation Summary", S.diamond); stepLine();
-    let boxContent = ""; for (const sn of skillsR.skills) 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}`));
-
-    stepLine(); fs.mkdirSync(targetScope, { recursive: true });
-    for (const sn of skillsR.skills) {
+    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',
+        options: skillsInRepo.map(s => ({
+            label: s.title,
+            value: s.value,
+            hint: s.value === singleSkill ? ' (requested)' : undefined
+        })),
+        initialValues: singleSkill ? [singleSkill] : [],
+        required: true
+    });
+
+    if (isCancel(skillsR)) {
+        cancel('Operation cancelled.');
+        fs.rmSync(tmp, { recursive: true, force: true });
+        return;
+    }
+
+    const selectedSkills = skillsR;
+    if (selectedSkills.length === 0) {
+        log.warn("No skills selected");
+        fs.rmSync(tmp, { recursive: true, force: true });
+        cancel("Operation cancelled");
+        return;
+    }
+
+    const scopeR = await select({
+        message: 'Installation scope',
+        options: [
+            { label: 'Project (current directory)', value: 'project' },
+            { label: 'Global', value: 'global' }
+        ],
+        initialValue: 'project'
+    });
+
+    if (isCancel(scopeR)) {
+        cancel('Operation cancelled.');
+        fs.rmSync(tmp, { recursive: true, force: true });
+        return;
+    }
+
+    const targetScope = scopeR === "global" ? GLOBAL_DIR : WORKSPACE;
+
+    log.info("Installing skills...");
+    fs.mkdirSync(targetScope, { recursive: true });
+
+    // Install loop
+    const sInstall = spinner();
+    sInstall.start("Copying files");
+
+    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));
-        console.log(`  ${c.gray(S.branch)}  ${c.green(S.check)}  Installed: ${c.bold(sn)}`);
     }
+    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) {
@@ -310,7 +405,7 @@ function runLock() {
         const m = JSON.parse(fs.readFileSync(mf, "utf-8"));
         skills[name] = { repo: m.repo, skill: m.skill, ref: m.ref, checksum: `sha256:${m.checksum}`, publisher: m.publisher || null };
     }
-    const lock = { lockVersion: 1, generatedAt: new Date().toISOString(), generator: `add-agent-skill@${pkg.version}`, skills };
+    const lock = { lockVersion: 1, generatedAt: new Date().toISOString(), generator: `install-agent-skill@${pkg.version}`, skills };
     if (DRY) { step("Would generate skill-lock.json", S.diamond); outputJSON(lock); return; }
     fs.mkdirSync(path.join(cwd, ".agent"), { recursive: true });
     fs.writeFileSync(path.join(cwd, ".agent", "skill-lock.json"), JSON.stringify(lock, null, 2));

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.3",
+  "version": "1.2.6",
   "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/",