skills-package-manager 0.6.2 → 0.7.0

package/README.md

@@ -1,42 +1,59 @@
-# spm
+# skills-package-manager
 
 Core library and CLI for managing agent skills.
 
 ## CLI Usage
 
+For one-off usage, `npx skills-package-manager add ...` is the low-friction migration path for teams already familiar with `npx skills add ...`.
+
 ```bash
-spm --help
-spm --version
-spm add <specifier> [--skill <name>]
-spm install
-spm update [skill...]
-spm init [--yes]
+npx skills-package-manager --help
+npx skills-package-manager --version
+npx skills-package-manager add <specifier> [--skill <name>]
+npx skills-package-manager install
+npx skills-package-manager update [skill...]
+npx skills-package-manager init [--yes]
 ```
 
-- `spm` with no command shows top-level help
-- `spm --help` prints top-level help
-- `spm --version` prints the package version
+- `npx skills-package-manager` with no command shows top-level help
+- `npx skills-package-manager --help` prints top-level help
+- `npx skills-package-manager --version` prints the package version
 
-### `spm add`
+### `npx skills-package-manager add`
 
 Add skills to your project.
 
+For teams already familiar with `npx skills add ...`, the headline migration message is:
+
+```bash
+npx skills add owner/repo
+# becomes
+npx skills-package-manager add owner/repo
+```
+
 ```bash
 # Interactive — clone repo, discover skills, select via multiselect prompt
-spm add owner/repo
-spm add https://github.com/owner/repo
+npx skills-package-manager add owner/repo
+npx skills-package-manager add https://github.com/owner/repo
 
 # Non-interactive — add a specific skill by name
-spm add owner/repo --skill find-skills
+npx skills-package-manager add owner/repo --skill find-skills
+npx skills-package-manager add owner/repo@find-skills
+npx skills-package-manager add owner/repo#main@find-skills
+
+# Direct repo subpath
+npx skills-package-manager add owner/repo/skills/my-skill
+npx skills-package-manager add https://github.com/owner/repo/tree/main/skills/my-skill#main
 
 # Direct specifier — skip discovery
-spm add https://github.com/owner/repo.git#path:/skills/my-skill
-spm add link:./local-source/skills/my-skill
-spm add file:./skills-package.tgz#path:/skills/my-skill
-spm add npm:@scope/skills-package#path:/skills/my-skill
+npx skills-package-manager add https://github.com/owner/repo.git#path:/skills/my-skill
+npx skills-package-manager add link:./local-source/skills/my-skill
+npx skills-package-manager add ./local-source
+npx skills-package-manager add file:./skills-package.tgz#path:/skills/my-skill
+npx skills-package-manager add npm:@scope/skills-package#path:/skills/my-skill
 ```
 
-After `spm add`, the newly added skills are resolved, materialized into `installDir`, and linked to each configured `linkTarget` immediately.
+After `npx skills-package-manager add`, the newly added skills are resolved, materialized into `installDir`, and linked to each configured `linkTarget` immediately.
 
 #### How it works
 
@@ -48,25 +65,25 @@ When given `owner/repo` or a GitHub URL:
 4. Writes selected skills to `skills.json` and resolves `skills-lock.yaml`
 5. Cleans up the temp directory
 
-### `spm init`
+### `npx skills-package-manager init`
 
 Create a new `skills.json` manifest in the current directory.
 
 ```bash
 # Interactive — prompt for installDir and linkTargets
-spm init
+npx skills-package-manager init
 
 # Non-interactive — write the default manifest immediately
-spm init --yes
+npx skills-package-manager init --yes
 ```
 
 Behavior:
 
-- `spm init` prompts for `installDir` and `linkTargets`, then writes `skills.json`
-- `spm init --yes` skips prompts and writes the default manifest
+- `npx skills-package-manager init` prompts for `installDir` and `linkTargets`, then writes `skills.json`
+- `npx skills-package-manager init --yes` skips prompts and writes the default manifest
 - If `skills.json` already exists, the command fails and does not overwrite it
 
-Default `skills.json` written by `spm init --yes`:
+Default `skills.json` written by `npx skills-package-manager init --yes`:
 
 ```json
 {
@@ -77,24 +94,24 @@ Default `skills.json` written by `spm init --yes`:
 }
 ```
 
-### `spm install`
+### `npx skills-package-manager install`
 
 Install all skills declared in `skills.json`:
 
 ```bash
-spm install
+npx skills-package-manager install
 ```
 
 This resolves each skill from its specifier, materializes it into `installDir` (default `.agents/skills/`), and creates symlinks for each `linkTarget`.
-When `selfSkill` is `true`, `spm install` also installs the bundled `skills-package-manager-cli` skill so users get guidance for `skills.json`, `skills-lock.yaml`, and the `spm` workflow. This helper skill is not written to `skills-lock.yaml`.
+When `selfSkill` is `true`, `npx skills-package-manager install` also installs the bundled `skills-package-manager-cli` skill so users get guidance for `skills.json`, `skills-lock.yaml`, and `npx skills-package-manager` commands. This helper skill is not written to `skills-lock.yaml`.
 
-### `spm update`
+### `npx skills-package-manager update`
 
 Refresh resolvable skills declared in `skills.json` without changing the manifest:
 
 ```bash
-spm update
-spm update find-skills rspress-custom-theme
+npx skills-package-manager update
+npx skills-package-manager update find-skills rspress-custom-theme
 ```
 
 Behavior:
@@ -153,7 +170,7 @@ link: link:<path-to-skill-dir>
 
 ```
 src/
-├── bin/           # CLI entry points (spm, skills)
+├── bin/           # CLI entry points
 ├── cli/           # CLI runner and interactive prompts
 ├── commands/      # add, install command implementations
 ├── config/        # skills.json / skills-lock.yaml read/write

package/dist/291.js

@@ -0,0 +1,19 @@
+import * as __rspack_external_zlib from "zlib";
+import * as __rspack_external_node_readline_91c31510 from "node:readline";
+export { stripVTControlCharacters, styleText } from "node:util";
+export { default as node_process, stdin, stdout } from "node:process";
+export { ReadStream } from "node:tty";
+export { default as node_fs, existsSync, lstatSync, readdirSync } from "node:fs";
+export { basename, default as node_path, dirname, join, posix, win32 } from "node:path";
+export { EventEmitter, default as events } from "events";
+export { default as fs } from "fs";
+export { EventEmitter as external_node_events_EventEmitter } from "node:events";
+export { default as node_stream } from "node:stream";
+export { StringDecoder } from "node:string_decoder";
+export { default as path, dirname as external_path_dirname, parse } from "path";
+export { default as assert } from "assert";
+export { Buffer } from "buffer";
+export { default as node_assert } from "node:assert";
+export { randomBytes } from "node:crypto";
+export { default as promises } from "node:fs/promises";
+export { __rspack_external_node_readline_91c31510, __rspack_external_zlib };

package/dist/612.js

@@ -0,0 +1,48 @@
+var __webpack_modules__ = {};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+__webpack_require__.m = __webpack_modules__;
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) Object.defineProperty(exports, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.add = function(modules) {
+        Object.assign(__webpack_require__.m, modules);
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports, '__esModule', {
+            value: true
+        });
+    };
+})();
+export { __webpack_require__ };