skillmds 1.0.14 → 1.0.15

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 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.

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,6 +1273,67 @@ 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 ")));
   for (; ; ) {
@@ -1295,7 +1379,11 @@ async function runInteractive() {
         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);
+          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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillmds",
-  "version": "1.0.14",
+  "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": {