add-skill 1.0.17 → 1.0.19

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

@@ -7,6 +7,16 @@ import chalk from "chalk";
 
 // src/source-parser.ts
 import { isAbsolute, resolve } from "path";
+function getOwnerRepo(parsed) {
+  if (parsed.type === "local") {
+    return null;
+  }
+  const match = parsed.url.match(/(?:github|gitlab)\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/);
+  if (match) {
+    return `${match[1]}/${match[2]}`;
+  }
+  return null;
+}
 function isLocalPath(input) {
   return isAbsolute(input) || input.startsWith("./") || input.startsWith("../") || input === "." || input === ".." || // Windows absolute paths like C:\ or D:\
   /^[a-zA-Z]:[/\\]/.test(input);
@@ -21,17 +31,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 +63,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 +115,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 +255,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 +519,7 @@ function track(data) {
 // package.json
 var package_default = {
   name: "add-skill",
-  version: "1.0.17",
+  version: "1.0.19",
   description: "Install agent skills onto coding agents (OpenCode, Claude Code, Codex, Cursor)",
   type: "module",
   bin: {
@@ -497,20 +532,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 +615,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 +629,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");
     }
@@ -795,18 +837,21 @@ async function main(source, options) {
       } else if (tempDir && skill.path.startsWith(tempDir + "/")) {
         relativePath = skill.path.slice(tempDir.length + 1) + "/SKILL.md";
       } else {
-        relativePath = skill.name + "/SKILL.md";
+        continue;
       }
       skillFiles[skill.name] = relativePath;
     }
-    track({
-      event: "install",
-      source,
-      skills: selectedSkills.map((s) => s.name).join(","),
-      agents: targetAgents.join(","),
-      ...installGlobally && { global: "1" },
-      skillFiles: JSON.stringify(skillFiles)
-    });
+    const normalizedSource = getOwnerRepo(parsed);
+    if (normalizedSource) {
+      track({
+        event: "install",
+        source: normalizedSource,
+        skills: selectedSkills.map((s) => s.name).join(","),
+        agents: targetAgents.join(","),
+        ...installGlobally && { global: "1" },
+        skillFiles: JSON.stringify(skillFiles)
+      });
+    }
     if (successful.length > 0) {
       const bySkill = /* @__PURE__ */ new Map();
       for (const r of successful) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-skill",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "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",