skills-atlas-cli 0.13.0 → 0.15.0

package/README.md

@@ -7,6 +7,11 @@
 Code.** Stop guessing which skill fits or copy-pasting from random repos. Search a
 curated catalog of **800+ skills** and drop the right one into `.claude/skills/` in seconds.
 
+> 🧩 **Using Claude Code? The easiest way is the [Skills Atlas plugin](./plugin).** It runs
+> on this CLI and brings everything into the conversation — an **autopilot that's on by
+> default** (the right skill finds you as you work) plus slash commands. Install this CLI as
+> the engine, then add the plugin (two lines). → [**plugin docs**](./plugin)
+
 > **New to "skills"?** A skill is a reusable `SKILL.md` instruction pack that teaches
 > Claude Code a specialized workflow: systematic debugging, pre-mortems, SEO audits,
 > PDF translation, and hundreds more. This tool finds and installs them for you.
@@ -129,17 +134,24 @@ skills-atlas registry remove https://skills.acme.internal/data.json
 
 Private skills merge with the public catalog (your own wins a name clash) and are cached locally.
 
-## In Claude Code
+## In Claude Code — the plugin (recommended)
 
-A thin [Claude Code plugin](./plugin) lets Claude do all of this in-conversation.
-Just describe what you need, or use `/skills-atlas:skill-search`, `:skill-info`,
-`:skill-install`:
+The **[Skills Atlas plugin](./plugin)** wraps this CLI so Claude does it all
+in-conversation: an **autopilot on by default** that surfaces the fitting skill as you
+work, plus slash commands (`/skills-atlas:skill-search`, `:skill-install`, `:skill-kit`,
+`:skill-craft`, …). Install this CLI first (the engine), then add the plugin:
 
 ```text
-/plugin marketplace add Zita-Go/Skills-Atlas
+npm i -g skills-atlas-cli                      # the engine (Node 18+)
+/plugin marketplace add Zita-Go/Skills-Atlas   # then, inside Claude Code:
 /plugin install skills-atlas@skills-atlas
 ```
 
+Restart Claude Code, run `/skills-atlas:setup`, and you're set. → [**plugin docs**](./plugin)
+
+<img src="https://raw.githubusercontent.com/Zita-Go/Skills-Atlas/main/docs/plugin-demo.png" alt="Skills Atlas plugin — the autopilot surfaces a fitting skill in-conversation" width="820">
+
+
 ## In any MCP client
 
 `skills-atlas mcp` runs an [MCP](https://modelcontextprotocol.io) server so any

package/bin/skills.js

@@ -22,12 +22,14 @@ const setup = require('../src/commands/setup');
 const feedback = require('../src/commands/feedback');
 const update = require('../src/commands/update');
 const mcp = require('../src/commands/mcp');
+const telemetry = require('../src/telemetry');
+const telemetryCmd = require('../src/commands/telemetry');
 const { categories, list } = require('../src/commands/categories');
 
 const VERSION = require('../package.json').version;
 // `use` = install + activate inline (emit the SKILL.md so an agent follows it now).
 const use = argv => install([...argv, '--inline']);
-const commands = { search, info, install, use, kit, sync, installed, upgrade, remove, outdated, doctor, suggest, hook, gaps, 'gap-analyze': gapAnalyze, craft, prune, feedback, setup, update, categories, list, registry, mcp };
+const commands = { search, info, install, use, kit, sync, installed, upgrade, remove, outdated, doctor, suggest, hook, gaps, 'gap-analyze': gapAnalyze, craft, prune, feedback, setup, update, categories, list, registry, mcp, telemetry: telemetryCmd };
 
 const HELP = `skills-atlas — search, install & manage AI agent skills
 
@@ -57,6 +59,7 @@ autopilot (opt-in):
   craft              codify a workflow you keep repeating into a new local skill (Claude drafts it)
   prune              installed skills you no longer use — Claude suggests removing them
   feedback           what the autopilot learned from your installs/removes (sharpens it)
+  telemetry on|off|status  anonymous opt-out usage telemetry (no prompts/paths/identity)
 
 catalog:
   update             refresh the catalog from the public data feed
@@ -87,7 +90,13 @@ async function main() {
   if (sub !== 'update' && sub !== 'gap-analyze' && sub !== 'setup' && !process.env.SKILLS_ATLAS_SUBCALL) {
     try { require('../src/data').maybeBackgroundRefresh(); } catch { /* ignore */ }
   }
-  await cmd(rest);
+  if (sub !== 'telemetry' && !process.env.SKILLS_ATLAS_SUBCALL) telemetry.emit('cli_cmd', { target: sub });
+  try {
+    await cmd(rest);
+  } catch (e) {
+    telemetry.emit('cli_err', { target: sub, detail: String(e && e.message || e).slice(0, 200) });
+    throw e;
+  }
 }
 
 main().catch(err => {

package/bin/telemetry-send.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+'use strict';
+// Detached sender. Reads {endpoint, client, events} from the temp file in argv[2], POSTs once
+// with a short timeout, then deletes the file. Fully fail-silent — telemetry must never matter.
+const fs = require('fs');
+const file = process.argv[2];
+const cleanup = () => { try { fs.unlinkSync(file); } catch { /* ignore */ } };
+if (!file) process.exit(0);
+let p; try { p = JSON.parse(fs.readFileSync(file, 'utf8')); } catch { cleanup(); process.exit(0); }
+if (!p || !p.endpoint || !Array.isArray(p.events) || !p.events.length) { cleanup(); process.exit(0); }
+try {
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), 2000);
+  fetch(p.endpoint, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ client: p.client, events: p.events }),
+    signal: ac.signal,
+  }).catch(() => {}).finally(() => { clearTimeout(timer); cleanup(); });
+} catch { cleanup(); }