@raghuveer-s/skillgraph 0.1.0-alpha

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 (3) hide show
  1. package/README.md +58 -0
  2. package/dist/cli/index.js +22515 -0
  3. package/package.json +47 -0
package/README.md ADDED
@@ -0,0 +1,58 @@
1
+ # skillgraph
2
+
3
+ **The package manager for AI-agent skills** — npm, but for [Agent Skills](https://agentskills.io).
4
+
5
+ > ⚠️ **Alpha.** Early and evolving — expect breaking changes before `1.0`.
6
+
7
+ A **skill** is a `SKILL.md` folder (the open Agent Skills standard) with a name, a
8
+ version, and dependencies on other skills. `skillgraph` resolves a skill's whole
9
+ dependency graph and installs it into your project's `.claude/skills/`, ready for an
10
+ agent to use. Browsing and installing are anonymous; publishing needs a GitHub account.
11
+
12
+ Requires **Node ≥ 22.12**.
13
+
14
+ ```bash
15
+ npm install -g @raghuveer-s/skillgraph
16
+ skg --help
17
+ ```
18
+
19
+ ## Install skills (no account)
20
+
21
+ ```bash
22
+ skg search run-tracker
23
+ skg install @raghuveer/run-tracker-app # the skill + its whole dependency closure
24
+ ```
25
+
26
+ Skills land in flat, standard `.claude/skills/<name>/` folders, and install is
27
+ **non-destructive** — your hand-written skills are left untouched. A `skillgraph.json`
28
+ (manifest) and `skillgraph.lock.json` (lockfile) are written at the project root;
29
+ commit them and `skg install` reproduces the exact graph.
30
+
31
+ ## Publish your own (GitHub account)
32
+
33
+ ```bash
34
+ skg login # sign in via GitHub; first time, you pick your @scope
35
+ skg init ./my-skill # add the skillgraph.node.json sidecar
36
+ skg publish ./my-skill # publishes under your @scope, stamped from your identity
37
+ ```
38
+
39
+ You publish only under your own `@scope` — you never type it; the registry stamps it.
40
+ Published versions are **immutable**. To base a skill on someone else's, `skg fork
41
+ @other/skill` mints it under your scope, then `skg install @you/skill` to edit it.
42
+
43
+ ## Commands
44
+
45
+ | command | does |
46
+ |---|---|
47
+ | `skg search <keyword>` | find skills by name or description |
48
+ | `skg install [@scope/name]` | install a skill (or reproduce from the lockfile) |
49
+ | `skg ls [@scope/name]` | print the installed tree, or inspect a coordinate |
50
+ | `skg init <dir>` | bring a `SKILL.md` folder under management |
51
+ | `skg publish <target…>` | publish your skills, leaves-first |
52
+ | `skg fork @scope/name` | fork another author's skill under your scope |
53
+ | `skg login` · `whoami` · `logout` | account |
54
+
55
+ ---
56
+
57
+ Source & docs: **[github.com/raghuveer-s/skillgraph](https://github.com/raghuveer-s/skillgraph)** ·
58
+ **[skillgraph.build](https://skillgraph.build)** · the standard: **[agentskills.io](https://agentskills.io)**