@smitdev/ai-skills 0.2.0 → 0.3.0

package/README.md

@@ -14,7 +14,8 @@ No global install needed — run it with `npx`:
 # See what's available
 npx @smitdev/ai-skills list
 
-# Interactive: pick assistant(s) and skill(s)
+# Interactive: pick assistant(s) and skill(s) with the keyboard
+#   ↑/↓ move · space or tab toggle · a select all · enter confirm
 npx @smitdev/ai-skills install
 
 # Non-interactive examples

package/bin/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 'use strict';
 
-const readline = require('readline');
 const path = require('path');
 const { listSkills } = require('../lib/skills');
 const { adapters } = require('../lib/adapters');
 const { install } = require('../lib/install');
+const { multiselect, select } = require('../lib/prompt');
 
 const ASSISTANT_IDS = Object.keys(adapters);
 
@@ -31,10 +31,6 @@ function parseArgs(argv) {
   return args;
 }
 
-function ask(rl, question) {
-  return new Promise((resolve) => rl.question(question, (a) => resolve(a.trim())));
-}
-
 function parseList(val, valid) {
   if (val === true || !val) return [];
   const items = String(val)
@@ -55,6 +51,8 @@ Usage:
 Commands:
   list                 List the skills bundled in this package
   install              Install skills for one or more assistants
+                       (run with no flags for an interactive picker:
+                        ↑/↓ move · space/tab toggle · a all · enter confirm)
 
 Options for "install":
   --assistant <ids>    Comma-separated: ${ASSISTANT_IDS.join(', ')} (or "all")
@@ -73,20 +71,6 @@ Examples:
 `);
 }
 
-async function pickFromList(rl, label, options) {
-  console.log(`\n${label}`);
-  options.forEach((o, i) => console.log(`  ${i + 1}. ${o.label}`));
-  console.log(`  (comma-separated numbers, or "a" for all)`);
-  const ans = await ask(rl, '> ');
-  if (ans.toLowerCase() === 'a' || ans === '') return options.map((o) => o.id);
-  const picked = ans
-    .split(',')
-    .map((s) => parseInt(s.trim(), 10))
-    .filter((n) => n >= 1 && n <= options.length)
-    .map((n) => options[n - 1].id);
-  return [...new Set(picked)];
-}
-
 async function runInstall(args) {
   const skills = listSkills();
   if (skills.length === 0) {
@@ -98,31 +82,43 @@ async function runInstall(args) {
     typeof args.flags.dir === 'string' ? args.flags.dir : process.cwd()
   );
   const dryRun = !!args.flags['dry-run'];
-  const scope = args.flags.global ? 'global' : 'project';
+  const scopeFlagged = !!args.flags.global || !!args.flags.project;
+  let scope = args.flags.global ? 'global' : 'project';
 
   let assistants = parseList(args.flags.assistant, ASSISTANT_IDS);
   let skillNames = parseList(args.flags.skill, skills.map((s) => s.name));
 
-  const nonInteractive =
-    args.flags.yes || (assistants.length > 0);
+  const nonInteractive = args.flags.yes || assistants.length > 0;
 
   if (!nonInteractive && process.stdin.isTTY) {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     if (assistants.length === 0) {
-      assistants = await pickFromList(
-        rl,
-        'Which assistant(s)?',
-        ASSISTANT_IDS.map((id) => ({ id, label: adapters[id].label }))
-      );
+      assistants = await multiselect({
+        title: 'Which assistant(s)? (Claude Code, Copilot, Cursor, Windsurf)',
+        options: ASSISTANT_IDS.map((id) => ({ id, label: adapters[id].label })),
+        initial: ['claude'],
+      });
     }
     if (skillNames.length === 0) {
-      skillNames = await pickFromList(
-        rl,
-        'Which skill(s)?',
-        skills.map((s) => ({ id: s.name, label: `${s.name} — ${truncate(s.description, 60)}` }))
-      );
+      skillNames = await multiselect({
+        title: 'Which skill(s)?',
+        options: skills.map((s) => ({
+          id: s.name,
+          label: `${s.name} — ${truncate(s.description, 60)}`,
+        })),
+        initial: skills.map((s) => s.name),
+      });
+    }
+    // Only Claude Code supports a global scope; ask when relevant.
+    if (!scopeFlagged && assistants.includes('claude')) {
+      scope = await select({
+        title: 'Install scope for Claude Code?',
+        options: [
+          { id: 'project', label: 'This project  (./.claude/skills)' },
+          { id: 'global', label: 'Global         (~/.claude/skills, available everywhere)' },
+        ],
+        initial: 'project',
+      });
     }
-    rl.close();
   }
 
   if (assistants.length === 0) assistants = ASSISTANT_IDS.slice();

package/lib/prompt.js

@@ -0,0 +1,185 @@
+'use strict';
+
+const readline = require('readline');
+
+// Tiny zero-dependency interactive prompts (checkbox + radio) built on
+// readline keypress events. Falls back to nothing in non-TTY environments —
+// callers should guard with process.stdin.isTTY.
+
+const useColor = !!process.stdout.isTTY && !process.env.NO_COLOR;
+const paint = (code) => (s) => (useColor ? `\x1b[${code}m${s}\x1b[0m` : String(s));
+const dim = paint('2');
+const bold = paint('1');
+const cyan = paint('36');
+const green = paint('32');
+
+function setupKeys() {
+  const input = process.stdin;
+  readline.emitKeypressEvents(input);
+  if (input.isTTY) input.setRawMode(true);
+  input.resume();
+  return input;
+}
+
+function teardownKeys(input, onKey) {
+  input.removeListener('keypress', onKey);
+  if (input.isTTY) input.setRawMode(false);
+  input.pause();
+}
+
+function hideCursor() {
+  if (useColor) process.stdout.write('\x1b[?25l');
+}
+function showCursor() {
+  if (useColor) process.stdout.write('\x1b[?25h');
+}
+
+/**
+ * Multi-select checkbox prompt.
+ *   options: [{ id, label }]
+ *   initial: array of pre-selected ids
+ * Resolves to an array of selected ids (in option order). Always returns at
+ * least one (the highlighted item) so callers never get an empty selection.
+ */
+function multiselect({ title, options, initial }) {
+  return new Promise((resolve) => {
+    const selected = new Set(initial || []);
+    let cursor = 0;
+    let rendered = 0;
+    const output = process.stdout;
+
+    const hint = dim(
+      '↑/↓ move · space/tab toggle · a all · enter confirm'
+    );
+
+    function render(first) {
+      if (!first) output.write(`\x1b[${rendered}A`);
+      const lines = [bold(title), hint];
+      options.forEach((o, i) => {
+        const active = i === cursor;
+        const pointer = active ? cyan('›') : ' ';
+        const box = selected.has(o.id) ? green('◉') : dim('◯');
+        const label = active ? cyan(o.label) : o.label;
+        lines.push(`${pointer} ${box} ${label}`);
+      });
+      output.write(lines.map((l) => '\x1b[2K' + l).join('\n') + '\n');
+      rendered = lines.length;
+    }
+
+    const input = setupKeys();
+    hideCursor();
+
+    function finish() {
+      if (selected.size === 0) selected.add(options[cursor].id);
+      teardownKeys(input, onKey);
+      showCursor();
+      resolve(options.filter((o) => selected.has(o.id)).map((o) => o.id));
+    }
+
+    function onKey(_str, key) {
+      if (!key) return;
+      if (key.ctrl && key.name === 'c') {
+        teardownKeys(input, onKey);
+        showCursor();
+        output.write('\n');
+        process.exit(130);
+      }
+      switch (key.name) {
+        case 'up':
+        case 'k':
+          cursor = (cursor - 1 + options.length) % options.length;
+          break;
+        case 'down':
+        case 'j':
+          cursor = (cursor + 1) % options.length;
+          break;
+        case 'space':
+        case 'tab':
+          if (selected.has(options[cursor].id)) selected.delete(options[cursor].id);
+          else selected.add(options[cursor].id);
+          break;
+        case 'a': {
+          if (selected.size === options.length) selected.clear();
+          else options.forEach((o) => selected.add(o.id));
+          break;
+        }
+        case 'return':
+        case 'enter':
+          finish();
+          return;
+        default:
+          return;
+      }
+      render(false);
+    }
+
+    input.on('keypress', onKey);
+    render(true);
+  });
+}
+
+/**
+ * Single-select radio prompt.
+ *   options: [{ id, label }]
+ * Resolves to one id.
+ */
+function select({ title, options, initial }) {
+  return new Promise((resolve) => {
+    let cursor = Math.max(0, options.findIndex((o) => o.id === initial));
+    if (cursor < 0) cursor = 0;
+    let rendered = 0;
+    const output = process.stdout;
+    const hint = dim('↑/↓ move · enter select');
+
+    function render(first) {
+      if (!first) output.write(`\x1b[${rendered}A`);
+      const lines = [bold(title), hint];
+      options.forEach((o, i) => {
+        const active = i === cursor;
+        const pointer = active ? cyan('›') : ' ';
+        const dot = active ? green('◉') : dim('◯');
+        const label = active ? cyan(o.label) : o.label;
+        lines.push(`${pointer} ${dot} ${label}`);
+      });
+      output.write(lines.map((l) => '\x1b[2K' + l).join('\n') + '\n');
+      rendered = lines.length;
+    }
+
+    const input = setupKeys();
+    hideCursor();
+
+    function onKey(_str, key) {
+      if (!key) return;
+      if (key.ctrl && key.name === 'c') {
+        teardownKeys(input, onKey);
+        showCursor();
+        output.write('\n');
+        process.exit(130);
+      }
+      switch (key.name) {
+        case 'up':
+        case 'k':
+          cursor = (cursor - 1 + options.length) % options.length;
+          break;
+        case 'down':
+        case 'j':
+          cursor = (cursor + 1) % options.length;
+          break;
+        case 'return':
+        case 'enter':
+          teardownKeys(input, onKey);
+          showCursor();
+          resolve(options[cursor].id);
+          return;
+        default:
+          return;
+      }
+      render(false);
+    }
+
+    input.on('keypress', onKey);
+    render(true);
+  });
+}
+
+module.exports = { multiselect, select };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smitdev/ai-skills",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Install reusable AI assistant skills (Claude Code, GitHub Copilot, Cursor, Windsurf) with one command.",
   "bin": {
     "ai-skills": "bin/cli.js"