skill-studio 0.0.0 → 0.1.0

package/README.md

@@ -1,5 +1,77 @@
 # skill-studio
 
-This name is reserved for Skill Studio, a desktop app and CLI for managing agent skills.
+Tidy up your agent skills. `skill-studio` finds your skills across Claude Code, Codex, OpenCode, pi, Cursor, Grok Build and the shared `.agents` folder. It finds broken, duplicate and unused skills. You can undo most changes.
 
-Source: https://github.com/sergical/agent-studio
+It runs on macOS, on Apple silicon and Intel Macs. It needs Node.js 18 or later.
+
+## Run it
+
+```bash
+npx skill-studio diagnose
+```
+
+Or install it:
+
+```bash
+npm install -g skill-studio
+skill-studio --help
+```
+
+Some commands:
+
+- `skill-studio scan` lists every skill installed for your agents.
+- `skill-studio diagnose` finds broken skills and says what is wrong with each.
+- `skill-studio usage` shows which skills your agents used, and which they never used.
+- `skill-studio park <skill>` turns a skill off for all agents. `skill-studio unpark <skill>` turns it on again.
+- `skill-studio undo` reverses your last install, remove, update, split or on/off change. It does not undo park or unpark. It skips them and reverses the change before them. To undo a park, run `skill-studio unpark <skill>`.
+
+## Use it from your agent (MCP)
+
+`skill-studio mcp` starts an MCP server. Add it to your agent:
+
+Claude Code:
+
+```bash
+claude mcp add --transport stdio skill-studio -- npx -y skill-studio mcp
+```
+
+Codex:
+
+```bash
+codex mcp add skill-studio -- npx -y skill-studio mcp
+```
+
+The first `npx` download can take more than ten seconds. If Codex stops waiting, set `startup_timeout_sec = 30` under `[mcp_servers.skill-studio]` in `~/.codex/config.toml`.
+
+Cursor, in `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "skill-studio": { "command": "npx", "args": ["-y", "skill-studio", "mcp"] }
+  }
+}
+```
+
+OpenCode, in `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "skill-studio": {
+      "type": "local",
+      "command": ["npx", "-y", "skill-studio", "mcp"],
+      "enabled": true
+    }
+  }
+}
+```
+
+## Privacy
+
+No account. It runs on your Mac. It can send anonymous crash reports, which you can turn off.
+
+## License
+
+MIT

package/bin/skill-studio.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// Runs the native skill-studio binary from the platform package that npm
+// installed through optionalDependencies (@skill-studio/cli-<os>-<arch>).
+"use strict";
+
+const { spawn } = require("node:child_process");
+const { constants } = require("node:os");
+
+const platformPackage = `@skill-studio/cli-${process.platform}-${process.arch}`;
+
+let binaryPath;
+try {
+  binaryPath = require.resolve(`${platformPackage}/bin/skill-studio`);
+} catch {
+  process.stderr.write(
+    `skill-studio: could not find ${platformPackage}.\n` +
+      "skill-studio runs on macOS only, on Apple silicon (arm64) and Intel (x64) Macs.\n" +
+      "On a Mac, install it again without skipping optional packages:\n" +
+      "  npm install -g skill-studio --include=optional\n",
+  );
+  process.exit(1);
+}
+
+// Async spawn, not spawnSync: `skill-studio mcp` is a long-lived stdio server,
+// and the launcher must stay responsive to forward signals to it.
+const child = spawn(binaryPath, process.argv.slice(2), { stdio: "inherit" });
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"];
+for (const signal of forwardedSignals) {
+  process.on(signal, () => child.kill(signal));
+}
+
+child.on("error", (error) => {
+  process.stderr.write(`skill-studio: could not start ${binaryPath}: ${error.message}\n`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    // Die from the same signal so the caller sees the real cause. The
+    // forwarding handlers must go first, or they would swallow it. Node
+    // ignores some signals (SIGPIPE), so also set the shell's 128+N code.
+    for (const forwarded of forwardedSignals) process.removeAllListeners(forwarded);
+    process.exitCode = 128 + (constants.signals[signal] ?? 0);
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/package.json

@@ -1,12 +1,34 @@
 {
   "name": "skill-studio",
-  "version": "0.0.0",
-  "description": "Skill Studio: manage, sync and test agent skills across Claude Code, Codex, OpenCode, pi, Cursor and Grok Build. Name reserved; the CLI ships here later.",
+  "version": "0.1.0",
+  "description": "Check, park and clean up the agent skills on your Mac, from the terminal or an MCP client.",
+  "keywords": [
+    "agent-skills",
+    "claude-code",
+    "codex",
+    "cursor",
+    "mcp",
+    "opencode",
+    "skills"
+  ],
+  "homepage": "https://github.com/sergical/skill-studio#readme",
+  "bugs": "https://github.com/sergical/skill-studio/issues",
   "license": "MIT",
-  "homepage": "https://github.com/sergical/agent-studio",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sergical/agent-studio.git"
+    "url": "git+https://github.com/sergical/skill-studio.git"
   },
-  "files": ["README.md"]
+  "bin": {
+    "skill-studio": "bin/skill-studio.js"
+  },
+  "files": [
+    "bin/skill-studio.js"
+  ],
+  "optionalDependencies": {
+    "@skill-studio/cli-darwin-arm64": "0.1.0",
+    "@skill-studio/cli-darwin-x64": "0.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
 }