hubskillz 0.1.0
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.
- package/README.md +56 -0
- package/dist/index.js +15624 -0
- package/package.json +41 -0
package/README.md
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# hubskillz
|
|
2
|
+
|
|
3
|
+
Keep the Claude Code skills on your machine in sync with your organization's approved catalog.
|
|
4
|
+
|
|
5
|
+
## Install
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
npm i -g hubskillz
|
|
9
|
+
# or run without installing
|
|
10
|
+
npx hubskillz --help
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Requires Node 22 or newer.
|
|
14
|
+
|
|
15
|
+
## Commands
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
hubskillz login [--base-url URL]
|
|
19
|
+
hubskillz status [--path DIR]
|
|
20
|
+
hubskillz sync [--path DIR] [--all] [--yes] [--dry-run] [--force]
|
|
21
|
+
hubskillz push <skill-dir> [-m MESSAGE]
|
|
22
|
+
hubskillz --version
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### login
|
|
26
|
+
|
|
27
|
+
Prompts for a device token (create one in the web app at `/app/settings/tokens`), verifies it against the server and writes it to the config file.
|
|
28
|
+
|
|
29
|
+
### status
|
|
30
|
+
|
|
31
|
+
Scans the local skills root, sends the inventory (names and content hashes only, never file contents) and prints the state of every skill: `synced`, `drifted`, `customized`, `missing` or `unmanaged`.
|
|
32
|
+
|
|
33
|
+
### sync
|
|
34
|
+
|
|
35
|
+
Installs missing skills and updates drifted ones to the approved version. Shows the plan first and asks for confirmation. Skills you changed locally are left untouched unless you pass `--force`.
|
|
36
|
+
|
|
37
|
+
- `--path DIR`: project directory to act on. Default: the current directory.
|
|
38
|
+
- `--all`: act on the global root and the project root. Default: the project root when `DIR/.claude/skills` exists, else the global root.
|
|
39
|
+
- `--yes`, `-y`: apply without asking.
|
|
40
|
+
- `--dry-run`: print the plan and stop.
|
|
41
|
+
- `--force`: overwrite locally customized skills.
|
|
42
|
+
|
|
43
|
+
### push
|
|
44
|
+
|
|
45
|
+
Uploads a skill directory as a draft version for review. `-m`, `--message` attaches a message to the draft.
|
|
46
|
+
|
|
47
|
+
## Surfaces
|
|
48
|
+
|
|
49
|
+
- Global root: `~/.claude/skills`
|
|
50
|
+
- Project root: `<project>/.claude/skills`
|
|
51
|
+
|
|
52
|
+
## Configuration
|
|
53
|
+
|
|
54
|
+
`~/.hubskillz/config.json` stores `{ "baseUrl", "token", "machineId" }`. It is written by `login`.
|
|
55
|
+
|
|
56
|
+
The server URL resolves in this order: `--base-url` flag, `HUBSKILLZ_BASE_URL` environment variable, the config file, then `https://hubskillz.com`.
|