skillspp 0.2.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.
Files changed (5) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +80 -0
  3. package/dist/cli.js +6802 -0
  4. package/dist/cli.js.map +7 -0
  5. package/package.json +56 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Omer Ayhan
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,80 @@
1
+ # skillspp CLI
2
+
3
+ `skillspp` is the published command-line distribution for the Skills++ project — a package-manager-style CLI for AI agent skill files. Declare external Markdown files as dependencies, run pre/post-install hooks, and install skills globally or per-project through an easy interactive TUI.
4
+
5
+ ## Installation
6
+
7
+ Install from npm:
8
+
9
+ ```bash
10
+ npm install -g skillspp
11
+ ```
12
+
13
+ ## Usage
14
+
15
+ ```bash
16
+ skillspp --help
17
+ skillspp validate ./path/to/source
18
+ ```
19
+
20
+ ## Commands
21
+
22
+ | Command | Alias | Summary | Common Options |
23
+ | ----------------------- | ----- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
24
+ | `add <source>` | - | Install skills from a local path, git source, or registry-like source. | `--skill`, `--agent`, `--list`, `--global`, `--symlink`, `--all`, `--lock-format` |
25
+ | `find <source> [query]` | - | Discover skills available in a source and optionally filter by query. | `--allow-host`, `--deny-host`, `--max-download-bytes` |
26
+ | `list` | `ls` | List installed skills (project or global scope). | `--agent`, `--global`, `--non-interactive` |
27
+ | `remove` | `rm` | Uninstall selected skills from selected agents. | `--skill`, `--agent`, `--all`, `--global`, `--non-interactive` |
28
+ | `check` | - | Detect drift between installed skills and tracked lockfile state. | `--skill`, `--global`, `--policy-mode` |
29
+ | `update [skill]` | - | Update drifted skills and optionally migrate a skill to a new source. | `--skill`, `--migrate`, `--dry-run`, `--global`, `--lock-format`, `--non-interactive` |
30
+ | `validate [source]` | - | Validate skill source structure, references, and policy constraints. | `--ci`, `--root`, `--strict`, `--json`, `--max-lines`, `--policy-mode` |
31
+ | `init [name]` | - | Scaffold a new `SKILL.md` and installer config template. | `--agent`, `--yaml`, `--non-interactive` |
32
+
33
+ ## Flags Reference
34
+
35
+ | Flag | Value | What it does | Appears in |
36
+ | ------------------------- | ------------- | -------------------------------------------------------------------------- | -------------------------------------------- |
37
+ | `-a, --agent` | `<agents...>` | Target or filter one or more agents. | `add`, `list`, `remove`, `init` |
38
+ | `-s, --skill` | `<skills...>` | Target one or more skill names. | `add`, `check`, `remove`, `update` |
39
+ | `-l, --list` | none | Preview skills from a source without installing. | `add` |
40
+ | `-g, --global` | none | Use global install scope instead of project scope. | `add`, `list`, `remove`, `check`, `update` |
41
+ | `--all` | none | Select all skills/agents relevant to the command. | `add`, `remove` |
42
+ | `--non-interactive` | none | Disable interactive prompts. | `add`, `list`, `remove`, `update`, `init` |
43
+ | `--symlink` | none | Install by creating symlinks instead of copying files. | `add` |
44
+ | `--yaml` | none | Use YAML installer scaffold format when creating missing installer config. | `add`, `init` |
45
+ | `--trust-well-known` | none | Allow hook commands for well-known sources. | `add`, `update` |
46
+ | `--allow-host` | `<hosts...>` | Allowlist specific hosts for remote source resolution. | `add`, `find`, `check`, `update`, `validate` |
47
+ | `--deny-host` | `<hosts...>` | Block specific hosts for remote source resolution. | `add`, `find`, `check`, `update`, `validate` |
48
+ | `--max-download-bytes` | `<n>` | Cap remote download budget in bytes. | `add`, `find`, `check`, `update`, `validate` |
49
+ | `--policy-mode` | `<mode>` | Set policy behavior (`enforce` or `warn`). | `add`, `check`, `update`, `validate` |
50
+ | `--lock-format` | `<format>` | Choose lockfile output format (`json` or `yaml`). | `add`, `update` |
51
+ | `--migrate` | `<source>` | Migrate one selected skill to a new source. | `update` |
52
+ | `--dry-run` | none | Show planned updates without applying changes. | `update` |
53
+ | `--ci` | none | Enable CI validation mode. | `validate` |
54
+ | `--root` | `<paths...>` | Provide root paths used in CI validation mode. | `validate` |
55
+ | `--strict` | none | Treat warnings as errors. | `validate` |
56
+ | `--json` | none | Emit machine-readable JSON output. | `validate` |
57
+ | `--max-lines` | `<n>` | Set SKILL.md line-count threshold. | `validate` |
58
+ | `--max-description-chars` | `<n>` | Set skill description length threshold. | `validate` |
59
+ | `--telemetry` | `<sink>` | Emit lifecycle telemetry events. | global CLI |
60
+ | `--experimental` | none | Enable experimental features. | global CLI |
61
+
62
+ ## Development
63
+
64
+ Run from repository root:
65
+
66
+ ```bash
67
+ corepack pnpm run skillspp -- --help
68
+ ```
69
+
70
+ Or run from workspace directly:
71
+
72
+ ```bash
73
+ corepack pnpm --filter skillspp skillspp --help
74
+ ```
75
+
76
+ ## Repository
77
+
78
+ Source lives in:
79
+
80
+ - https://github.com/omer-ayhan/skillspp