@agentskillshub/cli 0.2.1 → 0.2.3

package/README.md

@@ -11,7 +11,7 @@ npx @agentskillshub/cli search "scrape a website" --safe
 Discovering a skill is easy. Knowing whether it's safe to run against your credentials is not. `ash` puts the trust signal *before* the install:
 
 ```
-$ ash search postgres --category mcp-server --limit 2
+$ npx @agentskillshub/cli search postgres --category mcp-server --limit 2
 
 call518/MCP-PostgreSQL-Ops  150★  🟢 SAFE
   Give AI assistants full PostgreSQL DBA superpowers — 30+ tools…
@@ -24,12 +24,16 @@ sgaunet/postgresql-mcp  5★  ⚪ UNAUDITED  ~23.0k tok
 
 ## Commands
 
+Run via `npx @agentskillshub/cli <command>`. (A global `npm i -g` also exposes an
+`ash` shorthand — but `ash` is the Almquist shell on Alpine/BusyBox, so the `npx`
+form is the recommended, collision-free way to invoke it.)
+
 | | |
 |---|---|
-| `ash search <query> [filters]` | Find skills. Filters: `--category` `--platform` `--min-stars` `--safe` `--limit` |
-| `ash audit <owner/repo>` | Free basic trust check: security grade + plain-English verdict |
-| `ash install <owner/repo>` | Install commands + "check before you install" safety line |
-| `ash update` | Force-refresh the cached index |
+| `search <query> [filters]` | Find skills. Filters: `--category` `--platform` `--min-stars` `--safe` `--limit` |
+| `audit <owner/repo>` | Free basic trust check: security grade + plain-English verdict |
+| `install <owner/repo>` | Install commands + "check before you install" safety line |
+| `update` | Force-refresh the cached index |
 
 Add `--json` to any of `search` / `audit` / `install` for machine-readable output.
 

package/bin/ash.mjs

@@ -45,6 +45,13 @@ const GRADE = {
 // CJK detection — Chinese queries have no word boundaries, so we bigram them.
 const CJK = /[一-鿿]/;
 
+// Generic terms that appear in ~half the catalog — they drown the distinctive
+// part of a query. Ignored during scoring unless the whole query is generic.
+const STOPWORDS = new Set([
+  "ai", "mcp", "mcps", "agent", "agents", "tool", "tools", "skill", "skills",
+  "server", "servers", "app", "apps", "工具", "服务器", "服务",
+]);
+
 // ─── tiny ANSI (auto-off when not a TTY / NO_COLOR) ──────────────────────────
 const tty = process.stdout.isTTY && !process.env.NO_COLOR;
 const c = (code, s) => (tty ? `\x1b[${code}m${s}\x1b[0m` : s);
@@ -150,8 +157,14 @@ function scoreRow(row, tokens) {
   // English-only repos via our curated scenario titles, and ranks
   // scenario-relevant skills higher. Empty/undefined on older indexes.
   const scen = (row.w || "").toLowerCase();
+  // When the query has a distinctive term, generic tokens (ai/mcp/agent/工具…)
+  // match half the catalog and drown it — "去 AI 味" would rank vercel/ai over
+  // the actual humanizer. Skip generic tokens for scoring UNLESS the whole query
+  // is generic (then they're all we have).
+  const hasContent = tokens.some((t) => !STOPWORDS.has(t));
   let score = 0;
   for (const tok of tokens) {
+    if (hasContent && STOPWORDS.has(tok)) continue;
     if (name === tok) score += 50;
     else if (name.includes(tok)) score += 20;
     if (full.includes(tok)) score += 8;
@@ -322,20 +335,20 @@ function fail(msg) {
   process.exitCode = 1;
 }
 
-const HELP = `${bold("ash")} — AgentSkillsHub CLI  ${dim("· search · audit · install · ~20K skills")}
+const RUN = "npx @agentskillshub/cli";
+const HELP = `${bold("AgentSkillsHub CLI")}  ${dim("· search · audit · install · ~20K skills")}
 
-${bold("Usage")}
-  ash search <query> [--category <c>] [--platform <p>] [--min-stars <n>] [--safe] [--limit <n>] [--json]
-  ash audit  <owner/repo> [--json]
-  ash install <owner/repo> [--json]
-  ash update                      force-refresh the cached index
-  ash --help
+${bold("Usage")}  ${dim("(globally installed? `ash <command>` also works)")}
+  ${RUN} search <query> [--category <c>] [--platform <p>] [--min-stars <n>] [--safe] [--limit <n>] [--json]
+  ${RUN} audit  <owner/repo> [--json]
+  ${RUN} install <owner/repo> [--json]
+  ${RUN} update                  ${dim("force-refresh the cached index")}
 
 ${bold("Examples")}
-  ash search "scrape a website" --safe
-  ash search postgres --category mcp-server --limit 5
-  ash audit modelcontextprotocol/servers
-  ash install owner/repo
+  ${RUN} search "scrape a website" --safe
+  ${RUN} search postgres --category mcp-server --limit 5
+  ${RUN} audit modelcontextprotocol/servers
+  ${RUN} install owner/repo
 
 ${dim("Index is a static CDN file, downloaded once and cached at")} ${CACHE_DIR}
 ${dim("Refreshes every 8h. Zero backend load.  Set NO_COLOR=1 to disable color.")}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskillshub/cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Search, audit, and install open-source AI agent skills & MCP servers from the terminal — security-graded, quality-scored.",
   "type": "module",
   "bin": {