skills 1.4.5 → 1.4.6

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 [38 more](#available-agents).
+Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [39 more](#available-agents).
 <!-- agent-list:end -->
 
 ## Install a Skill
@@ -39,7 +39,7 @@ npx skills add ./my-local-skills
 | Option                    | Description                                                                                                                                        |
 | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `-g, --global`            | Install to user directory instead of project                                                                                                       |
-| `-a, --agent <agents...>` | <!-- agent-names:start -->Target specific agents (e.g., `claude-code`, `codex`). See [Available Agents](#available-agents)<!-- agent-names:end -->                  |
+| `-a, --agent <agents...>` | <!-- agent-names:start -->Target specific agents (e.g., `claude-code`, `codex`). See [Available Agents](#available-agents)<!-- agent-names:end --> |
 | `-s, --skill <skills...>` | Install specific skills by name (use `'*'` for all skills)                                                                                         |
 | `-l, --list`              | List available skills without installing                                                                                                           |
 | `--copy`                  | Copy files instead of symlinking to agent directories                                                                                              |
@@ -210,7 +210,7 @@ Skills can be installed to any of these agents:
 | Agent | `--agent` | Project Path | Global Path |
 |-------|-----------|--------------|-------------|
 | Amp, Kimi Code CLI, Replit, Universal | `amp`, `kimi-cli`, `replit`, `universal` | `.agents/skills/` | `~/.config/agents/skills/` |
-| Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
+| Antigravity | `antigravity` | `.agents/skills/` | `~/.gemini/antigravity/skills/` |
 | Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
 | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
 | OpenClaw | `openclaw` | `skills/` | `~/.openclaw/skills/` |
@@ -222,6 +222,7 @@ Skills can be installed to any of these agents:
 | 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/` |
 | Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
 | Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
 | GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
@@ -317,7 +318,6 @@ The CLI searches for skills in these locations within a repository:
 - `skills/.experimental/`
 - `skills/.system/`
 - `.agents/skills/`
-- `.agent/skills/`
 - `.augment/skills/`
 - `.claude/skills/`
 - `./skills/`

package/dist/cli.mjs

@@ -9,15 +9,15 @@ 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, spawn, spawnSync } from "child_process";
+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";
+import { createHash } from "crypto";
 var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
 function getOwnerRepo(parsed) {
 	if (parsed.type === "local") return null;
@@ -533,7 +533,6 @@ async function discoverSkills(basePath, subpath, options) {
 		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"),
@@ -620,7 +619,7 @@ const agents = {
 	antigravity: {
 		name: "antigravity",
 		displayName: "Antigravity",
-		skillsDir: ".agent/skills",
+		skillsDir: ".agents/skills",
 		globalSkillsDir: join(home, ".gemini/antigravity/skills"),
 		detectInstalled: async () => {
 			return existsSync(join(home, ".gemini/antigravity"));
@@ -725,6 +724,15 @@ const agents = {
 			return existsSync(join(home, ".cursor"));
 		}
 	},
+	deepagents: {
+		name: "deepagents",
+		displayName: "Deep Agents",
+		skillsDir: ".agents/skills",
+		globalSkillsDir: join(home, ".deepagents/agent/skills"),
+		detectInstalled: async () => {
+			return existsSync(join(home, ".deepagents"));
+		}
+	},
 	droid: {
 		name: "droid",
 		displayName: "Droid",
@@ -1310,6 +1318,19 @@ async function listInstalledSkills(options = {}) {
 				agentType
 			});
 		}
+		const allAgentTypes = Object.keys(agents);
+		for (const agentType of allAgentTypes) {
+			if (agentsToCheck.includes(agentType)) continue;
+			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)) continue;
+			if (existsSync(agentDir)) scopes.push({
+				global: isGlobal,
+				path: agentDir,
+				agentType
+			});
+		}
 	}
 	for (const scope of scopes) try {
 		const entries = await readdir(scope.path, { withFileTypes: true });
@@ -1452,7 +1473,7 @@ new ProviderRegistryImpl();
 var WellKnownProvider = class {
 	id = "well-known";
 	displayName = "Well-Known Skills";
-	WELL_KNOWN_PATH = ".well-known/skills";
+	WELL_KNOWN_PATHS = [".well-known/agent-skills", ".well-known/skills"];
 	INDEX_FILE = "index.json";
 	match(url) {
 		if (!url.startsWith("http://") && !url.startsWith("https://")) return { matches: false };
@@ -1475,15 +1496,20 @@ var WellKnownProvider = class {
 		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 urlsToTry = [];
+			for (const wellKnownPath of this.WELL_KNOWN_PATHS) {
+				urlsToTry.push({
+					indexUrl: `${parsed.protocol}//${parsed.host}${basePath}/${wellKnownPath}/${this.INDEX_FILE}`,
+					baseUrl: `${parsed.protocol}//${parsed.host}${basePath}`,
+					wellKnownPath
+				});
+				if (basePath && basePath !== "") urlsToTry.push({
+					indexUrl: `${parsed.protocol}//${parsed.host}/${wellKnownPath}/${this.INDEX_FILE}`,
+					baseUrl: `${parsed.protocol}//${parsed.host}`,
+					wellKnownPath
+				});
+			}
+			for (const { indexUrl, baseUrl: resolvedBase, wellKnownPath } of urlsToTry) try {
 				const response = await fetch(indexUrl);
 				if (!response.ok) continue;
 				const index = await response.json();
@@ -1495,7 +1521,8 @@ var WellKnownProvider = class {
 				}
 				if (allValid) return {
 					index,
-					resolvedBaseUrl: resolvedBase
+					resolvedBaseUrl: resolvedBase,
+					resolvedWellKnownPath: wellKnownPath
 				};
 			} catch {
 				continue;
@@ -1526,22 +1553,23 @@ var WellKnownProvider = class {
 			const parsed = new URL(url);
 			const result = await this.fetchIndex(url);
 			if (!result) return null;
-			const { index, resolvedBaseUrl } = result;
+			const { index, resolvedBaseUrl, resolvedWellKnownPath } = result;
 			let skillName = null;
-			const pathMatch = parsed.pathname.match(/\/.well-known\/skills\/([^/]+)\/?$/);
+			const pathMatch = parsed.pathname.match(/\/.well-known\/(?:agent-skills|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);
+			return this.fetchSkillByEntry(resolvedBaseUrl, skillEntry, resolvedWellKnownPath);
 		} catch {
 			return null;
 		}
 	}
-	async fetchSkillByEntry(baseUrl, entry) {
+	async fetchSkillByEntry(baseUrl, entry, wellKnownPath) {
 		try {
-			const skillBaseUrl = `${baseUrl.replace(/\/$/, "")}/${this.WELL_KNOWN_PATH}/${entry.name}`;
+			const resolvedPath = wellKnownPath ?? this.WELL_KNOWN_PATHS[0];
+			const skillBaseUrl = `${baseUrl.replace(/\/$/, "")}/${resolvedPath}/${entry.name}`;
 			const skillMdUrl = `${skillBaseUrl}/SKILL.md`;
 			const response = await fetch(skillMdUrl);
 			if (!response.ok) return null;
@@ -1581,8 +1609,8 @@ var WellKnownProvider = class {
 		try {
 			const result = await this.fetchIndex(url);
 			if (!result) return [];
-			const { index, resolvedBaseUrl } = result;
-			const skillPromises = index.skills.map((entry) => this.fetchSkillByEntry(resolvedBaseUrl, entry));
+			const { index, resolvedBaseUrl, resolvedWellKnownPath } = result;
+			const skillPromises = index.skills.map((entry) => this.fetchSkillByEntry(resolvedBaseUrl, entry, resolvedWellKnownPath));
 			return (await Promise.all(skillPromises)).filter((s) => s !== null);
 		} catch {
 			return [];
@@ -1592,13 +1620,14 @@ var WellKnownProvider = class {
 		try {
 			const parsed = new URL(url);
 			if (url.toLowerCase().endsWith("/skill.md")) return url;
-			const pathMatch = parsed.pathname.match(/\/.well-known\/skills\/([^/]+)\/?$/);
+			const primaryPath = this.WELL_KNOWN_PATHS[0];
+			const pathMatch = parsed.pathname.match(/\/.well-known\/(?:agent-skills|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(/\/.well-known\/(?:agent-skills|skills)\/.*$/, "");
+				return `${parsed.protocol}//${parsed.host}${basePath}/${primaryPath}/${pathMatch[1]}/SKILL.md`;
 			}
 			const basePath = parsed.pathname.replace(/\/$/, "");
-			return `${parsed.protocol}//${parsed.host}${basePath}/${this.WELL_KNOWN_PATH}/${this.INDEX_FILE}`;
+			return `${parsed.protocol}//${parsed.host}${basePath}/${primaryPath}/${this.INDEX_FILE}`;
 		} catch {
 			return url;
 		}
@@ -1793,7 +1822,7 @@ function createEmptyLocalLock() {
 		skills: {}
 	};
 }
-var version$1 = "1.4.5";
+var version$1 = "1.4.6";
 const isCancelled$1 = (value) => typeof value === "symbol";
 async function isSourcePrivate(source) {
 	const ownerRepo = parseOwnerRepo(source);
@@ -1964,7 +1993,7 @@ async function handleWellKnownSkills(source, url, options, spinner) {
 	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."));
+		Se(import_picocolors.default.red("No skills found at this URL. Make sure the server has a /.well-known/agent-skills/index.json or /.well-known/skills/index.json file."));
 		process.exit(1);
 	}
 	spinner.stop(`Found ${import_picocolors.default.green(skills.length)} skill${skills.length > 1 ? "s" : ""}`);
@@ -4001,6 +4030,11 @@ async function runCheck(args = []) {
 	if (errors.length > 0) {
 		console.log();
 		console.log(`${DIM}Could not check ${errors.length} skill(s) (may need reinstall)${RESET}`);
+		console.log();
+		for (const error of errors) {
+			console.log(`  ${DIM}✗${RESET} ${error.name}`);
+			console.log(`    ${DIM}source: ${error.source}${RESET}`);
+		}
 	}
 	printSkippedSkills(skipped);
 	track({
@@ -4068,9 +4102,14 @@ async function runUpdate() {
 			installUrl = update.entry.sourceUrl.replace(/\.git$/, "").replace(/\/$/, "");
 			installUrl = `${installUrl}/tree/main/${skillFolder}`;
 		}
-		if (spawnSync("npx", [
-			"-y",
-			"skills",
+		const cliEntry = join(__dirname, "..", "bin", "cli.mjs");
+		if (!existsSync(cliEntry)) {
+			failCount++;
+			console.log(`  ${DIM}✗ Failed to update ${update.name}: CLI entrypoint not found at ${cliEntry}${RESET}`);
+			continue;
+		}
+		if (spawnSync(process.execPath, [
+			cliEntry,
 			"add",
 			installUrl,
 			"-g",
@@ -4081,6 +4120,7 @@ async function runUpdate() {
 				"pipe",
 				"pipe"
 			],
+			encoding: "utf-8",
 			shell: process.platform === "win32"
 		}).status === 0) {
 			successCount++;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {
@@ -19,8 +19,8 @@
     "dev": "node src/cli.ts",
     "exec:test": "node scripts/execute-tests.ts",
     "prepublishOnly": "npm run build",
-    "format": "prettier --write 'src/**/*.ts' 'scripts/**/*.ts'",
-    "format:check": "prettier --check 'src/**/*.ts' 'scripts/**/*.ts'",
+    "format": "prettier --write \"src/**/*.ts\" \"scripts/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"scripts/**/*.ts\"",
     "prepare": "husky",
     "test": "vitest",
     "type-check": "tsc --noEmit",
@@ -49,6 +49,7 @@
     "cortex",
     "crush",
     "cursor",
+    "deepagents",
     "droid",
     "gemini-cli",
     "github-copilot",