skillmds 1.0.13 → 1.0.15

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to `skillmds` are documented here. Versions follow [semver](https://semver.org).
 
+## 1.0.15
+
+- Search is now **browsable in the interactive menu**: arrow through results, press Enter on one to see a card, and install it to your project or user directory — all without leaving the CLI (`← Back` at each level; Esc goes up one step, never quits).
+- Search results are clean two-line entries showing the source repo's **star count** (e.g. `★ 223.7k`) instead of the placeholder rating, with the description truncated to fit your terminal.
+- Fixes for narrow terminals: result rows are width-budgeted so they don't wrap and garble the menu; the result card prints once instead of repainting on every action.
+
+## 1.0.14
+
+- Interactive menu (`skillmds` in a terminal) no longer exits after one action — it returns to the menu until you pick **Quit**; cancelling a sub-prompt goes back to the menu instead of quitting.
+- "List installed skills" now shows project **and** global skills together, tagged `[agent/scope]`, replacing the misleading "Include global skills?" prompt (which actually toggled global-only vs project-only). Invalid skills show the parse reason.
+- The in-menu command reference now includes `info`.
+
 ## 1.0.13
 
 Safe & easy installs release.

package/dist/cli.js

@@ -795,6 +795,34 @@ ${skill.body_md || ""}`;
 }
 
 // ../cli/src/commands/search.ts
+var MAX_LINE_WIDTH = 100;
+function formatStars(n) {
+  if (n >= 1e6) {
+    const m = Math.round(n / 1e6 * 10) / 10;
+    return `${m % 1 === 0 ? m.toFixed(0) : m.toFixed(1)}M`;
+  }
+  if (n >= 1e3) {
+    const k = Math.round(n / 1e3 * 10) / 10;
+    return `${k % 1 === 0 ? k.toFixed(0) : k.toFixed(1)}k`;
+  }
+  return String(n);
+}
+function truncate(text3, width) {
+  if (text3.length <= width) return text3;
+  if (width <= 1) return "\u2026";
+  return `${text3.slice(0, width - 1).trimEnd()}\u2026`;
+}
+function formatSearchResult(item, width = process.stdout.columns ?? 80) {
+  const stars = item.repo_stars != null ? pc5.dim(`\u2605 ${formatStars(item.repo_stars)}`) : "";
+  const check = item.verified ? pc5.green("\u2713") : "";
+  const pack = item.type === "pack" ? pc5.dim("[pack]") : "";
+  const head = [pc5.bold(item.slug), stars, check, pack].filter(Boolean).join(" ");
+  const indent = "  ";
+  const lineWidth = Math.max(10, Math.min(width, MAX_LINE_WIDTH) - indent.length);
+  const desc = `${indent}${pc5.dim(truncate(item.description ?? "", lineWidth))}`;
+  return `${head}
+${desc}`;
+}
 async function runSearch(query, flags) {
   const { api } = createClient(flags);
   const params = new URLSearchParams({ q: query, limit: String(flags.limit ?? 20) });
@@ -805,13 +833,8 @@ async function runSearch(query, flags) {
   const r = await api(`/api/search?${params}`);
   const items = r.items ?? [];
   if (flags.json) return { items, output: JSON.stringify(items, null, 2) };
-  const lines = items.map((s) => {
-    const check = s.verified ? pc5.green("\u2713") : " ";
-    const rating = s.avg_rating ? pc5.dim(`\u2605${s.avg_rating.toFixed(1)} (${s.rating_count ?? 0})`) : "";
-    return `${check} ${pc5.bold(s.slug)} ${rating}
-    ${pc5.dim(s.description)}`;
-  });
-  return { items, output: lines.join("\n") || "No skills found." };
+  const lines = items.map((s) => formatSearchResult(s));
+  return { items, output: lines.join("\n\n") || "No skills found." };
 }
 function searchCommand() {
   return new Command5("search").description("Search the SkillMD registry").argument("<query>", "search terms").option("--category <slug>", "filter by category").option("--verified", "only verified skills").option("--type <type>", "single | pack").option("--min-rating <n>", "minimum average rating (0-5)").option("--limit <n>", "max results", "20").option("--json", "machine-readable output").action(async (query, opts, cmd) => {
@@ -1250,103 +1273,170 @@ function bail(v) {
   }
   return false;
 }
+async function browseSearchResults(items) {
+  const cols = process.stdout.columns ?? 80;
+  for (; ; ) {
+    const picked = await p4.select({
+      message: "Search results",
+      options: [
+        ...items.map((item2) => {
+          const starsTxt = item2.repo_stars != null ? ` \u2605${formatStars(item2.repo_stars)}` : "";
+          const checkTxt = item2.verified ? " \u2713" : "";
+          const plainLabel = `${item2.slug}${starsTxt}${checkTxt}`;
+          const label2 = `${pc12.bold(item2.slug)}${starsTxt ? pc12.dim(starsTxt) : ""}${checkTxt ? pc12.green(checkTxt) : ""}`;
+          const hintWidth = Math.max(10, cols - plainLabel.length - 6);
+          return {
+            value: item2.slug,
+            label: label2,
+            hint: truncate(item2.description ?? "", hintWidth)
+          };
+        }),
+        { value: "__back", label: "\u2190 Back to menu" }
+      ]
+    });
+    if (p4.isCancel(picked) || picked === "__back") return;
+    const item = items.find((i) => i.slug === picked);
+    if (!item) continue;
+    await browseOneResult(item);
+  }
+}
+async function browseOneResult(item) {
+  const starsTxt = item.repo_stars != null ? `\u2605 ${formatStars(item.repo_stars)} stars` : "";
+  const meta = [
+    starsTxt,
+    item.verified ? pc12.green("\u2713 verified") : "unverified",
+    item.type === "pack" ? "pack" : ""
+  ].filter(Boolean).join(" \xB7 ");
+  p4.note([item.description ?? "", pc12.dim(meta)].join("\n"), item.slug);
+  for (; ; ) {
+    const action = await p4.select({
+      message: "What next?",
+      options: [
+        { value: "project", label: "Install to this project" },
+        { value: "global", label: "Install globally (user dir)" },
+        { value: "url", label: "Show page URL" },
+        { value: "back", label: "\u2190 Back to results" }
+      ]
+    });
+    if (p4.isCancel(action) || action === "back") return;
+    if (action === "url") {
+      p4.log.message(pc12.dim(`https://skillmd.com/skills/${item.slug}`));
+      continue;
+    }
+    p4.log.step(`Installing ${item.slug}\u2026`);
+    try {
+      const run = await runAdd(item.slug, action === "global" ? { global: true } : {});
+      console.log(run.output);
+      if (run.exitCode === 0) p4.log.success("Installed.");
+      else p4.log.warn("Not installed.");
+    } catch (err) {
+      p4.log.error(err instanceof Error ? err.message : String(err));
+    }
+  }
+}
 async function runInteractive() {
   p4.intro(pc12.bgCyan(pc12.black(" skillmd ")));
-  const action = await p4.select({
-    message: "What would you like to do?",
-    options: [
-      { value: "lint", label: "Lint a skill", hint: "validate a SKILL.md" },
-      { value: "scan", label: "Security scan", hint: "scripts, network, secrets" },
-      { value: "search", label: "Search the registry" },
-      { value: "init", label: "Create a new skill" },
-      { value: "list", label: "List installed skills" },
-      { value: "help", label: "Show all commands" }
-    ]
-  });
-  if (bail(action)) return;
-  switch (action) {
-    case "lint":
-    case "scan": {
-      const path = await p4.text({ message: "Path to a skill or folder", placeholder: ".", defaultValue: "." });
-      if (bail(path)) return;
-      const target = String(path || ".");
-      const s = p4.spinner();
-      s.start(action === "lint" ? "Linting" : "Scanning");
-      try {
-        const run = action === "lint" ? await runLint(target, { format: "text" }) : await runScan(target, { format: "text" });
-        s.stop("Done");
-        console.log(run.output);
-        process.exitCode = run.exitCode;
-      } catch (err) {
-        s.stop(pc12.red(err instanceof Error ? err.message : String(err)));
-        process.exitCode = 1;
+  for (; ; ) {
+    const action = await p4.select({
+      message: "What would you like to do?",
+      options: [
+        { value: "lint", label: "Lint a skill", hint: "validate a SKILL.md" },
+        { value: "scan", label: "Security scan", hint: "scripts, network, secrets" },
+        { value: "search", label: "Search the registry" },
+        { value: "init", label: "Create a new skill" },
+        { value: "list", label: "List installed skills" },
+        { value: "help", label: "Show all commands" },
+        { value: "quit", label: "Quit" }
+      ]
+    });
+    if (bail(action) || action === "quit") break;
+    switch (action) {
+      case "lint":
+      case "scan": {
+        const path = await p4.text({ message: "Path to a skill or folder", placeholder: ".", defaultValue: "." });
+        if (bail(path)) break;
+        const target = String(path || ".");
+        const s = p4.spinner();
+        s.start(action === "lint" ? "Linting" : "Scanning");
+        try {
+          const run = action === "lint" ? await runLint(target, { format: "text" }) : await runScan(target, { format: "text" });
+          s.stop("Done");
+          console.log(run.output);
+          process.exitCode = run.exitCode;
+        } catch (err) {
+          s.stop(pc12.red(err instanceof Error ? err.message : String(err)));
+          process.exitCode = 1;
+        }
+        break;
       }
-      break;
-    }
-    case "search": {
-      const query = await p4.text({ message: "Search the registry for" });
-      if (bail(query)) return;
-      const verified = await p4.confirm({ message: "Verified skills only?", initialValue: false });
-      if (bail(verified)) return;
-      const s = p4.spinner();
-      s.start("Searching");
-      try {
-        const run = await runSearch(String(query), { verified: Boolean(verified), limit: "20" });
-        s.stop(`${run.items.length} result${run.items.length === 1 ? "" : "s"}`);
-        console.log(run.output);
-      } catch (err) {
-        s.stop(pc12.red(err instanceof Error ? err.message : String(err)));
-        process.exitCode = 1;
+      case "search": {
+        const query = await p4.text({ message: "Search the registry for" });
+        if (bail(query)) break;
+        const verified = await p4.confirm({ message: "Verified skills only?", initialValue: false });
+        if (bail(verified)) break;
+        const s = p4.spinner();
+        s.start("Searching");
+        try {
+          const run = await runSearch(String(query), { verified: Boolean(verified), limit: "20" });
+          s.stop(`${run.items.length} result${run.items.length === 1 ? "" : "s"}`);
+          if (run.items.length === 0) {
+            p4.log.info("No results.");
+            break;
+          }
+          await browseSearchResults(run.items);
+        } catch (err) {
+          s.stop(pc12.red(err instanceof Error ? err.message : String(err)));
+          process.exitCode = 1;
+        }
+        break;
       }
-      break;
-    }
-    case "init": {
-      const name = await p4.text({ message: "Skill name", placeholder: "my-skill" });
-      if (bail(name)) return;
-      const description = await p4.text({ message: "One-line description", placeholder: "What this skill helps an agent do" });
-      if (bail(description)) return;
-      try {
-        const file = initSkill(String(name), { description: String(description || "") });
-        p4.log.success(`Created ${pc12.bold(file)}`);
-      } catch (err) {
-        p4.log.error(err instanceof Error ? err.message : String(err));
-        process.exitCode = 1;
+      case "init": {
+        const name = await p4.text({ message: "Skill name", placeholder: "my-skill" });
+        if (bail(name)) break;
+        const description = await p4.text({ message: "One-line description", placeholder: "What this skill helps an agent do" });
+        if (bail(description)) break;
+        try {
+          const file = initSkill(String(name), { description: String(description || "") });
+          p4.log.success(`Created ${pc12.bold(file)}`);
+        } catch (err) {
+          p4.log.error(err instanceof Error ? err.message : String(err));
+          process.exitCode = 1;
+        }
+        break;
       }
-      break;
-    }
-    case "list": {
-      const global = await p4.confirm({ message: "Include global skills?", initialValue: true });
-      if (bail(global)) return;
-      const skills = installedSkills({ global: Boolean(global) });
-      if (skills.length === 0) {
-        p4.log.info("No installed skills found.");
-      } else {
-        p4.log.message(
-          skills.map((sk) => {
-            const parsed = parseSkillMd(sk.raw);
-            const desc = "error" in parsed ? pc12.red("(invalid)") : pc12.dim(parsed.description.slice(0, 70));
-            return `${pc12.bold(sk.name)} ${pc12.dim(`[${sk.agent}]`)}
+      case "list": {
+        const skills = [...installedSkills({}), ...installedSkills({ global: true })];
+        if (skills.length === 0) {
+          p4.log.info("No installed skills found (checked this folder and your user directory).");
+        } else {
+          p4.log.message(
+            skills.map((sk) => {
+              const parsed = parseSkillMd(sk.raw);
+              const desc = "error" in parsed ? pc12.red(`(invalid SKILL.md \u2014 ${parsed.error})`) : pc12.dim(parsed.description.slice(0, 70));
+              return `${pc12.bold(sk.name)} ${pc12.dim(`[${sk.agent}/${sk.scope}]`)}
   ${desc}`;
-          }).join("\n")
+            }).join("\n")
+          );
+        }
+        break;
+      }
+      case "help": {
+        p4.note(
+          [
+            `${pc12.bold("lint")} [path]      validate SKILL.md + quality score`,
+            `${pc12.bold("scan")} [path]      security scan`,
+            `${pc12.bold("search")} <query>   search the registry`,
+            `${pc12.bold("add")} <source>     install a skill (lints first)`,
+            `${pc12.bold("info")} <slug>      registry details for a skill`,
+            `${pc12.bold("init")} [name]      scaffold a new skill`,
+            `${pc12.bold("list / remove / update")}   manage installed skills`,
+            `${pc12.bold("publish")} [path]   publish (fails on lint errors)`,
+            `${pc12.bold("rules / login")}`
+          ].join("\n"),
+          "Commands (run: skillmd <command>)"
         );
+        break;
       }
-      break;
-    }
-    case "help": {
-      p4.note(
-        [
-          `${pc12.bold("lint")} [path]      validate SKILL.md + quality score`,
-          `${pc12.bold("scan")} [path]      security scan`,
-          `${pc12.bold("search")} <query>   search the registry`,
-          `${pc12.bold("add")} <source>     install a skill (lints first)`,
-          `${pc12.bold("init")} [name]      scaffold a new skill`,
-          `${pc12.bold("list / remove / update")}   manage installed skills`,
-          `${pc12.bold("publish")} [path]   publish (fails on lint errors)`,
-          `${pc12.bold("rules / login")}`
-        ].join("\n"),
-        "Commands (run: skillmd <command>)"
-      );
-      break;
     }
   }
   p4.outro(pc12.dim("skillmd.com"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillmds",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "SkillMD for agents: the `skillmds` MCP server + the `skillmd` CLI (lint, scan, search, install, publish Agent Skills) from skillmd.com.",
   "type": "module",
   "bin": {