skills 1.4.4 → 1.4.5

package/README.md

@@ -3,7 +3,7 @@
 The CLI for the open agent skills ecosystem.
 
 <!-- agent-list:start -->
-Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [37 more](#available-agents).
+Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [38 more](#available-agents).
 <!-- agent-list:end -->
 
 ## Install a Skill
@@ -214,7 +214,7 @@ Skills can be installed to any of these agents:
 | Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
 | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
 | OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |
-| Cline | `cline` | `.agents/skills/` | `~/.agents/skills/` |
+| Cline, Warp | `cline`, `warp` | `.agents/skills/` | `~/.agents/skills/` |
 | CodeBuddy | `codebuddy` | `.codebuddy/skills/` | `~/.codebuddy/skills/` |
 | Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
 | Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |

package/dist/cli.mjs

@@ -924,6 +924,15 @@ const agents = {
 			return existsSync(join(home, ".trae-cn"));
 		}
 	},
+	warp: {
+		name: "warp",
+		displayName: "Warp",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".agents/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".warp"));
+		}
+	},
 	windsurf: {
 		name: "windsurf",
 		displayName: "Windsurf",
@@ -1136,10 +1145,14 @@ async function installSkillForAgent(skill, agentType, options = {}) {
 	}
 }
 const EXCLUDE_FILES = new Set(["metadata.json"]);
-const EXCLUDE_DIRS = new Set([".git"]);
+const EXCLUDE_DIRS = new Set([
+	".git",
+	"__pycache__",
+	"__pypackages__"
+]);
 const isExcluded = (name, isDirectory = false) => {
 	if (EXCLUDE_FILES.has(name)) return true;
-	if (name.startsWith("_")) return true;
+	if (name.startsWith(".")) return true;
 	if (isDirectory && EXCLUDE_DIRS.has(name)) return true;
 	return false;
 };
@@ -1150,10 +1163,15 @@ async function copyDirectory(src, dest) {
 		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
-		});
+		else try {
+			await cp(srcPath, destPath, {
+				dereference: true,
+				recursive: true
+			});
+		} catch (err) {
+			if (err instanceof Error && "code" in err && err.code === "ENOENT" && entry.isSymbolicLink()) console.warn(`Skipping broken symlink: ${srcPath}`);
+			else throw err;
+		}
 	}));
 }
 async function isSkillInstalled(skillName, agentType, options = {}) {
@@ -1601,6 +1619,8 @@ const AGENTS_DIR$1 = ".agents";
 const LOCK_FILE$1 = ".skill-lock.json";
 const CURRENT_VERSION$1 = 3;
 function getSkillLockPath$1() {
+	const xdgStateHome = process.env.XDG_STATE_HOME;
+	if (xdgStateHome) return join(xdgStateHome, "skills", LOCK_FILE$1);
 	return join(homedir(), AGENTS_DIR$1, LOCK_FILE$1);
 }
 async function readSkillLock$1() {
@@ -1773,7 +1793,7 @@ function createEmptyLocalLock() {
 		skills: {}
 	};
 }
-var version$1 = "1.4.4";
+var version$1 = "1.4.5";
 const isCancelled$1 = (value) => typeof value === "symbol";
 async function isSourcePrivate(source) {
 	const ownerRepo = parseOwnerRepo(source);
@@ -2070,7 +2090,8 @@ async function handleWellKnownSkills(source, url, options, spinner) {
 		installGlobally = scope;
 	}
 	let installMode = options.copy ? "copy" : "symlink";
-	if (!options.copy && !options.yes) {
+	const uniqueDirs = new Set(targetAgents.map((a) => agents[a].skillsDir));
+	if (!options.copy && !options.yes && uniqueDirs.size > 1) {
 		const modeChoice = await ve({
 			message: "Installation method",
 			options: [{
@@ -2088,7 +2109,7 @@ async function handleWellKnownSkills(source, url, options, spinner) {
 			process.exit(0);
 		}
 		installMode = modeChoice;
-	}
+	} else if (uniqueDirs.size <= 1) installMode = "copy";
 	const cwd = process.cwd();
 	const summaryLines = [];
 	targetAgents.map((a) => agents[a].displayName);
@@ -2462,7 +2483,8 @@ async function runAdd(args, options = {}) {
 			installGlobally = scope;
 		}
 		let installMode = options.copy ? "copy" : "symlink";
-		if (!options.copy && !options.yes) {
+		const uniqueDirs = new Set(targetAgents.map((a) => agents[a].skillsDir));
+		if (!options.copy && !options.yes && uniqueDirs.size > 1) {
 			const modeChoice = await ve({
 				message: "Installation method",
 				options: [{
@@ -2481,7 +2503,7 @@ async function runAdd(args, options = {}) {
 				process.exit(0);
 			}
 			installMode = modeChoice;
-		}
+		} else if (uniqueDirs.size <= 1) installMode = "copy";
 		const cwd = process.cwd();
 		const summaryLines = [];
 		targetAgents.map((a) => agents[a].displayName);
@@ -2574,6 +2596,7 @@ async function runAdd(args, options = {}) {
 			skillFiles[skill.name] = relativePath;
 		}
 		const normalizedSource = getOwnerRepo(parsed);
+		const lockSource = parsed.url.startsWith("git@") ? parsed.url : normalizedSource;
 		if (normalizedSource) {
 			const ownerRepo = parseOwnerRepo(normalizedSource);
 			if (ownerRepo) {
@@ -2606,7 +2629,7 @@ async function runAdd(args, options = {}) {
 						if (hash) skillFolderHash = hash;
 					}
 					await addSkillToLock(skill.name, {
-						source: normalizedSource,
+						source: lockSource || normalizedSource,
 						sourceType: parsed.type,
 						sourceUrl: parsed.url,
 						skillPath: skillPathValue,
@@ -2623,7 +2646,7 @@ async function runAdd(args, options = {}) {
 				if (successfulSkillNames.has(skillDisplayName)) try {
 					const computedHash = await computeSkillFolderHash(skill.path);
 					await addSkillToLocalLock(skill.name, {
-						source: normalizedSource || parsed.url,
+						source: lockSource || parsed.url,
 						sourceType: parsed.type,
 						computedHash
 					}, cwd);
@@ -2812,7 +2835,7 @@ async function searchSkillsAPI(query) {
 			slug: skill.id,
 			source: skill.source || "",
 			installs: skill.installs
-		}));
+		})).sort((a, b) => (b.installs || 0) - (a.installs || 0));
 	} catch {
 		return [];
 	}
@@ -3368,6 +3391,7 @@ function parseListOptions(args) {
 	for (let i = 0; i < args.length; i++) {
 		const arg = args[i];
 		if (arg === "-g" || arg === "--global") options.global = true;
+		else if (arg === "--json") options.json = 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]);
@@ -3393,10 +3417,24 @@ async function runList(args) {
 		global: scope,
 		agentFilter
 	});
+	if (options.json) {
+		const jsonOutput = installedSkills.map((skill) => ({
+			name: skill.name,
+			path: skill.canonicalPath,
+			scope: skill.scope,
+			agents: skill.agents.map((a) => agents[a].displayName)
+		}));
+		console.log(JSON.stringify(jsonOutput, null, 2));
+		return;
+	}
 	const lockedSkills = await getAllLockedSkills();
 	const cwd = process.cwd();
 	const scopeLabel = scope ? "Global" : "Project";
 	if (installedSkills.length === 0) {
+		if (options.json) {
+			console.log("[]");
+			return;
+		}
 		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}`);
@@ -3735,6 +3773,7 @@ ${BOLD}Experimental Sync Options:${RESET}
 ${BOLD}List Options:${RESET}
   -g, --global           List global skills (default: project)
   -a, --agent <agents>   Filter by specific agents
+  --json                 Output as JSON (machine-readable, no ANSI codes)
 
 ${BOLD}Options:${RESET}
   --help, -h        Show this help message
@@ -3751,6 +3790,7 @@ ${BOLD}Examples:${RESET}
   ${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 check
@@ -3844,6 +3884,8 @@ const AGENTS_DIR = ".agents";
 const LOCK_FILE = ".skill-lock.json";
 const CURRENT_LOCK_VERSION = 3;
 function getSkillLockPath() {
+	const xdgStateHome = process.env.XDG_STATE_HOME;
+	if (xdgStateHome) return join(xdgStateHome, "skills", LOCK_FILE);
 	return join(homedir(), AGENTS_DIR, LOCK_FILE);
 }
 function readSkillLock() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {
@@ -71,6 +71,7 @@
     "roo",
     "trae",
     "trae-cn",
+    "warp",
     "windsurf",
     "zencoder",
     "neovate",