useskl 0.1.2 → 0.1.4

package/README.md

@@ -1,21 +1,80 @@
 # useskl
 
-Self-hosted, cross-harness skill distribution & management CLI. Installs the
-`skl` command.
+> The `skl` CLI — **publish a skill once, install it into any agent, rebuild it anywhere.**
+
+`skl` is a self-hosted, **cross-harness skill manager** for [Agent Skills](https://useskl.com).
+Think of it as a package manager for the `SKILL.md`-based skills your coding
+agents use: version them, share them, and pin them in a manifest so a teammate
+or a fresh machine ends up with the exact same setup — across **Claude Code,
+Codex, Copilot, Cursor, Gemini, and Grok**.
 
 ```sh
 npm install -g useskl
 skl --version
 ```
 
-`skl` is a Bun-compiled native binary. This npm package is a thin launcher that
-execs the platform-specific binary for your OS/arch, installed automatically as
-an [`optionalDependencies`](https://docs.npmjs.com/cli/configuring-npm/package-json#optionaldependencies)
-package (`skl-cli-darwin-arm64`, `skl-cli-darwin-x64`, `skl-cli-linux-x64`,
-`skl-cli-linux-arm64`). There is no postinstall download.
+> Installs the **`skl`** command. (The package is named `useskl` because `skl`
+> was already taken on npm — the command itself is `skl`.)
+
+## Why skl?
+
+The skills ecosystem tells you *how to write* a skill. skl manages **what
+happens after**:
+
+- **Distribute** — `skl publish` pushes a skill to your registry; `skl add`
+  pulls one into a project. No copy-pasting folders between repos.
+- **Reproduce** — every project gets a `skl.json` manifest. `skl install` rebuilds
+  the exact pinned versions on another machine (the `npm ci` of skills).
+- **Cross-harness** — one skill fans out to every agent you target. Pick your
+  harnesses once; skl lands the files in each one's directory.
+- **Yours** — self-hosted and private-capable. Skills can be public or private,
+  and nothing has to leave your network.
+
+## Quick start
+
+```sh
+skl login                  # authenticate this device
+skl init                   # create skl.json, choose your target agents
+skl add <user>/<skill>     # install a skill + record it in skl.json
+skl install                # rebuild every skill from skl.json (new machine / CI)
+skl publish ./my-skill     # publish your own skill (versioned, immutable)
+```
+
+Pin a skill to an exact version (`user/skill@1.2.0`) for reproducible installs,
+or track the latest (`user/skill`) and re-resolve on every `skl install`.
+
+Run `skl --help` for the full command set — `add`, `install`, `remove`, `info`,
+`list`, `scan`, `publish`, `fork`, `config`, and more.
+
+## Other ways to install
+
+```sh
+# macOS / Linux — one-line installer (checksum-verified)
+curl -fsSL https://useskl.com/install.sh | sh
+
+# Homebrew (macOS + Linux)
+brew install loopdoop/tap/skl
+
+# Debian / Ubuntu — grab the .deb from Releases
+sudo dpkg -i skl_*_amd64.deb
+```
+
+Or download a native binary directly from
+[Releases](https://github.com/loopdoop/skl/releases).
+
+## How this package works
+
+`skl` is a single Bun-compiled native binary, not a Node script. This package is
+a tiny launcher that execs the right binary for your OS/arch, installed
+automatically as an
+[`optionalDependencies`](https://docs.npmjs.com/cli/configuring-npm/package-json#optionaldependencies)
+package (`useskl-darwin-arm64`, `useskl-darwin-x64`, `useskl-linux-x64`,
+`useskl-linux-arm64`). npm pulls only the one matching your machine — **there is
+no postinstall download.** Windows and Alpine/musl aren't supported yet.
 
-Other install options: `brew install loopdoop/tap/skl`,
-`curl -fsSL https://useskl.com/install.sh | sh`, or download a binary directly
-from [Releases](https://github.com/loopdoop/skl/releases).
+## Links
 
-See <https://useskl.com>.
+- 🌐 Website — <https://useskl.com>
+- 📖 Docs — <https://useskl.com/docs>
+- 🔎 Browse skills — <https://useskl.com/skills>
+- 🐛 Issues & releases — <https://github.com/loopdoop/skl>

package/bin/skl.cjs

@@ -17,13 +17,13 @@ if (!OS || !CPU) {
   process.exit(1);
 }
 
-const pkg = `skl-cli-${OS}-${CPU}`;
+const pkg = `useskl-${OS}-${CPU}`;
 let binPath;
 try {
   binPath = require.resolve(`${pkg}/bin/skl`);
 } catch {
   console.error(
-    `skl: missing platform package '${pkg}'. Reinstall skl (npm i -g skl-cli), or download a binary from https://github.com/loopdoop/skl/releases`,
+    `skl: missing platform package '${pkg}'. Reinstall skl (npm i -g useskl), or download a binary from https://github.com/loopdoop/skl/releases`,
   );
   process.exit(1);
 }

package/package.json

@@ -1,18 +1,30 @@
 {
   "name": "useskl",
-  "version": "0.1.2",
-  "description": "Self-hosted, cross-harness skill distribution & management CLI (the `skl` command)",
+  "version": "0.1.4",
+  "description": "The skl CLI — publish, install, and version Agent Skills across Claude Code, Codex, Cursor, Copilot, Gemini & Grok. Cross-harness skill manager. Installs the `skl` command.",
   "bin": {
     "skl": "bin/skl.cjs"
   },
   "files": [
     "bin/skl.cjs"
   ],
+  "keywords": [
+    "skl",
+    "agent-skills",
+    "skills",
+    "skill-manager",
+    "claude",
+    "claude-code",
+    "codex",
+    "cursor",
+    "copilot",
+    "cli"
+  ],
   "optionalDependencies": {
-    "skl-cli-darwin-arm64": "0.1.2",
-    "skl-cli-darwin-x64": "0.1.2",
-    "skl-cli-linux-x64": "0.1.2",
-    "skl-cli-linux-arm64": "0.1.2"
+    "useskl-darwin-arm64": "0.1.4",
+    "useskl-darwin-x64": "0.1.4",
+    "useskl-linux-x64": "0.1.4",
+    "useskl-linux-arm64": "0.1.4"
   },
   "license": "UNLICENSED",
   "homepage": "https://useskl.com",