agentskillsdk 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentskillsdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Install agent skills from agentskills.dk",
   "type": "module",
   "bin": {

package/src/commands/add.js

@@ -1,10 +1,10 @@
 import chalk from 'chalk';
 import ora from 'ora';
 import { fetchSkill, fetchSkills } from '../lib/api.js';
-import { detectAgents } from '../lib/detect-agent.js';
+import { detectAgents, AGENTS } from '../lib/detect-agent.js';
 import { downloadSkill } from '../lib/download.js';
 import { parseGithubSource } from '../lib/parse-source.js';
-import { selectPrompt } from '../lib/prompt.js';
+import { selectPrompt, checkboxPrompt } from '../lib/prompt.js';
 import { printBanner, printCompletionSummary, step, error } from '../lib/ui.js';
 
 export async function addCommand(skillName, options) {
@@ -71,29 +71,88 @@ export async function addCommand(skillName, options) {
     spinner.succeed(`Found skill: ${chalk.bold(skill.name)}`);
   }
 
-  // --- detect agent ---
-  const agents = await detectAgents(cwd);
-  const agent = agents[0];
-  step(`Detected agent: ${chalk.bold(agent.name)}`);
-
-  // --- resolve scope ---
+  // --- agent selection + scope prompt (with back navigation) ---
+  const detected = detectAgents(cwd);
+  let agents;
   let scope;
-  if (options.global) {
-    scope = 'global';
-  } else if (options.project) {
-    scope = 'project';
+
+  agentSelection: while (true) {
+    agents = null;
+
+    if (detected.length === 1) {
+      // Auto-select the single detected agent
+      agents = detected;
+    } else if (detected.length > 1) {
+      // Prompt: all detected vs choose specific
+      const names = detected.map(a => a.name).join(', ');
+      const choice = await selectPrompt('How would you like to install?', [
+        { label: `All detected agents (${names})`, value: 'all' },
+        { label: 'Choose specific agents...', value: 'choose' },
+      ]);
+
+      if (choice === null) {
+        // Esc from top-level → cancel
+        process.exit(0);
+      }
+
+      if (choice === 'all') {
+        agents = detected;
+      } else {
+        // Checkbox from detected agents
+        const choices = detected.map(a => ({ label: a.name, value: a }));
+        const selected = await checkboxPrompt('Select agents:', choices);
+        if (selected === null) continue agentSelection; // Esc → back to all/choose
+        agents = selected;
+      }
+    } else {
+      // No agents detected — show checkbox of all known agents
+      const choices = AGENTS.map(a => ({ label: a.name, value: a }));
+      const selected = await checkboxPrompt('Select agents:', choices);
+      if (selected === null) {
+        // Esc with no detected agents → cancel
+        process.exit(0);
+      }
+      agents = selected;
+    }
+
+    // --- resolve scope ---
+    if (options.global) {
+      scope = 'global';
+    } else if (options.project) {
+      scope = 'project';
+    } else {
+      // Build hint using first agent (representative)
+      const a = agents[0];
+      const result = await selectPrompt('Install scope:', [
+        { label: 'Project', hint: `(local ${a.folder}/skills/)`, value: 'project' },
+        { label: 'Global', hint: `(~/${a.globalFolder}/skills/)`, value: 'global' },
+      ]);
+
+      if (result === null) {
+        // Esc → back to agent selection (unless auto-selected single agent)
+        if (detected.length === 1) process.exit(0);
+        continue agentSelection;
+      }
+      scope = result;
+    }
+
+    break; // selection complete
+  }
+
+  // --- step message ---
+  if (agents.length === 1) {
+    step(`Agent: ${chalk.bold(agents[0].name)}`);
   } else {
-    scope = await selectPrompt('Install scope:', [
-      { label: 'Project', hint: `(local ${agent.folder}/skills/)`, value: 'project' },
-      { label: 'Global', hint: `(~/${agent.globalFolder}/skills/)`, value: 'global' },
-    ]);
+    step(`Agents: ${chalk.bold(agents.map(a => a.name).join(', '))}`);
   }
 
-  // --- download ---
-  const destDir = agent.path(installName, { cwd, scope });
+  // --- download to each agent ---
   const spinner = ora({ text: 'Downloading skill files...', indent: 2 }).start();
   try {
-    await downloadSkill(skill, destDir);
+    for (const agent of agents) {
+      const destDir = agent.path(installName, { cwd, scope });
+      await downloadSkill(skill, destDir);
+    }
   } catch (err) {
     spinner.fail('Download failed');
     error(err.message);
@@ -105,8 +164,7 @@ export async function addCommand(skillName, options) {
   printCompletionSummary({
     skillName: installName,
     scope,
-    installPath: agent.displayPath(installName, scope),
-    agentName: agent.name,
+    agents,
     isGithub,
     namespace: skill.namespace,
   });

package/src/lib/detect-agent.js

@@ -1,7 +1,6 @@
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
-import { selectPrompt } from './prompt.js';
 
 function makeAgent(name, folder, { globalFolder, detectFolder } = {}) {
   const gFolder = globalFolder || folder;
@@ -22,7 +21,7 @@ function makeAgent(name, folder, { globalFolder, detectFolder } = {}) {
   };
 }
 
-const AGENTS = [
+export const AGENTS = [
   makeAgent('Claude Code', '.claude'),
   makeAgent('Codex CLI', '.agents', { globalFolder: '.codex' }),
   makeAgent('Cursor', '.cursor'),
@@ -32,18 +31,6 @@ const AGENTS = [
   makeAgent('OpenCode', '.opencode'),
 ];
 
-export async function detectAgents(cwd) {
-  const found = AGENTS.filter(agent => existsSync(join(cwd, agent.detectFolder)));
-
-  if (found.length === 1) return [found[0]];
-  if (found.length > 1) {
-    const choices = found.map(a => ({ label: a.name, value: a }));
-    const selected = await selectPrompt('Which agent do you use?', choices);
-    return [selected];
-  }
-
-  // None found — ask user to pick
-  const choices = AGENTS.map(a => ({ label: a.name, value: a }));
-  const selected = await selectPrompt('Which agent do you use?', choices);
-  return [selected];
+export function detectAgents(cwd) {
+  return AGENTS.filter(agent => existsSync(join(cwd, agent.detectFolder)));
 }

package/src/lib/prompt.js

@@ -34,12 +34,15 @@ export function selectPrompt(question, choices, { defaultIndex = 0 } = {}) {
     }
 
     function render() {
-      return choices.map((c, i) => {
+      const lines = choices.map((c, i) => {
         const marker = i === selected ? chalk.cyan('\u276f') : ' ';
         const label = i === selected ? chalk.cyan(c.label) : c.label;
         const hint = c.hint ? chalk.dim(` ${c.hint}`) : '';
         return `  ${marker} ${label}${hint}`;
       });
+      lines.push('');
+      lines.push(chalk.dim('  ↑↓ navigate · enter select · esc back'));
+      return lines;
     }
 
     // Hide cursor
@@ -88,6 +91,16 @@ export function selectPrompt(question, choices, { defaultIndex = 0 } = {}) {
         return;
       }
 
+      // Esc (bare escape, not part of an arrow sequence)
+      if (key === '\x1b' && buf.length === 1) {
+        const upCount = totalPhysicalLines(prevLines) - 1;
+        if (upCount > 0) stdout.write(`\x1b[${upCount}A`);
+        stdout.write('\r\x1b[J');
+        cleanup();
+        resolve(null);
+        return;
+      }
+
       // Arrow keys come as escape sequences: \x1b[A (up), \x1b[B (down)
       if (key === '\x1b[A' || key === '\x1b[D') {
         // Up or Left
@@ -110,3 +123,121 @@ export function selectPrompt(question, choices, { defaultIndex = 0 } = {}) {
     stdin.on('data', onData);
   });
 }
+
+/**
+ * Interactive checkbox prompt with arrow-key navigation and space to toggle.
+ * Up/Down to move, Space to toggle, Enter to confirm, Esc to cancel.
+ *
+ * @param {string} question
+ * @param {{ label: string, value: any }[]} choices
+ * @returns {Promise<any[]|null>} array of selected values, or null if Esc
+ */
+export function checkboxPrompt(question, choices) {
+  return new Promise((resolve) => {
+    let cursor = 0;
+    const checked = new Array(choices.length).fill(false);
+    const { stdin, stdout } = process;
+    const cols = stdout.columns || 80;
+
+    function physicalLines(str) {
+      const w = stripAnsi(str).length;
+      return Math.max(1, Math.ceil(w / cols));
+    }
+
+    function totalPhysicalLines(lines) {
+      return lines.reduce((sum, l) => sum + physicalLines(l), 0);
+    }
+
+    function render() {
+      const lines = choices.map((c, i) => {
+        const box = checked[i] ? chalk.cyan('◼') : '◻';
+        const label = i === cursor ? chalk.cyan(c.label) : c.label;
+        return `  ${box} ${label}`;
+      });
+      lines.push('');
+      lines.push(chalk.dim('  ↑↓ navigate · space toggle · enter confirm · esc back'));
+      return lines;
+    }
+
+    // Hide cursor
+    stdout.write('\x1b[?25l');
+
+    // Print question
+    stdout.write(`\n  ${question}\n\n`);
+
+    // Initial render
+    let prevLines = render();
+    stdout.write(prevLines.join('\n'));
+
+    const wasRaw = stdin.isRaw;
+    stdin.setRawMode(true);
+    stdin.resume();
+
+    function cleanup() {
+      stdin.setRawMode(wasRaw ?? false);
+      stdin.removeListener('data', onData);
+      stdin.pause();
+      stdout.write('\x1b[?25h');
+    }
+
+    function onData(buf) {
+      const key = buf.toString();
+
+      // Ctrl+C
+      if (key === '\x03') {
+        cleanup();
+        stdout.write('\n');
+        process.exit(0);
+      }
+
+      // Enter — confirm selection (must have at least 1)
+      if (key === '\r' || key === '\n') {
+        const selected = choices.filter((_, i) => checked[i]);
+        if (selected.length === 0) return; // ignore — must select at least 1
+
+        const upCount = totalPhysicalLines(prevLines) - 1;
+        if (upCount > 0) stdout.write(`\x1b[${upCount}A`);
+        stdout.write('\r\x1b[J');
+        const summary = selected.map(c => chalk.cyan(c.label)).join(', ');
+        stdout.write(`  ${chalk.cyan('❯')} ${summary}\n`);
+        cleanup();
+        resolve(selected.map(c => c.value));
+        return;
+      }
+
+      // Esc
+      if (key === '\x1b' && buf.length === 1) {
+        const upCount = totalPhysicalLines(prevLines) - 1;
+        if (upCount > 0) stdout.write(`\x1b[${upCount}A`);
+        stdout.write('\r\x1b[J');
+        cleanup();
+        resolve(null);
+        return;
+      }
+
+      // Space — toggle
+      if (key === ' ') {
+        checked[cursor] = !checked[cursor];
+      }
+      // Up / Left
+      else if (key === '\x1b[A' || key === '\x1b[D') {
+        cursor = (cursor - 1 + choices.length) % choices.length;
+      }
+      // Down / Right
+      else if (key === '\x1b[B' || key === '\x1b[C') {
+        cursor = (cursor + 1) % choices.length;
+      } else {
+        return;
+      }
+
+      // Redraw
+      const upCount = totalPhysicalLines(prevLines) - 1;
+      if (upCount > 0) stdout.write(`\x1b[${upCount}A`);
+      stdout.write('\r\x1b[J');
+      prevLines = render();
+      stdout.write(prevLines.join('\n'));
+    }
+
+    stdin.on('data', onData);
+  });
+}

package/src/lib/ui.js

@@ -45,21 +45,40 @@ export function printBanner() {
 
 // --- completion summary ---
 
-export function printCompletionSummary({ skillName, scope, installPath, agentName, isGithub, namespace }) {
+export function printCompletionSummary({ skillName, scope, agents, isGithub, namespace }) {
   const scopeLabel = scope === 'global'
     ? 'Global (all projects)'
     : 'Project (local)';
 
+  const isSingle = agents.length === 1;
+  const agentNames = agents.map(a => a.name).join(', ');
+  const paths = agents.map(a => a.displayPath(skillName, scope));
+
   const lines = [
     chalk.bold.green('Skill installed successfully!'),
     '',
     `  ${chalk.dim('Skill:')}   ${skillName}`,
     `  ${chalk.dim('Scope:')}   ${scopeLabel}`,
-    `  ${chalk.dim('Path:')}    ${installPath}`,
-    '',
-    `Start a new ${agentName} session to use it.`,
   ];
 
+  if (isSingle) {
+    lines.push(`  ${chalk.dim('Agent:')}   ${agentNames}`);
+    lines.push(`  ${chalk.dim('Path:')}    ${paths[0]}`);
+  } else {
+    lines.push(`  ${chalk.dim('Agents:')}  ${agentNames}`);
+    lines.push(`  ${chalk.dim('Paths:')}   ${paths[0]}`);
+    for (let i = 1; i < paths.length; i++) {
+      lines.push(`            ${paths[i]}`);
+    }
+  }
+
+  lines.push('');
+  if (isSingle) {
+    lines.push(`Start a new ${agents[0].name} session to use it.`);
+  } else {
+    lines.push('Start a new session in any of these agents to use it.');
+  }
+
   if (!isGithub && namespace) {
     lines.push(`Learn more: ${chalk.underline(`https://agentskills.dk/skills/${namespace}`)}`);
   }