playbooks 0.1.18 → 0.1.20

package/README.md

@@ -268,8 +268,9 @@ Skills can be installed to any of these supported agents. Use `-g, --global` to
 | Codex | `codex` | `.agents/skills/` | `~/.agents/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` | `.cursor/skills/` | `~/.cursor/skills/` |
+| Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
 | Droid | `droid` | `.agents/skills/` | `~/.agents/skills/` |
 | Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.agents/skills/` |
 | GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.agents/skills/` |
@@ -297,6 +298,7 @@ Skills can be installed to any of these supported agents. Use `-g, --global` to
 | Trae CN | `trae-cn` | `.trae/skills/` | `~/.trae-cn/skills/` |
 | Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
 | Zencoder | `zencoder` | `.zencoder/skills/` | `~/.zencoder/skills/` |
+| Universal | `universal` | `.agents/skills/` | `~/.agents/skills/` |
 <!-- available-agents:end -->
 
 > [!NOTE]
@@ -360,8 +362,8 @@ The CLI searches for skills in these locations within a repository:
 - `.codebuddy/skills/`
 - `.commandcode/skills/`
 - `.continue/skills/`
+- `.cortex/skills/`
 - `.crush/skills/`
-- `.cursor/skills/`
 - `.goose/skills/`
 - `.iflow/skills/`
 - `.junie/skills/`

package/dist/index.js

@@ -8,7 +8,7 @@ import { program } from "commander";
 // package.json
 var package_default = {
   name: "playbooks",
-  version: "0.1.18",
+  version: "0.1.20",
   description: "Install agent skills, MCPs and docs into your coding agents from any git repository.",
   type: "module",
   bin: {
@@ -53,6 +53,7 @@ var package_default = {
     "codex",
     "command-code",
     "continue",
+    "cortex",
     "crush",
     "cursor",
     "droid",
@@ -81,7 +82,8 @@ var package_default = {
     "trae",
     "trae-cn",
     "windsurf",
-    "zencoder"
+    "zencoder",
+    "universal"
   ],
   homepage: "https://playbooks.com",
   author: "",
@@ -208,6 +210,15 @@ var agents = {
       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",
@@ -220,7 +231,7 @@ var agents = {
   cursor: {
     name: "cursor",
     displayName: "Cursor",
-    skillsDir: ".cursor/skills",
+    skillsDir: ".agents/skills",
     globalSkillsDir: join(home, ".cursor/skills"),
     detectInstalled: async () => existsSync(join(home, ".cursor"))
   },
@@ -466,6 +477,14 @@ var agents = {
     detectInstalled: async () => {
       return existsSync(join(home, ".zencoder"));
     }
+  },
+  universal: {
+    name: "universal",
+    displayName: "Universal",
+    skillsDir: ".agents/skills",
+    globalSkillsDir: universalGlobalSkillsDir,
+    showInUniversalList: false,
+    detectInstalled: async () => false
   }
 };
 async function detectInstalledAgents() {
@@ -478,7 +497,9 @@ async function detectInstalledAgents() {
   return results.filter((r) => r.installed).map((r) => r.type);
 }
 function getUniversalAgents() {
-  return Object.entries(agents).filter(([_, config]) => config.skillsDir === ".agents/skills").map(([type]) => type);
+  return Object.entries(agents).filter(
+    ([_, config]) => config.skillsDir === ".agents/skills" && config.showInUniversalList !== false
+  ).map(([type]) => type);
 }
 function getNonUniversalAgents() {
   return Object.entries(agents).filter(([_, config]) => config.skillsDir !== ".agents/skills").map(([type]) => type);
@@ -758,6 +779,9 @@ async function parseSkillMd(skillMdPath) {
     if (!data.name || !data.description) {
       return null;
     }
+    if (typeof data.name !== "string" || typeof data.description !== "string") {
+      return null;
+    }
     return {
       name: data.name,
       description: data.description,
@@ -863,6 +887,7 @@ async function discoverSkills(basePath, subpath) {
     join3(searchPath, ".codex/skills"),
     join3(searchPath, ".commandcode/skills"),
     join3(searchPath, ".continue/skills"),
+    join3(searchPath, ".cortex/skills"),
     join3(searchPath, ".crush/skills"),
     join3(searchPath, ".cursor/skills"),
     join3(searchPath, ".factory/skills"),
@@ -7009,10 +7034,23 @@ var formatStars = (value) => {
   }
   return `${value}`;
 };
+var formatInstalls = (value) => {
+  if (!value || value <= 0) return "";
+  if (value >= 1e6) {
+    const rounded = (value / 1e6).toFixed(1).replace(/\.0$/, "");
+    return `${rounded}M`;
+  }
+  if (value >= 1e3) {
+    const rounded = (value / 1e3).toFixed(1).replace(/\.0$/, "");
+    return `${rounded}k`;
+  }
+  return `${value}`;
+};
 var buildLabel = (result) => {
   const owner = result.repoOwner ?? "unknown";
   const repo = result.repoName ?? "repo";
   const stars = formatStars(result.stars ?? null);
+  const installs = formatInstalls(result.installCount ?? null);
   const suffixParts = [];
   if (result.isOfficial) {
     suffixParts.push("official");
@@ -7020,6 +7058,9 @@ var buildLabel = (result) => {
   if (stars) {
     suffixParts.push(`stars:${stars}`);
   }
+  if (installs) {
+    suffixParts.push(`installs:${installs}`);
+  }
   const suffix = suffixParts.length > 0 ? ` ${suffixParts.join(" | ")}` : "";
   return `${result.name} (${owner}/${repo})${suffix}`.trim();
 };
@@ -9622,13 +9663,27 @@ function formatFindSkillMarkdown(query, outcome) {
       continue;
     }
     const tag = result.isOfficial ? "[official]" : "[community]";
-    lines.push(`- ${tag} npx playbooks add skill ${repo} --skill ${skillName}`);
+    const installs = formatInstallCount(result.installCount ?? null);
+    const installsText = installs ? ` ${installs}` : "";
+    lines.push(`- ${tag}${installsText} npx playbooks add skill ${repo} --skill ${skillName}`);
     if (description) {
       lines.push(`  ${truncateLine(description, 140)}`);
     }
   }
   return lines.join("\n");
 }
+function formatInstallCount(value) {
+  if (!value || value <= 0) return "";
+  if (value >= 1e6) {
+    const rounded = (value / 1e6).toFixed(1).replace(/\.0$/, "");
+    return `(${rounded}M installs)`;
+  }
+  if (value >= 1e3) {
+    const rounded = (value / 1e3).toFixed(1).replace(/\.0$/, "");
+    return `(${rounded}k installs)`;
+  }
+  return `(${value} install${value === 1 ? "" : "s"})`;
+}
 function truncateLine(value, maxLength) {
   if (value.length <= maxLength) return value;
   const sliced = value.slice(0, Math.max(0, maxLength - 1)).trimEnd();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playbooks",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Install agent skills, MCPs and docs into your coding agents from any git repository.",
   "type": "module",
   "bin": {
@@ -45,6 +45,7 @@
     "codex",
     "command-code",
     "continue",
+    "cortex",
     "crush",
     "cursor",
     "droid",
@@ -73,7 +74,8 @@
     "trae",
     "trae-cn",
     "windsurf",
-    "zencoder"
+    "zencoder",
+    "universal"
   ],
   "homepage": "https://playbooks.com",
   "author": "",