@findskills/cli 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# @findskills/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Your skills. Every agent.** The `findskills` CLI keeps your agent skills in one cloud profile and
+loads them on demand, so each new machine needs one login instead of copied skill folders.
+
+```bash
+npm i -g @findskills/cli        # or: bun add -g @findskills/cli
+findskills init                 # install the findskills skill into your agents
+findskills login                # connect your profile
+```
+
+Agents call `findskills` by name, so install it globally. To try it without installing:
+
+```bash
+npx @findskills/cli search "pdf forms"
+bunx @findskills/cli search "pdf forms"
+```
+
+The package ships prebuilt binaries for Linux (x64, arm64, static), macOS (x64, arm64) and Windows
+(x64). npm and Bun install only the one for your machine, and nothing runs at install time.
+
+Docs and the web app: https://findskills.cc

package/bin/findskills.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// Runs the prebuilt findskills binary from the platform package that npm or Bun installed next to
+// this one (`@findskills/cli-<platform>-<arch>`, an optional dependency).
+"use strict";
+
+const { chmodSync } = require("node:fs");
+const { spawnSync } = require("node:child_process");
+
+const SUPPORTED = ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"];
+const INSTALLER = "curl -fsSL https://findskills.cc/install.sh | sh";
+const platform = `${process.platform}-${process.arch}`;
+const exe = process.platform === "win32" ? "findskills.exe" : "findskills";
+
+function fail(message, next) {
+  process.stderr.write(`error: ${message}\n→ ${next}\n`);
+  process.exit(1);
+}
+
+function binary() {
+  if (process.env.FINDSKILLS_BINARY) return process.env.FINDSKILLS_BINARY;
+  if (!SUPPORTED.includes(platform)) {
+    fail(`findskills has no prebuilt binary for ${platform}`, "build it from source: cargo build --release in the findskills repo's cli/ folder");
+  }
+  try {
+    return require.resolve(`@findskills/cli-${platform}/bin/${exe}`);
+  } catch {
+    fail(
+      `the @findskills/cli-${platform} package is missing (installed with optional dependencies turned off?)`,
+      `reinstall with them: npm i -g @findskills/cli, or use the installer: ${INSTALLER}`,
+    );
+  }
+}
+
+const bin = binary();
+let result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (result.error && result.error.code === "EACCES") {
+  // Some package managers drop the executable bit when unpacking.
+  try {
+    chmodSync(bin, 0o755);
+    result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+  } catch {
+    // reported below
+  }
+}
+if (result.error) fail(`cannot run ${bin}: ${result.error.message}`, `use the installer instead: ${INSTALLER}`);
+if (result.signal) process.kill(process.pid, result.signal);
+process.exit(result.status ?? 1);

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@findskills/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "Your agent skills in one cloud profile, loaded on demand by any agent CLI",
+  "keywords": [
+    "agent-skills",
+    "skills",
+    "claude-code",
+    "codex",
+    "cursor",
+    "ai-agents",
+    "cli"
+  ],
+  "version": "0.1.0",
+  "license": "MIT",
+  "homepage": "https://findskills.cc",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Justar96/findskills.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "findskills": "bin/findskills.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@findskills/cli-linux-x64": "0.1.0",
+    "@findskills/cli-linux-arm64": "0.1.0",
+    "@findskills/cli-darwin-x64": "0.1.0",
+    "@findskills/cli-darwin-arm64": "0.1.0",
+    "@findskills/cli-win32-x64": "0.1.0"
+  }
+}