@stefafafan/skm 0.1.1 → 0.1.3

package/README.md

@@ -1,7 +1,11 @@
 # skm
 
+<a href="https://www.npmjs.com/package/@stefafafan/skm"><img alt="NPM Version" src="https://img.shields.io/npm/v/%40stefafafan%2Fskm"></a>
+
 `skm` is a package manager of [Agent Skills](https://agentskills.io), supporting both project and global-level skills.
 
+See [stefafafan/skm-demo](https://github.com/stefafafan/skm-demo) for real examples of how `skm` is used in a project.
+
 > [!WARNING]
 > This package is in beta. There may be breaking changes.
 
@@ -35,19 +39,19 @@ npx @stefafafan/skm
 Initialize a project with `skills.json` and `skills.lock.json`
 
 ```bash
-skm init --project
+skm init
 ```
 
 Add your favorite skills.
 
 ```bash
-skm add https://github.com/stefafafan/skills --project
+skm add https://github.com/stefafafan/skills
 ```
 
 Rename a skill locally if you prefer a different key name.
 
 ```bash
-skm rename pin-github-actions gha-pinner --project
+skm rename pin-github-actions gha-pinner
 ```
 
 Add and commit your files.
@@ -120,11 +124,11 @@ The following files are used by `skm`
 The intended manifest-first flow is:
 
 1. Change `skills.json` with `skm` commands or by editing it directly.
-2. Run `skm install --project`.
+2. Run `skm install`.
 3. Let `skills.lock.json` and `.agents/skills/` reconcile automatically.
 
-It is recommended to add the following to `.gitignore`
+It is recommended to add the `.skm` directory to `.gitignore`.
 
 ```sh
-.skm
+echo '.skm' >> .gitignore
 ```

package/dist/src/index.js

@@ -1,6 +1,11 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = main;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
 const add_1 = require("./commands/add");
 const init_1 = require("./commands/init");
 const inspect_1 = require("./commands/inspect");
@@ -44,6 +49,7 @@ function parseArgv(argv) {
         all: false,
         force: false,
         help: false,
+        version: false,
     };
     for (let index = 0; index < argv.length; index += 1) {
         const token = argv[index];
@@ -58,6 +64,10 @@ function parseArgv(argv) {
             parsed.help = true;
             continue;
         }
+        if (token === "--version" || token === "-v") {
+            parsed.version = true;
+            continue;
+        }
         if (token === "--project") {
             parsed.scope = "project";
             continue;
@@ -92,6 +102,9 @@ async function dispatch(parsed, cwd, env) {
     if (parsed.command === "help") {
         return buildHelpResult(parsed.positional[0]);
     }
+    if (parsed.version) {
+        return buildVersionResult();
+    }
     if (parsed.help) {
         return buildHelpResult(parsed.command);
     }
@@ -184,12 +197,21 @@ async function dispatch(parsed, cwd, env) {
                 scope: parsed.scope,
                 canonicalName: parsed.positional[0],
             });
+        case "version":
+            return buildVersionResult();
         default:
             throw new errors_1.SkmError(`Unknown command: ${parsed.command}`, 2);
     }
 }
 function buildHelpResult(command) {
     switch (command) {
+        case "version":
+            return {
+                kind: "help",
+                title: "skm version",
+                usage: "skm version",
+                sections: [{ title: "Aliases", lines: ["- --version", "- -v"] }],
+            };
         case "add":
             return {
                 kind: "help",
@@ -308,14 +330,34 @@ function buildHelpResult(command) {
                             "- update [name]",
                             "- list",
                             "- inspect <name>",
+                            "- version",
                             "- help [command]",
                         ],
                     },
                     {
                         title: "Global options",
-                        lines: ["- --help, -h", "- --project", "- --global"],
+                        lines: ["- --help, -h", "- --version, -v", "- --project", "- --global"],
                     },
                 ],
             };
     }
 }
+async function buildVersionResult() {
+    return {
+        kind: "version",
+        version: await readPackageVersion(),
+    };
+}
+let cachedPackageVersion;
+async function readPackageVersion() {
+    if (cachedPackageVersion) {
+        return cachedPackageVersion;
+    }
+    const packageJsonPath = node_path_1.default.resolve(__dirname, "..", "..", "package.json");
+    const packageJson = JSON.parse(await (0, promises_1.readFile)(packageJsonPath, "utf8"));
+    if (!packageJson.version) {
+        throw new errors_1.SkmError(`Missing version in ${packageJsonPath}`, 1);
+    }
+    cachedPackageVersion = packageJson.version;
+    return cachedPackageVersion;
+}

package/dist/src/materialize.js

@@ -18,7 +18,7 @@ async function materializeSkill(options) {
     }
     await (0, fs_1.copyDirectory)(options.sourceDir, outputDir);
     if (options.strategy === "wrap") {
-        const wrapped = await wrapSkillMarkdown(node_path_1.default.join(outputDir, "SKILL.md"), options.canonicalName, options.manifestSource, options.resolved);
+        const wrapped = await wrapSkillMarkdown(node_path_1.default.join(outputDir, "SKILL.md"), options.canonicalName);
         await (0, promises_1.writeFile)(node_path_1.default.join(outputDir, "SKILL.md"), wrapped);
     }
     else if (!(await (0, fs_1.pathExists)(node_path_1.default.join(outputDir, "SKILL.md")))) {
@@ -26,9 +26,8 @@ async function materializeSkill(options) {
     }
     return outputDir;
 }
-async function wrapSkillMarkdown(skillMdPath, canonicalName, manifestSource, resolved) {
+async function wrapSkillMarkdown(skillMdPath, canonicalName) {
     const raw = await (0, promises_1.readFile)(skillMdPath, "utf8");
-    const provenanceComment = `\n\n<!-- Generated by skm from ${manifestSource} @ ${resolved} -->\n`;
     if (!raw.startsWith("---\n")) {
         return [
             "---",
@@ -37,13 +36,12 @@ async function wrapSkillMarkdown(skillMdPath, canonicalName, manifestSource, res
             "---",
             "",
             raw.trimEnd(),
-            provenanceComment.trimEnd(),
             "",
         ].join("\n");
     }
     const endIndex = raw.indexOf("\n---", 4);
     if (endIndex === -1) {
-        return `${raw.trimEnd()}${provenanceComment}`;
+        return `${raw.trimEnd()}\n`;
     }
     const frontmatter = raw.slice(4, endIndex).split("\n");
     const body = raw.slice(endIndex + 5).replace(/^\n/, "");
@@ -58,13 +56,5 @@ async function wrapSkillMarkdown(skillMdPath, canonicalName, manifestSource, res
     if (!replacedName) {
         nextFrontmatter.unshift(`name: ${canonicalName}`);
     }
-    return [
-        "---",
-        ...nextFrontmatter,
-        "---",
-        "",
-        body.trimEnd(),
-        provenanceComment.trimEnd(),
-        "",
-    ].join("\n");
+    return ["---", ...nextFrontmatter, "---", "", body.trimEnd(), ""].join("\n");
 }

package/dist/src/output.js

@@ -28,5 +28,7 @@ function renderCliResultAsText(result) {
             }
             return `${lines.join("\n")}\n`;
         }
+        case "version":
+            return `${result.version}\n`;
     }
 }

package/dist/src/ui/render.js

@@ -25,6 +25,8 @@ function createResultView(ink, result) {
             return createInspectView(ink, result);
         case "help":
             return createHelpView(ink, result);
+        case "version":
+            return createVersionView(ink, result);
     }
 }
 function createSummaryView(ink, result) {
@@ -59,6 +61,10 @@ function createHelpView(ink, result) {
         ...section.lines.map((line, lineIndex) => react_1.default.createElement(Text, { key: `section-line-${index}-${lineIndex}` }, line)),
     ]));
 }
+function createVersionView(ink, result) {
+    const { Box, Text } = ink;
+    return react_1.default.createElement(Box, { flexDirection: "column" }, react_1.default.createElement(Text, { color: "green", bold: true }, "skm"), react_1.default.createElement(Text, null, result.version));
+}
 function createSkillSummary(ink, skill, index) {
     const { Box, Text } = ink;
     return react_1.default.createElement(Box, { key: `skill-${index}`, flexDirection: "column", marginLeft: 2 }, react_1.default.createElement(Text, { bold: true }, `${skill.name}${skill.status ? ` (${skill.status})` : ""}`), ...(skill.previousName

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stefafafan/skm",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "description": "A package manager for AI Agent Skills. Supports installation, version management, and renaming of skills. Can be used for both global and project specific skill management.",
   "keywords": [