useskl 0.1.2 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +69 -10
  2. package/package.json +18 -6
package/README.md CHANGED
@@ -1,21 +1,80 @@
1
1
  # useskl
2
2
 
3
- Self-hosted, cross-harness skill distribution & management CLI. Installs the
4
- `skl` command.
3
+ > The `skl` CLI — **publish a skill once, install it into any agent, rebuild it anywhere.**
4
+
5
+ `skl` is a self-hosted, **cross-harness skill manager** for [Agent Skills](https://useskl.com).
6
+ Think of it as a package manager for the `SKILL.md`-based skills your coding
7
+ agents use: version them, share them, and pin them in a manifest so a teammate
8
+ or a fresh machine ends up with the exact same setup — across **Claude Code,
9
+ Codex, Copilot, Cursor, Gemini, and Grok**.
5
10
 
6
11
  ```sh
7
12
  npm install -g useskl
8
13
  skl --version
9
14
  ```
10
15
 
11
- `skl` is a Bun-compiled native binary. This npm package is a thin launcher that
12
- execs the platform-specific binary for your OS/arch, installed automatically as
13
- an [`optionalDependencies`](https://docs.npmjs.com/cli/configuring-npm/package-json#optionaldependencies)
16
+ > Installs the **`skl`** command. (The package is named `useskl` because `skl`
17
+ > was already taken on npm the command itself is `skl`.)
18
+
19
+ ## Why skl?
20
+
21
+ The skills ecosystem tells you *how to write* a skill. skl manages **what
22
+ happens after**:
23
+
24
+ - **Distribute** — `skl publish` pushes a skill to your registry; `skl add`
25
+ pulls one into a project. No copy-pasting folders between repos.
26
+ - **Reproduce** — every project gets a `skl.json` manifest. `skl install` rebuilds
27
+ the exact pinned versions on another machine (the `npm ci` of skills).
28
+ - **Cross-harness** — one skill fans out to every agent you target. Pick your
29
+ harnesses once; skl lands the files in each one's directory.
30
+ - **Yours** — self-hosted and private-capable. Skills can be public or private,
31
+ and nothing has to leave your network.
32
+
33
+ ## Quick start
34
+
35
+ ```sh
36
+ skl login # authenticate this device
37
+ skl init # create skl.json, choose your target agents
38
+ skl add <user>/<skill> # install a skill + record it in skl.json
39
+ skl install # rebuild every skill from skl.json (new machine / CI)
40
+ skl publish ./my-skill # publish your own skill (versioned, immutable)
41
+ ```
42
+
43
+ Pin a skill to an exact version (`user/skill@1.2.0`) for reproducible installs,
44
+ or track the latest (`user/skill`) and re-resolve on every `skl install`.
45
+
46
+ Run `skl --help` for the full command set — `add`, `install`, `remove`, `info`,
47
+ `list`, `scan`, `publish`, `fork`, `config`, and more.
48
+
49
+ ## Other ways to install
50
+
51
+ ```sh
52
+ # macOS / Linux — one-line installer (checksum-verified)
53
+ curl -fsSL https://useskl.com/install.sh | sh
54
+
55
+ # Homebrew (macOS + Linux)
56
+ brew install loopdoop/tap/skl
57
+
58
+ # Debian / Ubuntu — grab the .deb from Releases
59
+ sudo dpkg -i skl_*_amd64.deb
60
+ ```
61
+
62
+ Or download a native binary directly from
63
+ [Releases](https://github.com/loopdoop/skl/releases).
64
+
65
+ ## How this package works
66
+
67
+ `skl` is a single Bun-compiled native binary, not a Node script. This package is
68
+ a tiny launcher that execs the right binary for your OS/arch, installed
69
+ automatically as an
70
+ [`optionalDependencies`](https://docs.npmjs.com/cli/configuring-npm/package-json#optionaldependencies)
14
71
  package (`skl-cli-darwin-arm64`, `skl-cli-darwin-x64`, `skl-cli-linux-x64`,
15
- `skl-cli-linux-arm64`). There is no postinstall download.
72
+ `skl-cli-linux-arm64`). npm pulls only the one matching your machine — **there is
73
+ no postinstall download.** Windows and Alpine/musl aren't supported yet.
16
74
 
17
- Other install options: `brew install loopdoop/tap/skl`,
18
- `curl -fsSL https://useskl.com/install.sh | sh`, or download a binary directly
19
- from [Releases](https://github.com/loopdoop/skl/releases).
75
+ ## Links
20
76
 
21
- See <https://useskl.com>.
77
+ - 🌐 Website — <https://useskl.com>
78
+ - 📖 Docs — <https://useskl.com/docs>
79
+ - 🔎 Browse skills — <https://useskl.com/skills>
80
+ - 🐛 Issues & releases — <https://github.com/loopdoop/skl>
package/package.json CHANGED
@@ -1,18 +1,30 @@
1
1
  {
2
2
  "name": "useskl",
3
- "version": "0.1.2",
4
- "description": "Self-hosted, cross-harness skill distribution & management CLI (the `skl` command)",
3
+ "version": "0.1.3",
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.",
5
5
  "bin": {
6
6
  "skl": "bin/skl.cjs"
7
7
  },
8
8
  "files": [
9
9
  "bin/skl.cjs"
10
10
  ],
11
+ "keywords": [
12
+ "skl",
13
+ "agent-skills",
14
+ "skills",
15
+ "skill-manager",
16
+ "claude",
17
+ "claude-code",
18
+ "codex",
19
+ "cursor",
20
+ "copilot",
21
+ "cli"
22
+ ],
11
23
  "optionalDependencies": {
12
- "skl-cli-darwin-arm64": "0.1.2",
13
- "skl-cli-darwin-x64": "0.1.2",
14
- "skl-cli-linux-x64": "0.1.2",
15
- "skl-cli-linux-arm64": "0.1.2"
24
+ "skl-cli-darwin-arm64": "0.1.3",
25
+ "skl-cli-darwin-x64": "0.1.3",
26
+ "skl-cli-linux-x64": "0.1.3",
27
+ "skl-cli-linux-arm64": "0.1.3"
16
28
  },
17
29
  "license": "UNLICENSED",
18
30
  "homepage": "https://useskl.com",