skills 1.3.2 → 1.3.4

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 [36 more](#supported-agents).
+Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [35 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 [Supported Agents](#supported-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                                                                                                           |
 | `-y, --yes`               | Skip all confirmation prompts                                                                                                                      |
@@ -209,7 +209,7 @@ Skills can be installed to any of these agents:
 | Agent | `--agent` | Project Path | Global Path |
 |-------|-----------|--------------|-------------|
 | Amp, Kimi Code CLI | `amp`, `kimi-cli` | `.agents/skills/` | `~/.config/agents/skills/` |
-| Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/global_skills/` |
+| Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
 | Augment | `augment` | `.augment/rules/` | `~/.augment/rules/` |
 | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
 | OpenClaw | `openclaw` | `skills/` | `~/.moltbot/skills/` |
@@ -233,7 +233,6 @@ Skills can be installed to any of these agents:
 | Mistral Vibe | `mistral-vibe` | `.vibe/skills/` | `~/.vibe/skills/` |
 | Mux | `mux` | `.mux/skills/` | `~/.mux/skills/` |
 | OpenCode | `opencode` | `.opencode/skills/` | `~/.config/opencode/skills/` |
-| OpenClaude IDE | `openclaude` | `.openclaude/skills/` | `~/.openclaude/skills/` |
 | OpenHands | `openhands` | `.openhands/skills/` | `~/.openhands/skills/` |
 | Pi | `pi` | `.pi/skills/` | `~/.pi/agent/skills/` |
 | Qoder | `qoder` | `.qoder/skills/` | `~/.qoder/skills/` |
@@ -341,7 +340,6 @@ The CLI searches for skills in these locations within a repository:
 - `.vibe/skills/`
 - `.mux/skills/`
 - `.opencode/skills/`
-- `.openclaude/skills/`
 - `.openhands/skills/`
 - `.pi/skills/`
 - `.qoder/skills/`
@@ -355,6 +353,24 @@ The CLI searches for skills in these locations within a repository:
 - `.adal/skills/`
 <!-- skill-discovery:end -->
 
+### Plugin Manifest Discovery
+
+If `.claude-plugin/marketplace.json` or `.claude-plugin/plugin.json` exists, skills declared in those files are also discovered:
+
+```json
+// .claude-plugin/marketplace.json
+{
+  "metadata": { "pluginRoot": "./plugins" },
+  "plugins": [{
+    "name": "my-plugin",
+    "source": "my-plugin",
+    "skills": ["./skills/review", "./skills/test"]
+  }]
+}
+```
+
+This enables compatibility with the [Claude Code plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces) ecosystem.
+
 If no skills are found in standard locations, a recursive search is performed.
 
 ## Compatibility

package/dist/cli.mjs

@@ -364,6 +364,41 @@ async function cleanupTempDir(dir) {
 	});
 }
 var import_gray_matter = /* @__PURE__ */ __toESM(require_gray_matter(), 1);
+function isContainedIn(targetPath, basePath) {
+	const normalizedBase = normalize(resolve(basePath));
+	const normalizedTarget = normalize(resolve(targetPath));
+	return normalizedTarget.startsWith(normalizedBase + sep) || normalizedTarget === normalizedBase;
+}
+function isValidRelativePath(path) {
+	return path.startsWith("./");
+}
+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;
+}
 const SKIP_DIRS = [
 	"node_modules",
 	".git",
@@ -445,7 +480,6 @@ async function discoverSkills(basePath, subpath, options) {
 		join(searchPath, ".kiro/skills"),
 		join(searchPath, ".mux/skills"),
 		join(searchPath, ".neovate/skills"),
-		join(searchPath, ".openclaude/skills"),
 		join(searchPath, ".opencode/skills"),
 		join(searchPath, ".openhands/skills"),
 		join(searchPath, ".pi/skills"),
@@ -455,6 +489,7 @@ async function discoverSkills(basePath, subpath, options) {
 		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()) {
@@ -509,7 +544,7 @@ const agents = {
 		name: "antigravity",
 		displayName: "Antigravity",
 		skillsDir: ".agent/skills",
-		globalSkillsDir: join(home, ".gemini/antigravity/global_skills"),
+		globalSkillsDir: join(home, ".gemini/antigravity/skills"),
 		detectInstalled: async () => {
 			return existsSync(join(process.cwd(), ".agent")) || existsSync(join(home, ".gemini/antigravity"));
 		}
@@ -730,15 +765,6 @@ const agents = {
 			return existsSync(join(configHome, "opencode")) || existsSync(join(claudeHome, "skills"));
 		}
 	},
-	openclaude: {
-		name: "openclaude",
-		displayName: "OpenClaude IDE",
-		skillsDir: ".openclaude/skills",
-		globalSkillsDir: join(home, ".openclaude/skills"),
-		detectInstalled: async () => {
-			return existsSync(join(home, ".openclaude")) || existsSync(join(process.cwd(), ".openclaude"));
-		}
-	},
 	openhands: {
 		name: "openhands",
 		displayName: "OpenHands",
@@ -1674,7 +1700,7 @@ async function saveSelectedAgents(agents) {
 	lock.lastSelectedAgents = agents;
 	await writeSkillLock(lock);
 }
-var version$1 = "1.3.2";
+var version$1 = "1.3.4";
 const isCancelled = (value) => typeof value === "symbol";
 async function isSourcePrivate(source) {
 	const ownerRepo = parseOwnerRepo(source);
@@ -2902,7 +2928,7 @@ async function searchSkillsAPI(query) {
 		return (await res.json()).skills.map((skill) => ({
 			name: skill.name,
 			slug: skill.id,
-			source: skill.topSource || "",
+			source: skill.source || "",
 			installs: skill.installs
 		}));
 	} catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {
@@ -62,7 +62,6 @@
     "mistral-vibe",
     "mux",
     "opencode",
-    "openclaude",
     "openhands",
     "pi",
     "qoder",