install-agent-skill 1.2.3 → 1.2.4

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.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 } 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") {
@@ -233,36 +252,75 @@ async function runInstall(spec) {
     if (!org || !repo) { fatal("Invalid spec. Format: org/repo or org/repo#skill"); return; }
     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();
+    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();
     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 { 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");
     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; }
+
+    // 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) { 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;
+    // 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.
+
+    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;
+
     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`;
+    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}`));
+    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 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)}`);
+        step(`Installed: ${c.bold(sn)}`, S.check, "green");
     }
     fs.rmSync(tmp, { recursive: true, force: true });
     stepLine(); console.log(` ${c.cyan("Done!")}`); console.log();
@@ -310,7 +368,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "install-agent-skill",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "description": "Enterprise-grade Agent Skill Manager with Antigravity Skills support, Progressive Disclosure detection, and semantic routing validation",
   "license": "MIT",
   "author": "DataGuruIn <contact@dataguruin.com>",