skills 1.7.2 → 1.7.3

package/dist/cli.mjs

@@ -1694,8 +1694,8 @@ const agents = {
 	fx: {
 		name: "fx",
 		displayName: "fx",
-		skillsDir: ".fx/skills",
-		globalSkillsDir: join(home, ".fx/skills"),
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".agents/skills"),
 		detectInstalled: async () => {
 			return existsSync(join(home, ".fx"));
 		}
@@ -2318,14 +2318,15 @@ async function installSkillForAgent(skill, agentType, options = {}) {
 				mode: "copy"
 			};
 		}
-		if (pathsOverlap(skill.path, canonicalDir)) return {
+		const sourceIsCanonical = resolve(skill.path) === resolve(canonicalDir);
+		if (!sourceIsCanonical && pathsOverlap(skill.path, canonicalDir)) return {
 			success: true,
 			path: canonicalDir,
 			canonicalPath: canonicalDir,
 			mode: installMode,
 			skipped: true
 		};
-		if (installMode === "link") {
+		if (!sourceIsCanonical) if (installMode === "link") {
 			if (!await createSymlink(skill.path, canonicalDir)) {
 				await cleanAndCreateDirectory(canonicalDir);
 				await copyDirectory(skill.path, canonicalDir, agentType);
@@ -4181,7 +4182,7 @@ async function tryBlobInstall(ownerRepo, options = {}) {
 		tree
 	};
 }
-var version$1 = "1.7.2";
+var version$1 = "1.7.3";
 const NOTION_API_VERSION = "2026-03-11";
 const NTN_TIMEOUT_MS = 3e4;
 const NTN_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
@@ -6323,6 +6324,9 @@ function matchesSkill(skill, patterns) {
 		return posix.matchesGlob(skill.packageName, packagePattern) && posix.matchesGlob(sanitizeName(skill.name), skillPattern);
 	});
 }
+function allowedByFilters(skill, { include, exclude }) {
+	return (!include?.length || matchesSkill(skill, include)) && !(exclude?.length && matchesSkill(skill, exclude));
+}
 function shortenPath$1(fullPath, cwd) {
 	const home = homedir();
 	if (fullPath === home || fullPath.startsWith(home + sep)) return "~" + fullPath.slice(home.length);
@@ -6369,6 +6373,32 @@ function findInstalledPackage(from, name) {
 		if (dirname(dir) === dir) return void 0;
 	}
 }
+function remoteAllowsSkill(request, name, options) {
+	return request.declarers.some((packageName) => allowedByFilters({
+		name,
+		packageName
+	}, options));
+}
+function filterRemoteRequests(requests, options) {
+	return requests.flatMap((request) => {
+		const declarers = request.declarers.filter((name) => (!options.include?.length || options.include.some((p) => posix.matchesGlob(name, p.split("#")[0]))) && !options.exclude?.some((p) => !p.includes("#") && posix.matchesGlob(name, p)));
+		if (declarers.length === 0) return [];
+		const filtered = {
+			...request,
+			via: declarers[0],
+			declarers
+		};
+		if (request.skills.length === 0) return [filtered];
+		const skills = request.skills.filter((name) => remoteAllowsSkill(filtered, name, options));
+		return skills.length > 0 ? [{
+			...filtered,
+			skills
+		}] : [];
+	});
+}
+function requestsLockedSkill(request, name, entry) {
+	return isFromRequest(entry, request) && (request.skills.length === 0 || request.skills.some((selected) => sanitizeName(selected) === sanitizeName(name) || selected === posix.basename(posix.dirname(entry.skillPath ?? ""))));
+}
 const DEPENDENCY_FIELDS = [
 	"dependencies",
 	"devDependencies",
@@ -6472,9 +6502,13 @@ async function discoverNodeModuleSkills(cwd, recursive) {
 				subpath,
 				request.skills
 			]);
-			if (!remote.has(key)) remote.set(key, {
+			const existing = remote.get(key);
+			if (existing) {
+				if (!existing.declarers.includes(declarer.name)) existing.declarers.push(declarer.name);
+			} else remote.set(key, {
 				...request,
-				via: declarer.name
+				via: declarer.name,
+				declarers: [declarer.name]
 			});
 		}
 		for (const request of parsed.npm) {
@@ -6536,7 +6570,7 @@ async function pruneStaleSkills(cwd, keep, keepRemote, lock, dryRun) {
 	const explicit = /* @__PURE__ */ new Set();
 	for (const [key, entry] of Object.entries(lock.skills)) {
 		const remote = entry.sourceType !== "node_modules";
-		if (installedBySync(entry) && !(remote && keepRemote(entry))) lockKeys.set(sanitizeName(key), key);
+		if (installedBySync(entry) && !(remote && keepRemote(entry, key))) lockKeys.set(sanitizeName(key), key);
 		else explicit.add(sanitizeName(key));
 	}
 	const candidates = new Set(lockKeys.keys());
@@ -6648,7 +6682,7 @@ async function runSync(args, options = {}) {
 		}
 	}
 	console.log();
-	if (!agentResult.isAgent) intro(import_picocolors.default.bgCyan(import_picocolors.default.black(" skills experimental_sync ")));
+	if (!agentResult.isAgent) intro(import_picocolors.default.bgCyan(import_picocolors.default.black(" skills sync ")));
 	if (agentResult.isAgent) log.info(import_picocolors.default.bgCyan(import_picocolors.default.black(import_picocolors.default.bold(` ${agentResult.agent.name} `))) + " Agent detected — installing non-interactively");
 	const spinner$2 = spinner();
 	spinner$2.start("Scanning node_modules for skills…");
@@ -6660,19 +6694,32 @@ async function runSync(args, options = {}) {
 		process.exitCode = 1;
 		return;
 	}
-	const { include, exclude } = options;
-	const discoveredSkills = discovery.skills.filter((skill) => (!include?.length || matchesSkill(skill, include)) && !(exclude?.length && matchesSkill(skill, exclude)));
+	const discoveredSkills = discovery.skills.filter((skill) => allowedByFilters(skill, options));
+	const remote = filterRemoteRequests(discovery.remote, options);
 	spinner$2.stop(discoveredSkills.length === 0 ? import_picocolors.default.yellow("No skills found") : `Found ${import_picocolors.default.green(String(discoveredSkills.length))} skill${discoveredSkills.length > 1 ? "s" : ""} in node_modules`);
 	for (const warning of discovery.warnings) log.warn(warning);
 	const localLock = await readLocalLock(cwd);
 	if (options.cleanup !== false) {
 		const keep = new Set(discoveredSkills.map((skill) => sanitizeName(skill.name)));
-		const keepRemote = (entry) => options.remote === false || discovery.remote.some((r) => isFromRequest(entry, r));
+		const keepRemote = (entry, name) => options.remote === false || remote.some((r) => requestsLockedSkill(r, name, entry) && remoteAllowsSkill(r, name, options));
 		const stale = await pruneStaleSkills(cwd, keep, keepRemote, localLock, options.dryRun ?? false);
 		for (const name of stale) log.info(`${options.dryRun ? "Would remove" : "Removed"} ${import_picocolors.default.cyan(name)} ${import_picocolors.default.dim("(no longer provided by a dependency)")}`);
 	}
-	const remoteRequests = (options.remote === false ? [] : discovery.remote).filter((request) => !isRemoteInstalled(request, localLock, cwd));
-	if (discoveredSkills.length === 0 && remoteRequests.length === 0) {
+	const remoteRequests = (options.remote === false ? [] : remote).filter((request) => !isRemoteInstalled(request, localLock, cwd));
+	const cachedRemoteSkills = [];
+	if (options.remote !== false) {
+		const shippedNames = new Set(discoveredSkills.map((skill) => sanitizeName(skill.name)));
+		for (const [name, entry] of Object.entries(localLock.skills)) {
+			if (shippedNames.has(sanitizeName(name))) continue;
+			if (!remote.some((request) => !remoteRequests.includes(request) && requestsLockedSkill(request, name, entry) && remoteAllowsSkill(request, name, options))) continue;
+			const skill = await parseSkillMd(join(getCanonicalPath(name, { cwd }), "SKILL.md"));
+			if (skill) cachedRemoteSkills.push({
+				skill,
+				source: entry.source
+			});
+		}
+	}
+	if (discoveredSkills.length === 0 && remoteRequests.length === 0 && cachedRemoteSkills.length === 0) {
 		outro(import_picocolors.default.dim("Nothing to sync."));
 		return;
 	}
@@ -6716,7 +6763,19 @@ async function runSync(args, options = {}) {
 	}
 	const { install: toInstall, skipped } = await resolveConflicts(discoveredSkills, targetAgents, localLock.skills, cwd);
 	for (const { skill, reason } of skipped) log.warn(`Skipped ${import_picocolors.default.cyan(skill.name)} ${import_picocolors.default.dim(`from ${skill.packageName}`)}: ${reason}`);
-	if (toInstall.length === 0 && remoteRequests.length === 0) {
+	const cachedToInstall = [];
+	for (const cached of cachedRemoteSkills) {
+		const { skill } = cached;
+		const missing = targetAgents.filter((agent) => !existsSync(getInstallPath(skill.name, agent, { cwd })));
+		if (missing.length === 0) continue;
+		const reason = await blockedReason(skill.name, missing, localLock.skills[skill.name], cwd);
+		if (reason) log.warn(`Skipped ${import_picocolors.default.cyan(skill.name)}: ${reason}`);
+		else cachedToInstall.push({
+			...cached,
+			agents: missing
+		});
+	}
+	if (toInstall.length === 0 && remoteRequests.length === 0 && cachedToInstall.length === 0) {
 		console.log();
 		outro(import_picocolors.default.yellow("Nothing to sync."));
 		return;
@@ -6729,6 +6788,7 @@ async function runSync(args, options = {}) {
 		summaryLines.push(`  ${import_picocolors.default.dim(`${shortenPath$1(canonicalPath, cwd)} ${mode === "link" ? "→" : "copied from"} ${shortenPath$1(skill.path, cwd)}`)}`);
 	}
 	for (const request of remoteRequests) summaryLines.push(`${import_picocolors.default.cyan(getProjectLockSource(request.parsed))} ${import_picocolors.default.dim(`← ${request.via} (remote)`)}`);
+	for (const { skill, source, agents: missing } of cachedToInstall) summaryLines.push(`${import_picocolors.default.cyan(skill.name)} ${import_picocolors.default.dim(`← ${source} (cached), link to ${missing.join(", ")}`)}`);
 	console.log();
 	note(summaryLines.join("\n"), "Sync Summary");
 	if (options.dryRun) {
@@ -6744,6 +6804,22 @@ async function runSync(args, options = {}) {
 	}
 	spinner$2.start("Syncing skills…");
 	const results = [];
+	for (const { skill, source, agents: missing } of cachedToInstall) for (const agent of missing) {
+		const result = await installSkillForAgent(skill, agent, {
+			cwd,
+			mode: "symlink",
+			createMissingAgentRoot: true
+		});
+		results.push({
+			skill: skill.name,
+			packageName: source,
+			agent: agents[agent].displayName,
+			success: result.success,
+			path: result.path,
+			canonicalPath: result.canonicalPath,
+			error: result.error
+		});
+	}
 	for (const skill of toInstall) for (const agent of targetAgents) {
 		const result = await installSkillForAgent(skill, agent, {
 			global: false,
@@ -6787,6 +6863,7 @@ async function runSync(args, options = {}) {
 				const selected = [];
 				for (const skill of skills) {
 					const name = sanitizeName(skill.name);
+					if (!remoteAllowsSkill(request, name, options)) continue;
 					const reason = claimed.has(name) ? "another source in this sync provides it" : await blockedReason(name, targetAgents, lockEntryFor(name), cwd);
 					if (reason) {
 						log.warn(`Skipped ${import_picocolors.default.cyan(name)} from ${label}: ${reason}`);
@@ -6818,7 +6895,7 @@ async function runSync(args, options = {}) {
 		const resultLines = [];
 		for (const [skillName, skillResults] of bySkill) {
 			const firstResult = skillResults[0];
-			const pkg = toInstall.find((s) => s.name === skillName)?.packageName;
+			const pkg = firstResult.packageName;
 			if (firstResult.canonicalPath) {
 				const shortPath = shortenPath$1(firstResult.canonicalPath, cwd);
 				resultLines.push(`${import_picocolors.default.green("✓")} ${skillName} ${import_picocolors.default.dim(`← ${pkg}`)}`);
@@ -6830,13 +6907,14 @@ async function runSync(args, options = {}) {
 		note(resultLines.join("\n"), title);
 	}
 	if (failed.length > 0) {
+		process.exitCode = 1;
 		console.log();
 		log.error(import_picocolors.default.red(`Failed to install ${failed.length}`));
 		for (const r of failed) log.message(`  ${import_picocolors.default.red("✗")} ${r.skill} → ${r.agent}: ${import_picocolors.default.dim(r.error)}`);
 	}
 	track({
 		event: "experimental_sync",
-		skillCount: String(toInstall.length),
+		skillCount: String(toInstall.length + cachedToInstall.length),
 		successCount: String(successfulSkillNames.size),
 		agents: targetAgents.join(",")
 	});
@@ -8574,7 +8652,7 @@ function showBanner() {
 	console.log();
 	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills experimental_install${RESET} ${DIM}Restore from skills-lock.json${RESET}`);
 	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills init ${DIM}[name]${RESET}          ${DIM}Create a new skill${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills experimental_sync${RESET}    ${DIM}Sync skills from node_modules${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills sync${RESET}                 ${DIM}Sync skills from node_modules${RESET}`);
 	console.log();
 	console.log(`${DIM}try:${RESET} npx skills add vercel-labs/agent-skills`);
 	console.log();
@@ -8582,6 +8660,37 @@ function showBanner() {
 	console.log();
 }
 function showHelp() {
+	const examples = [
+		["skills add vercel-labs/agent-skills"],
+		["skills use vercel-labs/agent-skills@vercel-optimize | claude"],
+		["skills use vercel-labs/agent-skills --skill vercel-optimize --agent claude-code"],
+		["skills add vercel-labs/agent-skills -g"],
+		["skills add vercel-labs/agent-skills --agent claude-code cursor"],
+		["skills add vercel-labs/agent-skills --skill pr-review commit"],
+		["skills add vercel-labs/agent-skills --json -y", "JSON output"],
+		["skills remove", "interactive remove"],
+		["skills remove web-design", "remove by name"],
+		["skills rm --global frontend-design"],
+		["skills list", "list project skills"],
+		["skills ls -g", "list global skills"],
+		["skills ls -a claude-code", "filter by agent"],
+		["skills ls --json", "JSON output"],
+		["skills find", "interactive search"],
+		["skills find typescript", "search by keyword"],
+		["skills find react --owner vercel", "search within an owner"],
+		["skills update"],
+		["skills update my-skill", "update a single skill"],
+		["skills update -g", "update global skills only"],
+		["skills experimental_install", "restore from skills-lock.json"],
+		["skills init my-skill"],
+		["skills sync", "sync from node_modules"],
+		["skills sync -y", "sync without prompts"]
+	];
+	const exampleWidth = Math.max(...examples.filter(([, description]) => description).map(([command]) => command.length));
+	const formattedExamples = examples.map(([command, description]) => {
+		const comment = description ? `${" ".repeat(exampleWidth - command.length + 2)}${DIM}# ${description}${RESET}` : "";
+		return `  ${DIM}$${RESET} ${command}${comment}`;
+	}).join("\n");
 	console.log(`
 ${BOLD}Usage:${RESET} skills <command> [options]
 
@@ -8611,7 +8720,7 @@ ${BOLD}Update Options:${RESET}
 ${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
+  sync                 Sync skills from node_modules into agent directories (alias: experimental_sync)
 
 ${BOLD}Add Options:${RESET}
   -g, --global           Install skill globally (user-level) instead of project-level
@@ -8638,7 +8747,7 @@ ${BOLD}Remove Options:${RESET}
   -y, --yes              Skip confirmation prompts
   --all                  Remove every installed skill (-y implied). Do not combine with named skills.
   
-${BOLD}Experimental Sync Options:${RESET}
+${BOLD}Sync Options:${RESET}
   -a, --agent <agents>   Specify agents to install to (use '*' for all agents)
   -y, --yes              Skip confirmation prompts
   --copy                 Copy skills instead of linking them to node_modules
@@ -8659,30 +8768,7 @@ ${BOLD}Options:${RESET}
   --version, -v     Show version number
 
 ${BOLD}Examples:${RESET}
-  ${DIM}$${RESET} skills add vercel-labs/agent-skills
-  ${DIM}$${RESET} skills use vercel-labs/agent-skills@vercel-optimize | claude
-  ${DIM}$${RESET} skills use vercel-labs/agent-skills --skill vercel-optimize --agent claude-code
-  ${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 add vercel-labs/agent-skills --json -y ${DIM}# JSON output${RESET}
-  ${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 ls --json                      ${DIM}# JSON output${RESET}
-  ${DIM}$${RESET} skills find                          ${DIM}# interactive search${RESET}
-  ${DIM}$${RESET} skills find typescript               ${DIM}# search by keyword${RESET}
-  ${DIM}$${RESET} skills find react --owner vercel     ${DIM}# search within an owner${RESET}
-  ${DIM}$${RESET} skills update
-  ${DIM}$${RESET} skills update my-skill             ${DIM}# update a single skill${RESET}
-  ${DIM}$${RESET} skills update -g                    ${DIM}# update global skills only${RESET}
-  ${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}
+${formattedExamples}
 
 Discover more skills at ${TEXT}https://skills.sh/${RESET}
 `);
@@ -8823,6 +8909,7 @@ async function main() {
 			await removeCommand(skills, removeOptions);
 			break;
 		}
+		case "sync":
 		case "experimental_sync": {
 			if (!inAgent) showLogo();
 			const { options: syncOptions } = parseSyncOptions(restArgs);

package/docs/agents.md

@@ -0,0 +1,135 @@
+# Supported agents
+
+[Back to the README](../README.md)
+
+Skills can be installed to any of these agents:
+
+<!-- supported-agents:start -->
+| Agent | `--agent` | Project Path | Global Path |
+|-------|-----------|--------------|-------------|
+| AiderDesk | `aider-desk` | `.aider-desk/skills/` | `~/.aider-desk/skills/` |
+| Amp, Replit, Universal | `amp`, `replit`, `universal` | `.agents/skills/` | `~/.config/agents/skills/` |
+| Antigravity | `antigravity` | `.agents/skills/` | `~/.gemini/antigravity/skills/` |
+| Antigravity CLI | `antigravity-cli` | `.agents/skills/` | `~/.gemini/antigravity-cli/skills/` |
+| AstrBot | `astrbot` | `data/skills/` | `~/.astrbot/data/skills/` |
+| Autohand Code CLI | `autohand-code` | `.autohand/skills/` | `~/.autohand/skills/` |
+| Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
+| IBM Bob | `bob` | `.bob/skills/` | `~/.bob/skills/` |
+| Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
+| OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |
+| Cline, Codex, Dexto, fx, Kimi Code CLI, Loaf, Pi, Sarvam Code, Warp, Zed | `cline`, `codex`, `dexto`, `fx`, `kimi-code-cli`, `loaf`, `pi`, `sarvam-code`, `warp`, `zed` | `.agents/skills/` | `~/.agents/skills/` |
+| CodeArts Agent | `codearts-agent` | `.codeartsdoer/skills/` | `~/.codeartsdoer/skills/` |
+| CodeBuddy | `codebuddy` | `.codebuddy/skills/` | `~/.codebuddy/skills/` |
+| Codemaker | `codemaker` | `.codemaker/skills/` | `~/.codemaker/skills/` |
+| Code Studio | `codestudio` | `.codestudio/skills/` | `~/.codestudio/skills/` |
+| Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |
+| Continue | `continue` | `.continue/skills/` | `~/.continue/skills/` |
+| Cortex Code | `cortex` | `.cortex/skills/` | `~/.snowflake/cortex/skills/` |
+| Crush | `crush` | `.crush/skills/` | `~/.config/crush/skills/` |
+| Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
+| Deep Agents | `deepagents` | `.agents/skills/` | `~/.deepagents/agent/skills/` |
+| Devin for Terminal | `devin` | `.devin/skills/` | `~/.config/devin/skills/` |
+| Droid | `droid` | `.agents/skills/` | `~/.factory/skills/` |
+| Eve | `eve` | `agent/skills/` | N/A (project-only) |
+| Firebender | `firebender` | `.agents/skills/` | `~/.firebender/skills/` |
+| ForgeCode | `forgecode` | `.forge/skills/` | `~/.forge/skills/` |
+| Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
+| GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
+| Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
+| Grok Build | `grok` | `.grok/skills/` | `~/.grok/skills/` |
+| Hermes Agent | `hermes-agent` | `.hermes/skills/` | `~/.hermes/skills/` |
+| inference.sh | `inference-sh` | `.inferencesh/skills/` | `~/.inferencesh/skills/` |
+| Jazz | `jazz` | `.jazz/skills/` | `~/.jazz/skills/` |
+| Junie | `junie` | `.junie/skills/` | `~/.junie/skills/` |
+| iFlow CLI | `iflow-cli` | `.iflow/skills/` | `~/.iflow/skills/` |
+| Kilo Code | `kilo` | `.agents/skills/` | `~/.kilo/skills/` |
+| Kimchi | `kimchi` | `.kimchi/skills/` | `~/.config/kimchi/harness/skills/` |
+| Kiro CLI | `kiro-cli` | `.kiro/skills/` | `~/.kiro/skills/` |
+| Kode | `kode` | `.kode/skills/` | `~/.kode/skills/` |
+| Lingma | `lingma` | `.lingma/skills/` | `~/.lingma/skills/` |
+| MCPJam | `mcpjam` | `.mcpjam/skills/` | `~/.mcpjam/skills/` |
+| MiniMax Code | `minimax-code` | `.minimax/skills/` | `~/.minimax/skills/` |
+| Mistral Vibe | `mistral-vibe` | `.vibe/skills/` | `~/.vibe/skills/` |
+| Moxby | `moxby` | `.moxby/skills/` | `~/.moxby/skills/` |
+| Mux | `mux` | `.mux/skills/` | `~/.mux/skills/` |
+| OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |
+| OpenHands | `openhands` | `.openhands/skills/` | `~/.openhands/skills/` |
+| Ona | `ona` | `.ona/skills/` | `~/.ona/skills/` |
+| Posit Assistant | `posit-assistant` | `.posit/assistant/skills/` | `~/.posit/assistant/skills/` |
+| Qoder | `qoder` | `.qoder/skills/` | `~/.qoder/skills/` |
+| Qoder CN | `qoder-cn` | `.qoder/skills/` | `~/.qoder-cn/skills/` |
+| Qwen Code | `qwen-code` | `.qwen/skills/` | `~/.qwen/skills/` |
+| Reasonix | `reasonix` | `.reasonix/skills/` | `~/.reasonix/skills/` |
+| Rovo Dev | `rovodev` | `.rovodev/skills/` | `~/.rovodev/skills/` |
+| Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
+| Tabnine CLI | `tabnine-cli` | `.tabnine/agent/skills/` | `~/.tabnine/agent/skills/` |
+| Terramind | `terramind` | `.terramind/skills/` | `~/.terramind/skills/` |
+| Tinycloud | `tinycloud` | `.tinycloud/skills/` | `~/.tinycloud/skills/` |
+| Trae | `trae` | `.trae/skills/` | `~/.trae/skills/` |
+| Trae CN | `trae-cn` | `.trae/skills/` | `~/.trae-cn/skills/` |
+| Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| ZCode | `zcode` | `.zcode/skills/` | `~/.zcode/skills/` |
+| Zencoder, Zenflow | `zencoder`, `zenflow` | `.zencoder/skills/` | `~/.zencoder/skills/` |
+| Neovate | `neovate` | `.neovate/skills/` | `~/.neovate/skills/` |
+| Pochi | `pochi` | `.pochi/skills/` | `~/.pochi/skills/` |
+| PromptScript | `promptscript` | `.agents/skills/` | N/A (project-only) |
+| AdaL | `adal` | `.adal/skills/` | `~/.adal/skills/` |
+<!-- supported-agents:end -->
+
+> [!NOTE]
+> **Kiro CLI users:** The default agent automatically loads skills from `.kiro/skills/` and `~/.kiro/skills/` — no
+> configuration needed. If you use a **custom agent**, add skills to its `resources` in `.kiro/agents/<agent>.json`:
+>
+> ```json
+> {
+>   "resources": ["skill://.kiro/skills/**/SKILL.md"]
+> }
+> ```
+
+The CLI automatically detects which coding agents you have installed. If none are detected, you'll be prompted to select
+which agents to install to.
+
+## Compatibility
+
+Skills are generally compatible across agents since they follow a
+shared [Agent Skills specification](https://agentskills.io). However, some features may be agent-specific:
+
+| Feature         | OpenCode | OpenHands | Claude Code | Cline | CodeBuddy | Codex | Command Code | Kiro CLI | Cursor | Antigravity | Roo Code | Github Copilot | Amp | OpenClaw | Neovate | Pi  | Qoder | Zencoder |
+| --------------- | -------- | --------- | ----------- | ----- | --------- | ----- | ------------ | -------- | ------ | ----------- | -------- | -------------- | --- | -------- | ------- | --- | ----- | -------- |
+| Basic skills    | Yes      | Yes       | Yes         | Yes   | Yes       | Yes   | Yes          | Yes      | Yes    | Yes         | Yes      | Yes            | Yes | Yes      | Yes     | Yes | Yes   | Yes      |
+| `allowed-tools` | Yes      | Yes       | Yes         | Yes   | Yes       | Yes   | Yes          | No       | Yes    | Yes         | Yes      | Yes            | Yes | Yes      | Yes     | Yes | Yes   | No       |
+| `context: fork` | No       | No        | Yes         | No    | No        | No    | No           | No       | No     | No          | No       | No             | No  | No       | No      | No  | No    | No       |
+| Hooks           | No       | No        | Yes         | Yes   | No        | No    | No           | Yes      | No     | No          | No       | No             | No  | No       | No      | No  | No    | No       |
+
+## Related Links
+
+- [Agent Skills Specification](https://agentskills.io)
+- [Skills Directory](https://skills.sh)
+- [Amp Skills Documentation](https://ampcode.com/manual#agent-skills)
+- [Antigravity Skills Documentation](https://antigravity.google/docs/skills)
+- [Factory AI / Droid Skills Documentation](https://docs.factory.ai/cli/configuration/skills)
+- [Claude Code Skills Documentation](https://code.claude.com/docs/en/skills)
+- [OpenClaw Skills Documentation](https://docs.openclaw.ai/tools/skills)
+- [Cline Skills Documentation](https://docs.cline.bot/features/skills)
+- [CodeBuddy Skills Documentation](https://www.codebuddy.ai/docs/ide/Features/Skills)
+- [Codex Skills Documentation](https://developers.openai.com/codex/skills)
+- [Command Code Skills Documentation](https://commandcode.ai/docs/skills)
+- [Crush Skills Documentation](https://github.com/charmbracelet/crush?tab=readme-ov-file#agent-skills)
+- [Cursor Skills Documentation](https://cursor.com/docs/context/skills)
+- [Firebender Skills Documentation](https://docs.firebender.com/multi-agent/skills)
+- [Gemini CLI Skills Documentation](https://geminicli.com/docs/cli/skills/)
+- [GitHub Copilot Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills)
+- [iFlow CLI Skills Documentation](https://platform.iflow.cn/en/cli/examples/skill)
+- [Kimi Code CLI Skills Documentation](https://moonshotai.github.io/kimi-code/en/customization/skills)
+- [Kiro CLI Skills Documentation](https://kiro.dev/docs/cli/custom-agents/configuration-reference/#skill-resources)
+- [Kode Skills Documentation](https://github.com/shareAI-lab/kode/blob/main/docs/skills.md)
+- [OpenCode Skills Documentation](https://opencode.ai/docs/skills)
+- [Qwen Code Skills Documentation](https://qwenlm.github.io/qwen-code-docs/en/users/features/skills/)
+- [OpenHands Skills Documentation](https://docs.openhands.ai/modules/usage/how-to/using-skills)
+- [Pi Skills Documentation](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/docs/skills.md)
+- [Posit Assistant Skills Documentation](https://assistant.posit.co/docs/features/skills/)
+- [Qoder Skills Documentation](https://docs.qoder.com/cli/Skills)
+- [Replit Skills Documentation](https://docs.replit.com/replitai/skills)
+- [Roo Code Skills Documentation](https://docs.roocode.com/features/skills)
+- [Trae Skills Documentation](https://docs.trae.ai/ide/skills)
+- [Vercel Agent Skills Repository](https://github.com/vercel-labs/agent-skills)