add-skill 1.0.16 → 1.0.18

package/README.md

@@ -80,22 +80,22 @@ npx add-skill vercel-labs/agent-skills -y -g
 Skills can be installed to any of these supported agents. Use `-g, --global` to install to the global path instead of project-level.
 
 <!-- available-agents:start -->
-| Agent | Project Path | Global Path |
-|-------|--------------|-------------|
-| OpenCode | `.opencode/skill/` | `~/.config/opencode/skill/` |
-| Claude Code | `.claude/skills/` | `~/.claude/skills/` |
-| Codex | `.codex/skills/` | `~/.codex/skills/` |
-| Cursor | `.cursor/skills/` | `~/.cursor/skills/` |
-| Amp | `.agents/skills/` | `~/.config/agents/skills/` |
-| Kilo Code | `.kilocode/skills/` | `~/.kilocode/skills/` |
-| Roo Code | `.roo/skills/` | `~/.roo/skills/` |
-| Goose | `.goose/skills/` | `~/.config/goose/skills/` |
-| Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` |
-| Antigravity | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
-| GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` |
-| Clawdbot | `skills/` | `~/.clawdbot/skills/` |
-| Droid | `.factory/skills/` | `~/.factory/skills/` |
-| Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| Agent | `--agent` | Project Path | Global Path |
+|-------|-----------|--------------|-------------|
+| OpenCode | `opencode` | `.opencode/skills/` | `~/.config/opencode/skills/` |
+| Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
+| Codex | `codex` | `.codex/skills/` | `~/.codex/skills/` |
+| Cursor | `cursor` | `.cursor/skills/` | `~/.cursor/skills/` |
+| Amp | `amp` | `.agents/skills/` | `~/.config/agents/skills/` |
+| Kilo Code | `kilo` | `.kilocode/skills/` | `~/.kilocode/skills/` |
+| Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
+| Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
+| Gemini CLI | `gemini-cli` | `.gemini/skills/` | `~/.gemini/skills/` |
+| Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
+| GitHub Copilot | `github-copilot` | `.github/skills/` | `~/.copilot/skills/` |
+| Clawdbot | `clawdbot` | `skills/` | `~/.clawdbot/skills/` |
+| Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
+| Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
 <!-- available-agents:end -->
 
 ## Agent Detection
@@ -141,7 +141,7 @@ The CLI searches for skills in these locations within a repository:
 - `skills/.curated/`
 - `skills/.experimental/`
 - `skills/.system/`
-- `.opencode/skill/`
+- `.opencode/skills/`
 - `.claude/skills/`
 - `.codex/skills/`
 - `.cursor/skills/`
@@ -186,6 +186,20 @@ Ensure the repository contains valid `SKILL.md` files with both `name` and `desc
 
 Ensure you have write access to the target directory.
 
+## Telemetry
+
+This CLI collects anonymous usage data to help improve the tool. No personal information is collected.
+
+To disable telemetry, set either of these environment variables:
+
+```bash
+DISABLE_TELEMETRY=1 npx add-skill vercel-labs/agent-skills
+# or
+DO_NOT_TRACK=1 npx add-skill vercel-labs/agent-skills
+```
+
+Telemetry is also automatically disabled in CI environments.
+
 ## Related Links
 
 - [Vercel Agent Skills Repository](https://github.com/vercel-labs/agent-skills)

package/dist/index.js

@@ -21,17 +21,29 @@ function parseSource(input) {
       localPath: resolvedPath
     };
   }
-  const githubTreeMatch = input.match(
+  const githubTreeWithPathMatch = input.match(
     /github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/
   );
-  if (githubTreeMatch) {
-    const [, owner, repo, , subpath] = githubTreeMatch;
+  if (githubTreeWithPathMatch) {
+    const [, owner, repo, ref, subpath] = githubTreeWithPathMatch;
     return {
       type: "github",
       url: `https://github.com/${owner}/${repo}.git`,
+      ref,
       subpath
     };
   }
+  const githubTreeMatch = input.match(
+    /github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)$/
+  );
+  if (githubTreeMatch) {
+    const [, owner, repo, ref] = githubTreeMatch;
+    return {
+      type: "github",
+      url: `https://github.com/${owner}/${repo}.git`,
+      ref
+    };
+  }
   const githubRepoMatch = input.match(/github\.com\/([^/]+)\/([^/]+)/);
   if (githubRepoMatch) {
     const [, owner, repo] = githubRepoMatch;
@@ -41,17 +53,29 @@ function parseSource(input) {
       url: `https://github.com/${owner}/${cleanRepo}.git`
     };
   }
-  const gitlabTreeMatch = input.match(
+  const gitlabTreeWithPathMatch = input.match(
     /gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)\/(.+)/
   );
-  if (gitlabTreeMatch) {
-    const [, owner, repo, , subpath] = gitlabTreeMatch;
+  if (gitlabTreeWithPathMatch) {
+    const [, owner, repo, ref, subpath] = gitlabTreeWithPathMatch;
     return {
       type: "gitlab",
       url: `https://gitlab.com/${owner}/${repo}.git`,
+      ref,
       subpath
     };
   }
+  const gitlabTreeMatch = input.match(
+    /gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)$/
+  );
+  if (gitlabTreeMatch) {
+    const [, owner, repo, ref] = gitlabTreeMatch;
+    return {
+      type: "gitlab",
+      url: `https://gitlab.com/${owner}/${repo}.git`,
+      ref
+    };
+  }
   const gitlabRepoMatch = input.match(/gitlab\.com\/([^/]+)\/([^/]+)/);
   if (gitlabRepoMatch) {
     const [, owner, repo] = gitlabRepoMatch;
@@ -81,10 +105,11 @@ import simpleGit from "simple-git";
 import { join, normalize, resolve as resolve2, sep } from "path";
 import { mkdtemp, rm } from "fs/promises";
 import { tmpdir } from "os";
-async function cloneRepo(url) {
+async function cloneRepo(url, ref) {
   const tempDir = await mkdtemp(join(tmpdir(), "add-skill-"));
   const git = simpleGit();
-  await git.clone(url, tempDir, ["--depth", "1"]);
+  const cloneOptions = ref ? ["--depth", "1", "--branch", ref] : ["--depth", "1"];
+  await git.clone(url, tempDir, cloneOptions);
   return tempDir;
 }
 async function cleanupTempDir(dir) {
@@ -220,8 +245,8 @@ var agents = {
   opencode: {
     name: "opencode",
     displayName: "OpenCode",
-    skillsDir: ".opencode/skill",
-    globalSkillsDir: join3(home, ".config/opencode/skill"),
+    skillsDir: ".opencode/skills",
+    globalSkillsDir: join3(home, ".config/opencode/skills"),
     detectInstalled: async () => {
       return existsSync(join3(home, ".config/opencode")) || existsSync(join3(home, ".claude/skills"));
     }
@@ -484,7 +509,7 @@ function track(data) {
 // package.json
 var package_default = {
   name: "add-skill",
-  version: "1.0.16",
+  version: "1.0.18",
   description: "Install agent skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)",
   type: "module",
   bin: {
@@ -497,20 +522,27 @@ var package_default = {
   scripts: {
     build: "tsup src/index.ts --format esm --dts --clean",
     dev: "tsx src/index.ts",
-    prepublishOnly: "npm run build",
-    "update-readme": "tsx scripts/update-readme.ts"
+    prepublishOnly: "npm run build"
   },
   keywords: [
     "cli",
+    "agent-skills",
     "skills",
+    "ai-agents",
     "opencode",
     "claude-code",
     "codex",
     "cursor",
     "amp",
+    "kilo",
+    "roo",
+    "goose",
+    "gemini-cli",
     "antigravity",
-    "roo-code",
-    "ai-agents"
+    "github-copilot",
+    "clawdbot",
+    "droid",
+    "windsurf"
   ],
   repository: {
     type: "git",
@@ -573,7 +605,7 @@ async function main(source, options) {
     const spinner2 = p.spinner();
     spinner2.start("Parsing source...");
     const parsed = parseSource(source);
-    spinner2.stop(`Source: ${chalk.cyan(parsed.type === "local" ? parsed.localPath : parsed.url)}${parsed.subpath ? ` (${parsed.subpath})` : ""}`);
+    spinner2.stop(`Source: ${chalk.cyan(parsed.type === "local" ? parsed.localPath : parsed.url)}${parsed.ref ? ` @ ${chalk.yellow(parsed.ref)}` : ""}${parsed.subpath ? ` (${parsed.subpath})` : ""}`);
     let skillsDir;
     if (parsed.type === "local") {
       spinner2.start("Validating local path...");
@@ -587,7 +619,7 @@ async function main(source, options) {
       spinner2.stop("Local path validated");
     } else {
       spinner2.start("Cloning repository...");
-      tempDir = await cloneRepo(parsed.url);
+      tempDir = await cloneRepo(parsed.url, parsed.ref);
       skillsDir = tempDir;
       spinner2.stop("Repository cloned");
     }
@@ -789,8 +821,15 @@ async function main(source, options) {
     const failed = results.filter((r) => !r.success);
     const skillFiles = {};
     for (const skill of selectedSkills) {
-      const relativePath = skill.path.replace(tempDir + "/", "");
-      skillFiles[skill.name] = relativePath + "/SKILL.md";
+      let relativePath;
+      if (tempDir && skill.path === tempDir) {
+        relativePath = "SKILL.md";
+      } else if (tempDir && skill.path.startsWith(tempDir + "/")) {
+        relativePath = skill.path.slice(tempDir.length + 1) + "/SKILL.md";
+      } else {
+        relativePath = skill.name + "/SKILL.md";
+      }
+      skillFiles[skill.name] = relativePath;
     }
     track({
       event: "install",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-skill",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "Install agent skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)",
   "type": "module",
   "bin": {
@@ -13,20 +13,27 @@
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",
     "dev": "tsx src/index.ts",
-    "prepublishOnly": "npm run build",
-    "update-readme": "tsx scripts/update-readme.ts"
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "cli",
+    "agent-skills",
     "skills",
+    "ai-agents",
     "opencode",
     "claude-code",
     "codex",
     "cursor",
     "amp",
+    "kilo",
+    "roo",
+    "goose",
+    "gemini-cli",
     "antigravity",
-    "roo-code",
-    "ai-agents"
+    "github-copilot",
+    "clawdbot",
+    "droid",
+    "windsurf"
   ],
   "repository": {
     "type": "git",