skills-ws 1.0.1 → 1.0.2

package/bin/cli.mjs

@@ -4,6 +4,7 @@ import { readdir, readFile, copyFile, mkdir, stat } from "node:fs/promises";
 import { join, resolve, dirname } from "node:path";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
+import readline from "node:readline";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const SKILLS_DIR = join(__dirname, "..", "skills");
@@ -15,11 +16,155 @@ const GREEN = "\x1b[32m";
 const CYAN = "\x1b[36m";
 const YELLOW = "\x1b[33m";
 const WHITE = "\x1b[37m";
+const GRAY = "\x1b[90m";
+const MAGENTA = "\x1b[35m";
 
 function print(msg = "") {
   process.stdout.write(msg + "\n");
 }
 
+// ── ASCII Animation ──────────────────────────────────────────
+
+const BANNER_FRAMES = [
+  // Frame 1: empty
+  ``,
+  // Frame 2: dots forming
+  `
+                          .  .  .
+`,
+  // Frame 3: lines emerging
+  `
+                     _______________
+                    |               |
+                    |_______________|
+`,
+  // Frame 4: box growing
+  `
+              _____________________________
+             |                             |
+             |                             |
+             |                             |
+             |_____________________________|
+`,
+  // Frame 5: text appearing
+  `
+              _____________________________
+             |                             |
+             |        s k i l l s          |
+             |                             |
+             |_____________________________|
+`,
+  // Frame 6: full banner
+  `
+              _____________________________
+             |                             |
+             |     s k i l l s - w s       |
+             |                             |
+             |_____________________________|
+`,
+  // Frame 7: with underline detail
+  `
+              _____________________________
+             |                             |
+             |     s k i l l s - w s       |
+             |     ___________________     |
+             |_____________________________|
+`,
+  // Frame 8: with tagline
+  `
+              _____________________________
+             |                             |
+             |     s k i l l s - w s       |
+             |     ___________________     |
+             |     agent skills for AI     |
+             |_____________________________|
+`,
+];
+
+const INSTALL_FRAMES = [
+  `  [          ]  preparing`,
+  `  [=         ]  loading skills`,
+  `  [==        ]  loading skills`,
+  `  [===       ]  reading manifests`,
+  `  [====      ]  reading manifests`,
+  `  [=====     ]  copying files`,
+  `  [======    ]  copying files`,
+  `  [=======   ]  copying files`,
+  `  [========  ]  writing to disk`,
+  `  [========= ]  writing to disk`,
+  `  [==========]  done`,
+];
+
+function hideCursor() {
+  process.stdout.write("\x1b[?25l");
+}
+
+function showCursor() {
+  process.stdout.write("\x1b[?25h");
+}
+
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+async function playBanner() {
+  // Skip animation if not a TTY or NO_COLOR is set
+  if (!process.stdout.isTTY || process.env.NO_COLOR) {
+    print(`\n${BOLD}${WHITE}  skills-ws${RESET} ${DIM}v1.0.1${RESET}\n`);
+    return;
+  }
+
+  hideCursor();
+
+  for (const frame of BANNER_FRAMES) {
+    readline.cursorTo(process.stdout, 0, 0);
+    readline.clearScreenDown(process.stdout);
+    process.stdout.write(`${CYAN}${frame}${RESET}\n`);
+    await sleep(90);
+  }
+
+  // Hold final frame, then fade to colored version
+  await sleep(200);
+  readline.cursorTo(process.stdout, 0, 0);
+  readline.clearScreenDown(process.stdout);
+
+  print();
+  print(`${GRAY}              _____________________________${RESET}`);
+  print(`${GRAY}             |                             |${RESET}`);
+  print(`${GRAY}             |     ${WHITE}${BOLD}s k i l l s - w s${RESET}${GRAY}       |${RESET}`);
+  print(`${GRAY}             |     ${DIM}___________________${RESET}${GRAY}     |${RESET}`);
+  print(`${GRAY}             |     ${DIM}agent skills for AI${RESET}${GRAY}     |${RESET}`);
+  print(`${GRAY}             |_____________________________|${RESET}`);
+  print();
+
+  await sleep(300);
+  showCursor();
+}
+
+async function playInstallProgress(skillCount) {
+  if (!process.stdout.isTTY || process.env.NO_COLOR) return;
+
+  hideCursor();
+  const startLine = process.stdout.rows || 20;
+
+  for (const frame of INSTALL_FRAMES) {
+    readline.cursorTo(process.stdout, 0);
+    readline.clearLine(process.stdout, 0);
+    process.stdout.write(`${GREEN}${frame}${RESET}`);
+    await sleep(80);
+  }
+
+  readline.cursorTo(process.stdout, 0);
+  readline.clearLine(process.stdout, 0);
+  process.stdout.write(
+    `${GREEN}  [==========]${RESET}  ${BOLD}${skillCount} skill${skillCount !== 1 ? "s" : ""} installed${RESET}\n`
+  );
+
+  showCursor();
+}
+
+// ── Skill Operations ─────────────────────────────────────────
+
 async function getSkills() {
   const entries = await readdir(SKILLS_DIR, { withFileTypes: true });
   const skills = [];
@@ -30,8 +175,8 @@ async function getSkills() {
     try {
       await stat(skillMd);
       const content = await readFile(skillMd, "utf8");
-      const descMatch = content.match(/^description:\s*(.+)$/m);
-      const desc = descMatch ? descMatch[1].replace(/^["']|["']$/g, "") : "";
+      const descMatch = content.match(/^description:\s*["']?(.+?)["']?\s*$/m);
+      const desc = descMatch ? descMatch[1] : "";
       skills.push({ name: e.name, desc, dir: skillDir });
     } catch {
       // skip dirs without SKILL.md
@@ -55,7 +200,6 @@ async function copyDir(src, dest) {
 }
 
 async function detectTarget() {
-  // Check for common skill directories
   const candidates = [
     join(process.cwd(), ".claude", "skills"),
     join(process.cwd(), "skills"),
@@ -71,46 +215,57 @@ async function detectTarget() {
   return join(process.cwd(), "skills");
 }
 
+// ── Main ─────────────────────────────────────────────────────
+
 async function main() {
   const args = process.argv.slice(2);
   const skills = await getSkills();
 
-  print();
-  print(`${BOLD}${WHITE}skills-ws${RESET} ${DIM}v1.0.0${RESET}`);
-  print(`${DIM}https://skills-ws.vercel.app${RESET}`);
-  print();
+  // Always play banner
+  await playBanner();
 
   if (args[0] === "list" || args[0] === "ls") {
-    print(`${BOLD}Available skills:${RESET}`);
+    print(`${BOLD}  Available skills:${RESET}`);
     print();
     for (const s of skills) {
-      print(`  ${GREEN}${s.name}${RESET}  ${DIM}${s.desc.slice(0, 80)}${RESET}`);
+      print(`    ${GREEN}${s.name}${RESET}  ${DIM}${s.desc.slice(0, 70)}${RESET}`);
     }
     print();
-    print(`${DIM}${skills.length} skills available. Run: npx skills-ws install <name>${RESET}`);
+    print(`  ${DIM}${skills.length} skills available. Run: npx skills-ws install <name>${RESET}`);
+    print();
     return;
   }
 
   if (args[0] === "install" || args[0] === "add") {
     const names = args.slice(1);
+
     if (names.length === 0) {
-      // Interactive mode
-      print(`${BOLD}Available skills:${RESET}`);
+      print(`${BOLD}  Available skills:${RESET}`);
       print();
       for (let i = 0; i < skills.length; i++) {
-        print(`  ${DIM}${String(i + 1).padStart(2)}.${RESET} ${GREEN}${skills[i].name}${RESET}  ${DIM}${skills[i].desc.slice(0, 60)}${RESET}`);
+        print(
+          `    ${DIM}${String(i + 1).padStart(2)}.${RESET} ${GREEN}${skills[i].name}${RESET}  ${DIM}${skills[i].desc.slice(0, 55)}${RESET}`
+        );
       }
       print();
-      print(`${YELLOW}Enter skill numbers or names (comma-separated), or 'all':${RESET}`);
+      print(`  ${YELLOW}Enter skill numbers or names (comma-separated), or 'all':${RESET}`);
 
-      const rl = createInterface({ input: process.stdin, output: process.stdout });
-      const answer = await new Promise((resolve) => rl.question(`${CYAN}> ${RESET}`, resolve));
+      const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+      });
+      const answer = await new Promise((resolve) =>
+        rl.question(`  ${CYAN}> ${RESET}`, resolve)
+      );
       rl.close();
 
       if (answer.trim().toLowerCase() === "all") {
         names.push(...skills.map((s) => s.name));
       } else {
-        for (const part of answer.split(",").map((s) => s.trim()).filter(Boolean)) {
+        for (const part of answer
+          .split(",")
+          .map((s) => s.trim())
+          .filter(Boolean)) {
           const num = parseInt(part);
           if (!isNaN(num) && num >= 1 && num <= skills.length) {
             names.push(skills[num - 1].name);
@@ -122,45 +277,69 @@ async function main() {
     }
 
     if (names.length === 0) {
-      print(`${DIM}Nothing selected.${RESET}`);
+      print(`  ${DIM}Nothing selected.${RESET}`);
       return;
     }
 
     const target = await detectTarget();
     print();
-    print(`${DIM}Installing to: ${target}${RESET}`);
+    print(`  ${DIM}target: ${target}${RESET}`);
     print();
 
     let installed = 0;
     for (const name of names) {
       const skill = skills.find((s) => s.name === name);
       if (!skill) {
-        print(`  ${YELLOW}skip${RESET} ${name} (not found)`);
+        print(`    ${YELLOW}skip${RESET} ${name} ${DIM}(not found)${RESET}`);
         continue;
       }
       const dest = join(target, name);
       await copyDir(skill.dir, dest);
-      print(`  ${GREEN}done${RESET} ${name}`);
       installed++;
     }
 
+    // Play install animation
+    await playInstallProgress(installed);
+    print();
+
+    // Summary
+    for (const name of names) {
+      const skill = skills.find((s) => s.name === name);
+      if (skill) {
+        print(`    ${GREEN}+${RESET} ${name}`);
+      }
+    }
+
+    print();
+    print(`  ${DIM}https://skills-ws.vercel.app${RESET}`);
     print();
-    print(`${BOLD}${installed} skill${installed !== 1 ? "s" : ""} installed.${RESET}`);
     return;
   }
 
   // Default: show help
-  print(`${BOLD}Usage:${RESET}`);
+  print(`${BOLD}  Usage:${RESET}`);
   print();
-  print(`  ${CYAN}npx skills-ws list${RESET}              List available skills`);
-  print(`  ${CYAN}npx skills-ws install${RESET}            Interactive install`);
-  print(`  ${CYAN}npx skills-ws install <name>${RESET}     Install specific skill(s)`);
-  print(`  ${CYAN}npx skills-ws install all${RESET}        Install everything`);
+  print(`    ${CYAN}npx skills-ws list${RESET}              List available skills`);
+  print(`    ${CYAN}npx skills-ws install${RESET}            Interactive install`);
+  print(`    ${CYAN}npx skills-ws install <name>${RESET}     Install specific skill(s)`);
+  print(`    ${CYAN}npx skills-ws install all${RESET}        Install everything`);
+  print();
+  print(`  ${DIM}${skills.length} skills | https://skills-ws.vercel.app${RESET}`);
   print();
-  print(`${DIM}${skills.length} skills available. Browse: https://skills-ws.vercel.app${RESET}`);
 }
 
+// Clean up cursor on exit
+process.on("SIGINT", () => {
+  showCursor();
+  process.exit(0);
+});
+
+process.on("exit", () => {
+  showCursor();
+});
+
 main().catch((err) => {
+  showCursor();
   console.error(err);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills-ws",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Install agent skills for AI coding assistants — OpenClaw, Claude Code, Cursor, Codex",
   "bin": {
     "skills-ws": "./bin/cli.mjs"