@voidagency/skills 1.0.0

package/dist/cli.mjs

@@ -0,0 +1,4730 @@
+#!/usr/bin/env node
+import { r as __toESM } from "./_chunks/rolldown-runtime.mjs";
+import { l as pD, u as require_picocolors } from "./_chunks/libs/@clack/core.mjs";
+import { a as Y, c as ve, i as Se, l as xe, n as M, o as be, r as Me, s as fe, t as Ie, u as ye } from "./_chunks/libs/@clack/prompts.mjs";
+import "./_chunks/libs/@kwsites/file-exists.mjs";
+import "./_chunks/libs/@kwsites/promise-deferred.mjs";
+import { t as esm_default } from "./_chunks/libs/simple-git.mjs";
+import { t as require_gray_matter } from "./_chunks/libs/gray-matter.mjs";
+import "./_chunks/libs/extend-shallow.mjs";
+import "./_chunks/libs/esprima.mjs";
+import { t as xdgConfig } from "./_chunks/libs/xdg-basedir.mjs";
+import { execSync, spawnSync } from "child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { basename, dirname, isAbsolute, join, normalize, relative, resolve, sep } from "path";
+import { homedir, platform, tmpdir } from "os";
+import { createHash } from "crypto";
+import { fileURLToPath } from "url";
+import * as readline from "readline";
+import { Writable } from "stream";
+import { access, cp, lstat, mkdir, mkdtemp, readFile, readdir, readlink, realpath, rm, stat, symlink, writeFile } from "fs/promises";
+//#region src/source-parser.ts
+var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
+/**
+* Extract owner/repo (or group/subgroup/repo for GitLab) from a parsed source
+* for lockfile tracking and telemetry.
+* Returns null for local paths or unparseable sources.
+* Supports any Git host with an owner/repo URL structure, including GitLab subgroups.
+*/
+function getOwnerRepo(parsed) {
+	if (parsed.type === "local") return null;
+	const sshMatch = parsed.url.match(/^git@[^:]+:(.+)$/);
+	if (sshMatch) {
+		let path = sshMatch[1];
+		path = path.replace(/\.git$/, "");
+		if (path.includes("/")) return path;
+		return null;
+	}
+	if (!parsed.url.startsWith("http://") && !parsed.url.startsWith("https://")) return null;
+	try {
+		let path = new URL(parsed.url).pathname.slice(1);
+		path = path.replace(/\.git$/, "");
+		if (path.includes("/")) return path;
+	} catch {}
+	return null;
+}
+/**
+* Extract owner and repo from an owner/repo string.
+* Returns null if the format is invalid.
+*/
+function parseOwnerRepo(ownerRepo) {
+	const match = ownerRepo.match(/^([^/]+)\/([^/]+)$/);
+	if (match) return {
+		owner: match[1],
+		repo: match[2]
+	};
+	return null;
+}
+/**
+* Check if a GitHub repository is private.
+* Returns true if private, false if public, null if unable to determine.
+* Only works for GitHub repositories (GitLab not supported).
+*/
+async function isRepoPrivate(owner, repo) {
+	try {
+		const res = await fetch(`https://api.github.com/repos/${owner}/${repo}`);
+		if (!res.ok) return null;
+		return (await res.json()).private === true;
+	} catch {
+		return null;
+	}
+}
+/**
+* Sanitizes a subpath to prevent path traversal attacks.
+* Rejects subpaths containing ".." segments that could escape the repository root.
+* Returns the sanitized subpath, or throws if the subpath is unsafe.
+*/
+function sanitizeSubpath(subpath) {
+	const segments = subpath.replace(/\\/g, "/").split("/");
+	for (const segment of segments) if (segment === "..") throw new Error(`Unsafe subpath: "${subpath}" contains path traversal segments. Subpaths must not contain ".." components.`);
+	return subpath;
+}
+/**
+* Check if a string represents a local file system path
+*/
+function isLocalPath(input) {
+	return isAbsolute(input) || input.startsWith("./") || input.startsWith("../") || input === "." || input === ".." || /^[a-zA-Z]:[/\\]/.test(input);
+}
+/**
+* Parse a source string into a structured format
+* Supports: local paths, GitHub URLs, GitLab URLs, GitHub shorthand, well-known URLs, and direct git URLs
+*/
+const SOURCE_ALIASES = { "coinbase/agentWallet": "coinbase/agentic-wallet-skills" };
+function parseSource(input) {
+	const alias = SOURCE_ALIASES[input];
+	if (alias) input = alias;
+	const githubPrefixMatch = input.match(/^github:(.+)$/);
+	if (githubPrefixMatch) return parseSource(githubPrefixMatch[1]);
+	const gitlabPrefixMatch = input.match(/^gitlab:(.+)$/);
+	if (gitlabPrefixMatch) return parseSource(`https://gitlab.com/${gitlabPrefixMatch[1]}`);
+	const bitbucketPrefixMatch = input.match(/^bitbucket:(.+)$/);
+	if (bitbucketPrefixMatch) return parseSource(`https://bitbucket.org/${bitbucketPrefixMatch[1]}`);
+	const atIdx = input.lastIndexOf("@");
+	if (atIdx > 0) {
+		const pathPart = input.slice(0, atIdx).trim();
+		const skillPart = input.slice(atIdx + 1).trim();
+		if (skillPart && isLocalPath(pathPart)) return {
+			type: "local",
+			url: resolve(pathPart),
+			localPath: resolve(pathPart),
+			skillFilter: skillPart
+		};
+	}
+	if (isLocalPath(input)) {
+		const resolvedPath = resolve(input);
+		return {
+			type: "local",
+			url: resolvedPath,
+			localPath: resolvedPath
+		};
+	}
+	const githubTreeWithPathMatch = input.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/);
+	if (githubTreeWithPathMatch) {
+		const [, owner, repo, ref, subpath] = githubTreeWithPathMatch;
+		return {
+			type: "github",
+			url: `https://github.com/${owner}/${repo}.git`,
+			ref,
+			subpath: subpath ? sanitizeSubpath(subpath) : 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;
+		return {
+			type: "github",
+			url: `https://github.com/${owner}/${repo.replace(/\.git$/, "")}.git`
+		};
+	}
+	const gitlabTreeWithPathMatch = input.match(/^(https?):\/\/([^/]+)\/(.+?)\/-\/tree\/([^/]+)\/(.+)/);
+	if (gitlabTreeWithPathMatch) {
+		const [, protocol, hostname, repoPath, ref, subpath] = gitlabTreeWithPathMatch;
+		if (hostname !== "github.com" && repoPath) return {
+			type: "gitlab",
+			url: `${protocol}://${hostname}/${repoPath.replace(/\.git$/, "")}.git`,
+			ref,
+			subpath: subpath ? sanitizeSubpath(subpath) : subpath
+		};
+	}
+	const gitlabTreeMatch = input.match(/^(https?):\/\/([^/]+)\/(.+?)\/-\/tree\/([^/]+)$/);
+	if (gitlabTreeMatch) {
+		const [, protocol, hostname, repoPath, ref] = gitlabTreeMatch;
+		if (hostname !== "github.com" && repoPath) return {
+			type: "gitlab",
+			url: `${protocol}://${hostname}/${repoPath.replace(/\.git$/, "")}.git`,
+			ref
+		};
+	}
+	const gitlabRepoMatch = input.match(/gitlab\.com\/(.+?)(?:\.git)?\/?$/);
+	if (gitlabRepoMatch) {
+		const repoPath = gitlabRepoMatch[1];
+		if (repoPath.includes("/")) return {
+			type: "gitlab",
+			url: `https://gitlab.com/${repoPath}.git`
+		};
+	}
+	const bitbucketSrcWithPathMatch = input.match(/bitbucket\.org\/([^/]+)\/([^/]+)\/src\/([^/]+)\/(.+)/);
+	if (bitbucketSrcWithPathMatch) {
+		const [, owner, repo, ref, subpath] = bitbucketSrcWithPathMatch;
+		return {
+			type: "bitbucket",
+			url: `https://bitbucket.org/${owner}/${repo}.git`,
+			ref,
+			subpath: subpath ? sanitizeSubpath(subpath) : subpath
+		};
+	}
+	const bitbucketSrcMatch = input.match(/bitbucket\.org\/([^/]+)\/([^/]+)\/src\/([^/]+)\/?$/);
+	if (bitbucketSrcMatch) {
+		const [, owner, repo, ref] = bitbucketSrcMatch;
+		return {
+			type: "bitbucket",
+			url: `https://bitbucket.org/${owner}/${repo}.git`,
+			ref
+		};
+	}
+	const bitbucketRepoMatch = input.match(/bitbucket\.org\/([^/]+)\/([^/]+)(?:\.git)?\/?$/);
+	if (bitbucketRepoMatch) {
+		const [, owner, repo] = bitbucketRepoMatch;
+		return {
+			type: "bitbucket",
+			url: `https://bitbucket.org/${owner}/${repo.replace(/\.git$/, "")}.git`
+		};
+	}
+	const atSkillMatch = input.match(/^([^/]+)\/([^/@]+)@(.+)$/);
+	if (atSkillMatch && !input.includes(":") && !input.startsWith(".") && !input.startsWith("/")) {
+		const [, owner, repo, skillFilter] = atSkillMatch;
+		return {
+			type: "github",
+			url: `https://github.com/${owner}/${repo}.git`,
+			skillFilter
+		};
+	}
+	const shorthandMatch = input.match(/^([^/]+)\/([^/]+)(?:\/(.+))?$/);
+	if (shorthandMatch && !input.includes(":") && !input.startsWith(".") && !input.startsWith("/")) {
+		const [, owner, repo, subpath] = shorthandMatch;
+		return {
+			type: "github",
+			url: `https://github.com/${owner}/${repo}.git`,
+			subpath: subpath ? sanitizeSubpath(subpath) : subpath
+		};
+	}
+	if (isWellKnownUrl(input)) return {
+		type: "well-known",
+		url: input
+	};
+	return {
+		type: "git",
+		url: input
+	};
+}
+/**
+* Check if a URL could be a well-known skills endpoint.
+* Must be HTTP(S) and not a known git host (GitHub, GitLab).
+* Also excludes URLs that look like git repos (.git suffix).
+*/
+function isWellKnownUrl(input) {
+	if (!input.startsWith("http://") && !input.startsWith("https://")) return false;
+	try {
+		const parsed = new URL(input);
+		if ([
+			"github.com",
+			"gitlab.com",
+			"bitbucket.org",
+			"raw.githubusercontent.com"
+		].includes(parsed.hostname)) return false;
+		if (input.endsWith(".git")) return false;
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/prompts/search-multiselect.ts
+const silentOutput = new Writable({ write(_chunk, _encoding, callback) {
+	callback();
+} });
+const S_STEP_ACTIVE = import_picocolors.default.green("◆");
+const S_STEP_CANCEL = import_picocolors.default.red("■");
+const S_STEP_SUBMIT = import_picocolors.default.green("◇");
+const S_RADIO_ACTIVE = import_picocolors.default.green("●");
+const S_RADIO_INACTIVE = import_picocolors.default.dim("○");
+import_picocolors.default.green("✓");
+const S_BULLET = import_picocolors.default.green("•");
+const S_BAR = import_picocolors.default.dim("│");
+const S_BAR_H = import_picocolors.default.dim("─");
+const cancelSymbol = Symbol("cancel");
+/**
+* Interactive search multiselect prompt.
+* Allows users to filter a long list by typing and select multiple items.
+* Optionally supports a "locked" section that displays always-selected items.
+*/
+async function searchMultiselect(options) {
+	const { message, items, maxVisible = 8, initialSelected = [], required = false, lockedSection } = options;
+	return new Promise((resolve) => {
+		const rl = readline.createInterface({
+			input: process.stdin,
+			output: silentOutput,
+			terminal: false
+		});
+		if (process.stdin.isTTY) process.stdin.setRawMode(true);
+		readline.emitKeypressEvents(process.stdin, rl);
+		let query = "";
+		let cursor = 0;
+		const selected = new Set(initialSelected);
+		let lastRenderHeight = 0;
+		const lockedValues = lockedSection ? lockedSection.items.map((i) => i.value) : [];
+		const filter = (item, q) => {
+			if (!q) return true;
+			const lowerQ = q.toLowerCase();
+			return item.label.toLowerCase().includes(lowerQ) || String(item.value).toLowerCase().includes(lowerQ);
+		};
+		const getFiltered = () => {
+			return items.filter((item) => filter(item, query));
+		};
+		const clearRender = () => {
+			if (lastRenderHeight > 0) {
+				process.stdout.write(`\x1b[${lastRenderHeight}A`);
+				for (let i = 0; i < lastRenderHeight; i++) process.stdout.write("\x1B[2K\x1B[1B");
+				process.stdout.write(`\x1b[${lastRenderHeight}A`);
+			}
+		};
+		const render = (state = "active") => {
+			clearRender();
+			const lines = [];
+			const filtered = getFiltered();
+			const icon = state === "active" ? S_STEP_ACTIVE : state === "cancel" ? S_STEP_CANCEL : S_STEP_SUBMIT;
+			lines.push(`${icon}  ${import_picocolors.default.bold(message)}`);
+			if (state === "active") {
+				if (lockedSection && lockedSection.items.length > 0) {
+					lines.push(`${S_BAR}`);
+					const lockedTitle = `${import_picocolors.default.bold(lockedSection.title)} ${import_picocolors.default.dim("── always included")}`;
+					lines.push(`${S_BAR}  ${S_BAR_H}${S_BAR_H} ${lockedTitle} ${S_BAR_H.repeat(12)}`);
+					for (const item of lockedSection.items) lines.push(`${S_BAR}    ${S_BULLET} ${import_picocolors.default.bold(item.label)}`);
+					lines.push(`${S_BAR}`);
+					lines.push(`${S_BAR}  ${S_BAR_H}${S_BAR_H} ${import_picocolors.default.bold("Additional agents")} ${S_BAR_H.repeat(29)}`);
+				}
+				const searchLine = `${S_BAR}  ${import_picocolors.default.dim("Search:")} ${query}${import_picocolors.default.inverse(" ")}`;
+				lines.push(searchLine);
+				lines.push(`${S_BAR}  ${import_picocolors.default.dim("↑↓ move, space select, enter confirm")}`);
+				lines.push(`${S_BAR}`);
+				const visibleStart = Math.max(0, Math.min(cursor - Math.floor(maxVisible / 2), filtered.length - maxVisible));
+				const visibleEnd = Math.min(filtered.length, visibleStart + maxVisible);
+				const visibleItems = filtered.slice(visibleStart, visibleEnd);
+				if (filtered.length === 0) lines.push(`${S_BAR}  ${import_picocolors.default.dim("No matches found")}`);
+				else {
+					for (let i = 0; i < visibleItems.length; i++) {
+						const item = visibleItems[i];
+						const actualIndex = visibleStart + i;
+						const isSelected = selected.has(item.value);
+						const isCursor = actualIndex === cursor;
+						const radio = isSelected ? S_RADIO_ACTIVE : S_RADIO_INACTIVE;
+						const label = isCursor ? import_picocolors.default.underline(item.label) : item.label;
+						const hint = item.hint ? import_picocolors.default.dim(` (${item.hint})`) : "";
+						const prefix = isCursor ? import_picocolors.default.cyan("❯") : " ";
+						lines.push(`${S_BAR} ${prefix} ${radio} ${label}${hint}`);
+					}
+					const hiddenBefore = visibleStart;
+					const hiddenAfter = filtered.length - visibleEnd;
+					if (hiddenBefore > 0 || hiddenAfter > 0) {
+						const parts = [];
+						if (hiddenBefore > 0) parts.push(`↑ ${hiddenBefore} more`);
+						if (hiddenAfter > 0) parts.push(`↓ ${hiddenAfter} more`);
+						lines.push(`${S_BAR}  ${import_picocolors.default.dim(parts.join("  "))}`);
+					}
+				}
+				lines.push(`${S_BAR}`);
+				const allSelectedLabels = [...lockedSection ? lockedSection.items.map((i) => i.label) : [], ...items.filter((item) => selected.has(item.value)).map((item) => item.label)];
+				if (allSelectedLabels.length === 0) lines.push(`${S_BAR}  ${import_picocolors.default.dim("Selected: (none)")}`);
+				else {
+					const summary = allSelectedLabels.length <= 3 ? allSelectedLabels.join(", ") : `${allSelectedLabels.slice(0, 3).join(", ")} +${allSelectedLabels.length - 3} more`;
+					lines.push(`${S_BAR}  ${import_picocolors.default.green("Selected:")} ${summary}`);
+				}
+				lines.push(`${import_picocolors.default.dim("└")}`);
+			} else if (state === "submit") {
+				const allSelectedLabels = [...lockedSection ? lockedSection.items.map((i) => i.label) : [], ...items.filter((item) => selected.has(item.value)).map((item) => item.label)];
+				lines.push(`${S_BAR}  ${import_picocolors.default.dim(allSelectedLabels.join(", "))}`);
+			} else if (state === "cancel") lines.push(`${S_BAR}  ${import_picocolors.default.strikethrough(import_picocolors.default.dim("Cancelled"))}`);
+			process.stdout.write(lines.join("\n") + "\n");
+			lastRenderHeight = lines.length;
+		};
+		const cleanup = () => {
+			process.stdin.removeListener("keypress", keypressHandler);
+			if (process.stdin.isTTY) process.stdin.setRawMode(false);
+			rl.close();
+		};
+		const submit = () => {
+			if (required && selected.size === 0 && lockedValues.length === 0) return;
+			render("submit");
+			cleanup();
+			resolve([...lockedValues, ...Array.from(selected)]);
+		};
+		const cancel = () => {
+			render("cancel");
+			cleanup();
+			resolve(cancelSymbol);
+		};
+		const keypressHandler = (_str, key) => {
+			if (!key) return;
+			const filtered = getFiltered();
+			if (key.name === "return") {
+				submit();
+				return;
+			}
+			if (key.name === "escape" || key.ctrl && key.name === "c") {
+				cancel();
+				return;
+			}
+			if (key.name === "up") {
+				cursor = Math.max(0, cursor - 1);
+				render();
+				return;
+			}
+			if (key.name === "down") {
+				cursor = Math.min(filtered.length - 1, cursor + 1);
+				render();
+				return;
+			}
+			if (key.name === "space") {
+				const item = filtered[cursor];
+				if (item) if (selected.has(item.value)) selected.delete(item.value);
+				else selected.add(item.value);
+				render();
+				return;
+			}
+			if (key.name === "backspace") {
+				query = query.slice(0, -1);
+				cursor = 0;
+				render();
+				return;
+			}
+			if (key.sequence && !key.ctrl && !key.meta && key.sequence.length === 1) {
+				query += key.sequence;
+				cursor = 0;
+				render();
+				return;
+			}
+		};
+		process.stdin.on("keypress", keypressHandler);
+		render();
+	});
+}
+//#endregion
+//#region src/git.ts
+const CLONE_TIMEOUT_MS = 6e4;
+var GitCloneError = class extends Error {
+	url;
+	isTimeout;
+	isAuthError;
+	constructor(message, url, isTimeout = false, isAuthError = false) {
+		super(message);
+		this.name = "GitCloneError";
+		this.url = url;
+		this.isTimeout = isTimeout;
+		this.isAuthError = isAuthError;
+	}
+};
+async function cloneRepo(url, ref) {
+	const tempDir = await mkdtemp(join(tmpdir(), "skills-"));
+	const git = esm_default({
+		timeout: { block: CLONE_TIMEOUT_MS },
+		env: {
+			...process.env,
+			GIT_TERMINAL_PROMPT: "0"
+		}
+	});
+	const cloneOptions = ref ? [
+		"--depth",
+		"1",
+		"--branch",
+		ref
+	] : ["--depth", "1"];
+	try {
+		await git.clone(url, tempDir, cloneOptions);
+		return tempDir;
+	} catch (error) {
+		await rm(tempDir, {
+			recursive: true,
+			force: true
+		}).catch(() => {});
+		const errorMessage = error instanceof Error ? error.message : String(error);
+		const isTimeout = errorMessage.includes("block timeout") || errorMessage.includes("timed out");
+		const isAuthError = errorMessage.includes("Authentication failed") || errorMessage.includes("could not read Username") || errorMessage.includes("Permission denied") || errorMessage.includes("Repository not found");
+		if (isTimeout) throw new GitCloneError("Clone timed out after 60s. This often happens with private repos that require authentication.\n  Ensure you have access and your SSH keys or credentials are configured:\n  - For SSH: ssh-add -l (to check loaded keys)\n  - For HTTPS: gh auth status (if using GitHub CLI)", url, true, false);
+		if (isAuthError) throw new GitCloneError(`Authentication failed for ${url}.\n  - For private repos, ensure you have access\n  - For SSH: Check your keys with 'ssh -T git@github.com'\n  - For HTTPS: Run 'gh auth login' or configure git credentials`, url, false, true);
+		throw new GitCloneError(`Failed to clone ${url}: ${errorMessage}`, url, false, false);
+	}
+}
+async function cleanupTempDir(dir) {
+	const normalizedDir = normalize(resolve(dir));
+	const normalizedTmpDir = normalize(resolve(tmpdir()));
+	if (!normalizedDir.startsWith(normalizedTmpDir + sep) && normalizedDir !== normalizedTmpDir) throw new Error("Attempted to clean up directory outside of temp directory");
+	await rm(dir, {
+		recursive: true,
+		force: true
+	});
+}
+//#endregion
+//#region src/plugin-manifest.ts
+var import_gray_matter = /* @__PURE__ */ __toESM(require_gray_matter(), 1);
+/**
+* Check if a path is contained within a base directory.
+* Prevents path traversal attacks via `..` segments or absolute paths.
+*/
+function isContainedIn(targetPath, basePath) {
+	const normalizedBase = normalize(resolve(basePath));
+	const normalizedTarget = normalize(resolve(targetPath));
+	return normalizedTarget.startsWith(normalizedBase + sep) || normalizedTarget === normalizedBase;
+}
+/**
+* Validate that a relative path follows Claude Code conventions.
+* Paths must start with './' per the plugin manifest spec.
+*/
+function isValidRelativePath(path) {
+	return path.startsWith("./");
+}
+/**
+* Extract skill search directories from plugin manifests.
+* Handles both marketplace.json (multi-plugin) and plugin.json (single plugin).
+* Only resolves local paths - remote sources are skipped.
+*
+* Returns directories that CONTAIN skills (to be searched for child SKILL.md files).
+* For explicit skill paths in manifests, adds the parent directory so the
+* existing discovery loop finds them.
+*/
+async function getPluginSkillPaths(basePath) {
+	const searchDirs = [];
+	const addPluginSkillPaths = (pluginBase, skills) => {
+		if (!isContainedIn(pluginBase, basePath)) return;
+		if (skills && skills.length > 0) for (const skillPath of skills) {
+			if (!isValidRelativePath(skillPath)) continue;
+			const skillDir = dirname(join(pluginBase, skillPath));
+			if (isContainedIn(skillDir, basePath)) searchDirs.push(skillDir);
+		}
+		searchDirs.push(join(pluginBase, "skills"));
+	};
+	try {
+		const content = await readFile(join(basePath, ".claude-plugin/marketplace.json"), "utf-8");
+		const manifest = JSON.parse(content);
+		const pluginRoot = manifest.metadata?.pluginRoot;
+		if (pluginRoot === void 0 || isValidRelativePath(pluginRoot)) for (const plugin of manifest.plugins ?? []) {
+			if (typeof plugin.source !== "string" && plugin.source !== void 0) continue;
+			if (plugin.source !== void 0 && !isValidRelativePath(plugin.source)) continue;
+			addPluginSkillPaths(join(basePath, pluginRoot ?? "", plugin.source ?? ""), plugin.skills);
+		}
+	} catch {}
+	try {
+		const content = await readFile(join(basePath, ".claude-plugin/plugin.json"), "utf-8");
+		addPluginSkillPaths(basePath, JSON.parse(content).skills);
+	} catch {}
+	return searchDirs;
+}
+/**
+* Get a map of skill directory paths to plugin names from plugin manifests.
+* This allows grouping skills by their parent plugin.
+*
+* Returns Map<AbsolutePath, PluginName>
+*/
+async function getPluginGroupings(basePath) {
+	const groupings = /* @__PURE__ */ new Map();
+	try {
+		const content = await readFile(join(basePath, ".claude-plugin/marketplace.json"), "utf-8");
+		const manifest = JSON.parse(content);
+		const pluginRoot = manifest.metadata?.pluginRoot;
+		if (pluginRoot === void 0 || isValidRelativePath(pluginRoot)) for (const plugin of manifest.plugins ?? []) {
+			if (!plugin.name) continue;
+			if (typeof plugin.source !== "string" && plugin.source !== void 0) continue;
+			if (plugin.source !== void 0 && !isValidRelativePath(plugin.source)) continue;
+			const pluginBase = join(basePath, pluginRoot ?? "", plugin.source ?? "");
+			if (!isContainedIn(pluginBase, basePath)) continue;
+			if (plugin.skills && plugin.skills.length > 0) for (const skillPath of plugin.skills) {
+				if (!isValidRelativePath(skillPath)) continue;
+				const skillDir = join(pluginBase, skillPath);
+				if (isContainedIn(skillDir, basePath)) groupings.set(resolve(skillDir), plugin.name);
+			}
+		}
+	} catch {}
+	try {
+		const content = await readFile(join(basePath, ".claude-plugin/plugin.json"), "utf-8");
+		const manifest = JSON.parse(content);
+		if (manifest.name && manifest.skills && manifest.skills.length > 0) for (const skillPath of manifest.skills) {
+			if (!isValidRelativePath(skillPath)) continue;
+			const skillDir = join(basePath, skillPath);
+			if (isContainedIn(skillDir, basePath)) groupings.set(resolve(skillDir), manifest.name);
+		}
+	} catch {}
+	return groupings;
+}
+//#endregion
+//#region src/skills.ts
+const SKIP_DIRS = [
+	"node_modules",
+	".git",
+	"dist",
+	"build",
+	"__pycache__"
+];
+/**
+* Check if internal skills should be installed.
+* Internal skills are hidden by default unless INSTALL_INTERNAL_SKILLS=1 is set.
+*/
+function shouldInstallInternalSkills() {
+	const envValue = process.env.INSTALL_INTERNAL_SKILLS;
+	return envValue === "1" || envValue === "true";
+}
+async function hasSkillMd(dir) {
+	try {
+		return (await stat(join(dir, "SKILL.md"))).isFile();
+	} catch {
+		return false;
+	}
+}
+async function parseSkillMd(skillMdPath, options) {
+	try {
+		const content = await readFile(skillMdPath, "utf-8");
+		const { data } = (0, import_gray_matter.default)(content);
+		if (!data.name || !data.description) return null;
+		if (typeof data.name !== "string" || typeof data.description !== "string") return null;
+		if (data.metadata?.internal === true && !shouldInstallInternalSkills() && !options?.includeInternal) return null;
+		return {
+			name: data.name,
+			description: data.description,
+			path: dirname(skillMdPath),
+			rawContent: content,
+			metadata: data.metadata
+		};
+	} catch {
+		return null;
+	}
+}
+async function findSkillDirs(dir, depth = 0, maxDepth = 5) {
+	if (depth > maxDepth) return [];
+	try {
+		const [hasSkill, entries] = await Promise.all([hasSkillMd(dir), readdir(dir, { withFileTypes: true }).catch(() => [])]);
+		const currentDir = hasSkill ? [dir] : [];
+		const subDirResults = await Promise.all(entries.filter((entry) => entry.isDirectory() && !SKIP_DIRS.includes(entry.name)).map((entry) => findSkillDirs(join(dir, entry.name), depth + 1, maxDepth)));
+		return [...currentDir, ...subDirResults.flat()];
+	} catch {
+		return [];
+	}
+}
+/**
+* Validates that a resolved subpath stays within the base directory.
+* Prevents path traversal attacks where subpath contains ".." segments
+* that would escape the cloned repository directory.
+*/
+function isSubpathSafe(basePath, subpath) {
+	const normalizedBase = normalize(resolve(basePath));
+	const normalizedTarget = normalize(resolve(join(basePath, subpath)));
+	return normalizedTarget.startsWith(normalizedBase + sep) || normalizedTarget === normalizedBase;
+}
+async function discoverSkills(basePath, subpath, options) {
+	const skills = [];
+	const seenNames = /* @__PURE__ */ new Set();
+	if (subpath && !isSubpathSafe(basePath, subpath)) throw new Error(`Invalid subpath: "${subpath}" resolves outside the repository directory. Subpath must not contain ".." segments that escape the base path.`);
+	const searchPath = subpath ? join(basePath, subpath) : basePath;
+	const pluginGroupings = await getPluginGroupings(searchPath);
+	const enhanceSkill = (skill) => {
+		const resolvedPath = resolve(skill.path);
+		if (pluginGroupings.has(resolvedPath)) skill.pluginName = pluginGroupings.get(resolvedPath);
+		return skill;
+	};
+	if (await hasSkillMd(searchPath)) {
+		let skill = await parseSkillMd(join(searchPath, "SKILL.md"), options);
+		if (skill) {
+			skill = enhanceSkill(skill);
+			skills.push(skill);
+			seenNames.add(skill.name);
+			if (!options?.fullDepth) return skills;
+		}
+	}
+	const prioritySearchDirs = [
+		searchPath,
+		join(searchPath, "skills"),
+		join(searchPath, "skills/.curated"),
+		join(searchPath, "skills/.experimental"),
+		join(searchPath, "skills/.system"),
+		join(searchPath, ".agent/skills"),
+		join(searchPath, ".agents/skills"),
+		join(searchPath, ".claude/skills"),
+		join(searchPath, ".cline/skills"),
+		join(searchPath, ".codebuddy/skills"),
+		join(searchPath, ".codex/skills"),
+		join(searchPath, ".commandcode/skills"),
+		join(searchPath, ".continue/skills"),
+		join(searchPath, ".github/skills"),
+		join(searchPath, ".goose/skills"),
+		join(searchPath, ".iflow/skills"),
+		join(searchPath, ".junie/skills"),
+		join(searchPath, ".kilocode/skills"),
+		join(searchPath, ".kiro/skills"),
+		join(searchPath, ".mux/skills"),
+		join(searchPath, ".neovate/skills"),
+		join(searchPath, ".opencode/skills"),
+		join(searchPath, ".openhands/skills"),
+		join(searchPath, ".pi/skills"),
+		join(searchPath, ".qoder/skills"),
+		join(searchPath, ".roo/skills"),
+		join(searchPath, ".trae/skills"),
+		join(searchPath, ".windsurf/skills"),
+		join(searchPath, ".zencoder/skills")
+	];
+	prioritySearchDirs.push(...await getPluginSkillPaths(searchPath));
+	for (const dir of prioritySearchDirs) try {
+		const entries = await readdir(dir, { withFileTypes: true });
+		for (const entry of entries) if (entry.isDirectory()) {
+			const skillDir = join(dir, entry.name);
+			if (await hasSkillMd(skillDir)) {
+				let skill = await parseSkillMd(join(skillDir, "SKILL.md"), options);
+				if (skill && !seenNames.has(skill.name)) {
+					skill = enhanceSkill(skill);
+					skills.push(skill);
+					seenNames.add(skill.name);
+				}
+			}
+		}
+	} catch {}
+	if (skills.length === 0 || options?.fullDepth) {
+		const allSkillDirs = await findSkillDirs(searchPath);
+		for (const skillDir of allSkillDirs) {
+			let skill = await parseSkillMd(join(skillDir, "SKILL.md"), options);
+			if (skill && !seenNames.has(skill.name)) {
+				skill = enhanceSkill(skill);
+				skills.push(skill);
+				seenNames.add(skill.name);
+			}
+		}
+	}
+	return skills;
+}
+function getSkillDisplayName(skill) {
+	return skill.name || basename(skill.path);
+}
+/**
+* Filter skills based on user input (case-insensitive direct matching).
+* Multi-word skill names must be quoted on the command line.
+*/
+function filterSkills(skills, inputNames) {
+	const normalizedInputs = inputNames.map((n) => n.toLowerCase());
+	return skills.filter((skill) => {
+		const name = skill.name.toLowerCase();
+		const displayName = getSkillDisplayName(skill).toLowerCase();
+		return normalizedInputs.some((input) => input === name || input === displayName);
+	});
+}
+//#endregion
+//#region src/agents.ts
+const home = homedir();
+const configHome = xdgConfig ?? join(home, ".config");
+const codexHome = process.env.CODEX_HOME?.trim() || join(home, ".codex");
+const claudeHome = process.env.CLAUDE_CONFIG_DIR?.trim() || join(home, ".claude");
+function getOpenClawGlobalSkillsDir(homeDir = home, pathExists = existsSync) {
+	if (pathExists(join(homeDir, ".openclaw"))) return join(homeDir, ".openclaw/skills");
+	if (pathExists(join(homeDir, ".clawdbot"))) return join(homeDir, ".clawdbot/skills");
+	if (pathExists(join(homeDir, ".moltbot"))) return join(homeDir, ".moltbot/skills");
+	return join(homeDir, ".openclaw/skills");
+}
+const agents = {
+	amp: {
+		name: "amp",
+		displayName: "Amp",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(configHome, "agents/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(configHome, "amp"));
+		}
+	},
+	antigravity: {
+		name: "antigravity",
+		displayName: "Antigravity",
+		skillsDir: ".agent/skills",
+		globalSkillsDir: join(home, ".gemini/antigravity/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".gemini/antigravity"));
+		}
+	},
+	augment: {
+		name: "augment",
+		displayName: "Augment",
+		skillsDir: ".augment/skills",
+		globalSkillsDir: join(home, ".augment/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".augment"));
+		}
+	},
+	"claude-code": {
+		name: "claude-code",
+		displayName: "Claude Code",
+		skillsDir: ".claude/skills",
+		globalSkillsDir: join(claudeHome, "skills"),
+		detectInstalled: async () => {
+			return existsSync(claudeHome);
+		}
+	},
+	openclaw: {
+		name: "openclaw",
+		displayName: "OpenClaw",
+		skillsDir: "skills",
+		globalSkillsDir: getOpenClawGlobalSkillsDir(),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".openclaw")) || existsSync(join(home, ".clawdbot")) || existsSync(join(home, ".moltbot"));
+		}
+	},
+	cline: {
+		name: "cline",
+		displayName: "Cline",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".agents", "skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".cline"));
+		}
+	},
+	codebuddy: {
+		name: "codebuddy",
+		displayName: "CodeBuddy",
+		skillsDir: ".codebuddy/skills",
+		globalSkillsDir: join(home, ".codebuddy/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(process.cwd(), ".codebuddy")) || existsSync(join(home, ".codebuddy"));
+		}
+	},
+	codex: {
+		name: "codex",
+		displayName: "Codex",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(codexHome, "skills"),
+		detectInstalled: async () => {
+			return existsSync(codexHome) || existsSync("/etc/codex");
+		}
+	},
+	"command-code": {
+		name: "command-code",
+		displayName: "Command Code",
+		skillsDir: ".commandcode/skills",
+		globalSkillsDir: join(home, ".commandcode/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".commandcode"));
+		}
+	},
+	continue: {
+		name: "continue",
+		displayName: "Continue",
+		skillsDir: ".continue/skills",
+		globalSkillsDir: join(home, ".continue/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(process.cwd(), ".continue")) || existsSync(join(home, ".continue"));
+		}
+	},
+	cortex: {
+		name: "cortex",
+		displayName: "Cortex Code",
+		skillsDir: ".cortex/skills",
+		globalSkillsDir: join(home, ".snowflake/cortex/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".snowflake/cortex"));
+		}
+	},
+	crush: {
+		name: "crush",
+		displayName: "Crush",
+		skillsDir: ".crush/skills",
+		globalSkillsDir: join(home, ".config/crush/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".config/crush"));
+		}
+	},
+	cursor: {
+		name: "cursor",
+		displayName: "Cursor",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".cursor/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".cursor"));
+		}
+	},
+	droid: {
+		name: "droid",
+		displayName: "Droid",
+		skillsDir: ".factory/skills",
+		globalSkillsDir: join(home, ".factory/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".factory"));
+		}
+	},
+	"gemini-cli": {
+		name: "gemini-cli",
+		displayName: "Gemini CLI",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".gemini/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".gemini"));
+		}
+	},
+	"github-copilot": {
+		name: "github-copilot",
+		displayName: "GitHub Copilot",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".copilot/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".copilot"));
+		}
+	},
+	goose: {
+		name: "goose",
+		displayName: "Goose",
+		skillsDir: ".goose/skills",
+		globalSkillsDir: join(configHome, "goose/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(configHome, "goose"));
+		}
+	},
+	junie: {
+		name: "junie",
+		displayName: "Junie",
+		skillsDir: ".junie/skills",
+		globalSkillsDir: join(home, ".junie/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".junie"));
+		}
+	},
+	"iflow-cli": {
+		name: "iflow-cli",
+		displayName: "iFlow CLI",
+		skillsDir: ".iflow/skills",
+		globalSkillsDir: join(home, ".iflow/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".iflow"));
+		}
+	},
+	kilo: {
+		name: "kilo",
+		displayName: "Kilo Code",
+		skillsDir: ".kilocode/skills",
+		globalSkillsDir: join(home, ".kilocode/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".kilocode"));
+		}
+	},
+	"kimi-cli": {
+		name: "kimi-cli",
+		displayName: "Kimi Code CLI",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".config/agents/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".kimi"));
+		}
+	},
+	"kiro-cli": {
+		name: "kiro-cli",
+		displayName: "Kiro CLI",
+		skillsDir: ".kiro/skills",
+		globalSkillsDir: join(home, ".kiro/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".kiro"));
+		}
+	},
+	kode: {
+		name: "kode",
+		displayName: "Kode",
+		skillsDir: ".kode/skills",
+		globalSkillsDir: join(home, ".kode/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".kode"));
+		}
+	},
+	mcpjam: {
+		name: "mcpjam",
+		displayName: "MCPJam",
+		skillsDir: ".mcpjam/skills",
+		globalSkillsDir: join(home, ".mcpjam/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".mcpjam"));
+		}
+	},
+	"mistral-vibe": {
+		name: "mistral-vibe",
+		displayName: "Mistral Vibe",
+		skillsDir: ".vibe/skills",
+		globalSkillsDir: join(home, ".vibe/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".vibe"));
+		}
+	},
+	mux: {
+		name: "mux",
+		displayName: "Mux",
+		skillsDir: ".mux/skills",
+		globalSkillsDir: join(home, ".mux/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".mux"));
+		}
+	},
+	opencode: {
+		name: "opencode",
+		displayName: "OpenCode",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(configHome, "opencode/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(configHome, "opencode"));
+		}
+	},
+	openhands: {
+		name: "openhands",
+		displayName: "OpenHands",
+		skillsDir: ".openhands/skills",
+		globalSkillsDir: join(home, ".openhands/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".openhands"));
+		}
+	},
+	pi: {
+		name: "pi",
+		displayName: "Pi",
+		skillsDir: ".pi/skills",
+		globalSkillsDir: join(home, ".pi/agent/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".pi/agent"));
+		}
+	},
+	qoder: {
+		name: "qoder",
+		displayName: "Qoder",
+		skillsDir: ".qoder/skills",
+		globalSkillsDir: join(home, ".qoder/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".qoder"));
+		}
+	},
+	"qwen-code": {
+		name: "qwen-code",
+		displayName: "Qwen Code",
+		skillsDir: ".qwen/skills",
+		globalSkillsDir: join(home, ".qwen/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".qwen"));
+		}
+	},
+	replit: {
+		name: "replit",
+		displayName: "Replit",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(configHome, "agents/skills"),
+		showInUniversalList: false,
+		detectInstalled: async () => {
+			return existsSync(join(process.cwd(), ".replit"));
+		}
+	},
+	roo: {
+		name: "roo",
+		displayName: "Roo Code",
+		skillsDir: ".roo/skills",
+		globalSkillsDir: join(home, ".roo/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".roo"));
+		}
+	},
+	trae: {
+		name: "trae",
+		displayName: "Trae",
+		skillsDir: ".trae/skills",
+		globalSkillsDir: join(home, ".trae/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".trae"));
+		}
+	},
+	"trae-cn": {
+		name: "trae-cn",
+		displayName: "Trae CN",
+		skillsDir: ".trae/skills",
+		globalSkillsDir: join(home, ".trae-cn/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".trae-cn"));
+		}
+	},
+	windsurf: {
+		name: "windsurf",
+		displayName: "Windsurf",
+		skillsDir: ".windsurf/skills",
+		globalSkillsDir: join(home, ".codeium/windsurf/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".codeium/windsurf"));
+		}
+	},
+	zencoder: {
+		name: "zencoder",
+		displayName: "Zencoder",
+		skillsDir: ".zencoder/skills",
+		globalSkillsDir: join(home, ".zencoder/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".zencoder"));
+		}
+	},
+	neovate: {
+		name: "neovate",
+		displayName: "Neovate",
+		skillsDir: ".neovate/skills",
+		globalSkillsDir: join(home, ".neovate/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".neovate"));
+		}
+	},
+	pochi: {
+		name: "pochi",
+		displayName: "Pochi",
+		skillsDir: ".pochi/skills",
+		globalSkillsDir: join(home, ".pochi/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".pochi"));
+		}
+	},
+	adal: {
+		name: "adal",
+		displayName: "AdaL",
+		skillsDir: ".adal/skills",
+		globalSkillsDir: join(home, ".adal/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".adal"));
+		}
+	},
+	universal: {
+		name: "universal",
+		displayName: "Universal",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(configHome, "agents/skills"),
+		showInUniversalList: false,
+		detectInstalled: async () => false
+	}
+};
+async function detectInstalledAgents() {
+	return (await Promise.all(Object.entries(agents).map(async ([type, config]) => ({
+		type,
+		installed: await config.detectInstalled()
+	})))).filter((r) => r.installed).map((r) => r.type);
+}
+/**
+* Returns agents that use the universal .agents/skills directory.
+* These agents share a common skill location and don't need symlinks.
+* Agents with showInUniversalList: false are excluded.
+*/
+function getUniversalAgents() {
+	return Object.entries(agents).filter(([_, config]) => config.skillsDir === ".agents/skills" && config.showInUniversalList !== false).map(([type]) => type);
+}
+/**
+* Returns agents that use agent-specific skill directories (not universal).
+* These agents need symlinks from the canonical .agents/skills location.
+*/
+function getNonUniversalAgents() {
+	return Object.entries(agents).filter(([_, config]) => config.skillsDir !== ".agents/skills").map(([type]) => type);
+}
+/**
+* Check if an agent uses the universal .agents/skills directory.
+*/
+function isUniversalAgent(type) {
+	return agents[type].skillsDir === ".agents/skills";
+}
+//#endregion
+//#region src/constants.ts
+const AGENTS_DIR$2 = ".agents";
+const SKILLS_SUBDIR = "skills";
+//#endregion
+//#region src/installer.ts
+/**
+* Sanitizes a filename/directory name to prevent path traversal attacks
+* and ensures it follows kebab-case convention
+* @param name - The name to sanitize
+* @returns Sanitized name safe for use in file paths
+*/
+function sanitizeName(name) {
+	return name.toLowerCase().replace(/[^a-z0-9._]+/g, "-").replace(/^[.\-]+|[.\-]+$/g, "").substring(0, 255) || "unnamed-skill";
+}
+/**
+* Validates that a path is within an expected base directory
+* @param basePath - The expected base directory
+* @param targetPath - The path to validate
+* @returns true if targetPath is within basePath
+*/
+function isPathSafe(basePath, targetPath) {
+	const normalizedBase = normalize(resolve(basePath));
+	const normalizedTarget = normalize(resolve(targetPath));
+	return normalizedTarget.startsWith(normalizedBase + sep) || normalizedTarget === normalizedBase;
+}
+function getCanonicalSkillsDir(global, cwd) {
+	return join(global ? homedir() : cwd || process.cwd(), AGENTS_DIR$2, SKILLS_SUBDIR);
+}
+/**
+* Gets the base directory for an agent's skills, respecting universal agents.
+* Universal agents always use the canonical directory, which prevents
+* redundant symlinks and double-listing of skills.
+*/
+function getAgentBaseDir(agentType, global, cwd) {
+	if (isUniversalAgent(agentType)) return getCanonicalSkillsDir(global, cwd);
+	const agent = agents[agentType];
+	const baseDir = global ? homedir() : cwd || process.cwd();
+	if (global) {
+		if (agent.globalSkillsDir === void 0) return join(baseDir, agent.skillsDir);
+		return agent.globalSkillsDir;
+	}
+	return join(baseDir, agent.skillsDir);
+}
+function resolveSymlinkTarget(linkPath, linkTarget) {
+	return resolve(dirname(linkPath), linkTarget);
+}
+/**
+* Cleans and recreates a directory for skill installation.
+*
+* This ensures:
+* 1. Renamed/deleted files from previous installs are removed
+* 2. Symlinks (including self-referential ones causing ELOOP) are handled
+*    when canonical and agent paths resolve to the same location
+*/
+async function cleanAndCreateDirectory(path) {
+	try {
+		await rm(path, {
+			recursive: true,
+			force: true
+		});
+	} catch {}
+	await mkdir(path, { recursive: true });
+}
+/**
+* Resolve a path's parent directory through symlinks, keeping the final component.
+* This handles the case where a parent directory (e.g., ~/.claude/skills) is a symlink
+* to another location (e.g., ~/.agents/skills). In that case, computing relative paths
+* from the symlink path produces broken symlinks.
+*
+* Returns the real path of the parent + the original basename.
+* If realpath fails (parent doesn't exist), returns the original resolved path.
+*/
+async function resolveParentSymlinks(path) {
+	const resolved = resolve(path);
+	const dir = dirname(resolved);
+	const base = basename(resolved);
+	try {
+		return join(await realpath(dir), base);
+	} catch {
+		return resolved;
+	}
+}
+/**
+* Creates a symlink, handling cross-platform differences
+* Returns true if symlink was created, false if fallback to copy is needed
+*/
+async function createSymlink(target, linkPath) {
+	try {
+		const resolvedTarget = resolve(target);
+		const resolvedLinkPath = resolve(linkPath);
+		const [realTarget, realLinkPath] = await Promise.all([realpath(resolvedTarget).catch(() => resolvedTarget), realpath(resolvedLinkPath).catch(() => resolvedLinkPath)]);
+		if (realTarget === realLinkPath) return true;
+		if (await resolveParentSymlinks(target) === await resolveParentSymlinks(linkPath)) return true;
+		try {
+			if ((await lstat(linkPath)).isSymbolicLink()) {
+				if (resolveSymlinkTarget(linkPath, await readlink(linkPath)) === resolvedTarget) return true;
+				await rm(linkPath);
+			} else await rm(linkPath, { recursive: true });
+		} catch (err) {
+			if (err && typeof err === "object" && "code" in err && err.code === "ELOOP") try {
+				await rm(linkPath, { force: true });
+			} catch {}
+		}
+		const linkDir = dirname(linkPath);
+		await mkdir(linkDir, { recursive: true });
+		await symlink(relative(await resolveParentSymlinks(linkDir), target), linkPath, platform() === "win32" ? "junction" : void 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function installSkillForAgent(skill, agentType, options = {}) {
+	const agent = agents[agentType];
+	const isGlobal = options.global ?? false;
+	const cwd = options.cwd || process.cwd();
+	if (isGlobal && agent.globalSkillsDir === void 0) return {
+		success: false,
+		path: "",
+		mode: options.mode ?? "symlink",
+		error: `${agent.displayName} does not support global skill installation`
+	};
+	const skillName = sanitizeName(skill.name || basename(skill.path));
+	const canonicalBase = getCanonicalSkillsDir(isGlobal, cwd);
+	const canonicalDir = join(canonicalBase, skillName);
+	const agentBase = getAgentBaseDir(agentType, isGlobal, cwd);
+	const agentDir = join(agentBase, skillName);
+	const installMode = options.mode ?? "symlink";
+	if (!isPathSafe(canonicalBase, canonicalDir)) return {
+		success: false,
+		path: agentDir,
+		mode: installMode,
+		error: "Invalid skill name: potential path traversal detected"
+	};
+	if (!isPathSafe(agentBase, agentDir)) return {
+		success: false,
+		path: agentDir,
+		mode: installMode,
+		error: "Invalid skill name: potential path traversal detected"
+	};
+	try {
+		if (installMode === "copy") {
+			await cleanAndCreateDirectory(agentDir);
+			await copyDirectory(skill.path, agentDir);
+			return {
+				success: true,
+				path: agentDir,
+				mode: "copy"
+			};
+		}
+		await cleanAndCreateDirectory(canonicalDir);
+		await copyDirectory(skill.path, canonicalDir);
+		if (isGlobal && isUniversalAgent(agentType)) return {
+			success: true,
+			path: canonicalDir,
+			canonicalPath: canonicalDir,
+			mode: "symlink"
+		};
+		if (!await createSymlink(canonicalDir, agentDir)) {
+			await cleanAndCreateDirectory(agentDir);
+			await copyDirectory(skill.path, agentDir);
+			return {
+				success: true,
+				path: agentDir,
+				canonicalPath: canonicalDir,
+				mode: "symlink",
+				symlinkFailed: true
+			};
+		}
+		return {
+			success: true,
+			path: agentDir,
+			canonicalPath: canonicalDir,
+			mode: "symlink"
+		};
+	} catch (error) {
+		return {
+			success: false,
+			path: agentDir,
+			mode: installMode,
+			error: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+const EXCLUDE_FILES = new Set(["metadata.json"]);
+const EXCLUDE_DIRS = new Set([".git"]);
+const isExcluded = (name, isDirectory = false) => {
+	if (EXCLUDE_FILES.has(name)) return true;
+	if (name.startsWith("_")) return true;
+	if (isDirectory && EXCLUDE_DIRS.has(name)) return true;
+	return false;
+};
+async function copyDirectory(src, dest) {
+	await mkdir(dest, { recursive: true });
+	const entries = await readdir(src, { withFileTypes: true });
+	await Promise.all(entries.filter((entry) => !isExcluded(entry.name, entry.isDirectory())).map(async (entry) => {
+		const srcPath = join(src, entry.name);
+		const destPath = join(dest, entry.name);
+		if (entry.isDirectory()) await copyDirectory(srcPath, destPath);
+		else await cp(srcPath, destPath, {
+			dereference: true,
+			recursive: true
+		});
+	}));
+}
+async function isSkillInstalled(skillName, agentType, options = {}) {
+	const agent = agents[agentType];
+	const sanitized = sanitizeName(skillName);
+	if (options.global && agent.globalSkillsDir === void 0) return false;
+	const targetBase = options.global ? agent.globalSkillsDir : join(options.cwd || process.cwd(), agent.skillsDir);
+	const skillDir = join(targetBase, sanitized);
+	if (!isPathSafe(targetBase, skillDir)) return false;
+	try {
+		await access(skillDir);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function getInstallPath(skillName, agentType, options = {}) {
+	agents[agentType];
+	options.cwd || process.cwd();
+	const sanitized = sanitizeName(skillName);
+	const targetBase = getAgentBaseDir(agentType, options.global ?? false, options.cwd);
+	const installPath = join(targetBase, sanitized);
+	if (!isPathSafe(targetBase, installPath)) throw new Error("Invalid skill name: potential path traversal detected");
+	return installPath;
+}
+/**
+* Gets the canonical .agents/skills/<skill> path
+*/
+function getCanonicalPath(skillName, options = {}) {
+	const sanitized = sanitizeName(skillName);
+	const canonicalBase = getCanonicalSkillsDir(options.global ?? false, options.cwd);
+	const canonicalPath = join(canonicalBase, sanitized);
+	if (!isPathSafe(canonicalBase, canonicalPath)) throw new Error("Invalid skill name: potential path traversal detected");
+	return canonicalPath;
+}
+/**
+* Install a well-known skill with multiple files.
+* The skill directory name is derived from the installName field.
+* All files from the skill's files map are written to the installation directory.
+* Supports symlink mode (writes to canonical location and symlinks to agent dirs)
+* or copy mode (writes directly to each agent dir).
+*/
+async function installWellKnownSkillForAgent(skill, agentType, options = {}) {
+	const agent = agents[agentType];
+	const isGlobal = options.global ?? false;
+	const cwd = options.cwd || process.cwd();
+	const installMode = options.mode ?? "symlink";
+	if (isGlobal && agent.globalSkillsDir === void 0) return {
+		success: false,
+		path: "",
+		mode: installMode,
+		error: `${agent.displayName} does not support global skill installation`
+	};
+	const skillName = sanitizeName(skill.installName);
+	const canonicalBase = getCanonicalSkillsDir(isGlobal, cwd);
+	const canonicalDir = join(canonicalBase, skillName);
+	const agentBase = getAgentBaseDir(agentType, isGlobal, cwd);
+	const agentDir = join(agentBase, skillName);
+	if (!isPathSafe(canonicalBase, canonicalDir)) return {
+		success: false,
+		path: agentDir,
+		mode: installMode,
+		error: "Invalid skill name: potential path traversal detected"
+	};
+	if (!isPathSafe(agentBase, agentDir)) return {
+		success: false,
+		path: agentDir,
+		mode: installMode,
+		error: "Invalid skill name: potential path traversal detected"
+	};
+	/**
+	* Write all skill files to a directory (assumes directory already exists)
+	*/
+	async function writeSkillFiles(targetDir) {
+		for (const [filePath, content] of skill.files) {
+			const fullPath = join(targetDir, filePath);
+			if (!isPathSafe(targetDir, fullPath)) continue;
+			const parentDir = dirname(fullPath);
+			if (parentDir !== targetDir) await mkdir(parentDir, { recursive: true });
+			await writeFile(fullPath, content, "utf-8");
+		}
+	}
+	try {
+		if (installMode === "copy") {
+			await cleanAndCreateDirectory(agentDir);
+			await writeSkillFiles(agentDir);
+			return {
+				success: true,
+				path: agentDir,
+				mode: "copy"
+			};
+		}
+		await cleanAndCreateDirectory(canonicalDir);
+		await writeSkillFiles(canonicalDir);
+		if (isGlobal && isUniversalAgent(agentType)) return {
+			success: true,
+			path: canonicalDir,
+			canonicalPath: canonicalDir,
+			mode: "symlink"
+		};
+		if (!await createSymlink(canonicalDir, agentDir)) {
+			await cleanAndCreateDirectory(agentDir);
+			await writeSkillFiles(agentDir);
+			return {
+				success: true,
+				path: agentDir,
+				canonicalPath: canonicalDir,
+				mode: "symlink",
+				symlinkFailed: true
+			};
+		}
+		return {
+			success: true,
+			path: agentDir,
+			canonicalPath: canonicalDir,
+			mode: "symlink"
+		};
+	} catch (error) {
+		return {
+			success: false,
+			path: agentDir,
+			mode: installMode,
+			error: error instanceof Error ? error.message : "Unknown error"
+		};
+	}
+}
+/**
+* Lists all installed skills from canonical locations
+* @param options - Options for listing skills
+* @returns Array of installed skills with metadata
+*/
+async function listInstalledSkills(options = {}) {
+	const cwd = options.cwd || process.cwd();
+	const skillsMap = /* @__PURE__ */ new Map();
+	const scopes = [];
+	const detectedAgents = await detectInstalledAgents();
+	const agentFilter = options.agentFilter;
+	const agentsToCheck = agentFilter ? detectedAgents.filter((a) => agentFilter.includes(a)) : detectedAgents;
+	const scopeTypes = [];
+	if (options.global === void 0) scopeTypes.push({ global: false }, { global: true });
+	else scopeTypes.push({ global: options.global });
+	for (const { global: isGlobal } of scopeTypes) {
+		scopes.push({
+			global: isGlobal,
+			path: getCanonicalSkillsDir(isGlobal, cwd)
+		});
+		for (const agentType of agentsToCheck) {
+			const agent = agents[agentType];
+			if (isGlobal && agent.globalSkillsDir === void 0) continue;
+			const agentDir = isGlobal ? agent.globalSkillsDir : join(cwd, agent.skillsDir);
+			if (!scopes.some((s) => s.path === agentDir && s.global === isGlobal)) scopes.push({
+				global: isGlobal,
+				path: agentDir,
+				agentType
+			});
+		}
+	}
+	for (const scope of scopes) try {
+		const entries = await readdir(scope.path, { withFileTypes: true });
+		for (const entry of entries) {
+			if (!entry.isDirectory()) continue;
+			const skillDir = join(scope.path, entry.name);
+			const skillMdPath = join(skillDir, "SKILL.md");
+			try {
+				await stat(skillMdPath);
+			} catch {
+				continue;
+			}
+			const skill = await parseSkillMd(skillMdPath);
+			if (!skill) continue;
+			const scopeKey = scope.global ? "global" : "project";
+			const skillKey = `${scopeKey}:${skill.name}`;
+			if (scope.agentType) {
+				if (skillsMap.has(skillKey)) {
+					const existing = skillsMap.get(skillKey);
+					if (!existing.agents.includes(scope.agentType)) existing.agents.push(scope.agentType);
+				} else skillsMap.set(skillKey, {
+					name: skill.name,
+					description: skill.description,
+					path: skillDir,
+					canonicalPath: skillDir,
+					scope: scopeKey,
+					agents: [scope.agentType]
+				});
+				continue;
+			}
+			const sanitizedSkillName = sanitizeName(skill.name);
+			const installedAgents = [];
+			for (const agentType of agentsToCheck) {
+				const agent = agents[agentType];
+				if (scope.global && agent.globalSkillsDir === void 0) continue;
+				const agentBase = scope.global ? agent.globalSkillsDir : join(cwd, agent.skillsDir);
+				let found = false;
+				const possibleNames = Array.from(new Set([
+					entry.name,
+					sanitizedSkillName,
+					skill.name.toLowerCase().replace(/\s+/g, "-").replace(/[\/\\:\0]/g, "")
+				]));
+				for (const possibleName of possibleNames) {
+					const agentSkillDir = join(agentBase, possibleName);
+					if (!isPathSafe(agentBase, agentSkillDir)) continue;
+					try {
+						await access(agentSkillDir);
+						found = true;
+						break;
+					} catch {}
+				}
+				if (!found) try {
+					const agentEntries = await readdir(agentBase, { withFileTypes: true });
+					for (const agentEntry of agentEntries) {
+						if (!agentEntry.isDirectory()) continue;
+						const candidateDir = join(agentBase, agentEntry.name);
+						if (!isPathSafe(agentBase, candidateDir)) continue;
+						try {
+							const candidateSkillMd = join(candidateDir, "SKILL.md");
+							await stat(candidateSkillMd);
+							const candidateSkill = await parseSkillMd(candidateSkillMd);
+							if (candidateSkill && candidateSkill.name === skill.name) {
+								found = true;
+								break;
+							}
+						} catch {}
+					}
+				} catch {}
+				if (found) installedAgents.push(agentType);
+			}
+			if (skillsMap.has(skillKey)) {
+				const existing = skillsMap.get(skillKey);
+				for (const agent of installedAgents) if (!existing.agents.includes(agent)) existing.agents.push(agent);
+			} else skillsMap.set(skillKey, {
+				name: skill.name,
+				description: skill.description,
+				path: skillDir,
+				canonicalPath: skillDir,
+				scope: scopeKey,
+				agents: installedAgents
+			});
+		}
+	} catch {}
+	return Array.from(skillsMap.values());
+}
+//#endregion
+//#region src/telemetry.ts
+const TELEMETRY_URL = process.env.SKILLS_TELEMETRY_URL || "";
+const AUDIT_URL = process.env.SKILLS_AUDIT_URL || "";
+let cliVersion = null;
+function isCI() {
+	return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.CIRCLECI || process.env.TRAVIS || process.env.BUILDKITE || process.env.JENKINS_URL || process.env.TEAMCITY_VERSION);
+}
+function isEnabled() {
+	return !process.env.DISABLE_TELEMETRY && !process.env.DO_NOT_TRACK;
+}
+function setVersion(version) {
+	cliVersion = version;
+}
+/**
+* Fetch security audit results for skills from the audit API.
+* Returns null on any error or timeout — never blocks installation.
+*/
+async function fetchAuditData(source, skillSlugs, timeoutMs = 3e3) {
+	if (!AUDIT_URL || skillSlugs.length === 0) return null;
+	try {
+		const params = new URLSearchParams({
+			source,
+			skills: skillSlugs.join(",")
+		});
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), timeoutMs);
+		const response = await fetch(`${AUDIT_URL}?${params.toString()}`, { signal: controller.signal });
+		clearTimeout(timeout);
+		if (!response.ok) return null;
+		return await response.json();
+	} catch {
+		return null;
+	}
+}
+function track(data) {
+	if (!TELEMETRY_URL || !isEnabled()) return;
+	try {
+		const params = new URLSearchParams();
+		if (cliVersion) params.set("v", cliVersion);
+		if (isCI()) params.set("ci", "1");
+		for (const [key, value] of Object.entries(data)) if (value !== void 0 && value !== null) params.set(key, String(value));
+		fetch(`${TELEMETRY_URL}?${params.toString()}`).catch(() => {});
+	} catch {}
+}
+//#endregion
+//#region src/providers/registry.ts
+var ProviderRegistryImpl = class {
+	providers = [];
+	register(provider) {
+		if (this.providers.some((p) => p.id === provider.id)) throw new Error(`Provider with id "${provider.id}" already registered`);
+		this.providers.push(provider);
+	}
+	findProvider(url) {
+		for (const provider of this.providers) if (provider.match(url).matches) return provider;
+		return null;
+	}
+	getProviders() {
+		return [...this.providers];
+	}
+};
+new ProviderRegistryImpl();
+//#endregion
+//#region src/providers/wellknown.ts
+/**
+* Well-known skills provider using RFC 8615 well-known URIs.
+*
+* Organizations can publish skills at:
+* https://example.com/.well-known/skills/
+*
+* URL formats supported:
+* - https://example.com (discovers all skills from root)
+* - https://example.com/docs (discovers from /docs/.well-known/skills/)
+* - https://example.com/.well-known/skills (discovers all skills)
+* - https://example.com/.well-known/skills/skill-name (specific skill)
+*
+* The source identifier is "wellknown/{hostname}" or "wellknown/{hostname}/path".
+*/
+var WellKnownProvider = class {
+	id = "well-known";
+	displayName = "Well-Known Skills";
+	WELL_KNOWN_PATH = ".well-known/skills";
+	INDEX_FILE = "index.json";
+	/**
+	* Check if a URL could be a well-known skills endpoint.
+	* This is a fallback provider - it matches any HTTP(S) URL that is not
+	* a recognized pattern (GitHub, GitLab, owner/repo shorthand, etc.)
+	*/
+	match(url) {
+		if (!url.startsWith("http://") && !url.startsWith("https://")) return { matches: false };
+		try {
+			const parsed = new URL(url);
+			if ([
+				"github.com",
+				"gitlab.com",
+				"huggingface.co"
+			].includes(parsed.hostname)) return { matches: false };
+			return {
+				matches: true,
+				sourceIdentifier: `wellknown/${parsed.hostname}`
+			};
+		} catch {
+			return { matches: false };
+		}
+	}
+	/**
+	* Fetch the skills index from a well-known endpoint.
+	* Tries both the path-relative .well-known and the root .well-known.
+	*/
+	async fetchIndex(baseUrl) {
+		try {
+			const parsed = new URL(baseUrl);
+			const basePath = parsed.pathname.replace(/\/$/, "");
+			const urlsToTry = [{
+				indexUrl: `${parsed.protocol}//${parsed.host}${basePath}/${this.WELL_KNOWN_PATH}/${this.INDEX_FILE}`,
+				baseUrl: `${parsed.protocol}//${parsed.host}${basePath}`
+			}];
+			if (basePath && basePath !== "") urlsToTry.push({
+				indexUrl: `${parsed.protocol}//${parsed.host}/${this.WELL_KNOWN_PATH}/${this.INDEX_FILE}`,
+				baseUrl: `${parsed.protocol}//${parsed.host}`
+			});
+			for (const { indexUrl, baseUrl: resolvedBase } of urlsToTry) try {
+				const response = await fetch(indexUrl);
+				if (!response.ok) continue;
+				const index = await response.json();
+				if (!index.skills || !Array.isArray(index.skills)) continue;
+				let allValid = true;
+				for (const entry of index.skills) if (!this.isValidSkillEntry(entry)) {
+					allValid = false;
+					break;
+				}
+				if (allValid) return {
+					index,
+					resolvedBaseUrl: resolvedBase
+				};
+			} catch {
+				continue;
+			}
+			return null;
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Validate a skill entry from the index.
+	*/
+	isValidSkillEntry(entry) {
+		if (!entry || typeof entry !== "object") return false;
+		const e = entry;
+		if (typeof e.name !== "string" || !e.name) return false;
+		if (typeof e.description !== "string" || !e.description) return false;
+		if (!Array.isArray(e.files) || e.files.length === 0) return false;
+		if (!/^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$/.test(e.name) && e.name.length > 1) {
+			if (e.name.length === 1 && !/^[a-z0-9]$/.test(e.name)) return false;
+		}
+		for (const file of e.files) {
+			if (typeof file !== "string") return false;
+			if (file.startsWith("/") || file.startsWith("\\") || file.includes("..")) return false;
+		}
+		if (!e.files.some((f) => typeof f === "string" && f.toLowerCase() === "skill.md")) return false;
+		return true;
+	}
+	/**
+	* Fetch a single skill and all its files from a well-known endpoint.
+	*/
+	async fetchSkill(url) {
+		try {
+			const parsed = new URL(url);
+			const result = await this.fetchIndex(url);
+			if (!result) return null;
+			const { index, resolvedBaseUrl } = result;
+			let skillName = null;
+			const pathMatch = parsed.pathname.match(/\/.well-known\/skills\/([^/]+)\/?$/);
+			if (pathMatch && pathMatch[1] && pathMatch[1] !== "index.json") skillName = pathMatch[1];
+			else if (index.skills.length === 1) skillName = index.skills[0].name;
+			if (!skillName) return null;
+			const skillEntry = index.skills.find((s) => s.name === skillName);
+			if (!skillEntry) return null;
+			return this.fetchSkillByEntry(resolvedBaseUrl, skillEntry);
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Fetch a skill by its index entry.
+	* @param baseUrl - The base URL (e.g., https://example.com or https://example.com/docs)
+	* @param entry - The skill entry from index.json
+	*/
+	async fetchSkillByEntry(baseUrl, entry) {
+		try {
+			const skillBaseUrl = `${baseUrl.replace(/\/$/, "")}/${this.WELL_KNOWN_PATH}/${entry.name}`;
+			const skillMdUrl = `${skillBaseUrl}/SKILL.md`;
+			const response = await fetch(skillMdUrl);
+			if (!response.ok) return null;
+			const content = await response.text();
+			const { data } = (0, import_gray_matter.default)(content);
+			if (!data.name || !data.description) return null;
+			const files = /* @__PURE__ */ new Map();
+			files.set("SKILL.md", content);
+			const filePromises = entry.files.filter((f) => f.toLowerCase() !== "skill.md").map(async (filePath) => {
+				try {
+					const fileUrl = `${skillBaseUrl}/${filePath}`;
+					const fileResponse = await fetch(fileUrl);
+					if (fileResponse.ok) return {
+						path: filePath,
+						content: await fileResponse.text()
+					};
+				} catch {}
+				return null;
+			});
+			const fileResults = await Promise.all(filePromises);
+			for (const result of fileResults) if (result) files.set(result.path, result.content);
+			return {
+				name: data.name,
+				description: data.description,
+				content,
+				installName: entry.name,
+				sourceUrl: skillMdUrl,
+				metadata: data.metadata,
+				files,
+				indexEntry: entry
+			};
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Fetch all skills from a well-known endpoint.
+	*/
+	async fetchAllSkills(url) {
+		try {
+			const result = await this.fetchIndex(url);
+			if (!result) return [];
+			const { index, resolvedBaseUrl } = result;
+			const skillPromises = index.skills.map((entry) => this.fetchSkillByEntry(resolvedBaseUrl, entry));
+			return (await Promise.all(skillPromises)).filter((s) => s !== null);
+		} catch {
+			return [];
+		}
+	}
+	/**
+	* Convert a user-facing URL to a skill URL.
+	* For well-known, this extracts the base domain and constructs the proper path.
+	*/
+	toRawUrl(url) {
+		try {
+			const parsed = new URL(url);
+			if (url.toLowerCase().endsWith("/skill.md")) return url;
+			const pathMatch = parsed.pathname.match(/\/.well-known\/skills\/([^/]+)\/?$/);
+			if (pathMatch && pathMatch[1]) {
+				const basePath = parsed.pathname.replace(/\/.well-known\/skills\/.*$/, "");
+				return `${parsed.protocol}//${parsed.host}${basePath}/${this.WELL_KNOWN_PATH}/${pathMatch[1]}/SKILL.md`;
+			}
+			const basePath = parsed.pathname.replace(/\/$/, "");
+			return `${parsed.protocol}//${parsed.host}${basePath}/${this.WELL_KNOWN_PATH}/${this.INDEX_FILE}`;
+		} catch {
+			return url;
+		}
+	}
+	/**
+	* Get the source identifier for telemetry/storage.
+	* Returns the full hostname with www. stripped.
+	* e.g., "https://mintlify.com/docs" → "mintlify.com"
+	*       "https://mppx-discovery-skills.vercel.app" → "mppx-discovery-skills.vercel.app"
+	*       "https://www.example.com" → "example.com"
+	*       "https://docs.lovable.dev" → "docs.lovable.dev"
+	*/
+	getSourceIdentifier(url) {
+		try {
+			return new URL(url).hostname.replace(/^www\./, "");
+		} catch {
+			return "unknown";
+		}
+	}
+	/**
+	* Check if a URL has a well-known skills index.
+	*/
+	async hasSkillsIndex(url) {
+		return await this.fetchIndex(url) !== null;
+	}
+};
+const wellKnownProvider = new WellKnownProvider();
+//#endregion
+//#region src/skill-lock.ts
+const AGENTS_DIR$1 = ".agents";
+const LOCK_FILE$1 = ".skill-lock.json";
+const CURRENT_VERSION$1 = 3;
+/**
+* Get the path to the global skill lock file.
+* Located at ~/.agents/.skill-lock.json
+*/
+function getSkillLockPath$1() {
+	return join(homedir(), AGENTS_DIR$1, LOCK_FILE$1);
+}
+/**
+* Read the skill lock file.
+* Returns an empty lock file structure if the file doesn't exist.
+* Wipes the lock file if it's an old format (version < CURRENT_VERSION).
+*/
+async function readSkillLock$1() {
+	const lockPath = getSkillLockPath$1();
+	try {
+		const content = await readFile(lockPath, "utf-8");
+		const parsed = JSON.parse(content);
+		if (typeof parsed.version !== "number" || !parsed.skills) return createEmptyLockFile();
+		if (parsed.version < CURRENT_VERSION$1) return createEmptyLockFile();
+		return parsed;
+	} catch (error) {
+		return createEmptyLockFile();
+	}
+}
+/**
+* Write the skill lock file.
+* Creates the directory if it doesn't exist.
+*/
+async function writeSkillLock(lock) {
+	const lockPath = getSkillLockPath$1();
+	await mkdir(dirname(lockPath), { recursive: true });
+	await writeFile(lockPath, JSON.stringify(lock, null, 2), "utf-8");
+}
+/**
+* Get GitHub token from user's environment.
+* Tries in order:
+* 1. GITHUB_TOKEN environment variable
+* 2. GH_TOKEN environment variable
+* 3. gh CLI auth token (if gh is installed)
+*
+* @returns The token string or null if not available
+*/
+function getGitHubToken() {
+	if (process.env.GITHUB_TOKEN) return process.env.GITHUB_TOKEN;
+	if (process.env.GH_TOKEN) return process.env.GH_TOKEN;
+	try {
+		const token = execSync("gh auth token", {
+			encoding: "utf-8",
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			]
+		}).trim();
+		if (token) return token;
+	} catch {}
+	return null;
+}
+/**
+* Fetch the tree SHA (folder hash) for a skill folder using GitHub's Trees API.
+* This makes ONE API call to get the entire repo tree, then extracts the SHA
+* for the specific skill folder.
+*
+* @param ownerRepo - GitHub owner/repo (e.g., "vercel-labs/agent-skills")
+* @param skillPath - Path to skill folder or SKILL.md (e.g., "skills/react-best-practices/SKILL.md")
+* @param token - Optional GitHub token for authenticated requests (higher rate limits)
+* @returns The tree SHA for the skill folder, or null if not found
+*/
+async function fetchSkillFolderHash(ownerRepo, skillPath, token) {
+	let folderPath = skillPath.replace(/\\/g, "/");
+	if (folderPath.endsWith("/SKILL.md")) folderPath = folderPath.slice(0, -9);
+	else if (folderPath.endsWith("SKILL.md")) folderPath = folderPath.slice(0, -8);
+	if (folderPath.endsWith("/")) folderPath = folderPath.slice(0, -1);
+	for (const branch of ["main", "master"]) try {
+		const url = `https://api.github.com/repos/${ownerRepo}/git/trees/${branch}?recursive=1`;
+		const headers = {
+			Accept: "application/vnd.github.v3+json",
+			"User-Agent": "skills-cli"
+		};
+		if (token) headers["Authorization"] = `Bearer ${token}`;
+		const response = await fetch(url, { headers });
+		if (!response.ok) continue;
+		const data = await response.json();
+		if (!folderPath) return data.sha;
+		const folderEntry = data.tree.find((entry) => entry.type === "tree" && entry.path === folderPath);
+		if (folderEntry) return folderEntry.sha;
+	} catch {
+		continue;
+	}
+	return null;
+}
+/**
+* Add or update a skill entry in the lock file.
+*/
+async function addSkillToLock(skillName, entry) {
+	const lock = await readSkillLock$1();
+	const now = (/* @__PURE__ */ new Date()).toISOString();
+	const existingEntry = lock.skills[skillName];
+	lock.skills[skillName] = {
+		...entry,
+		installedAt: existingEntry?.installedAt ?? now,
+		updatedAt: now
+	};
+	await writeSkillLock(lock);
+}
+/**
+* Remove a skill from the lock file.
+*/
+async function removeSkillFromLock(skillName) {
+	const lock = await readSkillLock$1();
+	if (!(skillName in lock.skills)) return false;
+	delete lock.skills[skillName];
+	await writeSkillLock(lock);
+	return true;
+}
+/**
+* Get a skill entry from the lock file.
+*/
+async function getSkillFromLock(skillName) {
+	return (await readSkillLock$1()).skills[skillName] ?? null;
+}
+/**
+* Get all skills from the lock file.
+*/
+async function getAllLockedSkills() {
+	return (await readSkillLock$1()).skills;
+}
+/**
+* Create an empty lock file structure.
+*/
+function createEmptyLockFile() {
+	return {
+		version: CURRENT_VERSION$1,
+		skills: {},
+		dismissed: {}
+	};
+}
+/**
+* Check if a prompt has been dismissed.
+*/
+async function isPromptDismissed(promptKey) {
+	return (await readSkillLock$1()).dismissed?.[promptKey] === true;
+}
+/**
+* Mark a prompt as dismissed.
+*/
+async function dismissPrompt(promptKey) {
+	const lock = await readSkillLock$1();
+	if (!lock.dismissed) lock.dismissed = {};
+	lock.dismissed[promptKey] = true;
+	await writeSkillLock(lock);
+}
+/**
+* Get the last selected agents.
+*/
+async function getLastSelectedAgents() {
+	return (await readSkillLock$1()).lastSelectedAgents;
+}
+/**
+* Save the selected agents to the lock file.
+*/
+async function saveSelectedAgents(agents) {
+	const lock = await readSkillLock$1();
+	lock.lastSelectedAgents = agents;
+	await writeSkillLock(lock);
+}
+//#endregion
+//#region src/local-lock.ts
+const LOCAL_LOCK_FILE = "skills-lock.json";
+const CURRENT_VERSION = 1;
+/**
+* Get the path to the local skill lock file for a project.
+*/
+function getLocalLockPath(cwd) {
+	return join(cwd || process.cwd(), LOCAL_LOCK_FILE);
+}
+/**
+* Read the local skill lock file.
+* Returns an empty lock file structure if the file doesn't exist
+* or is corrupted (e.g., merge conflict markers).
+*/
+async function readLocalLock(cwd) {
+	const lockPath = getLocalLockPath(cwd);
+	try {
+		const content = await readFile(lockPath, "utf-8");
+		const parsed = JSON.parse(content);
+		if (typeof parsed.version !== "number" || !parsed.skills) return createEmptyLocalLock();
+		if (parsed.version < CURRENT_VERSION) return createEmptyLocalLock();
+		return parsed;
+	} catch {
+		return createEmptyLocalLock();
+	}
+}
+/**
+* Write the local skill lock file.
+* Skills are sorted alphabetically by name for deterministic output.
+*/
+async function writeLocalLock(lock, cwd) {
+	const lockPath = getLocalLockPath(cwd);
+	const sortedSkills = {};
+	for (const key of Object.keys(lock.skills).sort()) sortedSkills[key] = lock.skills[key];
+	const sorted = {
+		version: lock.version,
+		skills: sortedSkills
+	};
+	await writeFile(lockPath, JSON.stringify(sorted, null, 2) + "\n", "utf-8");
+}
+/**
+* Compute a SHA-256 hash from all files in a skill directory.
+* Reads all files recursively, sorts them by relative path for determinism,
+* and produces a single hash from their concatenated contents.
+*/
+async function computeSkillFolderHash(skillDir) {
+	const files = [];
+	await collectFiles(skillDir, skillDir, files);
+	files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+	const hash = createHash("sha256");
+	for (const file of files) {
+		hash.update(file.relativePath);
+		hash.update(file.content);
+	}
+	return hash.digest("hex");
+}
+async function collectFiles(baseDir, currentDir, results) {
+	const entries = await readdir(currentDir, { withFileTypes: true });
+	await Promise.all(entries.map(async (entry) => {
+		const fullPath = join(currentDir, entry.name);
+		if (entry.isDirectory()) {
+			if (entry.name === ".git" || entry.name === "node_modules") return;
+			await collectFiles(baseDir, fullPath, results);
+		} else if (entry.isFile()) {
+			const content = await readFile(fullPath);
+			const relativePath = relative(baseDir, fullPath).split("\\").join("/");
+			results.push({
+				relativePath,
+				content
+			});
+		}
+	}));
+}
+/**
+* Add or update a skill entry in the local lock file.
+*/
+async function addSkillToLocalLock(skillName, entry, cwd) {
+	const lock = await readLocalLock(cwd);
+	lock.skills[skillName] = entry;
+	await writeLocalLock(lock, cwd);
+}
+function createEmptyLocalLock() {
+	return {
+		version: CURRENT_VERSION,
+		skills: {}
+	};
+}
+//#endregion
+//#region package.json
+var version$1 = "1.0.0";
+//#endregion
+//#region src/add.ts
+const isCancelled$1 = (value) => typeof value === "symbol";
+/**
+* Check if a source identifier (owner/repo format) represents a private GitHub repo.
+* Returns true if private, false if public, null if unable to determine or not a GitHub repo.
+*/
+async function isSourcePrivate(source) {
+	const ownerRepo = parseOwnerRepo(source);
+	if (!ownerRepo) return false;
+	return isRepoPrivate(ownerRepo.owner, ownerRepo.repo);
+}
+function initTelemetry(version) {
+	setVersion(version);
+}
+function riskLabel(risk) {
+	switch (risk) {
+		case "critical": return import_picocolors.default.red(import_picocolors.default.bold("Critical Risk"));
+		case "high": return import_picocolors.default.red("High Risk");
+		case "medium": return import_picocolors.default.yellow("Med Risk");
+		case "low": return import_picocolors.default.green("Low Risk");
+		case "safe": return import_picocolors.default.green("Safe");
+		default: return import_picocolors.default.dim("--");
+	}
+}
+function socketLabel(audit) {
+	if (!audit) return import_picocolors.default.dim("--");
+	const count = audit.alerts ?? 0;
+	return count > 0 ? import_picocolors.default.red(`${count} alert${count !== 1 ? "s" : ""}`) : import_picocolors.default.green("0 alerts");
+}
+/** Pad a string to a given visible width (ignoring ANSI escape codes). */
+function padEnd(str, width) {
+	const visible = str.replace(/\x1b\[[0-9;]*m/g, "");
+	const pad = Math.max(0, width - visible.length);
+	return str + " ".repeat(pad);
+}
+/**
+* Render a compact security table showing partner audit results.
+* Returns the lines to display, or empty array if no data.
+*/
+function buildSecurityLines(auditData, skills, source) {
+	if (!auditData) return [];
+	if (!skills.some((s) => {
+		const data = auditData[s.slug];
+		return data && Object.keys(data).length > 0;
+	})) return [];
+	const nameWidth = Math.min(Math.max(...skills.map((s) => s.displayName.length)), 36);
+	const lines = [];
+	const header = padEnd("", nameWidth + 2) + padEnd(import_picocolors.default.dim("Gen"), 18) + padEnd(import_picocolors.default.dim("Socket"), 18) + import_picocolors.default.dim("Snyk");
+	lines.push(header);
+	for (const skill of skills) {
+		const data = auditData[skill.slug];
+		const name = skill.displayName.length > nameWidth ? skill.displayName.slice(0, nameWidth - 1) + "…" : skill.displayName;
+		const ath = data?.ath ? riskLabel(data.ath.risk) : import_picocolors.default.dim("--");
+		const socket = data?.socket ? socketLabel(data.socket) : import_picocolors.default.dim("--");
+		const snyk = data?.snyk ? riskLabel(data.snyk.risk) : import_picocolors.default.dim("--");
+		lines.push(padEnd(import_picocolors.default.cyan(name), nameWidth + 2) + padEnd(ath, 18) + padEnd(socket, 18) + snyk);
+	}
+	lines.push("");
+	lines.push(`${import_picocolors.default.dim("Details:")} ${import_picocolors.default.dim(`your skills directory${source}`)}`);
+	return lines;
+}
+/**
+* Shortens a path for display: replaces homedir with ~ and cwd with .
+* Handles both Unix and Windows path separators.
+*/
+function shortenPath$2(fullPath, cwd) {
+	const home = homedir();
+	if (fullPath === home || fullPath.startsWith(home + sep)) return "~" + fullPath.slice(home.length);
+	if (fullPath === cwd || fullPath.startsWith(cwd + sep)) return "." + fullPath.slice(cwd.length);
+	return fullPath;
+}
+/**
+* Formats a list of items, truncating if too many
+*/
+function formatList$1(items, maxShow = 5) {
+	if (items.length <= maxShow) return items.join(", ");
+	const shown = items.slice(0, maxShow);
+	const remaining = items.length - maxShow;
+	return `${shown.join(", ")} +${remaining} more`;
+}
+/**
+* Splits agents into universal and non-universal (symlinked) groups.
+* Returns display names for each group.
+*/
+function splitAgentsByType(agentTypes) {
+	const universal = [];
+	const symlinked = [];
+	for (const a of agentTypes) if (isUniversalAgent(a)) universal.push(agents[a].displayName);
+	else symlinked.push(agents[a].displayName);
+	return {
+		universal,
+		symlinked
+	};
+}
+/**
+* Builds summary lines showing universal vs symlinked agents
+*/
+function buildAgentSummaryLines(targetAgents, installMode) {
+	const lines = [];
+	const { universal, symlinked } = splitAgentsByType(targetAgents);
+	if (installMode === "symlink") {
+		if (universal.length > 0) lines.push(`  ${import_picocolors.default.green("universal:")} ${formatList$1(universal)}`);
+		if (symlinked.length > 0) lines.push(`  ${import_picocolors.default.dim("symlink →")} ${formatList$1(symlinked)}`);
+	} else {
+		const allNames = targetAgents.map((a) => agents[a].displayName);
+		lines.push(`  ${import_picocolors.default.dim("copy →")} ${formatList$1(allNames)}`);
+	}
+	return lines;
+}
+/**
+* Ensures universal agents are always included in the target agents list.
+* Used when -y flag is passed or when auto-selecting agents.
+*/
+function ensureUniversalAgents(targetAgents) {
+	const universalAgents = getUniversalAgents();
+	const result = [...targetAgents];
+	for (const ua of universalAgents) if (!result.includes(ua)) result.push(ua);
+	return result;
+}
+/**
+* Builds result lines from installation results, splitting by universal vs symlinked
+*/
+function buildResultLines(results, targetAgents) {
+	const lines = [];
+	const { universal, symlinked: symlinkAgents } = splitAgentsByType(targetAgents);
+	const successfulSymlinks = results.filter((r) => !r.symlinkFailed && !universal.includes(r.agent)).map((r) => r.agent);
+	const failedSymlinks = results.filter((r) => r.symlinkFailed).map((r) => r.agent);
+	if (universal.length > 0) lines.push(`  ${import_picocolors.default.green("universal:")} ${formatList$1(universal)}`);
+	if (successfulSymlinks.length > 0) lines.push(`  ${import_picocolors.default.dim("symlinked:")} ${formatList$1(successfulSymlinks)}`);
+	if (failedSymlinks.length > 0) lines.push(`  ${import_picocolors.default.yellow("copied:")} ${formatList$1(failedSymlinks)}`);
+	return lines;
+}
+/**
+* Wrapper around p.multiselect that adds a hint for keyboard usage.
+* Accepts options with required labels (matching our usage pattern).
+*/
+function multiselect(opts) {
+	return fe({
+		...opts,
+		options: opts.options,
+		message: `${opts.message} ${import_picocolors.default.dim("(space to toggle)")}`
+	});
+}
+/**
+* Prompts the user to select agents using interactive search.
+* Pre-selects the last used agents if available.
+* Saves the selection for future use.
+*/
+async function promptForAgents(message, choices) {
+	let lastSelected;
+	try {
+		lastSelected = await getLastSelectedAgents();
+	} catch {}
+	const validAgents = choices.map((c) => c.value);
+	const defaultValues = [
+		"claude-code",
+		"opencode",
+		"codex"
+	].filter((a) => validAgents.includes(a));
+	let initialValues = [];
+	if (lastSelected && lastSelected.length > 0) initialValues = lastSelected.filter((a) => validAgents.includes(a));
+	if (initialValues.length === 0) initialValues = defaultValues;
+	const selected = await searchMultiselect({
+		message,
+		items: choices,
+		initialSelected: initialValues,
+		required: true
+	});
+	if (!isCancelled$1(selected)) try {
+		await saveSelectedAgents(selected);
+	} catch {}
+	return selected;
+}
+/**
+* Interactive agent selection using fuzzy search.
+* Shows universal agents as locked (always selected), and other agents as selectable.
+*/
+async function selectAgentsInteractive(options) {
+	const supportsGlobalFilter = (a) => !options.global || agents[a].globalSkillsDir;
+	const universalAgents = getUniversalAgents().filter(supportsGlobalFilter);
+	const otherAgents = getNonUniversalAgents().filter(supportsGlobalFilter);
+	const universalSection = {
+		title: "Universal (.agents/skills)",
+		items: universalAgents.map((a) => ({
+			value: a,
+			label: agents[a].displayName
+		}))
+	};
+	const otherChoices = otherAgents.map((a) => ({
+		value: a,
+		label: agents[a].displayName,
+		hint: options.global ? agents[a].globalSkillsDir : agents[a].skillsDir
+	}));
+	let lastSelected;
+	try {
+		lastSelected = await getLastSelectedAgents();
+	} catch {}
+	const selected = await searchMultiselect({
+		message: "Which agents do you want to install to?",
+		items: otherChoices,
+		initialSelected: lastSelected ? lastSelected.filter((a) => otherAgents.includes(a) && !universalAgents.includes(a)) : [],
+		lockedSection: universalSection
+	});
+	if (!isCancelled$1(selected)) try {
+		await saveSelectedAgents(selected);
+	} catch {}
+	return selected;
+}
+setVersion(version$1);
+/**
+* Handle skills from a well-known endpoint (RFC 8615).
+* Discovers skills from /.well-known/skills/index.json
+*/
+async function handleWellKnownSkills(source, url, options, spinner) {
+	spinner.start("Discovering skills from well-known endpoint...");
+	const skills = await wellKnownProvider.fetchAllSkills(url);
+	if (skills.length === 0) {
+		spinner.stop(import_picocolors.default.red("No skills found"));
+		Se(import_picocolors.default.red("No skills found at this URL. Make sure the server has a /.well-known/skills/index.json file."));
+		process.exit(1);
+	}
+	spinner.stop(`Found ${import_picocolors.default.green(skills.length)} skill${skills.length > 1 ? "s" : ""}`);
+	for (const skill of skills) {
+		M.info(`Skill: ${import_picocolors.default.cyan(skill.installName)}`);
+		M.message(import_picocolors.default.dim(skill.description));
+		if (skill.files.size > 1) M.message(import_picocolors.default.dim(`  Files: ${Array.from(skill.files.keys()).join(", ")}`));
+	}
+	if (options.list) {
+		console.log();
+		M.step(import_picocolors.default.bold("Available Skills"));
+		for (const skill of skills) {
+			M.message(`  ${import_picocolors.default.cyan(skill.installName)}`);
+			M.message(`    ${import_picocolors.default.dim(skill.description)}`);
+			if (skill.files.size > 1) M.message(`    ${import_picocolors.default.dim(`Files: ${skill.files.size}`)}`);
+		}
+		console.log();
+		Se("Run without --list to install");
+		process.exit(0);
+	}
+	let selectedSkills;
+	if (options.skill?.includes("*")) {
+		selectedSkills = skills;
+		M.info(`Installing all ${skills.length} skills`);
+	} else if (options.skill && options.skill.length > 0) {
+		selectedSkills = skills.filter((s) => options.skill.some((name) => s.installName.toLowerCase() === name.toLowerCase() || s.name.toLowerCase() === name.toLowerCase()));
+		if (selectedSkills.length === 0) {
+			M.error(`No matching skills found for: ${options.skill.join(", ")}`);
+			M.info("Available skills:");
+			for (const s of skills) M.message(`  - ${s.installName}`);
+			process.exit(1);
+		}
+	} else if (skills.length === 1) {
+		selectedSkills = skills;
+		const firstSkill = skills[0];
+		M.info(`Skill: ${import_picocolors.default.cyan(firstSkill.installName)}`);
+	} else if (options.yes) {
+		selectedSkills = skills;
+		M.info(`Installing all ${skills.length} skills`);
+	} else {
+		const selected = await multiselect({
+			message: "Select skills to install",
+			options: skills.map((s) => ({
+				value: s,
+				label: s.installName,
+				hint: s.description.length > 60 ? s.description.slice(0, 57) + "..." : s.description
+			})),
+			required: true
+		});
+		if (pD(selected)) {
+			xe("Installation cancelled");
+			process.exit(0);
+		}
+		selectedSkills = selected;
+	}
+	let targetAgents;
+	const validAgents = Object.keys(agents);
+	if (options.agent?.includes("*")) {
+		targetAgents = validAgents;
+		M.info(`Installing to all ${targetAgents.length} agents`);
+	} else if (options.agent && options.agent.length > 0) {
+		const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
+		if (invalidAgents.length > 0) {
+			M.error(`Invalid agents: ${invalidAgents.join(", ")}`);
+			M.info(`Valid agents: ${validAgents.join(", ")}`);
+			process.exit(1);
+		}
+		targetAgents = options.agent;
+	} else {
+		spinner.start("Loading agents...");
+		const installedAgents = await detectInstalledAgents();
+		const totalAgents = Object.keys(agents).length;
+		spinner.stop(`${totalAgents} agents`);
+		if (installedAgents.length === 0) if (options.yes) {
+			targetAgents = validAgents;
+			M.info("Installing to all agents");
+		} else {
+			M.info("Select agents to install skills to");
+			const selected = await promptForAgents("Which agents do you want to install to?", Object.entries(agents).map(([key, config]) => ({
+				value: key,
+				label: config.displayName
+			})));
+			if (pD(selected)) {
+				xe("Installation cancelled");
+				process.exit(0);
+			}
+			targetAgents = selected;
+		}
+		else if (installedAgents.length === 1 || options.yes) {
+			targetAgents = ensureUniversalAgents(installedAgents);
+			if (installedAgents.length === 1) {
+				const firstAgent = installedAgents[0];
+				M.info(`Installing to: ${import_picocolors.default.cyan(agents[firstAgent].displayName)}`);
+			} else M.info(`Installing to: ${installedAgents.map((a) => import_picocolors.default.cyan(agents[a].displayName)).join(", ")}`);
+		} else {
+			const selected = await selectAgentsInteractive({ global: options.global });
+			if (pD(selected)) {
+				xe("Installation cancelled");
+				process.exit(0);
+			}
+			targetAgents = selected;
+		}
+	}
+	let installGlobally = options.global ?? false;
+	const supportsGlobal = targetAgents.some((a) => agents[a].globalSkillsDir !== void 0);
+	if (options.global === void 0 && !options.yes && supportsGlobal) {
+		const scope = await ve({
+			message: "Installation scope",
+			options: [{
+				value: false,
+				label: "Project",
+				hint: "Install in current directory (committed with your project)"
+			}, {
+				value: true,
+				label: "Global",
+				hint: "Install in home directory (available across all projects)"
+			}]
+		});
+		if (pD(scope)) {
+			xe("Installation cancelled");
+			process.exit(0);
+		}
+		installGlobally = scope;
+	}
+	let installMode = options.copy ? "copy" : "symlink";
+	if (!options.copy && !options.yes) {
+		const modeChoice = await ve({
+			message: "Installation method",
+			options: [{
+				value: "symlink",
+				label: "Symlink (Recommended)",
+				hint: "Single source of truth, easy updates"
+			}, {
+				value: "copy",
+				label: "Copy to all agents",
+				hint: "Independent copies for each agent"
+			}]
+		});
+		if (pD(modeChoice)) {
+			xe("Installation cancelled");
+			process.exit(0);
+		}
+		installMode = modeChoice;
+	}
+	const cwd = process.cwd();
+	const summaryLines = [];
+	targetAgents.map((a) => agents[a].displayName);
+	const overwriteChecks = await Promise.all(selectedSkills.flatMap((skill) => targetAgents.map(async (agent) => ({
+		skillName: skill.installName,
+		agent,
+		installed: await isSkillInstalled(skill.installName, agent, { global: installGlobally })
+	}))));
+	const overwriteStatus = /* @__PURE__ */ new Map();
+	for (const { skillName, agent, installed } of overwriteChecks) {
+		if (!overwriteStatus.has(skillName)) overwriteStatus.set(skillName, /* @__PURE__ */ new Map());
+		overwriteStatus.get(skillName).set(agent, installed);
+	}
+	for (const skill of selectedSkills) {
+		if (summaryLines.length > 0) summaryLines.push("");
+		const shortCanonical = shortenPath$2(getCanonicalPath(skill.installName, { global: installGlobally }), cwd);
+		summaryLines.push(`${import_picocolors.default.cyan(shortCanonical)}`);
+		summaryLines.push(...buildAgentSummaryLines(targetAgents, installMode));
+		if (skill.files.size > 1) summaryLines.push(`  ${import_picocolors.default.dim("files:")} ${skill.files.size}`);
+		const skillOverwrites = overwriteStatus.get(skill.installName);
+		const overwriteAgents = targetAgents.filter((a) => skillOverwrites?.get(a)).map((a) => agents[a].displayName);
+		if (overwriteAgents.length > 0) summaryLines.push(`  ${import_picocolors.default.yellow("overwrites:")} ${formatList$1(overwriteAgents)}`);
+	}
+	console.log();
+	Me(summaryLines.join("\n"), "Installation Summary");
+	if (!options.yes) {
+		const confirmed = await ye({ message: "Proceed with installation?" });
+		if (pD(confirmed) || !confirmed) {
+			xe("Installation cancelled");
+			process.exit(0);
+		}
+	}
+	spinner.start("Installing skills...");
+	const results = [];
+	for (const skill of selectedSkills) for (const agent of targetAgents) {
+		const result = await installWellKnownSkillForAgent(skill, agent, {
+			global: installGlobally,
+			mode: installMode
+		});
+		results.push({
+			skill: skill.installName,
+			agent: agents[agent].displayName,
+			...result
+		});
+	}
+	spinner.stop("Installation complete");
+	console.log();
+	const successful = results.filter((r) => r.success);
+	const failed = results.filter((r) => !r.success);
+	const sourceIdentifier = wellKnownProvider.getSourceIdentifier(url);
+	const skillFiles = {};
+	for (const skill of selectedSkills) skillFiles[skill.installName] = skill.sourceUrl;
+	if (await isSourcePrivate(sourceIdentifier) !== true) track({
+		event: "install",
+		source: sourceIdentifier,
+		skills: selectedSkills.map((s) => s.installName).join(","),
+		agents: targetAgents.join(","),
+		...installGlobally && { global: "1" },
+		skillFiles: JSON.stringify(skillFiles),
+		sourceType: "well-known"
+	});
+	if (successful.length > 0 && installGlobally) {
+		const successfulSkillNames = new Set(successful.map((r) => r.skill));
+		for (const skill of selectedSkills) if (successfulSkillNames.has(skill.installName)) try {
+			await addSkillToLock(skill.installName, {
+				source: sourceIdentifier,
+				sourceType: "well-known",
+				sourceUrl: skill.sourceUrl,
+				skillFolderHash: ""
+			});
+		} catch {}
+	}
+	if (successful.length > 0 && !installGlobally) {
+		const successfulSkillNames = new Set(successful.map((r) => r.skill));
+		for (const skill of selectedSkills) if (successfulSkillNames.has(skill.installName)) try {
+			const matchingResult = successful.find((r) => r.skill === skill.installName);
+			const installDir = matchingResult?.canonicalPath || matchingResult?.path;
+			if (installDir) {
+				const computedHash = await computeSkillFolderHash(installDir);
+				await addSkillToLocalLock(skill.installName, {
+					source: sourceIdentifier,
+					sourceType: "well-known",
+					computedHash
+				}, cwd);
+			}
+		} catch {}
+	}
+	if (successful.length > 0) {
+		const bySkill = /* @__PURE__ */ new Map();
+		for (const r of successful) {
+			const skillResults = bySkill.get(r.skill) || [];
+			skillResults.push(r);
+			bySkill.set(r.skill, skillResults);
+		}
+		const skillCount = bySkill.size;
+		const symlinkFailures = successful.filter((r) => r.mode === "symlink" && r.symlinkFailed);
+		const copiedAgents = symlinkFailures.map((r) => r.agent);
+		const resultLines = [];
+		for (const [skillName, skillResults] of bySkill) {
+			const firstResult = skillResults[0];
+			if (firstResult.mode === "copy") {
+				resultLines.push(`${import_picocolors.default.green("✓")} ${skillName} ${import_picocolors.default.dim("(copied)")}`);
+				for (const r of skillResults) {
+					const shortPath = shortenPath$2(r.path, cwd);
+					resultLines.push(`  ${import_picocolors.default.dim("→")} ${shortPath}`);
+				}
+			} else {
+				if (firstResult.canonicalPath) {
+					const shortPath = shortenPath$2(firstResult.canonicalPath, cwd);
+					resultLines.push(`${import_picocolors.default.green("✓")} ${shortPath}`);
+				} else resultLines.push(`${import_picocolors.default.green("✓")} ${skillName}`);
+				resultLines.push(...buildResultLines(skillResults, targetAgents));
+			}
+		}
+		const title = import_picocolors.default.green(`Installed ${skillCount} skill${skillCount !== 1 ? "s" : ""}`);
+		Me(resultLines.join("\n"), title);
+		if (symlinkFailures.length > 0) {
+			M.warn(import_picocolors.default.yellow(`Symlinks failed for: ${formatList$1(copiedAgents)}`));
+			M.message(import_picocolors.default.dim("  Files were copied instead. On Windows, enable Developer Mode for symlink support."));
+		}
+	}
+	if (failed.length > 0) {
+		console.log();
+		M.error(import_picocolors.default.red(`Failed to install ${failed.length}`));
+		for (const r of failed) M.message(`  ${import_picocolors.default.red("✗")} ${r.skill} → ${r.agent}: ${import_picocolors.default.dim(r.error)}`);
+	}
+	console.log();
+	Se(import_picocolors.default.green("Done!") + import_picocolors.default.dim("  Review skills before use; they run with full agent permissions."));
+	await promptForFindSkills(options, targetAgents);
+}
+async function runAdd(args, options = {}) {
+	const source = args[0];
+	let installTipShown = false;
+	const showInstallTip = () => {
+		if (installTipShown) return;
+		M.message(import_picocolors.default.dim("Tip: use the --yes (-y) and --global (-g) flags to install without prompts."));
+		installTipShown = true;
+	};
+	if (!source) {
+		console.log();
+		console.log(import_picocolors.default.bgRed(import_picocolors.default.white(import_picocolors.default.bold(" ERROR "))) + " " + import_picocolors.default.red("Missing required argument: source"));
+		console.log();
+		console.log(import_picocolors.default.dim("  Usage:"));
+		console.log(`    ${import_picocolors.default.cyan("npx @voidagency/skills add")} ${import_picocolors.default.yellow("<source>")} ${import_picocolors.default.dim("[options]")}`);
+		console.log();
+		console.log(import_picocolors.default.dim("  Example:"));
+		console.log(`    ${import_picocolors.default.cyan("npx @voidagency/skills add")} ${import_picocolors.default.yellow("vercel-labs/agent-skills")}`);
+		console.log();
+		process.exit(1);
+	}
+	if (options.all) {
+		options.skill = ["*"];
+		options.agent = ["*"];
+		options.yes = true;
+	}
+	console.log();
+	Ie(import_picocolors.default.bgCyan(import_picocolors.default.black(" skills ")));
+	if (!process.stdin.isTTY) showInstallTip();
+	let tempDir = null;
+	try {
+		const spinner = Y();
+		spinner.start("Parsing source...");
+		const parsed = parseSource(source);
+		spinner.stop(`Source: ${parsed.type === "local" ? parsed.localPath : parsed.url}${parsed.ref ? ` @ ${import_picocolors.default.yellow(parsed.ref)}` : ""}${parsed.subpath ? ` (${parsed.subpath})` : ""}${parsed.skillFilter ? ` ${import_picocolors.default.dim("@")}${import_picocolors.default.cyan(parsed.skillFilter)}` : ""}`);
+		if (parsed.type === "well-known") {
+			await handleWellKnownSkills(source, parsed.url, options, spinner);
+			return;
+		}
+		let skillsDir;
+		if (parsed.type === "local") {
+			spinner.start("Validating local path...");
+			if (!existsSync(parsed.localPath)) {
+				spinner.stop(import_picocolors.default.red("Path not found"));
+				Se(import_picocolors.default.red(`Local path does not exist: ${parsed.localPath}`));
+				process.exit(1);
+			}
+			skillsDir = parsed.localPath;
+			spinner.stop("Local path validated");
+		} else {
+			spinner.start("Cloning repository...");
+			tempDir = await cloneRepo(parsed.url, parsed.ref);
+			skillsDir = tempDir;
+			spinner.stop("Repository cloned");
+		}
+		if (parsed.skillFilter) {
+			options.skill = options.skill || [];
+			if (!options.skill.includes(parsed.skillFilter)) options.skill.push(parsed.skillFilter);
+		}
+		const includeInternal = !!(options.skill && options.skill.length > 0);
+		spinner.start("Discovering skills...");
+		const skills = await discoverSkills(skillsDir, parsed.subpath, {
+			includeInternal,
+			fullDepth: options.fullDepth
+		});
+		if (skills.length === 0) {
+			spinner.stop(import_picocolors.default.red("No skills found"));
+			Se(import_picocolors.default.red("No valid skills found. Skills require a SKILL.md with name and description."));
+			await cleanup(tempDir);
+			process.exit(1);
+		}
+		spinner.stop(`Found ${import_picocolors.default.green(skills.length)} skill${skills.length > 1 ? "s" : ""}`);
+		if (options.list) {
+			console.log();
+			M.step(import_picocolors.default.bold("Available Skills"));
+			const groupedSkills = {};
+			const ungroupedSkills = [];
+			for (const skill of skills) if (skill.pluginName) {
+				const group = skill.pluginName;
+				if (!groupedSkills[group]) groupedSkills[group] = [];
+				groupedSkills[group].push(skill);
+			} else ungroupedSkills.push(skill);
+			const sortedGroups = Object.keys(groupedSkills).sort();
+			for (const group of sortedGroups) {
+				const title = group.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+				console.log(import_picocolors.default.bold(title));
+				for (const skill of groupedSkills[group]) {
+					M.message(`  ${import_picocolors.default.cyan(getSkillDisplayName(skill))}`);
+					M.message(`    ${import_picocolors.default.dim(skill.description)}`);
+				}
+				console.log();
+			}
+			if (ungroupedSkills.length > 0) {
+				if (sortedGroups.length > 0) console.log(import_picocolors.default.bold("General"));
+				for (const skill of ungroupedSkills) {
+					M.message(`  ${import_picocolors.default.cyan(getSkillDisplayName(skill))}`);
+					M.message(`    ${import_picocolors.default.dim(skill.description)}`);
+				}
+			}
+			console.log();
+			Se("Use --skill <name> to install specific skills");
+			await cleanup(tempDir);
+			process.exit(0);
+		}
+		let selectedSkills;
+		if (options.skill?.includes("*")) {
+			selectedSkills = skills;
+			M.info(`Installing all ${skills.length} skills`);
+		} else if (options.skill && options.skill.length > 0) {
+			selectedSkills = filterSkills(skills, options.skill);
+			if (selectedSkills.length === 0) {
+				M.error(`No matching skills found for: ${options.skill.join(", ")}`);
+				M.info("Available skills:");
+				for (const s of skills) M.message(`  - ${getSkillDisplayName(s)}`);
+				await cleanup(tempDir);
+				process.exit(1);
+			}
+			M.info(`Selected ${selectedSkills.length} skill${selectedSkills.length !== 1 ? "s" : ""}: ${selectedSkills.map((s) => import_picocolors.default.cyan(getSkillDisplayName(s))).join(", ")}`);
+		} else if (skills.length === 1) {
+			selectedSkills = skills;
+			const firstSkill = skills[0];
+			M.info(`Skill: ${import_picocolors.default.cyan(getSkillDisplayName(firstSkill))}`);
+			M.message(import_picocolors.default.dim(firstSkill.description));
+		} else if (options.yes) {
+			selectedSkills = skills;
+			M.info(`Installing all ${skills.length} skills`);
+		} else {
+			const sortedSkills = [...skills].sort((a, b) => {
+				if (a.pluginName && !b.pluginName) return -1;
+				if (!a.pluginName && b.pluginName) return 1;
+				if (a.pluginName && b.pluginName && a.pluginName !== b.pluginName) return a.pluginName.localeCompare(b.pluginName);
+				return getSkillDisplayName(a).localeCompare(getSkillDisplayName(b));
+			});
+			const hasGroups = sortedSkills.some((s) => s.pluginName);
+			let selected;
+			if (hasGroups) {
+				const kebabToTitle = (s) => s.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+				const grouped = {};
+				for (const s of sortedSkills) {
+					const groupName = s.pluginName ? kebabToTitle(s.pluginName) : "Other";
+					if (!grouped[groupName]) grouped[groupName] = [];
+					grouped[groupName].push({
+						value: s,
+						label: getSkillDisplayName(s),
+						hint: s.description.length > 60 ? s.description.slice(0, 57) + "..." : s.description
+					});
+				}
+				selected = await be({
+					message: `Select skills to install ${import_picocolors.default.dim("(space to toggle)")}`,
+					options: grouped,
+					required: true
+				});
+			} else selected = await multiselect({
+				message: "Select skills to install",
+				options: sortedSkills.map((s) => ({
+					value: s,
+					label: getSkillDisplayName(s),
+					hint: s.description.length > 60 ? s.description.slice(0, 57) + "..." : s.description
+				})),
+				required: true
+			});
+			if (pD(selected)) {
+				xe("Installation cancelled");
+				await cleanup(tempDir);
+				process.exit(0);
+			}
+			selectedSkills = selected;
+		}
+		const ownerRepoForAudit = getOwnerRepo(parsed);
+		const auditPromise = ownerRepoForAudit ? fetchAuditData(ownerRepoForAudit, selectedSkills.map((s) => getSkillDisplayName(s))) : Promise.resolve(null);
+		let targetAgents;
+		const validAgents = Object.keys(agents);
+		if (options.agent?.includes("*")) {
+			targetAgents = validAgents;
+			M.info(`Installing to all ${targetAgents.length} agents`);
+		} else if (options.agent && options.agent.length > 0) {
+			const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
+			if (invalidAgents.length > 0) {
+				M.error(`Invalid agents: ${invalidAgents.join(", ")}`);
+				M.info(`Valid agents: ${validAgents.join(", ")}`);
+				await cleanup(tempDir);
+				process.exit(1);
+			}
+			targetAgents = options.agent;
+		} else {
+			spinner.start("Loading agents...");
+			const installedAgents = await detectInstalledAgents();
+			const totalAgents = Object.keys(agents).length;
+			spinner.stop(`${totalAgents} agents`);
+			if (installedAgents.length === 0) if (options.yes) {
+				targetAgents = validAgents;
+				M.info("Installing to all agents");
+			} else {
+				M.info("Select agents to install skills to");
+				const selected = await promptForAgents("Which agents do you want to install to?", Object.entries(agents).map(([key, config]) => ({
+					value: key,
+					label: config.displayName
+				})));
+				if (pD(selected)) {
+					xe("Installation cancelled");
+					await cleanup(tempDir);
+					process.exit(0);
+				}
+				targetAgents = selected;
+			}
+			else if (installedAgents.length === 1 || options.yes) {
+				targetAgents = ensureUniversalAgents(installedAgents);
+				if (installedAgents.length === 1) {
+					const firstAgent = installedAgents[0];
+					M.info(`Installing to: ${import_picocolors.default.cyan(agents[firstAgent].displayName)}`);
+				} else M.info(`Installing to: ${installedAgents.map((a) => import_picocolors.default.cyan(agents[a].displayName)).join(", ")}`);
+			} else {
+				const selected = await selectAgentsInteractive({ global: options.global });
+				if (pD(selected)) {
+					xe("Installation cancelled");
+					await cleanup(tempDir);
+					process.exit(0);
+				}
+				targetAgents = selected;
+			}
+		}
+		let installGlobally = options.global ?? false;
+		const supportsGlobal = targetAgents.some((a) => agents[a].globalSkillsDir !== void 0);
+		if (options.global === void 0 && !options.yes && supportsGlobal) {
+			const scope = await ve({
+				message: "Installation scope",
+				options: [{
+					value: false,
+					label: "Project",
+					hint: "Install in current directory (committed with your project)"
+				}, {
+					value: true,
+					label: "Global",
+					hint: "Install in home directory (available across all projects)"
+				}]
+			});
+			if (pD(scope)) {
+				xe("Installation cancelled");
+				await cleanup(tempDir);
+				process.exit(0);
+			}
+			installGlobally = scope;
+		}
+		let installMode = options.copy ? "copy" : "symlink";
+		if (!options.copy && !options.yes) {
+			const modeChoice = await ve({
+				message: "Installation method",
+				options: [{
+					value: "symlink",
+					label: "Symlink (Recommended)",
+					hint: "Single source of truth, easy updates"
+				}, {
+					value: "copy",
+					label: "Copy to all agents",
+					hint: "Independent copies for each agent"
+				}]
+			});
+			if (pD(modeChoice)) {
+				xe("Installation cancelled");
+				await cleanup(tempDir);
+				process.exit(0);
+			}
+			installMode = modeChoice;
+		}
+		const cwd = process.cwd();
+		const summaryLines = [];
+		targetAgents.map((a) => agents[a].displayName);
+		const overwriteChecks = await Promise.all(selectedSkills.flatMap((skill) => targetAgents.map(async (agent) => ({
+			skillName: skill.name,
+			agent,
+			installed: await isSkillInstalled(skill.name, agent, { global: installGlobally })
+		}))));
+		const overwriteStatus = /* @__PURE__ */ new Map();
+		for (const { skillName, agent, installed } of overwriteChecks) {
+			if (!overwriteStatus.has(skillName)) overwriteStatus.set(skillName, /* @__PURE__ */ new Map());
+			overwriteStatus.get(skillName).set(agent, installed);
+		}
+		const groupedSummary = {};
+		const ungroupedSummary = [];
+		for (const skill of selectedSkills) if (skill.pluginName) {
+			const group = skill.pluginName;
+			if (!groupedSummary[group]) groupedSummary[group] = [];
+			groupedSummary[group].push(skill);
+		} else ungroupedSummary.push(skill);
+		const printSkillSummary = (skills) => {
+			for (const skill of skills) {
+				if (summaryLines.length > 0) summaryLines.push("");
+				const shortCanonical = shortenPath$2(getCanonicalPath(skill.name, { global: installGlobally }), cwd);
+				summaryLines.push(`${import_picocolors.default.cyan(shortCanonical)}`);
+				summaryLines.push(...buildAgentSummaryLines(targetAgents, installMode));
+				const skillOverwrites = overwriteStatus.get(skill.name);
+				const overwriteAgents = targetAgents.filter((a) => skillOverwrites?.get(a)).map((a) => agents[a].displayName);
+				if (overwriteAgents.length > 0) summaryLines.push(`  ${import_picocolors.default.yellow("overwrites:")} ${formatList$1(overwriteAgents)}`);
+			}
+		};
+		const sortedGroups = Object.keys(groupedSummary).sort();
+		for (const group of sortedGroups) {
+			const title = group.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+			summaryLines.push("");
+			summaryLines.push(import_picocolors.default.bold(title));
+			printSkillSummary(groupedSummary[group]);
+		}
+		if (ungroupedSummary.length > 0) {
+			if (sortedGroups.length > 0) {
+				summaryLines.push("");
+				summaryLines.push(import_picocolors.default.bold("General"));
+			}
+			printSkillSummary(ungroupedSummary);
+		}
+		console.log();
+		Me(summaryLines.join("\n"), "Installation Summary");
+		try {
+			const auditData = await auditPromise;
+			if (auditData && ownerRepoForAudit) {
+				const securityLines = buildSecurityLines(auditData, selectedSkills.map((s) => ({
+					slug: getSkillDisplayName(s),
+					displayName: getSkillDisplayName(s)
+				})), ownerRepoForAudit);
+				if (securityLines.length > 0) Me(securityLines.join("\n"), "Security Risk Assessments");
+			}
+		} catch {}
+		if (!options.yes) {
+			const confirmed = await ye({ message: "Proceed with installation?" });
+			if (pD(confirmed) || !confirmed) {
+				xe("Installation cancelled");
+				await cleanup(tempDir);
+				process.exit(0);
+			}
+		}
+		spinner.start("Installing skills...");
+		const results = [];
+		for (const skill of selectedSkills) for (const agent of targetAgents) {
+			const result = await installSkillForAgent(skill, agent, {
+				global: installGlobally,
+				mode: installMode
+			});
+			results.push({
+				skill: getSkillDisplayName(skill),
+				agent: agents[agent].displayName,
+				pluginName: skill.pluginName,
+				...result
+			});
+		}
+		spinner.stop("Installation complete");
+		console.log();
+		const successful = results.filter((r) => r.success);
+		const failed = results.filter((r) => !r.success);
+		const skillFiles = {};
+		for (const skill of selectedSkills) {
+			let relativePath;
+			if (tempDir && skill.path === tempDir) relativePath = "SKILL.md";
+			else if (tempDir && skill.path.startsWith(tempDir + sep)) relativePath = skill.path.slice(tempDir.length + 1).split(sep).join("/") + "/SKILL.md";
+			else continue;
+			skillFiles[skill.name] = relativePath;
+		}
+		const normalizedSource = getOwnerRepo(parsed);
+		if (normalizedSource) {
+			const ownerRepo = parseOwnerRepo(normalizedSource);
+			if (ownerRepo) {
+				if (await isRepoPrivate(ownerRepo.owner, ownerRepo.repo) === false) track({
+					event: "install",
+					source: normalizedSource,
+					skills: selectedSkills.map((s) => s.name).join(","),
+					agents: targetAgents.join(","),
+					...installGlobally && { global: "1" },
+					skillFiles: JSON.stringify(skillFiles)
+				});
+			} else 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 && installGlobally && normalizedSource) {
+			const successfulSkillNames = new Set(successful.map((r) => r.skill));
+			for (const skill of selectedSkills) {
+				const skillDisplayName = getSkillDisplayName(skill);
+				if (successfulSkillNames.has(skillDisplayName)) try {
+					let skillFolderHash = "";
+					const skillPathValue = skillFiles[skill.name];
+					if (parsed.type === "github" && skillPathValue) {
+						const hash = await fetchSkillFolderHash(normalizedSource, skillPathValue, getGitHubToken());
+						if (hash) skillFolderHash = hash;
+					}
+					await addSkillToLock(skill.name, {
+						source: normalizedSource,
+						sourceType: parsed.type,
+						sourceUrl: parsed.url,
+						skillPath: skillPathValue,
+						skillFolderHash,
+						pluginName: skill.pluginName
+					});
+				} catch {}
+			}
+		}
+		if (successful.length > 0 && !installGlobally) {
+			const successfulSkillNames = new Set(successful.map((r) => r.skill));
+			for (const skill of selectedSkills) {
+				const skillDisplayName = getSkillDisplayName(skill);
+				if (successfulSkillNames.has(skillDisplayName)) try {
+					const computedHash = await computeSkillFolderHash(skill.path);
+					await addSkillToLocalLock(skill.name, {
+						source: normalizedSource || parsed.url,
+						sourceType: parsed.type,
+						computedHash
+					}, cwd);
+				} catch {}
+			}
+		}
+		if (successful.length > 0) {
+			const bySkill = /* @__PURE__ */ new Map();
+			const groupedResults = {};
+			const ungroupedResults = [];
+			for (const r of successful) {
+				const skillResults = bySkill.get(r.skill) || [];
+				skillResults.push(r);
+				bySkill.set(r.skill, skillResults);
+				if (skillResults.length === 1) if (r.pluginName) {
+					const group = r.pluginName;
+					if (!groupedResults[group]) groupedResults[group] = [];
+					groupedResults[group].push(r);
+				} else ungroupedResults.push(r);
+			}
+			const skillCount = bySkill.size;
+			const symlinkFailures = successful.filter((r) => r.mode === "symlink" && r.symlinkFailed);
+			const copiedAgents = symlinkFailures.map((r) => r.agent);
+			const resultLines = [];
+			const printSkillResults = (entries) => {
+				for (const entry of entries) {
+					const skillResults = bySkill.get(entry.skill) || [];
+					const firstResult = skillResults[0];
+					if (firstResult.mode === "copy") {
+						resultLines.push(`${import_picocolors.default.green("✓")} ${entry.skill} ${import_picocolors.default.dim("(copied)")}`);
+						for (const r of skillResults) {
+							const shortPath = shortenPath$2(r.path, cwd);
+							resultLines.push(`  ${import_picocolors.default.dim("→")} ${shortPath}`);
+						}
+					} else {
+						if (firstResult.canonicalPath) {
+							const shortPath = shortenPath$2(firstResult.canonicalPath, cwd);
+							resultLines.push(`${import_picocolors.default.green("✓")} ${shortPath}`);
+						} else resultLines.push(`${import_picocolors.default.green("✓")} ${entry.skill}`);
+						resultLines.push(...buildResultLines(skillResults, targetAgents));
+					}
+				}
+			};
+			const sortedResultGroups = Object.keys(groupedResults).sort();
+			for (const group of sortedResultGroups) {
+				const title = group.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+				resultLines.push("");
+				resultLines.push(import_picocolors.default.bold(title));
+				printSkillResults(groupedResults[group]);
+			}
+			if (ungroupedResults.length > 0) {
+				if (sortedResultGroups.length > 0) {
+					resultLines.push("");
+					resultLines.push(import_picocolors.default.bold("General"));
+				}
+				printSkillResults(ungroupedResults);
+			}
+			const title = import_picocolors.default.green(`Installed ${skillCount} skill${skillCount !== 1 ? "s" : ""}`);
+			Me(resultLines.join("\n"), title);
+			if (symlinkFailures.length > 0) {
+				M.warn(import_picocolors.default.yellow(`Symlinks failed for: ${formatList$1(copiedAgents)}`));
+				M.message(import_picocolors.default.dim("  Files were copied instead. On Windows, enable Developer Mode for symlink support."));
+			}
+		}
+		if (failed.length > 0) {
+			console.log();
+			M.error(import_picocolors.default.red(`Failed to install ${failed.length}`));
+			for (const r of failed) M.message(`  ${import_picocolors.default.red("✗")} ${r.skill} → ${r.agent}: ${import_picocolors.default.dim(r.error)}`);
+		}
+		console.log();
+		Se(import_picocolors.default.green("Done!") + import_picocolors.default.dim("  Review skills before use; they run with full agent permissions."));
+		await promptForFindSkills(options, targetAgents);
+	} catch (error) {
+		if (error instanceof GitCloneError) {
+			M.error(import_picocolors.default.red("Failed to clone repository"));
+			for (const line of error.message.split("\n")) M.message(import_picocolors.default.dim(line));
+		} else M.error(error instanceof Error ? error.message : "Unknown error occurred");
+		showInstallTip();
+		Se(import_picocolors.default.red("Installation failed"));
+		process.exit(1);
+	} finally {
+		await cleanup(tempDir);
+	}
+}
+async function cleanup(tempDir) {
+	if (tempDir) try {
+		await cleanupTempDir(tempDir);
+	} catch {}
+}
+/**
+* Prompt user to install the find-skills skill after their first installation.
+*/
+async function promptForFindSkills(options, targetAgents) {
+	if (!process.stdin.isTTY) return;
+	if (options?.yes) return;
+	try {
+		if (await isPromptDismissed("findSkillsPrompt")) return;
+		if (await isSkillInstalled("find-skills", "claude-code", { global: true })) {
+			await dismissPrompt("findSkillsPrompt");
+			return;
+		}
+		console.log();
+		M.message(import_picocolors.default.dim("One-time prompt - you won't be asked again if you dismiss."));
+		const install = await ye({ message: `Install the ${import_picocolors.default.cyan("find-skills")} skill? It helps your agent discover and suggest skills.` });
+		if (pD(install)) {
+			await dismissPrompt("findSkillsPrompt");
+			return;
+		}
+		if (install) {
+			await dismissPrompt("findSkillsPrompt");
+			const findSkillsAgents = targetAgents?.filter((a) => a !== "replit");
+			if (!findSkillsAgents || findSkillsAgents.length === 0) return;
+			console.log();
+			M.step("Installing find-skills skill...");
+			try {
+				await runAdd(["vercel-labs/skills"], {
+					skill: ["find-skills"],
+					global: true,
+					yes: true,
+					agent: findSkillsAgents
+				});
+			} catch {
+				M.warn("Failed to install find-skills. You can try again with:");
+				M.message(import_picocolors.default.dim("  npx @voidagency/skills add vercel-labs/skills@find-skills -g -y --all"));
+			}
+		} else {
+			await dismissPrompt("findSkillsPrompt");
+			M.message(import_picocolors.default.dim("You can install it later with: npx @voidagency/skills add vercel-labs/skills@find-skills"));
+		}
+	} catch {}
+}
+function parseAddOptions(args) {
+	const options = {};
+	const source = [];
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "-g" || arg === "--global") options.global = true;
+		else if (arg === "-y" || arg === "--yes") options.yes = true;
+		else if (arg === "-l" || arg === "--list") options.list = true;
+		else if (arg === "--all") options.all = true;
+		else if (arg === "-a" || arg === "--agent") {
+			options.agent = options.agent || [];
+			i++;
+			let nextArg = args[i];
+			while (i < args.length && nextArg && !nextArg.startsWith("-")) {
+				options.agent.push(nextArg);
+				i++;
+				nextArg = args[i];
+			}
+			i--;
+		} else if (arg === "-s" || arg === "--skill") {
+			options.skill = options.skill || [];
+			i++;
+			let nextArg = args[i];
+			while (i < args.length && nextArg && !nextArg.startsWith("-")) {
+				options.skill.push(nextArg);
+				i++;
+				nextArg = args[i];
+			}
+			i--;
+		} else if (arg === "--full-depth") options.fullDepth = true;
+		else if (arg === "--copy") options.copy = true;
+		else if (arg && !arg.startsWith("-")) source.push(arg);
+	}
+	return {
+		source,
+		options
+	};
+}
+//#endregion
+//#region src/agent-install.ts
+/**
+* Install an agent definition (AGENTS.md + manifest) and its dependent skills.
+* Agent repos should contain agent.json: { "skills": ["owner/repo", "owner/repo@skill", ...] }
+*/
+const AGENT_DEFINITIONS_DIR = "agent-definitions";
+function getAgentDefinitionsBase() {
+	return join(homedir(), AGENTS_DIR$2, AGENT_DEFINITIONS_DIR);
+}
+/**
+* Sanitize a source string into a safe directory name (e.g. "owner/repo" -> "owner-repo").
+*/
+function slugFromSource(source) {
+	return source.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "") || "agent";
+}
+/**
+* Parse "source" or "source@agent-name" for add-agent.
+* Returns { source, agentName } where agentName is undefined when repo root is the agent.
+*/
+function parseAgentSource(input) {
+	const at = input.lastIndexOf("@");
+	if (at < 0) return { source: input.trim() };
+	const source = input.slice(0, at).trim();
+	const agentName = input.slice(at + 1).trim();
+	if (!agentName) return { source };
+	return {
+		source,
+		agentName
+	};
+}
+/**
+* Load agent.json from a directory. Looks for agent.json in the given dir.
+*/
+async function loadAgentManifest(dir) {
+	const path = join(dir, "agent.json");
+	try {
+		const raw = await readFile(path, "utf-8");
+		const data = JSON.parse(raw);
+		if (!data || typeof data !== "object") return null;
+		return data;
+	} catch {
+		return null;
+	}
+}
+/**
+* Install an agent definition from a source (GitHub/Bitbucket URL or owner/repo).
+* Optional agent name: use source@agent-name to install from agents/<agent-name>/ in the repo.
+* Clones the repo, reads agent.json (from root or agents/<agent-name>/), installs each listed skill, then copies AGENTS.md and agent.json to ~/.agents/agent-definitions/<slug>.
+*/
+async function runAddAgent(agentSource, options = {}) {
+	const { source, agentName } = parseAgentSource(agentSource);
+	const parsed = parseSource(source);
+	let repoDir;
+	if (parsed.type === "local") {
+		repoDir = resolve(process.cwd(), parsed.localPath);
+		if (!existsSync(repoDir)) {
+			M.error(`Local path does not exist: ${repoDir}`);
+			process.exit(1);
+		}
+	}
+	let tempDir = null;
+	try {
+		Ie(import_picocolors.default.bgCyan(import_picocolors.default.black(" add-agent ")));
+		const spinner = Y();
+		if (parsed.type === "local") {
+			spinner.start("Using local path...");
+			spinner.stop("Using local path.");
+		} else {
+			spinner.start("Cloning agent repository...");
+			tempDir = await cloneRepo(parsed.url, parsed.ref);
+			spinner.stop("Repository cloned.");
+			repoDir = tempDir;
+		}
+		const agentDirInRepo = agentName ? join(repoDir, "agents", agentName) : repoDir;
+		const manifest = await loadAgentManifest(agentDirInRepo);
+		if (!manifest || typeof manifest !== "object") {
+			if (agentName) M.error(`No agent found at agents/${agentName}/. Expected agents/${agentName}/AGENTS.md and agents/${agentName}/agent.json.`);
+			else M.error("No agent.json found in the repository.");
+			process.exit(1);
+		}
+		const baseSlug = parsed.type === "local" ? slugFromSource(repoDir) : getOwnerRepo(parsed) || slugFromSource(source);
+		const slug = agentName ? `${baseSlug}-${slugFromSource(agentName)}` : baseSlug;
+		const skillsList = Array.isArray(manifest.skills) ? manifest.skills : [];
+		if (skillsList.length > 0) M.info(`Installing ${skillsList.length} skill(s) from agent manifest...`);
+		for (const skillSource of skillsList) {
+			const trimmed = String(skillSource).trim();
+			if (!trimmed) continue;
+			spinner.start(`Installing skill: ${trimmed}`);
+			try {
+				await runAdd([trimmed], options);
+				spinner.stop(`Installed: ${trimmed}`);
+			} catch (err) {
+				spinner.stop(`Failed: ${trimmed}`);
+				M.warn(`Could not install skill ${trimmed}: ${err instanceof Error ? err.message : err}`);
+			}
+		}
+		const destDir = join(getAgentDefinitionsBase(), slug);
+		await mkdir(destDir, { recursive: true });
+		const entries = await readdir(agentDirInRepo, { withFileTypes: true });
+		for (const ent of entries) await cp(join(agentDirInRepo, ent.name), join(destDir, ent.name), { recursive: ent.isDirectory() });
+		M.success(`Agent definition saved to ${destDir}`);
+	} finally {
+		if (tempDir) await cleanupTempDir(tempDir).catch(() => {});
+	}
+}
+/**
+* Parse add-agent options from argv. Reuses add options (global, agent, yes).
+*/
+function parseAddAgentOptions(args) {
+	const options = {};
+	let source = "";
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "-g" || arg === "--global") options.global = true;
+		else if (arg === "-y" || arg === "--yes") options.yes = true;
+		else if (arg === "-a" || arg === "--agent") {
+			options.agent = options.agent || [];
+			i++;
+			let nextArg = args[i];
+			while (i < args.length && nextArg && !nextArg.startsWith("-")) {
+				options.agent.push(nextArg);
+				i++;
+				nextArg = args[i];
+			}
+			i--;
+		} else if (arg && !arg.startsWith("-")) source = arg;
+	}
+	return {
+		source,
+		options
+	};
+}
+//#endregion
+//#region src/find.ts
+const RESET$2 = "\x1B[0m";
+const BOLD$2 = "\x1B[1m";
+const DIM$2 = "\x1B[38;5;102m";
+const TEXT$1 = "\x1B[38;5;145m";
+const CYAN$1 = "\x1B[36m";
+const SEARCH_API_BASE = process.env.SKILLS_API_URL || "";
+function formatInstalls(count) {
+	if (!count || count <= 0) return "";
+	if (count >= 1e6) return `${(count / 1e6).toFixed(1).replace(/\.0$/, "")}M installs`;
+	if (count >= 1e3) return `${(count / 1e3).toFixed(1).replace(/\.0$/, "")}K installs`;
+	return `${count} install${count === 1 ? "" : "s"}`;
+}
+async function searchSkillsAPI(query) {
+	if (!SEARCH_API_BASE) return [];
+	try {
+		const url = `${SEARCH_API_BASE}/api/search?q=${encodeURIComponent(query)}&limit=10`;
+		const res = await fetch(url);
+		if (!res.ok) return [];
+		return (await res.json()).skills.map((skill) => ({
+			name: skill.name,
+			slug: skill.id,
+			source: skill.source || "",
+			installs: skill.installs
+		}));
+	} catch {
+		return [];
+	}
+}
+const HIDE_CURSOR = "\x1B[?25l";
+const SHOW_CURSOR = "\x1B[?25h";
+const CLEAR_DOWN = "\x1B[J";
+const MOVE_UP = (n) => `\x1b[${n}A`;
+const MOVE_TO_COL = (n) => `\x1b[${n}G`;
+async function runSearchPrompt(initialQuery = "") {
+	let results = [];
+	let selectedIndex = 0;
+	let query = initialQuery;
+	let loading = false;
+	let debounceTimer = null;
+	let lastRenderedLines = 0;
+	if (process.stdin.isTTY) process.stdin.setRawMode(true);
+	readline.emitKeypressEvents(process.stdin);
+	process.stdin.resume();
+	process.stdout.write(HIDE_CURSOR);
+	function render() {
+		if (lastRenderedLines > 0) process.stdout.write(MOVE_UP(lastRenderedLines) + MOVE_TO_COL(1));
+		process.stdout.write(CLEAR_DOWN);
+		const lines = [];
+		const cursor = `${BOLD$2}_${RESET$2}`;
+		lines.push(`${TEXT$1}Search skills:${RESET$2} ${query}${cursor}`);
+		lines.push("");
+		if (!query || query.length < 2) lines.push(`${DIM$2}Start typing to search (min 2 chars)${RESET$2}`);
+		else if (results.length === 0 && loading) lines.push(`${DIM$2}Searching...${RESET$2}`);
+		else if (results.length === 0) lines.push(`${DIM$2}No skills found${RESET$2}`);
+		else {
+			const visible = results.slice(0, 8);
+			for (let i = 0; i < visible.length; i++) {
+				const skill = visible[i];
+				const isSelected = i === selectedIndex;
+				const arrow = isSelected ? `${BOLD$2}>${RESET$2}` : " ";
+				const name = isSelected ? `${BOLD$2}${skill.name}${RESET$2}` : `${TEXT$1}${skill.name}${RESET$2}`;
+				const source = skill.source ? ` ${DIM$2}${skill.source}${RESET$2}` : "";
+				const installs = formatInstalls(skill.installs);
+				const installsBadge = installs ? ` ${CYAN$1}${installs}${RESET$2}` : "";
+				const loadingIndicator = loading && i === 0 ? ` ${DIM$2}...${RESET$2}` : "";
+				lines.push(`  ${arrow} ${name}${source}${installsBadge}${loadingIndicator}`);
+			}
+		}
+		lines.push("");
+		lines.push(`${DIM$2}up/down navigate | enter select | esc cancel${RESET$2}`);
+		for (const line of lines) process.stdout.write(line + "\n");
+		lastRenderedLines = lines.length;
+	}
+	function triggerSearch(q) {
+		if (debounceTimer) {
+			clearTimeout(debounceTimer);
+			debounceTimer = null;
+		}
+		loading = false;
+		if (!q || q.length < 2) {
+			results = [];
+			selectedIndex = 0;
+			render();
+			return;
+		}
+		loading = true;
+		render();
+		const debounceMs = Math.max(150, 350 - q.length * 50);
+		debounceTimer = setTimeout(async () => {
+			try {
+				results = await searchSkillsAPI(q);
+				selectedIndex = 0;
+			} catch {
+				results = [];
+			} finally {
+				loading = false;
+				debounceTimer = null;
+				render();
+			}
+		}, debounceMs);
+	}
+	if (initialQuery) triggerSearch(initialQuery);
+	render();
+	return new Promise((resolve) => {
+		function cleanup() {
+			process.stdin.removeListener("keypress", handleKeypress);
+			if (process.stdin.isTTY) process.stdin.setRawMode(false);
+			process.stdout.write(SHOW_CURSOR);
+			process.stdin.pause();
+		}
+		function handleKeypress(_ch, key) {
+			if (!key) return;
+			if (key.name === "escape" || key.ctrl && key.name === "c") {
+				cleanup();
+				resolve(null);
+				return;
+			}
+			if (key.name === "return") {
+				cleanup();
+				resolve(results[selectedIndex] || null);
+				return;
+			}
+			if (key.name === "up") {
+				selectedIndex = Math.max(0, selectedIndex - 1);
+				render();
+				return;
+			}
+			if (key.name === "down") {
+				selectedIndex = Math.min(Math.max(0, results.length - 1), selectedIndex + 1);
+				render();
+				return;
+			}
+			if (key.name === "backspace") {
+				if (query.length > 0) {
+					query = query.slice(0, -1);
+					triggerSearch(query);
+				}
+				return;
+			}
+			if (key.sequence && !key.ctrl && !key.meta && key.sequence.length === 1) {
+				const char = key.sequence;
+				if (char >= " " && char <= "~") {
+					query += char;
+					triggerSearch(query);
+				}
+			}
+		}
+		process.stdin.on("keypress", handleKeypress);
+	});
+}
+function getOwnerRepoFromString(pkg) {
+	const atIndex = pkg.lastIndexOf("@");
+	const match = (atIndex > 0 ? pkg.slice(0, atIndex) : pkg).match(/^([^/]+)\/([^/]+)$/);
+	if (match) return {
+		owner: match[1],
+		repo: match[2]
+	};
+	return null;
+}
+async function isRepoPublic(owner, repo) {
+	return await isRepoPrivate(owner, repo) === false;
+}
+async function runFind(args) {
+	const query = args.join(" ");
+	const isNonInteractive = !process.stdin.isTTY;
+	const agentTip = `${DIM$2}Tip: if running in a coding agent, follow these steps:${RESET$2}
+${DIM$2}  1) npx @voidagency/skills find [query]${RESET$2}
+${DIM$2}  2) npx @voidagency/skills add <owner/repo@skill>${RESET$2}`;
+	if (query) {
+		const results = await searchSkillsAPI(query);
+		track({
+			event: "find",
+			query,
+			resultCount: String(results.length)
+		});
+		if (results.length === 0) {
+			console.log(`${DIM$2}No skills found for "${query}"${RESET$2}`);
+			return;
+		}
+		console.log(`${DIM$2}Install with${RESET$2} npx @voidagency/skills add <owner/repo@skill>`);
+		console.log();
+		for (const skill of results.slice(0, 6)) {
+			const pkg = skill.source || skill.slug;
+			const installs = formatInstalls(skill.installs);
+			console.log(`${TEXT$1}${pkg}@${skill.name}${RESET$2}${installs ? ` ${CYAN$1}${installs}${RESET$2}` : ""}`);
+			console.log(`${DIM$2}└ your skills directory/${skill.slug}${RESET$2}`);
+			console.log();
+		}
+		return;
+	}
+	if (isNonInteractive) {
+		console.log(agentTip);
+		console.log();
+	}
+	const selected = await runSearchPrompt();
+	track({
+		event: "find",
+		query: "",
+		resultCount: selected ? "1" : "0",
+		interactive: "1"
+	});
+	if (!selected) {
+		console.log(`${DIM$2}Search cancelled${RESET$2}`);
+		console.log();
+		return;
+	}
+	const pkg = selected.source || selected.slug;
+	const skillName = selected.name;
+	console.log();
+	console.log(`${TEXT$1}Installing ${BOLD$2}${skillName}${RESET$2} from ${DIM$2}${pkg}${RESET$2}...`);
+	console.log();
+	const { source, options } = parseAddOptions([
+		pkg,
+		"--skill",
+		skillName
+	]);
+	await runAdd(source, options);
+	console.log();
+	const info = getOwnerRepoFromString(pkg);
+	if (info && await isRepoPublic(info.owner, info.repo)) console.log(`${DIM$2}View the skill at${RESET$2} ${TEXT$1}your skills directory/${selected.slug}${RESET$2}`);
+	else console.log(`${DIM$2}Discover more skills at${RESET$2} ${TEXT$1}your skills directory${RESET$2}`);
+	console.log();
+}
+//#endregion
+//#region src/sync.ts
+const isCancelled = (value) => typeof value === "symbol";
+/**
+* Shortens a path for display: replaces homedir with ~ and cwd with .
+*/
+function shortenPath$1(fullPath, cwd) {
+	const home = homedir();
+	if (fullPath === home || fullPath.startsWith(home + sep)) return "~" + fullPath.slice(home.length);
+	if (fullPath === cwd || fullPath.startsWith(cwd + sep)) return "." + fullPath.slice(cwd.length);
+	return fullPath;
+}
+/**
+* Crawl node_modules for SKILL.md files.
+* Searches both top-level packages and scoped packages (@org/pkg).
+* Returns discovered skills with their source package name.
+*/
+async function discoverNodeModuleSkills(cwd) {
+	const nodeModulesDir = join(cwd, "node_modules");
+	const skills = [];
+	let topNames;
+	try {
+		topNames = await readdir(nodeModulesDir);
+	} catch {
+		return skills;
+	}
+	const processPackageDir = async (pkgDir, packageName) => {
+		const rootSkill = await parseSkillMd(join(pkgDir, "SKILL.md"));
+		if (rootSkill) {
+			skills.push({
+				...rootSkill,
+				packageName
+			});
+			return;
+		}
+		const searchDirs = [
+			pkgDir,
+			join(pkgDir, "skills"),
+			join(pkgDir, ".agents", "skills")
+		];
+		for (const searchDir of searchDirs) try {
+			const entries = await readdir(searchDir);
+			for (const name of entries) {
+				const skillDir = join(searchDir, name);
+				try {
+					if (!(await stat(skillDir)).isDirectory()) continue;
+				} catch {
+					continue;
+				}
+				const skill = await parseSkillMd(join(skillDir, "SKILL.md"));
+				if (skill) skills.push({
+					...skill,
+					packageName
+				});
+			}
+		} catch {}
+	};
+	await Promise.all(topNames.map(async (name) => {
+		if (name.startsWith(".")) return;
+		const fullPath = join(nodeModulesDir, name);
+		try {
+			if (!(await stat(fullPath)).isDirectory()) return;
+		} catch {
+			return;
+		}
+		if (name.startsWith("@")) try {
+			const scopeNames = await readdir(fullPath);
+			await Promise.all(scopeNames.map(async (scopedName) => {
+				const scopedPath = join(fullPath, scopedName);
+				try {
+					if (!(await stat(scopedPath)).isDirectory()) return;
+				} catch {
+					return;
+				}
+				await processPackageDir(scopedPath, `${name}/${scopedName}`);
+			}));
+		} catch {}
+		else await processPackageDir(fullPath, name);
+	}));
+	return skills;
+}
+async function runSync(args, options = {}) {
+	const cwd = process.cwd();
+	console.log();
+	Ie(import_picocolors.default.bgCyan(import_picocolors.default.black(" skills experimental_sync ")));
+	const spinner = Y();
+	spinner.start("Scanning node_modules for skills...");
+	const discoveredSkills = await discoverNodeModuleSkills(cwd);
+	if (discoveredSkills.length === 0) {
+		spinner.stop(import_picocolors.default.yellow("No skills found"));
+		Se(import_picocolors.default.dim("No SKILL.md files found in node_modules."));
+		return;
+	}
+	spinner.stop(`Found ${import_picocolors.default.green(String(discoveredSkills.length))} skill${discoveredSkills.length > 1 ? "s" : ""} in node_modules`);
+	for (const skill of discoveredSkills) {
+		M.info(`${import_picocolors.default.cyan(skill.name)} ${import_picocolors.default.dim(`from ${skill.packageName}`)}`);
+		if (skill.description) M.message(import_picocolors.default.dim(`  ${skill.description}`));
+	}
+	const localLock = await readLocalLock(cwd);
+	const toInstall = [];
+	const upToDate = [];
+	if (options.force) {
+		toInstall.push(...discoveredSkills);
+		M.info(import_picocolors.default.dim("Force mode: reinstalling all skills"));
+	} else {
+		for (const skill of discoveredSkills) {
+			const existingEntry = localLock.skills[skill.name];
+			if (existingEntry) {
+				if (await computeSkillFolderHash(skill.path) === existingEntry.computedHash) {
+					upToDate.push(skill.name);
+					continue;
+				}
+			}
+			toInstall.push(skill);
+		}
+		if (upToDate.length > 0) M.info(import_picocolors.default.dim(`${upToDate.length} skill${upToDate.length !== 1 ? "s" : ""} already up to date`));
+		if (toInstall.length === 0) {
+			console.log();
+			Se(import_picocolors.default.green("All skills are up to date."));
+			return;
+		}
+	}
+	M.info(`${toInstall.length} skill${toInstall.length !== 1 ? "s" : ""} to install/update`);
+	let targetAgents;
+	const validAgents = Object.keys(agents);
+	const universalAgents = getUniversalAgents();
+	if (options.agent?.includes("*")) {
+		targetAgents = validAgents;
+		M.info(`Installing to all ${targetAgents.length} agents`);
+	} else if (options.agent && options.agent.length > 0) {
+		const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
+		if (invalidAgents.length > 0) {
+			M.error(`Invalid agents: ${invalidAgents.join(", ")}`);
+			M.info(`Valid agents: ${validAgents.join(", ")}`);
+			process.exit(1);
+		}
+		targetAgents = options.agent;
+	} else {
+		spinner.start("Loading agents...");
+		const installedAgents = await detectInstalledAgents();
+		const totalAgents = Object.keys(agents).length;
+		spinner.stop(`${totalAgents} agents`);
+		if (installedAgents.length === 0) if (options.yes) {
+			targetAgents = universalAgents;
+			M.info("Installing to universal agents");
+		} else {
+			const selected = await searchMultiselect({
+				message: "Which agents do you want to install to?",
+				items: getNonUniversalAgents().map((a) => ({
+					value: a,
+					label: agents[a].displayName,
+					hint: agents[a].skillsDir
+				})),
+				initialSelected: [],
+				lockedSection: {
+					title: "Universal (.agents/skills)",
+					items: universalAgents.map((a) => ({
+						value: a,
+						label: agents[a].displayName
+					}))
+				}
+			});
+			if (isCancelled(selected)) {
+				xe("Sync cancelled");
+				process.exit(0);
+			}
+			targetAgents = selected;
+		}
+		else if (installedAgents.length === 1 || options.yes) {
+			targetAgents = [...installedAgents];
+			for (const ua of universalAgents) if (!targetAgents.includes(ua)) targetAgents.push(ua);
+		} else {
+			const selected = await searchMultiselect({
+				message: "Which agents do you want to install to?",
+				items: getNonUniversalAgents().filter((a) => installedAgents.includes(a)).map((a) => ({
+					value: a,
+					label: agents[a].displayName,
+					hint: agents[a].skillsDir
+				})),
+				initialSelected: installedAgents.filter((a) => !universalAgents.includes(a)),
+				lockedSection: {
+					title: "Universal (.agents/skills)",
+					items: universalAgents.map((a) => ({
+						value: a,
+						label: agents[a].displayName
+					}))
+				}
+			});
+			if (isCancelled(selected)) {
+				xe("Sync cancelled");
+				process.exit(0);
+			}
+			targetAgents = selected;
+		}
+	}
+	const summaryLines = [];
+	for (const skill of toInstall) {
+		const shortCanonical = shortenPath$1(getCanonicalPath(skill.name, { global: false }), cwd);
+		summaryLines.push(`${import_picocolors.default.cyan(skill.name)} ${import_picocolors.default.dim(`← ${skill.packageName}`)}`);
+		summaryLines.push(`  ${import_picocolors.default.dim(shortCanonical)}`);
+	}
+	console.log();
+	Me(summaryLines.join("\n"), "Sync Summary");
+	if (!options.yes) {
+		const confirmed = await ye({ message: "Proceed with sync?" });
+		if (pD(confirmed) || !confirmed) {
+			xe("Sync cancelled");
+			process.exit(0);
+		}
+	}
+	spinner.start("Syncing skills...");
+	const results = [];
+	for (const skill of toInstall) for (const agent of targetAgents) {
+		const result = await installSkillForAgent(skill, agent, {
+			global: false,
+			cwd,
+			mode: "symlink"
+		});
+		results.push({
+			skill: skill.name,
+			packageName: skill.packageName,
+			agent: agents[agent].displayName,
+			success: result.success,
+			path: result.path,
+			canonicalPath: result.canonicalPath,
+			error: result.error
+		});
+	}
+	spinner.stop("Sync complete");
+	const successful = results.filter((r) => r.success);
+	const failed = results.filter((r) => !r.success);
+	const successfulSkillNames = new Set(successful.map((r) => r.skill));
+	for (const skill of toInstall) if (successfulSkillNames.has(skill.name)) try {
+		const computedHash = await computeSkillFolderHash(skill.path);
+		await addSkillToLocalLock(skill.name, {
+			source: skill.packageName,
+			sourceType: "node_modules",
+			computedHash
+		}, cwd);
+	} catch {}
+	console.log();
+	if (successful.length > 0) {
+		const bySkill = /* @__PURE__ */ new Map();
+		for (const r of successful) {
+			const skillResults = bySkill.get(r.skill) || [];
+			skillResults.push(r);
+			bySkill.set(r.skill, skillResults);
+		}
+		const resultLines = [];
+		for (const [skillName, skillResults] of bySkill) {
+			const firstResult = skillResults[0];
+			const pkg = toInstall.find((s) => s.name === skillName)?.packageName;
+			if (firstResult.canonicalPath) {
+				const shortPath = shortenPath$1(firstResult.canonicalPath, cwd);
+				resultLines.push(`${import_picocolors.default.green("✓")} ${skillName} ${import_picocolors.default.dim(`← ${pkg}`)}`);
+				resultLines.push(`  ${import_picocolors.default.dim(shortPath)}`);
+			} else resultLines.push(`${import_picocolors.default.green("✓")} ${skillName} ${import_picocolors.default.dim(`← ${pkg}`)}`);
+		}
+		const skillCount = bySkill.size;
+		const title = import_picocolors.default.green(`Synced ${skillCount} skill${skillCount !== 1 ? "s" : ""}`);
+		Me(resultLines.join("\n"), title);
+	}
+	if (failed.length > 0) {
+		console.log();
+		M.error(import_picocolors.default.red(`Failed to install ${failed.length}`));
+		for (const r of failed) M.message(`  ${import_picocolors.default.red("✗")} ${r.skill} → ${r.agent}: ${import_picocolors.default.dim(r.error)}`);
+	}
+	track({
+		event: "experimental_sync",
+		skillCount: String(toInstall.length),
+		successCount: String(successfulSkillNames.size),
+		agents: targetAgents.join(",")
+	});
+	console.log();
+	Se(import_picocolors.default.green("Done!") + import_picocolors.default.dim("  Review skills before use; they run with full agent permissions."));
+}
+function parseSyncOptions(args) {
+	const options = {};
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "-y" || arg === "--yes") options.yes = true;
+		else if (arg === "-f" || arg === "--force") options.force = true;
+		else if (arg === "-a" || arg === "--agent") {
+			options.agent = options.agent || [];
+			i++;
+			let nextArg = args[i];
+			while (i < args.length && nextArg && !nextArg.startsWith("-")) {
+				options.agent.push(nextArg);
+				i++;
+				nextArg = args[i];
+			}
+			i--;
+		}
+	}
+	return { options };
+}
+//#endregion
+//#region src/install.ts
+/**
+* Install all skills from the local skills-lock.json.
+* Groups skills by source and calls `runAdd` for each group.
+*
+* Only installs to .agents/skills/ (universal agents) -- the canonical
+* project-level location. Does not install to agent-specific directories.
+*
+* node_modules skills are handled via experimental_sync.
+*/
+async function runInstallFromLock(args) {
+	const lock = await readLocalLock(process.cwd());
+	const skillEntries = Object.entries(lock.skills);
+	if (skillEntries.length === 0) {
+		M.warn("No project skills found in skills-lock.json");
+		M.info(`Add project-level skills with ${import_picocolors.default.cyan("npx @voidagency/skills add <package>")} (without ${import_picocolors.default.cyan("-g")})`);
+		return;
+	}
+	const universalAgentNames = getUniversalAgents();
+	const nodeModuleSkills = [];
+	const bySource = /* @__PURE__ */ new Map();
+	for (const [skillName, entry] of skillEntries) {
+		if (entry.sourceType === "node_modules") {
+			nodeModuleSkills.push(skillName);
+			continue;
+		}
+		const existing = bySource.get(entry.source);
+		if (existing) existing.skills.push(skillName);
+		else bySource.set(entry.source, {
+			sourceType: entry.sourceType,
+			skills: [skillName]
+		});
+	}
+	const remoteCount = skillEntries.length - nodeModuleSkills.length;
+	if (remoteCount > 0) M.info(`Restoring ${import_picocolors.default.cyan(String(remoteCount))} skill${remoteCount !== 1 ? "s" : ""} from skills-lock.json into ${import_picocolors.default.dim(".agents/skills/")}`);
+	for (const [source, { skills }] of bySource) try {
+		await runAdd([source], {
+			skill: skills,
+			agent: universalAgentNames,
+			yes: true
+		});
+	} catch (error) {
+		M.error(`Failed to install from ${import_picocolors.default.cyan(source)}: ${error instanceof Error ? error.message : "Unknown error"}`);
+	}
+	if (nodeModuleSkills.length > 0) {
+		M.info(`${import_picocolors.default.cyan(String(nodeModuleSkills.length))} skill${nodeModuleSkills.length !== 1 ? "s" : ""} from node_modules`);
+		try {
+			const { options: syncOptions } = parseSyncOptions(args);
+			await runSync(args, {
+				...syncOptions,
+				yes: true,
+				agent: universalAgentNames
+			});
+		} catch (error) {
+			M.error(`Failed to sync node_modules skills: ${error instanceof Error ? error.message : "Unknown error"}`);
+		}
+	}
+}
+//#endregion
+//#region src/list.ts
+const RESET$1 = "\x1B[0m";
+const BOLD$1 = "\x1B[1m";
+const DIM$1 = "\x1B[38;5;102m";
+const CYAN = "\x1B[36m";
+const YELLOW = "\x1B[33m";
+/**
+* Shortens a path for display: replaces homedir with ~ and cwd with .
+*/
+function shortenPath(fullPath, cwd) {
+	const home = homedir();
+	if (fullPath.startsWith(home)) return fullPath.replace(home, "~");
+	if (fullPath.startsWith(cwd)) return "." + fullPath.slice(cwd.length);
+	return fullPath;
+}
+/**
+* Formats a list of items, truncating if too many
+*/
+function formatList(items, maxShow = 5) {
+	if (items.length <= maxShow) return items.join(", ");
+	const shown = items.slice(0, maxShow);
+	const remaining = items.length - maxShow;
+	return `${shown.join(", ")} +${remaining} more`;
+}
+function parseListOptions(args) {
+	const options = {};
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "-g" || arg === "--global") options.global = true;
+		else if (arg === "-a" || arg === "--agent") {
+			options.agent = options.agent || [];
+			while (i + 1 < args.length && !args[i + 1].startsWith("-")) options.agent.push(args[++i]);
+		}
+	}
+	return options;
+}
+async function runList(args) {
+	const options = parseListOptions(args);
+	const scope = options.global === true ? true : false;
+	let agentFilter;
+	if (options.agent && options.agent.length > 0) {
+		const validAgents = Object.keys(agents);
+		const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
+		if (invalidAgents.length > 0) {
+			console.log(`${YELLOW}Invalid agents: ${invalidAgents.join(", ")}${RESET$1}`);
+			console.log(`${DIM$1}Valid agents: ${validAgents.join(", ")}${RESET$1}`);
+			process.exit(1);
+		}
+		agentFilter = options.agent;
+	}
+	const installedSkills = await listInstalledSkills({
+		global: scope,
+		agentFilter
+	});
+	const lockedSkills = await getAllLockedSkills();
+	const cwd = process.cwd();
+	const scopeLabel = scope ? "Global" : "Project";
+	if (installedSkills.length === 0) {
+		console.log(`${DIM$1}No ${scopeLabel.toLowerCase()} skills found.${RESET$1}`);
+		if (scope) console.log(`${DIM$1}Try listing project skills without -g${RESET$1}`);
+		else console.log(`${DIM$1}Try listing global skills with -g${RESET$1}`);
+		return;
+	}
+	function printSkill(skill, indent = false) {
+		const prefix = indent ? "  " : "";
+		const shortPath = shortenPath(skill.canonicalPath, cwd);
+		const agentNames = skill.agents.map((a) => agents[a].displayName);
+		const agentInfo = skill.agents.length > 0 ? formatList(agentNames) : `${YELLOW}not linked${RESET$1}`;
+		console.log(`${prefix}${CYAN}${skill.name}${RESET$1} ${DIM$1}${shortPath}${RESET$1}`);
+		console.log(`${prefix}  ${DIM$1}Agents:${RESET$1} ${agentInfo}`);
+	}
+	console.log(`${BOLD$1}${scopeLabel} Skills${RESET$1}`);
+	console.log();
+	const groupedSkills = {};
+	const ungroupedSkills = [];
+	for (const skill of installedSkills) {
+		const lockEntry = lockedSkills[skill.name];
+		if (lockEntry?.pluginName) {
+			const group = lockEntry.pluginName;
+			if (!groupedSkills[group]) groupedSkills[group] = [];
+			groupedSkills[group].push(skill);
+		} else ungroupedSkills.push(skill);
+	}
+	if (Object.keys(groupedSkills).length > 0) {
+		const sortedGroups = Object.keys(groupedSkills).sort();
+		for (const group of sortedGroups) {
+			const title = group.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+			console.log(`${BOLD$1}${title}${RESET$1}`);
+			const skills = groupedSkills[group];
+			if (skills) for (const skill of skills) printSkill(skill, true);
+			console.log();
+		}
+		if (ungroupedSkills.length > 0) {
+			console.log(`${BOLD$1}General${RESET$1}`);
+			for (const skill of ungroupedSkills) printSkill(skill, true);
+			console.log();
+		}
+	} else {
+		for (const skill of installedSkills) printSkill(skill);
+		console.log();
+	}
+}
+//#endregion
+//#region src/remove.ts
+async function removeCommand(skillNames, options) {
+	const isGlobal = options.global ?? false;
+	const cwd = process.cwd();
+	const spinner = Y();
+	spinner.start("Scanning for installed skills...");
+	const skillNamesSet = /* @__PURE__ */ new Set();
+	const scanDir = async (dir) => {
+		try {
+			const entries = await readdir(dir, { withFileTypes: true });
+			for (const entry of entries) if (entry.isDirectory()) skillNamesSet.add(entry.name);
+		} catch (err) {
+			if (err instanceof Error && err.code !== "ENOENT") M.warn(`Could not scan directory ${dir}: ${err.message}`);
+		}
+	};
+	if (isGlobal) {
+		await scanDir(getCanonicalSkillsDir(true, cwd));
+		for (const agent of Object.values(agents)) if (agent.globalSkillsDir !== void 0) await scanDir(agent.globalSkillsDir);
+	} else {
+		await scanDir(getCanonicalSkillsDir(false, cwd));
+		for (const agent of Object.values(agents)) await scanDir(join(cwd, agent.skillsDir));
+	}
+	const installedSkills = Array.from(skillNamesSet).sort();
+	spinner.stop(`Found ${installedSkills.length} unique installed skill(s)`);
+	if (installedSkills.length === 0) {
+		Se(import_picocolors.default.yellow("No skills found to remove."));
+		return;
+	}
+	if (options.agent && options.agent.length > 0) {
+		const validAgents = Object.keys(agents);
+		const invalidAgents = options.agent.filter((a) => !validAgents.includes(a));
+		if (invalidAgents.length > 0) {
+			M.error(`Invalid agents: ${invalidAgents.join(", ")}`);
+			M.info(`Valid agents: ${validAgents.join(", ")}`);
+			process.exit(1);
+		}
+	}
+	let selectedSkills = [];
+	if (options.all) selectedSkills = installedSkills;
+	else if (skillNames.length > 0) {
+		selectedSkills = installedSkills.filter((s) => skillNames.some((name) => name.toLowerCase() === s.toLowerCase()));
+		if (selectedSkills.length === 0) {
+			M.error(`No matching skills found for: ${skillNames.join(", ")}`);
+			return;
+		}
+	} else {
+		const choices = installedSkills.map((s) => ({
+			value: s,
+			label: s
+		}));
+		const selected = await fe({
+			message: `Select skills to remove ${import_picocolors.default.dim("(space to toggle)")}`,
+			options: choices,
+			required: true
+		});
+		if (pD(selected)) {
+			xe("Removal cancelled");
+			process.exit(0);
+		}
+		selectedSkills = selected;
+	}
+	let targetAgents;
+	if (options.agent && options.agent.length > 0) targetAgents = options.agent;
+	else {
+		targetAgents = Object.keys(agents);
+		spinner.stop(`Targeting ${targetAgents.length} potential agent(s)`);
+	}
+	if (!options.yes) {
+		console.log();
+		M.info("Skills to remove:");
+		for (const skill of selectedSkills) M.message(`  ${import_picocolors.default.red("•")} ${skill}`);
+		console.log();
+		const confirmed = await ye({ message: `Are you sure you want to uninstall ${selectedSkills.length} skill(s)?` });
+		if (pD(confirmed) || !confirmed) {
+			xe("Removal cancelled");
+			process.exit(0);
+		}
+	}
+	spinner.start("Removing skills...");
+	const results = [];
+	for (const skillName of selectedSkills) try {
+		const canonicalPath = getCanonicalPath(skillName, {
+			global: isGlobal,
+			cwd
+		});
+		for (const agentKey of targetAgents) {
+			const agent = agents[agentKey];
+			const skillPath = getInstallPath(skillName, agentKey, {
+				global: isGlobal,
+				cwd
+			});
+			const pathsToCleanup = new Set([skillPath]);
+			const sanitizedName = sanitizeName(skillName);
+			if (isGlobal && agent.globalSkillsDir) pathsToCleanup.add(join(agent.globalSkillsDir, sanitizedName));
+			else pathsToCleanup.add(join(cwd, agent.skillsDir, sanitizedName));
+			for (const pathToCleanup of pathsToCleanup) {
+				if (pathToCleanup === canonicalPath) continue;
+				try {
+					if (await lstat(pathToCleanup).catch(() => null)) await rm(pathToCleanup, {
+						recursive: true,
+						force: true
+					});
+				} catch (err) {
+					M.warn(`Could not remove skill from ${agent.displayName}: ${err instanceof Error ? err.message : String(err)}`);
+				}
+			}
+		}
+		const remainingAgents = (await detectInstalledAgents()).filter((a) => !targetAgents.includes(a));
+		let isStillUsed = false;
+		for (const agentKey of remainingAgents) if (await lstat(getInstallPath(skillName, agentKey, {
+			global: isGlobal,
+			cwd
+		})).catch(() => null)) {
+			isStillUsed = true;
+			break;
+		}
+		if (!isStillUsed) await rm(canonicalPath, {
+			recursive: true,
+			force: true
+		});
+		const lockEntry = isGlobal ? await getSkillFromLock(skillName) : null;
+		const effectiveSource = lockEntry?.source || "local";
+		const effectiveSourceType = lockEntry?.sourceType || "local";
+		if (isGlobal) await removeSkillFromLock(skillName);
+		results.push({
+			skill: skillName,
+			success: true,
+			source: effectiveSource,
+			sourceType: effectiveSourceType
+		});
+	} catch (err) {
+		results.push({
+			skill: skillName,
+			success: false,
+			error: err instanceof Error ? err.message : String(err)
+		});
+	}
+	spinner.stop("Removal process complete");
+	const successful = results.filter((r) => r.success);
+	const failed = results.filter((r) => !r.success);
+	if (successful.length > 0) {
+		const bySource = /* @__PURE__ */ new Map();
+		for (const r of successful) {
+			const source = r.source || "local";
+			const existing = bySource.get(source) || { skills: [] };
+			existing.skills.push(r.skill);
+			existing.sourceType = r.sourceType;
+			bySource.set(source, existing);
+		}
+		for (const [source, data] of bySource) track({
+			event: "remove",
+			source,
+			skills: data.skills.join(","),
+			agents: targetAgents.join(","),
+			...isGlobal && { global: "1" },
+			sourceType: data.sourceType
+		});
+	}
+	if (successful.length > 0) M.success(import_picocolors.default.green(`Successfully removed ${successful.length} skill(s)`));
+	if (failed.length > 0) {
+		M.error(import_picocolors.default.red(`Failed to remove ${failed.length} skill(s)`));
+		for (const r of failed) M.message(`  ${import_picocolors.default.red("✗")} ${r.skill}: ${r.error}`);
+	}
+	console.log();
+	Se(import_picocolors.default.green("Done!"));
+}
+/**
+* Parse command line options for the remove command.
+* Separates skill names from options flags.
+*/
+function parseRemoveOptions(args) {
+	const options = {};
+	const skills = [];
+	for (let i = 0; i < args.length; i++) {
+		const arg = args[i];
+		if (arg === "-g" || arg === "--global") options.global = true;
+		else if (arg === "-y" || arg === "--yes") options.yes = true;
+		else if (arg === "--all") options.all = true;
+		else if (arg === "-a" || arg === "--agent") {
+			options.agent = options.agent || [];
+			i++;
+			let nextArg = args[i];
+			while (i < args.length && nextArg && !nextArg.startsWith("-")) {
+				options.agent.push(nextArg);
+				i++;
+				nextArg = args[i];
+			}
+			i--;
+		} else if (arg && !arg.startsWith("-")) skills.push(arg);
+	}
+	return {
+		skills,
+		options
+	};
+}
+//#endregion
+//#region src/cli.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function getVersion() {
+	try {
+		const pkgPath = join(__dirname, "..", "package.json");
+		return JSON.parse(readFileSync(pkgPath, "utf-8")).version;
+	} catch {
+		return "0.0.0";
+	}
+}
+const VERSION = getVersion();
+initTelemetry(VERSION);
+const RESET = "\x1B[0m";
+const BOLD = "\x1B[1m";
+const DIM = "\x1B[38;5;102m";
+const TEXT = "\x1B[38;5;145m";
+const LOGO_LINES = [
+	"███████╗██╗  ██╗██╗██╗     ██╗     ███████╗",
+	"██╔════╝██║ ██╔╝██║██║     ██║     ██╔════╝",
+	"███████╗█████╔╝ ██║██║     ██║     ███████╗",
+	"╚════██║██╔═██╗ ██║██║     ██║     ╚════██║",
+	"███████║██║  ██╗██║███████╗███████╗███████║",
+	"╚══════╝╚═╝  ╚═╝╚═╝╚══════╝╚══════╝╚══════╝"
+];
+const GRAYS = [
+	"\x1B[38;5;250m",
+	"\x1B[38;5;248m",
+	"\x1B[38;5;245m",
+	"\x1B[38;5;243m",
+	"\x1B[38;5;240m",
+	"\x1B[38;5;238m"
+];
+function showLogo() {
+	console.log();
+	LOGO_LINES.forEach((line, i) => {
+		console.log(`${GRAYS[i]}${line}${RESET}`);
+	});
+}
+function showBanner() {
+	showLogo();
+	console.log();
+	console.log(`${DIM}The open agent skills ecosystem${RESET}`);
+	console.log();
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills add ${DIM}<package>${RESET}        ${DIM}Add a new skill${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills remove${RESET}               ${DIM}Remove installed skills${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills list${RESET}                 ${DIM}List installed skills${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills find ${DIM}[query]${RESET}         ${DIM}Search for skills${RESET}`);
+	console.log();
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills check${RESET}                ${DIM}Check for updates${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills update${RESET}               ${DIM}Update all skills${RESET}`);
+	console.log();
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills experimental_install${RESET} ${DIM}Restore from skills-lock.json${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills init ${DIM}[name]${RESET}          ${DIM}Create a new skill${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills experimental_sync${RESET}    ${DIM}Sync skills from node_modules${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @voidagency/skills add-agent ${DIM}<source>${RESET}     ${DIM}Install agent and its skills${RESET}`);
+	console.log();
+	console.log(`${DIM}try:${RESET} npx @voidagency/skills add vercel-labs/agent-skills`);
+	console.log();
+	console.log(`Discover more skills at ${TEXT}your skills directory${RESET}`);
+	console.log();
+}
+function showHelp() {
+	console.log(`
+${BOLD}Usage:${RESET} skills <command> [options]
+
+${BOLD}Manage Skills:${RESET}
+  add <package>        Add a skill package (alias: a)
+                       e.g. vercel-labs/agent-skills
+                            https://github.com/vercel-labs/agent-skills
+  add-agent <source>   Install an agent definition and its skills. Use source@agent-name
+                       for multi-agent repos (agent in agents/<name>/).
+  remove [skills]      Remove installed skills
+  list, ls             List installed skills
+  find [query]         Search for skills interactively
+
+${BOLD}Updates:${RESET}
+  check                Check for available skill updates
+  update               Update all skills to latest versions
+
+${BOLD}Project:${RESET}
+  experimental_install Restore skills from skills-lock.json
+  init [name]          Initialize a skill (creates <name>/SKILL.md or ./SKILL.md)
+  experimental_sync    Sync skills from node_modules into agent directories
+
+${BOLD}Add Options:${RESET}
+  -g, --global           Install skill globally (user-level) instead of project-level
+  -a, --agent <agents>   Specify agents to install to (use '*' for all agents)
+  -s, --skill <skills>   Specify skill names to install (use '*' for all skills)
+  -l, --list             List available skills in the repository without installing
+  -y, --yes              Skip confirmation prompts
+  --copy                 Copy files instead of symlinking to agent directories
+  --all                  Shorthand for --skill '*' --agent '*' -y
+  --full-depth           Search all subdirectories even when a root SKILL.md exists
+
+${BOLD}Remove Options:${RESET}
+  -g, --global           Remove from global scope
+  -a, --agent <agents>   Remove from specific agents (use '*' for all agents)
+  -s, --skill <skills>   Specify skills to remove (use '*' for all skills)
+  -y, --yes              Skip confirmation prompts
+  --all                  Shorthand for --skill '*' --agent '*' -y
+  
+${BOLD}Experimental Sync Options:${RESET}
+  -a, --agent <agents>   Specify agents to install to (use '*' for all agents)
+  -y, --yes              Skip confirmation prompts
+
+${BOLD}List Options:${RESET}
+  -g, --global           List global skills (default: project)
+  -a, --agent <agents>   Filter by specific agents
+
+${BOLD}Options:${RESET}
+  --help, -h        Show this help message
+  --version, -v     Show version number
+
+${BOLD}Examples:${RESET}
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills -g
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills --agent claude-code cursor
+  ${DIM}$${RESET} skills add vercel-labs/agent-skills --skill pr-review commit
+  ${DIM}$${RESET} skills remove                        ${DIM}# interactive remove${RESET}
+  ${DIM}$${RESET} skills remove web-design             ${DIM}# remove by name${RESET}
+  ${DIM}$${RESET} skills rm --global frontend-design
+  ${DIM}$${RESET} skills list                          ${DIM}# list project skills${RESET}
+  ${DIM}$${RESET} skills ls -g                         ${DIM}# list global skills${RESET}
+  ${DIM}$${RESET} skills ls -a claude-code             ${DIM}# filter by agent${RESET}
+  ${DIM}$${RESET} skills find                          ${DIM}# interactive search${RESET}
+  ${DIM}$${RESET} skills find typescript               ${DIM}# search by keyword${RESET}
+  ${DIM}$${RESET} skills check
+  ${DIM}$${RESET} skills update
+  ${DIM}$${RESET} skills experimental_install            ${DIM}# restore from skills-lock.json${RESET}
+  ${DIM}$${RESET} skills init my-skill
+  ${DIM}$${RESET} skills experimental_sync              ${DIM}# sync from node_modules${RESET}
+  ${DIM}$${RESET} skills experimental_sync -y           ${DIM}# sync without prompts${RESET}
+
+Discover more skills at ${TEXT}your skills directory${RESET}
+`);
+}
+function showRemoveHelp() {
+	console.log(`
+${BOLD}Usage:${RESET} skills remove [skills...] [options]
+
+${BOLD}Description:${RESET}
+  Remove installed skills from agents. If no skill names are provided,
+  an interactive selection menu will be shown.
+
+${BOLD}Arguments:${RESET}
+  skills            Optional skill names to remove (space-separated)
+
+${BOLD}Options:${RESET}
+  -g, --global       Remove from global scope (~/) instead of project scope
+  -a, --agent        Remove from specific agents (use '*' for all agents)
+  -s, --skill        Specify skills to remove (use '*' for all skills)
+  -y, --yes          Skip confirmation prompts
+  --all              Shorthand for --skill '*' --agent '*' -y
+
+${BOLD}Examples:${RESET}
+  ${DIM}$${RESET} skills remove                           ${DIM}# interactive selection${RESET}
+  ${DIM}$${RESET} skills remove my-skill                   ${DIM}# remove specific skill${RESET}
+  ${DIM}$${RESET} skills remove skill1 skill2 -y           ${DIM}# remove multiple skills${RESET}
+  ${DIM}$${RESET} skills remove --global my-skill          ${DIM}# remove from global scope${RESET}
+  ${DIM}$${RESET} skills rm --agent claude-code my-skill   ${DIM}# remove from specific agent${RESET}
+  ${DIM}$${RESET} skills remove --all                      ${DIM}# remove all skills${RESET}
+  ${DIM}$${RESET} skills remove --skill '*' -a cursor      ${DIM}# remove all skills from cursor${RESET}
+
+Discover more skills at ${TEXT}your skills directory${RESET}
+`);
+}
+function runInit(args) {
+	const cwd = process.cwd();
+	const skillName = args[0] || basename(cwd);
+	const hasName = args[0] !== void 0;
+	const skillDir = hasName ? join(cwd, skillName) : cwd;
+	const skillFile = join(skillDir, "SKILL.md");
+	const displayPath = hasName ? `${skillName}/SKILL.md` : "SKILL.md";
+	if (existsSync(skillFile)) {
+		console.log(`${TEXT}Skill already exists at ${DIM}${displayPath}${RESET}`);
+		return;
+	}
+	if (hasName) mkdirSync(skillDir, { recursive: true });
+	writeFileSync(skillFile, `---
+name: ${skillName}
+description: A brief description of what this skill does
+---
+
+# ${skillName}
+
+Instructions for the agent to follow when this skill is activated.
+
+## When to use
+
+Describe when this skill should be used.
+
+## Instructions
+
+1. First step
+2. Second step
+3. Additional steps as needed
+`);
+	console.log(`${TEXT}Initialized skill: ${DIM}${skillName}${RESET}`);
+	console.log();
+	console.log(`${DIM}Created:${RESET}`);
+	console.log(`  ${displayPath}`);
+	console.log();
+	console.log(`${DIM}Next steps:${RESET}`);
+	console.log(`  1. Edit ${TEXT}${displayPath}${RESET} to define your skill instructions`);
+	console.log(`  2. Update the ${TEXT}name${RESET} and ${TEXT}description${RESET} in the frontmatter`);
+	console.log();
+	console.log(`${DIM}Publishing:${RESET}`);
+	console.log(`  ${DIM}GitHub:${RESET}  Push to a repo, then ${TEXT}npx @voidagency/skills add <owner>/<repo>${RESET}`);
+	console.log(`  ${DIM}URL:${RESET}     Host the file, then ${TEXT}npx @voidagency/skills add https://example.com/${displayPath}${RESET}`);
+	console.log();
+	console.log(`Browse existing skills for inspiration at ${TEXT}your skills directory${RESET}`);
+	console.log();
+}
+const AGENTS_DIR = ".agents";
+const LOCK_FILE = ".skill-lock.json";
+const CURRENT_LOCK_VERSION = 3;
+function getSkillLockPath() {
+	return join(homedir(), AGENTS_DIR, LOCK_FILE);
+}
+function readSkillLock() {
+	const lockPath = getSkillLockPath();
+	try {
+		const content = readFileSync(lockPath, "utf-8");
+		const parsed = JSON.parse(content);
+		if (typeof parsed.version !== "number" || !parsed.skills) return {
+			version: CURRENT_LOCK_VERSION,
+			skills: {}
+		};
+		if (parsed.version < CURRENT_LOCK_VERSION) return {
+			version: CURRENT_LOCK_VERSION,
+			skills: {}
+		};
+		return parsed;
+	} catch {
+		return {
+			version: CURRENT_LOCK_VERSION,
+			skills: {}
+		};
+	}
+}
+/**
+* Determine why a skill cannot be checked for updates automatically.
+*/
+function getSkipReason(entry) {
+	if (entry.sourceType === "local") return "Local path";
+	if (entry.sourceType === "git") return "Git URL (hash tracking not supported)";
+	if (entry.sourceType === "bitbucket") return "Bitbucket (reinstall to update)";
+	if (!entry.skillFolderHash) return "No version hash available";
+	if (!entry.skillPath) return "No skill path recorded";
+	return "No version tracking";
+}
+/**
+* Print a list of skills that cannot be checked automatically,
+* with the reason and a manual update command for each.
+*/
+function printSkippedSkills(skipped) {
+	if (skipped.length === 0) return;
+	console.log();
+	console.log(`${DIM}${skipped.length} skill(s) cannot be checked automatically:${RESET}`);
+	for (const skill of skipped) {
+		console.log(`  ${TEXT}•${RESET} ${skill.name} ${DIM}(${skill.reason})${RESET}`);
+		console.log(`    ${DIM}To update: ${TEXT}npx @voidagency/skills add ${skill.sourceUrl} -g -y${RESET}`);
+	}
+}
+async function runCheck(args = []) {
+	console.log(`${TEXT}Checking for skill updates...${RESET}`);
+	console.log();
+	const lock = readSkillLock();
+	const skillNames = Object.keys(lock.skills);
+	if (skillNames.length === 0) {
+		console.log(`${DIM}No skills tracked in lock file.${RESET}`);
+		console.log(`${DIM}Install skills with${RESET} ${TEXT}npx @voidagency/skills add <package>${RESET}`);
+		return;
+	}
+	const token = getGitHubToken();
+	const skillsBySource = /* @__PURE__ */ new Map();
+	const skipped = [];
+	for (const skillName of skillNames) {
+		const entry = lock.skills[skillName];
+		if (!entry) continue;
+		if (!entry.skillFolderHash || !entry.skillPath) {
+			skipped.push({
+				name: skillName,
+				reason: getSkipReason(entry),
+				sourceUrl: entry.sourceUrl
+			});
+			continue;
+		}
+		const existing = skillsBySource.get(entry.source) || [];
+		existing.push({
+			name: skillName,
+			entry
+		});
+		skillsBySource.set(entry.source, existing);
+	}
+	const totalSkills = skillNames.length - skipped.length;
+	if (totalSkills === 0) {
+		console.log(`${DIM}No GitHub skills to check.${RESET}`);
+		printSkippedSkills(skipped);
+		return;
+	}
+	console.log(`${DIM}Checking ${totalSkills} skill(s) for updates...${RESET}`);
+	const updates = [];
+	const errors = [];
+	for (const [source, skills] of skillsBySource) for (const { name, entry } of skills) try {
+		const latestHash = await fetchSkillFolderHash(source, entry.skillPath, token);
+		if (!latestHash) {
+			errors.push({
+				name,
+				source,
+				error: "Could not fetch from GitHub"
+			});
+			continue;
+		}
+		if (latestHash !== entry.skillFolderHash) updates.push({
+			name,
+			source
+		});
+	} catch (err) {
+		errors.push({
+			name,
+			source,
+			error: err instanceof Error ? err.message : "Unknown error"
+		});
+	}
+	console.log();
+	if (updates.length === 0) console.log(`${TEXT}✓ All skills are up to date${RESET}`);
+	else {
+		console.log(`${TEXT}${updates.length} update(s) available:${RESET}`);
+		console.log();
+		for (const update of updates) {
+			console.log(`  ${TEXT}↑${RESET} ${update.name}`);
+			console.log(`    ${DIM}source: ${update.source}${RESET}`);
+		}
+		console.log();
+		console.log(`${DIM}Run${RESET} ${TEXT}npx @voidagency/skills update${RESET} ${DIM}to update all skills${RESET}`);
+	}
+	if (errors.length > 0) {
+		console.log();
+		console.log(`${DIM}Could not check ${errors.length} skill(s) (may need reinstall)${RESET}`);
+	}
+	printSkippedSkills(skipped);
+	track({
+		event: "check",
+		skillCount: String(totalSkills),
+		updatesAvailable: String(updates.length)
+	});
+	console.log();
+}
+async function runUpdate() {
+	console.log(`${TEXT}Checking for skill updates...${RESET}`);
+	console.log();
+	const lock = readSkillLock();
+	const skillNames = Object.keys(lock.skills);
+	if (skillNames.length === 0) {
+		console.log(`${DIM}No skills tracked in lock file.${RESET}`);
+		console.log(`${DIM}Install skills with${RESET} ${TEXT}npx @voidagency/skills add <package>${RESET}`);
+		return;
+	}
+	const token = getGitHubToken();
+	const updates = [];
+	const skipped = [];
+	for (const skillName of skillNames) {
+		const entry = lock.skills[skillName];
+		if (!entry) continue;
+		if (!entry.skillFolderHash || !entry.skillPath) {
+			skipped.push({
+				name: skillName,
+				reason: getSkipReason(entry),
+				sourceUrl: entry.sourceUrl
+			});
+			continue;
+		}
+		try {
+			const latestHash = await fetchSkillFolderHash(entry.source, entry.skillPath, token);
+			if (latestHash && latestHash !== entry.skillFolderHash) updates.push({
+				name: skillName,
+				source: entry.source,
+				entry
+			});
+		} catch {}
+	}
+	if (skillNames.length - skipped.length === 0) {
+		console.log(`${DIM}No skills to check.${RESET}`);
+		printSkippedSkills(skipped);
+		return;
+	}
+	if (updates.length === 0) {
+		console.log(`${TEXT}✓ All skills are up to date${RESET}`);
+		console.log();
+		return;
+	}
+	console.log(`${TEXT}Found ${updates.length} update(s)${RESET}`);
+	console.log();
+	let successCount = 0;
+	let failCount = 0;
+	for (const update of updates) {
+		console.log(`${TEXT}Updating ${update.name}...${RESET}`);
+		let installUrl = update.entry.sourceUrl;
+		if (update.entry.skillPath) {
+			let skillFolder = update.entry.skillPath;
+			if (skillFolder.endsWith("/SKILL.md")) skillFolder = skillFolder.slice(0, -9);
+			else if (skillFolder.endsWith("SKILL.md")) skillFolder = skillFolder.slice(0, -8);
+			if (skillFolder.endsWith("/")) skillFolder = skillFolder.slice(0, -1);
+			installUrl = update.entry.sourceUrl.replace(/\.git$/, "").replace(/\/$/, "");
+			installUrl = `${installUrl}/tree/main/${skillFolder}`;
+		}
+		if (spawnSync("npx", [
+			"-y",
+			"@voidagency/skills",
+			"add",
+			installUrl,
+			"-g",
+			"-y"
+		], {
+			stdio: [
+				"inherit",
+				"pipe",
+				"pipe"
+			],
+			shell: process.platform === "win32"
+		}).status === 0) {
+			successCount++;
+			console.log(`  ${TEXT}✓${RESET} Updated ${update.name}`);
+		} else {
+			failCount++;
+			console.log(`  ${DIM}✗ Failed to update ${update.name}${RESET}`);
+		}
+	}
+	console.log();
+	if (successCount > 0) console.log(`${TEXT}✓ Updated ${successCount} skill(s)${RESET}`);
+	if (failCount > 0) console.log(`${DIM}Failed to update ${failCount} skill(s)${RESET}`);
+	track({
+		event: "update",
+		skillCount: String(updates.length),
+		successCount: String(successCount),
+		failCount: String(failCount)
+	});
+	console.log();
+}
+async function main() {
+	const args = process.argv.slice(2);
+	if (args.length === 0) {
+		showBanner();
+		return;
+	}
+	const command = args[0];
+	const restArgs = args.slice(1);
+	switch (command) {
+		case "find":
+		case "search":
+		case "f":
+		case "s":
+			showLogo();
+			console.log();
+			await runFind(restArgs);
+			break;
+		case "init":
+			showLogo();
+			console.log();
+			runInit(restArgs);
+			break;
+		case "experimental_install":
+			showLogo();
+			await runInstallFromLock(restArgs);
+			break;
+		case "add-agent": {
+			showLogo();
+			const { source: agentSource, options: agentOpts } = parseAddAgentOptions(restArgs);
+			if (!agentSource) {
+				console.log(`${BOLD}Usage:${RESET} npx @voidagency/skills add-agent <source> [options]\n`);
+				console.log(`${DIM}Examples:${RESET} npx @voidagency/skills add-agent owner/repo -g -y\n         npx @voidagency/skills add-agent bitbucket:org/skills@backend -a cursor -g -y\n`);
+				process.exit(1);
+			}
+			await runAddAgent(agentSource, agentOpts);
+			break;
+		}
+		case "i":
+		case "install":
+		case "a":
+		case "add": {
+			showLogo();
+			const { source: addSource, options: addOpts } = parseAddOptions(restArgs);
+			await runAdd(addSource, addOpts);
+			break;
+		}
+		case "remove":
+		case "rm":
+		case "r":
+			if (restArgs.includes("--help") || restArgs.includes("-h")) {
+				showRemoveHelp();
+				break;
+			}
+			const { skills, options: removeOptions } = parseRemoveOptions(restArgs);
+			await removeCommand(skills, removeOptions);
+			break;
+		case "experimental_sync": {
+			showLogo();
+			const { options: syncOptions } = parseSyncOptions(restArgs);
+			await runSync(restArgs, syncOptions);
+			break;
+		}
+		case "list":
+		case "ls":
+			await runList(restArgs);
+			break;
+		case "check":
+			runCheck(restArgs);
+			break;
+		case "update":
+		case "upgrade":
+			runUpdate();
+			break;
+		case "--help":
+		case "-h":
+			showHelp();
+			break;
+		case "--version":
+		case "-v":
+			console.log(VERSION);
+			break;
+		default:
+			console.log(`Unknown command: ${command}`);
+			console.log(`Run ${BOLD}skills --help${RESET} for usage.`);
+	}
+}
+main();
+//#endregion
+export {};