skill-linker 4.0.0 → 4.0.4

package/README.md

@@ -124,7 +124,7 @@ npx skill-linker list --repo skill-name --json
 | **GitHub Copilot**     | `.github/skills/`   | `~/.copilot/skills/`            |
 | **Google Antigravity** | `.agent/skills/`    | `~/.gemini/antigravity/skills/` |
 | **Cursor**             | `.cursor/skills/`   | `~/.cursor/skills/`             |
-| **OpenCode**           | `.opencode/skill/`  | `~/.config/opencode/skill/`     |
+| **OpenCode**           | `.opencode/skills/` | `~/.config/opencode/skills/`    |
 | **OpenAI Codex**       | `.codex/skills/`    | `~/.codex/skills/`              |
 | **Gemini CLI**         | `.gemini/skills/`   | `~/.gemini/skills/`             |
 | **Windsurf**           | `.windsurf/skills/` | `~/.codeium/windsurf/skills/`   |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-linker",
-  "version": "4.0.0",
+  "version": "4.0.4",
   "description": "CLI to link AI Agent Skills to various agents (Claude, Copilot, Antigravity, Cursor, etc.)",
   "main": "bin/cli.js",
   "bin": {

package/src/commands/install.js

@@ -6,7 +6,11 @@ const {
   createSymlink,
   listDirectories,
 } = require("../utils/file-system");
-const { getAllAgents, detectInstalledAgents } = require("../utils/agents");
+const {
+  getAllAgents,
+  detectInstalledAgents,
+  findAgentIndex,
+} = require("../utils/agents");
 const { cloneOrUpdateRepo, pullRepo } = require("../utils/git");
 
 /**
@@ -99,10 +103,8 @@ async function install(options) {
   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) {
+        const idx = findAgentIndex(agentName);
+        if (idx === null) {
           console.log(
             chalk.yellow("[WARNING]"),
             `Unknown agent: ${agentName}, skipping...`,

package/src/utils/agents.js

@@ -1,69 +1,93 @@
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
 
 /**
  * Supported AI Agent configurations
- * Format: { name, projectDir, globalDir }
+ * Format: { name, projectDir, globalDir, aliases }
  */
 const AGENTS = [
-    {
-        name: 'Claude Code',
-        projectDir: '.claude/skills',
-        globalDir: path.join(os.homedir(), '.claude/skills')
-    },
-    {
-        name: 'GitHub Copilot',
-        projectDir: '.github/skills',
-        globalDir: path.join(os.homedir(), '.copilot/skills')
-    },
-    {
-        name: 'Google Antigravity',
-        projectDir: '.agent/skills',
-        globalDir: path.join(os.homedir(), '.gemini/antigravity/skills')
-    },
-    {
-        name: 'Cursor',
-        projectDir: '.cursor/skills',
-        globalDir: path.join(os.homedir(), '.cursor/skills')
-    },
-    {
-        name: 'OpenCode',
-        projectDir: '.opencode/skill',
-        globalDir: path.join(os.homedir(), '.config/opencode/skill')
-    },
-    {
-        name: 'OpenAI Codex',
-        projectDir: '.codex/skills',
-        globalDir: path.join(os.homedir(), '.codex/skills')
-    },
-    {
-        name: 'Gemini CLI',
-        projectDir: '.gemini/skills',
-        globalDir: path.join(os.homedir(), '.gemini/skills')
-    },
-    {
-        name: 'Windsurf',
-        projectDir: '.windsurf/skills',
-        globalDir: path.join(os.homedir(), '.codeium/windsurf/skills')
-    }
+  {
+    name: "Claude Code",
+    projectDir: ".claude/skills",
+    globalDir: path.join(os.homedir(), ".claude/skills"),
+    aliases: ["claude", "claude-code", "anthropic"],
+  },
+  {
+    name: "GitHub Copilot",
+    projectDir: ".github/skills",
+    globalDir: path.join(os.homedir(), ".copilot/skills"),
+    aliases: ["copilot", "github", "gh-copilot"],
+  },
+  {
+    name: "Google Antigravity",
+    projectDir: ".agent/skills",
+    globalDir: path.join(os.homedir(), ".gemini/antigravity/skills"),
+    aliases: ["antigravity", "gemini-antigravity"],
+  },
+  {
+    name: "Cursor",
+    projectDir: ".cursor/skills",
+    globalDir: path.join(os.homedir(), ".cursor/skills"),
+    aliases: ["cursor"],
+  },
+  {
+    name: "OpenCode",
+    projectDir: ".opencode/skills",
+    globalDir: path.join(os.homedir(), ".config/opencode/skills"),
+    aliases: ["opencode", "open-code"],
+  },
+  {
+    name: "OpenAI Codex",
+    projectDir: ".codex/skills",
+    globalDir: path.join(os.homedir(), ".codex/skills"),
+    aliases: ["codex", "openai", "openai-codex"],
+  },
+  {
+    name: "Gemini CLI",
+    projectDir: ".gemini/skills",
+    globalDir: path.join(os.homedir(), ".gemini/skills"),
+    aliases: ["gemini", "gemini-cli", "google-gemini"],
+  },
+  {
+    name: "Windsurf",
+    projectDir: ".windsurf/skills",
+    globalDir: path.join(os.homedir(), ".codeium/windsurf/skills"),
+    aliases: ["windsurf", "codeium"],
+  },
 ];
 
+/**
+ * Find agent index by name or alias (case-insensitive)
+ * @param {string} name - Agent name or alias
+ * @returns {number|null} Agent index or null if not found
+ */
+function findAgentIndex(nameOrAlias) {
+  const lower = nameOrAlias.toLowerCase();
+  const idx = AGENTS.findIndex(
+    (agent) =>
+      agent.name.toLowerCase() === lower ||
+      (agent.aliases &&
+        agent.aliases.some((alias) => alias.toLowerCase() === lower)),
+  );
+  return idx !== -1 ? idx : null;
+}
+
 /**
  * Detect which agents are installed on the system
  * @returns {Array} List of detected agent indices
  */
 function detectInstalledAgents() {
-    const installed = [];
+  const installed = [];
 
-    AGENTS.forEach((agent, index) => {
-        // Check if global directory exists
-        if (fs.existsSync(agent.globalDir)) {
-            installed.push(index);
-        }
-    });
+  AGENTS.forEach((agent, index) => {
+    // Check if global directory exists
+    if (fs.existsSync(agent.globalDir)) {
+      installed.push(index);
+    }
+  });
 
-    return installed;
+  return installed;
 }
 
 /**
@@ -72,7 +96,7 @@ function detectInstalledAgents() {
  * @returns {Object} Agent configuration
  */
 function getAgent(index) {
-    return AGENTS[index];
+  return AGENTS[index];
 }
 
 /**
@@ -80,12 +104,13 @@ function getAgent(index) {
  * @returns {Array} All agent configurations
  */
 function getAllAgents() {
-    return AGENTS;
+  return AGENTS;
 }
 
 module.exports = {
-    AGENTS,
-    detectInstalledAgents,
-    getAgent,
-    getAllAgents
+  AGENTS,
+  detectInstalledAgents,
+  getAgent,
+  getAllAgents,
+  findAgentIndex,
 };

package/src/utils/git.js

@@ -1,9 +1,9 @@
-const execa = require('execa');
-const path = require('path');
-const os = require('os');
-const { dirExists } = require('./file-system');
+const execa = require("execa");
+const path = require("path");
+const os = require("os");
+const { dirExists } = require("./file-system");
 
-const DEFAULT_LIB_PATH = path.join(os.homedir(), 'Documents/AgentSkills');
+const DEFAULT_LIB_PATH = path.join(os.homedir(), "Documents/AgentSkills");
 
 /**
  * Parse GitHub URL to extract owner, repo, branch, and subpath
@@ -11,46 +11,50 @@ const DEFAULT_LIB_PATH = path.join(os.homedir(), 'Documents/AgentSkills');
  * @returns {Object} Parsed components
  */
 function parseGitHubUrl(url) {
-    let cleanUrl = url;
-    let subpath = '';
-    let branch = 'main';
+  let cleanUrl = url;
+  let subpath = "";
+  let branch = "main";
 
-    // Check for /tree/branch/path format
-    const treeMatch = url.match(/(.+)\/tree\/([^/]+)\/(.+)$/);
-    if (treeMatch) {
-        cleanUrl = treeMatch[1];
-        branch = treeMatch[2];
-        subpath = treeMatch[3];
-    }
+  // Check for /tree/branch/path format
+  const treeMatch = url.match(/(.+)\/tree\/([^/]+)\/(.+)$/);
+  if (treeMatch) {
+    cleanUrl = treeMatch[1];
+    branch = treeMatch[2];
+    subpath = treeMatch[3];
+  }
 
-    // Extract owner/repo
-    const repoMatch = cleanUrl.match(/github\.com[/:]([^/]+)\/([^/]+?)(\.git)?$/);
+  // Extract owner/repo
+  const repoMatch = cleanUrl.match(/github\.com[/:]([^/]+)\/([^/]+?)(\.git)?$/);
 
-    if (!repoMatch) {
-        throw new Error('Invalid GitHub URL format');
-    }
+  if (!repoMatch) {
+    throw new Error("Invalid GitHub URL format");
+  }
 
-    return {
-        owner: repoMatch[1],
-        repo: repoMatch[2].replace('.git', ''),
-        branch,
-        subpath,
-        cleanUrl
-    };
+  return {
+    owner: repoMatch[1],
+    repo: repoMatch[2].replace(".git", ""),
+    branch,
+    subpath,
+    cleanUrl,
+  };
 }
 
 /**
  * Clone a GitHub repository
  * @param {string} url - GitHub URL
  * @param {string} targetPath - Target directory
+ * @param {boolean} shallow - Use shallow clone (default true)
  * @returns {Promise<void>}
  */
-async function cloneRepo(url, targetPath) {
-    try {
-        await execa('git', ['clone', url, targetPath]);
-    } catch (error) {
-        throw new Error(`Failed to clone repository: ${error.message}`);
-    }
+async function cloneRepo(url, targetPath, shallow = true) {
+  try {
+    const args = shallow
+      ? ["clone", "--depth", "1", url, targetPath]
+      : ["clone", url, targetPath];
+    await execa("git", args);
+  } catch (error) {
+    throw new Error(`Failed to clone repository: ${error.message}`);
+  }
 }
 
 /**
@@ -59,11 +63,11 @@ async function cloneRepo(url, targetPath) {
  * @returns {Promise<void>}
  */
 async function pullRepo(repoPath) {
-    try {
-        await execa('git', ['-C', repoPath, 'pull']);
-    } catch (error) {
-        throw new Error(`Failed to pull repository: ${error.message}`);
-    }
+  try {
+    await execa("git", ["-C", repoPath, "pull", "--rebase"]);
+  } catch (error) {
+    throw new Error(`Failed to pull repository: ${error.message}`);
+  }
 }
 
 /**
@@ -72,37 +76,37 @@ async function pullRepo(repoPath) {
  * @returns {Promise<{skillPath: string, needsUpdate: boolean}>}
  */
 async function cloneOrUpdateRepo(url) {
-    const parsed = parseGitHubUrl(url);
-    const targetPath = path.join(DEFAULT_LIB_PATH, parsed.owner, parsed.repo);
+  const parsed = parseGitHubUrl(url);
+  const targetPath = path.join(DEFAULT_LIB_PATH, parsed.owner, parsed.repo);
 
-    let needsUpdate = false;
+  let needsUpdate = false;
 
-    if (dirExists(targetPath)) {
-        // Repo exists, ask if user wants to update
-        needsUpdate = true;
-    } else {
-        // Clone new repo
-        await cloneRepo(parsed.cleanUrl, targetPath);
-    }
+  if (dirExists(targetPath)) {
+    // Repo exists, ask if user wants to update
+    needsUpdate = true;
+  } else {
+    // Clone new repo
+    await cloneRepo(parsed.cleanUrl, targetPath);
+  }
 
-    // Determine final skill path
-    let skillPath = targetPath;
-    if (parsed.subpath) {
-        skillPath = path.join(targetPath, parsed.subpath);
-    }
+  // Determine final skill path
+  let skillPath = targetPath;
+  if (parsed.subpath) {
+    skillPath = path.join(targetPath, parsed.subpath);
+  }
 
-    return {
-        skillPath,
-        targetPath,
-        needsUpdate,
-        hasSubpath: !!parsed.subpath
-    };
+  return {
+    skillPath,
+    targetPath,
+    needsUpdate,
+    hasSubpath: !!parsed.subpath,
+  };
 }
 
 module.exports = {
-    DEFAULT_LIB_PATH,
-    parseGitHubUrl,
-    cloneRepo,
-    pullRepo,
-    cloneOrUpdateRepo
+  DEFAULT_LIB_PATH,
+  parseGitHubUrl,
+  cloneRepo,
+  pullRepo,
+  cloneOrUpdateRepo,
 };