skill-linker 3.0.7 → 4.0.0

package/README.md

@@ -4,13 +4,12 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
 
-一個現代化的互動式 CLI 工具，用於將 AI Agent Skills 快速連結（Symlink）到各種 AI Agent 的專案或全域目錄中。
+一個現代化的 CLI 工具，用於將 AI Agent Skills 快速連結（Symlink）到各種 AI Agent 的專案或全域目錄中。
 
 ## ✨ 功能特色
 
-- **現代化 TUI 介面**：使用 `prompts` 提供流暢的互動體驗。
-- **模糊搜尋 (Fuzzy Search)**：在選擇 Repository 時，直接輸入文字即可即時過濾清單。
-- **智慧偵測**：自動偵測系統中已安裝的 Agent，並在選單中預設勾選。
+- **CLI 優先設計**：專為 AI Agent 打造的命令列介面，無需互動問答。
+- **自動化流程**：支援自動 Clone、安裝、覆寫。
 - **多 Agent 支援**：支援 Claude Code, GitHub Copilot, Antigravity, Cursor, Windsurf, OpenCode, Gemini CLI 等。
 - **雙重範圍 (Scope)**：可選擇安裝到當前 `專案目錄 (Project)` 或 `全域目錄 (Global)`。
 - **自動 Clone**：支援從 GitHub Clone 並自動處理 Multi-skill Repos。
@@ -21,19 +20,14 @@
 ### 方式 1：使用 npx (推薦)
 
 ```bash
-# 啟動互動式安裝介面 (選擇本地或新 Clone)
-npx skill-linker
+# 安裝技能（需要 --skill 或 --from）
+npx /app/workspace/projects/skill-linker install --skill <路徑> --agent opencode --scope both --yes
+npx skill-linker install --from https://github.com/anthropics/skills --agent claude --scope both
 
-# 瀏覽並從庫中 (AgentSkills/) 挑選已下載的 Skill
+# 列出已安裝的 Repos
 npx skill-linker list
-# 或使用縮寫
-npx skill-linker -l
-
-# 從 GitHub Clone 並安裝
-npx skill-linker --from https://github.com/user/my-skill
-
-# 指定本地路徑 (如果是自己 clone 下來的指定目錄)
-npx skill-linker /path/to/my-skill
+npx skill-linker list --repo skill-name
+npx skill-linker list --repo skill-name --json
 ```
 
 ### 方式 2：本地開發/安裝
@@ -48,43 +42,67 @@ npm link # 之後可直接使用 skill-linker 指令
 ## 🛠️ 命令說明
 
 ```
-Usage: skill-linker [options] [command] [skill-path]
+Usage: skill-linker [command]
 
-Interactive CLI to link AI Agent Skills to various agents
+CLI to link AI Agent Skills to various agents
 
-Arguments:
-  skill-path           指定本地 Skill 目錄路徑
+Commands:
+  install    Install a skill to specified agents
+  list       List available skills in library
 
 Options:
-  -V, --version        顯示版本號
-  --from <github-url>  先從 GitHub Clone Skill 後再進行連結
-  -l, --list           列出庫中可用的 Skills (可互動選擇)
-  -h, --help           顯示說明
+  -V, --version    顯示版本號
+  -h, --help       顯示說明
+```
+
+### install 命令
 
-Commands:
-  list                 列出庫中所有可用的 Repos 與其 Skills
 ```
+Usage: skill-linker install --skill <path>
 
-### 📋 瀏覽模式 (List Mode)
+Options:
+  --skill <path>         指定本地 Skill 目錄路徑（必需）
+  --from <github-url>    從 GitHub Clone 後再進行連結
+  -a, --agent <names>    指定 Agent 名稱（opencode, claude, cursor 等）
+  -s, --scope <scope>    範圍：project, global, both（預設 both）
+  -y, --yes              自動覆寫已存在的連結
+```
 
-如果您想從之前透過 `--from` 下載過的庫 (`~/Documents/AgentSkills`) 中挑選 Skill 來安裝，請使用 `list` 子指令：
+範例：
 
 ```bash
-npx skill-linker list
+# 指定路徑安裝到 opencode
+npx skill-linker install --skill /path/to/skill --agent opencode
+
+# 從 GitHub Clone 並安裝到多個 Agents
+npx skill-linker install --from https://github.com/anthropics/skills --agent claude cursor --scope both
+
+# 安裝到所有已偵測到的 Agents
+npx skill-linker install --skill /path/to/skill --scope both --yes
 ```
 
-或使用選項：
-```bash
-npx skill-linker -l
+### list 命令
+
 ```
+Usage: skill-linker list [options]
 
-1. **第一層**：選擇已 Clone 的 Repository (會標註是否有 `skills/` 子目錄)。
-2. **第二層**：如果該 Repo 包含多個 Skills，會進階列出供您查看。
+Options:
+  -r, --repo <name>   指定 Repository 名稱
+  --json              JSON 輸出格式
+```
+
+範例：
 
-> 💡 **提示**：如果您已經手動 `git clone` 了某個 Skill Repo，也可以直接指定路徑安裝：
-> ```bash
-> npx skill-linker /path/to/your-cloned-repo
-> ```
+```bash
+# 列出所有 Repos
+npx skill-linker list
+
+# 列出特定 Repo 的 Skills
+npx skill-linker list --repo skill-name
+
+# JSON 輸出
+npx skill-linker list --repo skill-name --json
+```
 
 ## 📂 Skill Library 管理
 
@@ -100,35 +118,41 @@ npx skill-linker -l
 
 ## 🛠️ 支援的 Agent 與路徑
 
-| 平台 / 工具 | 專案目錄 | 全域目錄 |
-|------------|---------|---------|
-| **Claude Code** | `.claude/skills/` | `~/.claude/skills/` |
-| **GitHub Copilot** | `.github/skills/` | `~/.copilot/skills/` |
-| **Google Antigravity** | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
-| **Cursor** | `.cursor/skills/` | `~/.cursor/skills/` |
-| **OpenCode** | `.opencode/skill/` | `~/.config/opencode/skill/` |
-| **OpenAI Codex** | `.codex/skills/` | `~/.codex/skills/` |
-| **Gemini CLI** | `.gemini/skills/` | `~/.gemini/skills/` |
-| **Windsurf** | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| 平台 / 工具            | 專案目錄            | 全域目錄                        |
+| ---------------------- | ------------------- | ------------------------------- |
+| **Claude Code**        | `.claude/skills/`   | `~/.claude/skills/`             |
+| **GitHub Copilot**     | `.github/skills/`   | `~/.copilot/skills/`            |
+| **Google Antigravity** | `.agent/skills/`    | `~/.gemini/antigravity/skills/` |
+| **Cursor**             | `.cursor/skills/`   | `~/.cursor/skills/`             |
+| **OpenCode**           | `.opencode/skill/`  | `~/.config/opencode/skill/`     |
+| **OpenAI Codex**       | `.codex/skills/`    | `~/.codex/skills/`              |
+| **Gemini CLI**         | `.gemini/skills/`   | `~/.gemini/skills/`             |
+| **Windsurf**           | `.windsurf/skills/` | `~/.codeium/windsurf/skills/`   |
 
 ## 📦 推薦的 Public Skill Repos
 
 ### Claude 官方 Skills (pdf, docx, pptx, xlsx...)
+
 [anthropics/skills](https://github.com/anthropics/skills)
+
 ```bash
-npx skill-linker --from https://github.com/anthropics/skills
+npx skill-linker install --from https://github.com/anthropics/skills --agent claude
 ```
 
 ### moltbot 的 AI Agent Skills (來自 clawdhub.com)
+
 [moltbot/skills](https://github.com/moltbot/skills)
+
 ```bash
-npx skill-linker --from https://github.com/moltbot/skills
+npx skill-linker install --from https://github.com/moltbot/skills --agent opencode
 ```
 
 ### 精選的 AI Skills 工具箱
+
 [obra/superpowers](https://github.com/obra/superpowers)
+
 ```bash
-npx skill-linker --from https://github.com/obra/superpowers
+npx skill-linker install --from https://github.com/obra/superpowers --agent claude cursor
 ```
 
 ## ⚠️ 注意事項

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "skill-linker",
-  "version": "3.0.7",
-  "description": "Interactive CLI to link AI Agent Skills to various agents (Claude, Copilot, Antigravity, Cursor, etc.)",
+  "version": "4.0.0",
+  "description": "CLI to link AI Agent Skills to various agents (Claude, Copilot, Antigravity, Cursor, etc.)",
   "main": "bin/cli.js",
   "bin": {
     "skill-linker": "bin/cli.js"
@@ -28,8 +28,7 @@
   "dependencies": {
     "chalk": "^4.1.2",
     "commander": "^12.0.0",
-    "execa": "^5.1.1",
-    "prompts": "^2.4.2"
+    "execa": "^5.1.1"
   },
   "repository": {
     "type": "git",

package/src/cli.js

@@ -1,45 +1,57 @@
 #!/usr/bin/env node
 
-const { program } = require('commander');
-const chalk = require('chalk');
-const install = require('./commands/install');
-const list = require('./commands/list');
+const { program } = require("commander");
+const chalk = require("chalk");
+const install = require("./commands/install");
+const list = require("./commands/list");
 
 // Package info
-const packageJson = require('../package.json');
+const packageJson = require("../package.json");
 
 program
-    .name('skill-linker')
-    .description('Interactive CLI to link AI Agent Skills to various agents')
-    .version(packageJson.version);
+  .name("skill-linker")
+  .description(
+    "CLI to link AI Agent Skills to various agents (Claude, Copilot, Antigravity, Cursor, etc.)",
+  )
+  .version(packageJson.version);
 
-// Default command (install)
+// Install command
 program
-    .argument('[skill-path]', 'Path to skill directory')
-    .option('--from <github-url>', 'Clone skill from GitHub URL first, then link')
-    .option('-l, --list', 'List available skills in library')
-    .action(async (skillPath, options) => {
-        // Handle --list flag
-        if (options.list) {
-            await list();
-            return;
-        }
-
-        // Run install command
-        await install({
-            skill: skillPath,
-            from: options.from
-        });
+  .command("install")
+  .description("Install a skill to specified agents")
+  .requiredOption(
+    "--skill <path>",
+    "Path to skill directory or --from clone URL",
+  )
+  .option("--from <github-url>", "Clone skill from GitHub URL first, then link")
+  .option(
+    "-a, --agent <names...>",
+    "Agent names to install to (opencode, claude, cursor, etc.)",
+  )
+  .option("-s, --scope <scope>", "Scope: project, global, or both")
+  .option("-y, --yes", "Skip confirmation prompts")
+  .action(async (options) => {
+    await install({
+      skill: options.skill,
+      from: options.from,
+      agents: options.agent,
+      scope: options.scope,
+      yes: options.yes || false,
     });
+  });
 
-// Standalone list command
+// List command
 program
-    .command('list')
-    .description('List all available skills in the library')
-    .action(async () => {
-        await list();
+  .command("list")
+  .description("List available skills in library")
+  .option("-r, --repo <name>", "Repository name to list skills from")
+  .option("--json", "Output as JSON")
+  .action(async (options) => {
+    await list({
+      repo: options.repo,
+      json: options.json || false,
     });
+  });
 
 // Parse command line arguments
 program.parse(process.argv);
-

package/src/commands/install.js

@@ -1,260 +1,201 @@
-const prompts = require('prompts');
-const chalk = require('chalk');
-const path = require('path');
-const { findSkills, findRepos, dirExists, ensureDir, createSymlink, listDirectories } = require('../utils/file-system');
-const { getAllAgents, detectInstalledAgents } = require('../utils/agents');
-const { DEFAULT_LIB_PATH, cloneOrUpdateRepo, pullRepo } = require('../utils/git');
+const chalk = require("chalk");
+const path = require("path");
+const {
+  dirExists,
+  ensureDir,
+  createSymlink,
+  listDirectories,
+} = require("../utils/file-system");
+const { getAllAgents, detectInstalledAgents } = require("../utils/agents");
+const { cloneOrUpdateRepo, pullRepo } = require("../utils/git");
 
 /**
- * Main install command
+ * Main install command (CLI mode only)
  * @param {Object} options - Command options
+ * @param {string} options.skill - Skill path or --from clone URL
+ * @param {string} [options.from] - GitHub URL to clone from
+ * @param {string[]} [options.agents] - Agent names to install to
+ * @param {string} [options.scope] - Scope: project, global, or both
+ * @param {boolean} [options.yes] - Auto-overwrite existing links
  */
 async function install(options) {
-    let skillPaths = [];
-
-    // Handle --from flag: Clone from GitHub
-    if (options.from) {
-        console.log(chalk.blue('[INFO]'), `Cloning from ${options.from}...`);
-
-        try {
-            const { skillPath: clonedPath, targetPath, needsUpdate, hasSubpath } = await cloneOrUpdateRepo(options.from);
-
-            if (needsUpdate) {
-                const { shouldUpdate } = await prompts({
-                    type: 'confirm',
-                    name: 'shouldUpdate',
-                    message: `Repository already exists. Update with git pull?`,
-                    initial: false
-                });
-
-                if (shouldUpdate) {
-                    await pullRepo(targetPath);
-                    console.log(chalk.green('[SUCCESS]'), 'Repository updated!');
-                }
-            }
-
-            // If no subpath, check for skills/ subdirectory
-            if (!hasSubpath && dirExists(path.join(targetPath, 'skills'))) {
-                const subSkills = listDirectories(path.join(targetPath, 'skills'));
-
-                if (subSkills.length > 0) {
-                    const { selectedSkills } = await prompts({
-                        type: 'multiselect',
-                        name: 'selectedSkills',
-                        message: 'This repo contains multiple skills. Select skills to install:',
-                        choices: [
-                            ...subSkills.map(s => ({ title: s, value: path.join(targetPath, 'skills', s) })),
-                            { title: 'Link entire repo', value: targetPath }
-                        ],
-                        hint: '- Space to select. Return to submit'
-                    });
+  let skillPaths = [];
+
+  // Handle --from flag: Clone from GitHub
+  if (options.from) {
+    console.log(chalk.blue("[INFO]"), `Cloning from ${options.from}...`);
+
+    try {
+      const {
+        skillPath: clonedPath,
+        targetPath,
+        needsUpdate,
+        hasSubpath,
+      } = await cloneOrUpdateRepo(options.from);
+
+      if (needsUpdate) {
+        if (options.yes) {
+          await pullRepo(targetPath);
+          console.log(chalk.green("[SUCCESS]"), "Repository updated!");
+        } else {
+          console.log(
+            chalk.yellow("[WARNING]"),
+            "Repository already exists. Use --yes to update.",
+          );
+        }
+      }
 
-                    if (selectedSkills && selectedSkills.length > 0) {
-                        skillPaths = selectedSkills;
-                    } else {
-                        // If nothing selected, maybe they just hit enter without selection? Default to repo path?
-                        // Or better, error out if multiselect returns empty.
-                        // Let's assume empty selection means exit or user made mistake.
-                        // But to be safe, if they chose "Link entire repo" in multiselect (which is weird), handle it.
-                        // Actually multiselect is better for picking subsets.
-                        // If empty, let's fall back to entire repo (or maybe error).
-                        // Let's error to be consistent with agent selection.
-                    }
-                } else {
-                    skillPaths = [targetPath];
-                }
-            } else {
-                skillPaths = [clonedPath];
-            }
+      // If no subpath, check for skills/ subdirectory
+      if (!hasSubpath && dirExists(path.join(targetPath, "skills"))) {
+        const subSkills = listDirectories(path.join(targetPath, "skills"));
 
-            console.log(chalk.green('[SUCCESS]'), 'Clone completed!');
-        } catch (error) {
-            console.error(chalk.red('[ERROR]'), error.message);
-            process.exit(1);
+        if (subSkills.length > 0) {
+          // Install all skills from skills/ directory
+          skillPaths = subSkills.map((s) => path.join(targetPath, "skills", s));
+        } else {
+          skillPaths = [targetPath];
         }
+      } else {
+        skillPaths = [clonedPath];
+      }
+
+      console.log(chalk.green("[SUCCESS]"), "Clone completed!");
+    } catch (error) {
+      console.error(chalk.red("[ERROR]"), error.message);
+      process.exit(1);
     }
-
-    // If no skill path provided, show library selection
-    if (skillPaths.length === 0 && options.skill) {
-        skillPaths = [options.skill];
+  }
+
+  // If no skill path provided via --from, use --skill
+  if (skillPaths.length === 0 && options.skill) {
+    skillPaths = [options.skill];
+  }
+
+  // Validate skill paths
+  for (const p of skillPaths) {
+    if (!dirExists(p)) {
+      console.error(chalk.red("[ERROR]"), `Skill directory not found: ${p}`);
+      process.exit(1);
     }
-
-    if (skillPaths.length === 0) {
-        if (!dirExists(DEFAULT_LIB_PATH)) {
-            console.error(chalk.red('[ERROR]'), `Skill library not found: ${DEFAULT_LIB_PATH}`);
-            console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-            process.exit(1);
-        }
-
-        const repos = findRepos(DEFAULT_LIB_PATH);
-
-        if (repos.length === 0) {
-            console.error(chalk.red('[ERROR]'), `No repos found in ${DEFAULT_LIB_PATH}`);
-            console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-            process.exit(1);
-        }
-
-        console.log('');
-
-        // 1. Select Repository
-        const { selectedRepo } = await prompts({
-            type: 'autocomplete',
-            name: 'selectedRepo',
-            message: 'Select a repository:',
-            choices: repos.map(repo => ({
-                title: `${repo.name}${repo.hasSkillsDir ? chalk.dim(' (has skills/)') : ''}`,
-                value: repo
-            })),
-            suggest: (input, choices) => {
-                const inputLower = input.toLowerCase();
-                return Promise.resolve(
-                    choices.filter(choice => choice.title.toLowerCase().includes(inputLower))
-                );
-            }
-        });
-
-        if (!selectedRepo) {
-            console.log(chalk.yellow('[WARNING]'), 'No repository selected. Exiting.');
-            process.exit(0);
+  }
+
+  if (skillPaths.length > 1) {
+    console.log(chalk.blue("[INFO]"), `Selected ${skillPaths.length} skills`);
+  } else {
+    const skillName = path.basename(skillPaths[0]);
+    console.log(
+      chalk.blue("[INFO]"),
+      `Selected Skill: ${chalk.cyan(skillName)} (${skillPaths[0]})`,
+    );
+  }
+
+  // Agent selection
+  const agents = getAllAgents();
+  const installedIndices = detectInstalledAgents();
+
+  let selectedAgents = [];
+
+  // Use provided agents list
+  if (options.agents && options.agents.length > 0) {
+    selectedAgents = options.agents
+      .map((agentName) => {
+        const idx = agents.findIndex(
+          (a) => a.name.toLowerCase() === agentName.toLowerCase(),
+        );
+        if (idx === -1) {
+          console.log(
+            chalk.yellow("[WARNING]"),
+            `Unknown agent: ${agentName}, skipping...`,
+          );
+          return null;
         }
+        return idx;
+      })
+      .filter((idx) => idx !== null);
 
-        // 2. Select Sub-skills (if applicable)
-        if (selectedRepo.hasSkillsDir) {
-            const skillsDir = path.join(selectedRepo.path, 'skills');
-            const subSkills = listDirectories(skillsDir);
-
-            if (subSkills.length > 0) {
-                const { selectedSubSkills } = await prompts({
-                    type: 'multiselect',
-                    name: 'selectedSubSkills',
-                    message: `Select skills from ${chalk.cyan(selectedRepo.name)} (Space to select):`,
-                    choices: [
-                        ...subSkills.map(s => ({ title: s, value: path.join(skillsDir, s) })),
-                        { title: 'Link entire repo', value: selectedRepo.path }
-                    ],
-                    hint: '- Space to select. Return to submit'
-                });
-
-                if (!selectedSubSkills || selectedSubSkills.length === 0) {
-                    console.log(chalk.yellow('[WARNING]'), 'No skills selected. Exiting.');
-                    process.exit(0);
-                }
-                skillPaths = selectedSubSkills;
-            } else {
-                skillPaths = [selectedRepo.path];
-            }
-        } else {
-            skillPaths = [selectedRepo.path];
-        }
+    if (selectedAgents.length === 0) {
+      console.error(chalk.red("[ERROR]"), "No valid agents specified");
+      process.exit(1);
     }
-
-    // Validate skill paths
-    for (const p of skillPaths) {
-        if (!dirExists(p)) {
-            console.error(chalk.red('[ERROR]'), `Skill directory not found: ${p}`);
-            process.exit(1);
-        }
+  } else {
+    // Use all installed agents
+    selectedAgents = installedIndices;
+    if (selectedAgents.length === 0) {
+      console.error(
+        chalk.red("[ERROR]"),
+        "No installed agents detected. Please specify --agent.",
+      );
+      process.exit(1);
     }
-
-    if (skillPaths.length > 1) {
-        console.log(chalk.blue('[INFO]'), `Selected ${skillPaths.length} skills`);
-    } else {
-        const skillName = path.basename(skillPaths[0]);
-        console.log(chalk.blue('[INFO]'), `Selected Skill: ${chalk.cyan(skillName)} (${skillPaths[0]})`);
+  }
+
+  console.log(
+    chalk.blue("[INFO]"),
+    `Installing to ${selectedAgents.length} agent(s): ${selectedAgents.map((i) => agents[i].name).join(", ")}`,
+  );
+
+  // Determine scope
+  let scope = options.scope ? options.scope.toLowerCase() : "both";
+  if (!["project", "global", "both"].includes(scope)) {
+    console.error(
+      chalk.red("[ERROR]"),
+      `Invalid scope: ${scope}. Use: project, global, or both`,
+    );
+    process.exit(1);
+  }
+  console.log(chalk.blue("[INFO]"), `Scope: ${scope}`);
+
+  // Process each selected agent
+  for (const agentIndex of selectedAgents) {
+    const agent = agents[agentIndex];
+
+    console.log("");
+    console.log(
+      chalk.blue("[INFO]"),
+      `Configuring for ${chalk.cyan(agent.name)}...`,
+    );
+
+    const targets = [];
+    if (scope === "project" || scope === "both") {
+      targets.push(path.join(process.cwd(), agent.projectDir));
     }
-
-    // Agent selection
-    const agents = getAllAgents();
-    const installedIndices = detectInstalledAgents();
-
-    const { selectedAgents } = await prompts({
-        type: 'multiselect',
-        name: 'selectedAgents',
-        message: 'Select agents to install to (Space to select, Enter to confirm):',
-        choices: agents.map((agent, index) => ({
-            title: agent.name + (installedIndices.includes(index) ? chalk.green(' (Installed)') : ''),
-            value: index,
-            selected: installedIndices.includes(index)
-        })),
-        hint: '- Space to select. Return to submit'
-    });
-
-    if (!selectedAgents || selectedAgents.length === 0) {
-        console.log(chalk.yellow('[WARNING]'), 'No agents selected. Exiting.');
-        process.exit(0);
+    if (scope === "global" || scope === "both") {
+      targets.push(agent.globalDir);
     }
 
-    // Process each selected agent
-    for (const agentIndex of selectedAgents) {
-        const agent = agents[agentIndex];
-
-        console.log('');
-        console.log(chalk.blue('[INFO]'), `Configuring for ${chalk.cyan(agent.name)}...`);
-
-        const { scope } = await prompts({
-            type: 'select',
-            name: 'scope',
-            message: 'Select scope:',
-            choices: [
-                { title: `Project (${agent.projectDir})`, value: 'project' },
-                { title: `Global (${agent.globalDir})`, value: 'global' },
-                { title: 'Both', value: 'both' },
-                { title: 'Skip', value: 'skip' }
-            ]
-        });
-
-        if (scope === 'skip') continue;
-
-        const targets = [];
-        if (scope === 'project' || scope === 'both') {
-            targets.push(path.join(process.cwd(), agent.projectDir));
-        }
-        if (scope === 'global' || scope === 'both') {
-            targets.push(agent.globalDir);
+    for (const targetBase of targets) {
+      ensureDir(targetBase);
+
+      // Loop through all selected skills and link them
+      for (const sPath of skillPaths) {
+        const sName = path.basename(sPath);
+        const targetLink = path.join(targetBase, sName);
+
+        if (dirExists(targetLink)) {
+          if (!options.yes) {
+            console.log(
+              chalk.yellow("[WARNING]"),
+              `Already exists: ${targetLink}. Use --yes to overwrite.`,
+            );
+            continue;
+          }
+          console.log(
+            chalk.blue("[INFO]"),
+            `Overwriting existing: ${targetLink}`,
+          );
         }
 
-        for (const targetBase of targets) {
-            ensureDir(targetBase);
-
-            // Loop through all selected skills and link them
-            for (const sPath of skillPaths) {
-                const sName = path.basename(sPath);
-                const targetLink = path.join(targetBase, sName);
-
-                if (dirExists(targetLink)) {
-                    // Check if already correct link to avoid prompt
-                    // But for simplicity, we prompt or skip. 
-                    // To avoid spamming prompts for multiple skills, maybe auto-overwrite or ask once?
-                    // Let's ask individually for safety for now, or maybe just log and skip if overwrite not confirmed.
-                    // Actually, prompting for every file in a loop is annoying. 
-                    // Let's check overlap first? Or just try createSymlink which handles unlink.
-
-                    // Let's prompt once per agent/target if any conflicts? Too complex.
-                    // Simple approach: Prompt for each conflict.
-                    const { overwrite } = await prompts({
-                        type: 'confirm',
-                        name: 'overwrite',
-                        message: `${targetLink} already exists. Overwrite?`,
-                        initial: false
-                    });
-
-                    if (!overwrite) {
-                        console.log(chalk.blue('[INFO]'), `Skipping ${sName}...`);
-                        continue;
-                    }
-                }
-
-                if (createSymlink(sPath, targetLink)) {
-                    console.log(chalk.green('[SUCCESS]'), `Linked ${sName}`);
-                } else {
-                    console.error(chalk.red('[ERROR]'), `Failed to link ${sName}`);
-                }
-            }
+        if (createSymlink(sPath, targetLink)) {
+          console.log(chalk.green("[SUCCESS]"), `Linked ${sName}`);
+        } else {
+          console.error(chalk.red("[ERROR]"), `Failed to link ${sName}`);
         }
+      }
     }
+  }
 
-    console.log('');
-    console.log(chalk.green('[SUCCESS]'), 'All operations completed.');
+  console.log("");
+  console.log(chalk.green("[SUCCESS]"), "All operations completed.");
 }
 
 module.exports = install;

package/src/commands/list.js

@@ -1,78 +1,155 @@
-const chalk = require('chalk');
-const prompts = require('prompts');
-const path = require('path');
-const { findRepos, listDirectories, dirExists } = require('../utils/file-system');
-const { DEFAULT_LIB_PATH } = require('../utils/git');
+const chalk = require("chalk");
+const path = require("path");
+const {
+  findRepos,
+  listDirectories,
+  dirExists,
+} = require("../utils/file-system");
+const { DEFAULT_LIB_PATH } = require("../utils/git");
 
 /**
- * List command - shows repos, then skills within selected repo
+ * List command - shows repos and skills (CLI mode only)
+ * @param {Object} options - Command options
+ * @param {string} [options.repo] - Repository name to list
+ * @param {boolean} [options.json] - Output as JSON
  */
-async function list() {
-    if (!dirExists(DEFAULT_LIB_PATH)) {
-        console.error(chalk.red('[ERROR]'), `Skill library not found: ${DEFAULT_LIB_PATH}`);
-        console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-        process.exit(1);
-    }
+async function list(options = {}) {
+  const repoName = options.repo;
+  const outputJson = options.json || false;
 
-    const repos = findRepos(DEFAULT_LIB_PATH);
+  if (!dirExists(DEFAULT_LIB_PATH)) {
+    console.error(
+      chalk.red("[ERROR]"),
+      `Skill library not found: ${DEFAULT_LIB_PATH}`,
+    );
+    console.log(
+      chalk.blue("[INFO]"),
+      "Use --from <github_url> to clone skills first.",
+    );
+    process.exit(1);
+  }
 
-    if (repos.length === 0) {
-        console.log(chalk.yellow('[WARNING]'), `No repos found in ${DEFAULT_LIB_PATH}`);
-        console.log(chalk.blue('[INFO]'), 'Use --from <github_url> to clone skills first.');
-        return;
-    }
+  const repos = findRepos(DEFAULT_LIB_PATH);
 
-    console.log('');
-    console.log(chalk.blue('[INFO]'), `Repositories in library (${DEFAULT_LIB_PATH}):`);
-    console.log('');
-
-    // Show repos with indication if they have skills/ directory
-    const { selectedRepo } = await prompts({
-        type: 'select',
-        name: 'selectedRepo',
-        message: 'Select a repository to view:',
-        choices: repos.map(repo => ({
-            title: `${repo.name}${repo.hasSkillsDir ? chalk.dim(' (has skills/)') : ''}`,
-            value: repo,
-            description: repo.path
-        }))
-    });
+  if (repos.length === 0) {
+    console.log(
+      chalk.yellow("[WARNING]"),
+      `No repos found in ${DEFAULT_LIB_PATH}`,
+    );
+    console.log(
+      chalk.blue("[INFO]"),
+      "Use --from <github_url> to clone skills first.",
+    );
+    return;
+  }
+
+  // CLI mode: use provided repo name
+  if (repoName) {
+    const selectedRepo = repos.find(
+      (r) => r.name.toLowerCase() === repoName.toLowerCase(),
+    );
 
     if (!selectedRepo) {
-        console.log(chalk.yellow('[INFO]'), 'No repository selected.');
-        return;
+      console.error(chalk.red("[ERROR]"), `Repository not found: ${repoName}`);
+      console.log(
+        chalk.blue("[INFO]"),
+        "Available repos:",
+        repos.map((r) => r.name).join(", "),
+      );
+      process.exit(1);
     }
 
-    console.log('');
-    console.log(chalk.blue('[INFO]'), `Repository: ${chalk.cyan(selectedRepo.name)}`);
-    console.log(chalk.dim(`Path: ${selectedRepo.path}`));
-    console.log('');
+    if (outputJson) {
+      const skills = selectedRepo.hasSkillsDir
+        ? listDirectories(path.join(selectedRepo.path, "skills"))
+        : [];
+      console.log(
+        JSON.stringify(
+          {
+            name: selectedRepo.name,
+            path: selectedRepo.path,
+            hasSkillsDir: selectedRepo.hasSkillsDir,
+            skills: skills,
+          },
+          null,
+          2,
+        ),
+      );
+    } else {
+      console.log("");
+      console.log(
+        chalk.blue("[INFO]"),
+        `Repository: ${chalk.cyan(selectedRepo.name)}`,
+      );
+      console.log(chalk.dim(`Path: ${selectedRepo.path}`));
+      console.log("");
 
-    // If repo has skills/ subdirectory, list the skills
-    if (selectedRepo.hasSkillsDir) {
-        const skillsDir = path.join(selectedRepo.path, 'skills');
+      if (selectedRepo.hasSkillsDir) {
+        const skillsDir = path.join(selectedRepo.path, "skills");
         const skills = listDirectories(skillsDir);
 
         if (skills.length === 0) {
-            console.log(chalk.yellow('[WARNING]'), 'No skills found in skills/ directory');
-            return;
+          console.log(
+            chalk.yellow("[WARNING]"),
+            "No skills found in skills/ directory",
+          );
+          return;
         }
 
-        console.log(chalk.blue('[INFO]'), 'Skills in this repository:');
-        console.log('');
+        console.log(chalk.blue("[INFO]"), "Skills in this repository:");
+        console.log("");
 
         skills.forEach((skill, index) => {
-            console.log(`  ${index + 1}. ${chalk.cyan(skill)}`);
-            console.log(`     ${chalk.dim(path.join(skillsDir, skill))}`);
+          console.log(`  ${index + 1}. ${chalk.cyan(skill)}`);
+          console.log(`     ${chalk.dim(path.join(skillsDir, skill))}`);
         });
 
-        console.log('');
-    } else {
-        console.log(chalk.blue('[INFO]'), 'This is a single-skill repository (no skills/ subdirectory)');
-        console.log(chalk.dim('The entire repository acts as one skill'));
-        console.log('');
+        console.log("");
+      } else {
+        console.log(
+          chalk.blue("[INFO]"),
+          "This is a single-skill repository (no skills/ subdirectory)",
+        );
+        console.log(chalk.dim("The entire repository acts as one skill"));
+        console.log("");
+      }
     }
+    return;
+  }
+
+  // No repo specified - list all repos
+  if (outputJson) {
+    console.log(
+      JSON.stringify(
+        repos.map((repo) => ({
+          name: repo.name,
+          path: repo.path,
+          hasSkillsDir: repo.hasSkillsDir,
+        })),
+        null,
+        2,
+      ),
+    );
+  } else {
+    console.log("");
+    console.log(
+      chalk.blue("[INFO]"),
+      `Repositories in library (${DEFAULT_LIB_PATH}):`,
+    );
+    console.log("");
+
+    repos.forEach((repo, index) => {
+      const hasSkills = repo.hasSkillsDir ? chalk.dim(" (has skills/)") : "";
+      console.log(`  ${index + 1}. ${chalk.cyan(repo.name)}${hasSkills}`);
+      console.log(`     ${chalk.dim(repo.path)}`);
+    });
+
+    console.log("");
+    console.log(
+      chalk.blue("[INFO]"),
+      "Use --repo <name> to list skills in a specific repo.",
+    );
+  }
 }
 
 module.exports = list;
-