skmr 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Minwei Shen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# skmr
+
+A CLI tool to manage AI agent skills using a `skills.json` manifest file. Think of it as `package.json` for [skills](https://skills.sh/).
+
+## Install
+
+```bash
+npm install -g skmr
+```
+
+Or use directly with `npx`:
+
+```bash
+npx skmr <command>
+```
+
+## Usage
+
+### Add a skill
+
+```bash
+skmr add <source> --skill <name> -a <agent> [-a <agent>...] [-g|-p]
+```
+
+The `-a` flag is required and repeatable. This wraps `npx skills add` and updates your `skills.json`.
+
+```bash
+# Add a skill for claude-code and cursor, project-level
+skmr add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practices -a claude-code -a cursor -p
+
+# Add a skill globally
+skmr add https://github.com/anthropics/skills --skill skill-creator -a claude-code -g
+```
+
+### Install all skills
+
+```bash
+# Install from ./skills.json
+skmr install
+
+# Install from a custom path
+skmr install -c path/to/skills.json
+```
+
+Reads `skills.json` and installs all skills in parallel.
+
+### Help
+
+```bash
+skmr help
+skmr -h
+```
+
+## skills.json
+
+The `skills.json` file tracks your installed skills:
+
+```json
+{
+  "version": "0.0.1",
+  "command": "npx",
+  "skills": [
+    {
+      "source": "https://github.com/vercel-labs/agent-skills",
+      "name": "vercel-react-best-practices",
+      "agents": ["claude-code", "cursor"],
+      "location": "project"
+    }
+  ]
+}
+```
+
+| Field | Maps to |
+|-------|---------|
+| `source` | `<source>` positional arg |
+| `name` | `--skill <name>` |
+| `agents` | `--agent <agent1> <agent2>` |
+| `location: "global"` | `-g` |
+| `location: "project"` | (default) |
+
+## Supported Agents
+
+claude-code, cursor, windsurf, cline, copilot, codex, gemini-cli, roo-code, kilo-code, trae, goose, opencode, continue, junie, kiro-cli, qwen-code, pochi, amp
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("./index.js");
+(0, index_js_1.main)();

package/dist/commands/add.d.ts

@@ -0,0 +1 @@
+export declare function addCommand(args: string[]): Promise<void>;

package/dist/commands/add.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCommand = addCommand;
+const runner_js_1 = require("../lib/runner.js");
+const skills_json_js_1 = require("../lib/skills-json.js");
+function parseAddArgs(args) {
+    const result = {
+        source: "",
+        skill: "",
+        agents: [],
+        location: undefined,
+    };
+    let i = 0;
+    // First positional arg is the source
+    if (args.length > 0 && !args[0].startsWith("-")) {
+        result.source = args[0];
+        i = 1;
+    }
+    while (i < args.length) {
+        const arg = args[i];
+        if (arg === "--skill" && i + 1 < args.length) {
+            result.skill = args[++i];
+        }
+        else if (arg === "-a" && i + 1 < args.length) {
+            result.agents.push(args[++i]);
+        }
+        else if (arg === "-g") {
+            result.location = "global";
+        }
+        else if (arg === "-p") {
+            result.location = "project";
+        }
+        i++;
+    }
+    return result;
+}
+function buildSkillsArgs(parsed) {
+    const args = ["add", parsed.source, "--skill", parsed.skill];
+    if (parsed.agents.length > 0) {
+        args.push("--agent", ...parsed.agents);
+    }
+    if (parsed.location === "global") {
+        args.push("-g");
+    }
+    args.push("-y");
+    return args;
+}
+const KNOWN_AGENTS = [
+    "claude-code",
+    "cursor",
+    "windsurf",
+    "cline",
+    "copilot",
+    "codex",
+    "gemini-cli",
+    "roo-code",
+    "kilo-code",
+    "trae",
+    "goose",
+    "opencode",
+    "continue",
+    "junie",
+    "kiro-cli",
+    "qwen-code",
+    "pochi",
+    "amp",
+];
+async function addCommand(args) {
+    const parsed = parseAddArgs(args);
+    if (!parsed.source || !parsed.skill) {
+        console.error("Error: source and --skill are required.");
+        console.error("Usage: skmr add [source] --skill [name] -a [agent]... [-g|-p]");
+        process.exit(1);
+    }
+    if (parsed.agents.length === 0) {
+        console.error("Error: at least one agent is required via -a flag.\n");
+        console.error("Available agents:");
+        for (const agent of KNOWN_AGENTS) {
+            console.error(`  ${agent}`);
+        }
+        console.error("\nUsage: skmr add [source] --skill [name] -a [agent]... [-g|-p]");
+        console.error("Example: skmr add https://github.com/org/repo --skill my-skill -a claude-code -a cursor -p");
+        process.exit(1);
+    }
+    // Read the manifest to get the command
+    const manifest = await (0, skills_json_js_1.readSkillsJson)();
+    const baseCommand = manifest.command || "npx";
+    // Build and run the skills command
+    const skillsArgs = ["skills", ...buildSkillsArgs(parsed)];
+    console.log(`Running: ${baseCommand} ${skillsArgs.join(" ")}`);
+    const result = await (0, runner_js_1.runSkillsCommand)(baseCommand, skillsArgs);
+    if (result.exitCode !== 0) {
+        console.error(`\nskills command failed with exit code ${result.exitCode}`);
+        process.exit(result.exitCode);
+    }
+    // Update skills.json
+    const entry = {
+        source: parsed.source,
+        name: parsed.skill,
+        agents: parsed.agents,
+        location: parsed.location ?? "project",
+    };
+    const updated = (0, skills_json_js_1.upsertSkill)(manifest, entry);
+    await (0, skills_json_js_1.writeSkillsJson)(updated);
+    console.log(`\nUpdated skills.json with "${entry.name}"`);
+}

package/dist/commands/help.d.ts

@@ -0,0 +1 @@
+export declare function helpCommand(): void;

package/dist/commands/help.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.helpCommand = helpCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+function helpCommand() {
+    const pkgPath = (0, node_path_1.join)(__dirname, "..", "..", "package.json");
+    const pkg = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf-8"));
+    console.log(`
+skmr v${pkg.version} - AI skill manager
+
+Usage:
+  skmr <command> [options]
+
+Commands:
+  add [source] --skill [name]   Add a skill and update skills.json
+    -a <agent>                  Target agent (required, repeatable, e.g. -a claude-code -a cursor)
+    -g                          Install globally
+    -p                          Install for project
+
+  install                       Install all skills from skills.json in parallel
+    -c <path>                   Path to skills.json (default: ./skills.json)
+
+  help                          Show this help message
+
+Examples:
+  skmr add https://github.com/vercel-labs/agent-skills --skill vercel-react-best-practices -a claude-code -p
+  skmr install
+  skmr install -c config/skills.json
+`.trim());
+}

package/dist/commands/install.d.ts

@@ -0,0 +1 @@
+export declare function installCommand(args: string[]): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installCommand = installCommand;
+const skills_json_js_1 = require("../lib/skills-json.js");
+const runner_js_1 = require("../lib/runner.js");
+function buildSkillsArgs(skill) {
+    const args = ["skills", "add", skill.source, "--skill", skill.name];
+    if (skill.agents.length > 0) {
+        args.push("--agent", ...skill.agents);
+    }
+    if (skill.location === "global") {
+        args.push("-g");
+    }
+    args.push("-y");
+    return args;
+}
+function parseInstallArgs(args) {
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "-c" && i + 1 < args.length) {
+            return { configPath: args[i + 1] };
+        }
+    }
+    return {};
+}
+async function installCommand(args) {
+    const { configPath } = parseInstallArgs(args);
+    let manifest;
+    try {
+        manifest = await (0, skills_json_js_1.readSkillsJson)(configPath);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            console.error(`Error: skills.json not found at ${configPath ?? "skills.json"}`);
+            process.exit(1);
+        }
+        if (err instanceof SyntaxError) {
+            console.error(`Error: Invalid JSON in ${configPath ?? "skills.json"}: ${err.message}`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    if (manifest.skills.length === 0) {
+        console.log("No skills to install.");
+        return;
+    }
+    const baseCommand = manifest.command || "npx";
+    console.log(`Installing ${manifest.skills.length} skill(s) in parallel...\n`);
+    const results = await Promise.allSettled(manifest.skills.map(async (skill) => {
+        const skillArgs = buildSkillsArgs(skill);
+        console.log(`[${skill.name}] Running: ${baseCommand} ${skillArgs.join(" ")}`);
+        const result = await (0, runner_js_1.runSkillsCommand)(baseCommand, skillArgs);
+        return { skill, result };
+    }));
+    // Summary
+    let succeeded = 0;
+    let failed = 0;
+    console.log("\n--- Installation Summary ---");
+    for (const r of results) {
+        if (r.status === "fulfilled" && r.value.result.exitCode === 0) {
+            console.log(`  OK: ${r.value.skill.name}`);
+            succeeded++;
+        }
+        else if (r.status === "fulfilled") {
+            console.log(`  FAIL: ${r.value.skill.name} (exit code ${r.value.result.exitCode})`);
+            failed++;
+        }
+        else {
+            console.log(`  FAIL: ${r.reason}`);
+            failed++;
+        }
+    }
+    console.log(`\n${succeeded} succeeded, ${failed} failed`);
+    if (failed > 0) {
+        process.exit(1);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function main(): Promise<void>;

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const help_js_1 = require("./commands/help.js");
+const add_js_1 = require("./commands/add.js");
+const install_js_1 = require("./commands/install.js");
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    const commandArgs = args.slice(1);
+    switch (command) {
+        case "add":
+            await (0, add_js_1.addCommand)(commandArgs);
+            break;
+        case "install":
+            await (0, install_js_1.installCommand)(commandArgs);
+            break;
+        case "help":
+        case "-h":
+        case "--help":
+        case undefined:
+            (0, help_js_1.helpCommand)();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            (0, help_js_1.helpCommand)();
+            process.exit(1);
+    }
+}

package/dist/lib/runner.d.ts

@@ -0,0 +1,6 @@
+export interface RunResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function runSkillsCommand(command: string, args: string[]): Promise<RunResult>;

package/dist/lib/runner.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSkillsCommand = runSkillsCommand;
+const node_child_process_1 = require("node:child_process");
+function runSkillsCommand(command, args) {
+    return new Promise((resolve) => {
+        const child = (0, node_child_process_1.spawn)(command, args, {
+            stdio: ["inherit", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (data) => {
+            const text = data.toString();
+            stdout += text;
+            process.stdout.write(text);
+        });
+        child.stderr.on("data", (data) => {
+            const text = data.toString();
+            stderr += text;
+            process.stderr.write(text);
+        });
+        child.on("close", (code) => {
+            resolve({ exitCode: code ?? 1, stdout, stderr });
+        });
+        child.on("error", (err) => {
+            stderr += err.message;
+            resolve({ exitCode: 1, stdout, stderr });
+        });
+    });
+}

package/dist/lib/skills-json.d.ts

@@ -0,0 +1,4 @@
+import type { SkillEntry, SkillsManifest } from "./types.js";
+export declare function readSkillsJson(path?: string): Promise<SkillsManifest>;
+export declare function writeSkillsJson(manifest: SkillsManifest, path?: string): Promise<void>;
+export declare function upsertSkill(manifest: SkillsManifest, entry: SkillEntry): SkillsManifest;

package/dist/lib/skills-json.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSkillsJson = readSkillsJson;
+exports.writeSkillsJson = writeSkillsJson;
+exports.upsertSkill = upsertSkill;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const DEFAULT_PATH = "skills.json";
+function createDefaultManifest() {
+    return {
+        version: "0.0.1",
+        command: "npx",
+        skills: [],
+    };
+}
+async function readSkillsJson(path) {
+    const filePath = (0, node_path_1.resolve)(path ?? DEFAULT_PATH);
+    let content;
+    try {
+        content = await (0, promises_1.readFile)(filePath, "utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return createDefaultManifest();
+        }
+        throw err;
+    }
+    const data = JSON.parse(content);
+    if (!Array.isArray(data.skills)) {
+        throw new Error(`Invalid skills.json: "skills" must be an array`);
+    }
+    return data;
+}
+async function writeSkillsJson(manifest, path) {
+    const filePath = (0, node_path_1.resolve)(path ?? DEFAULT_PATH);
+    await (0, promises_1.writeFile)(filePath, JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+}
+function upsertSkill(manifest, entry) {
+    const idx = manifest.skills.findIndex((s) => s.source === entry.source && s.name === entry.name);
+    if (idx >= 0) {
+        manifest.skills[idx] = entry;
+    }
+    else {
+        manifest.skills.push(entry);
+    }
+    return manifest;
+}

package/dist/lib/types.d.ts

@@ -0,0 +1,11 @@
+export interface SkillEntry {
+    source: string;
+    name: string;
+    agents: string[];
+    location: "global" | "project";
+}
+export interface SkillsManifest {
+    version: string;
+    command: string;
+    skills: SkillEntry[];
+}

package/dist/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "skmr",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "skmr": "dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "homepage": "https://github.com/MinweiShen/skill-manager",
+  "author": "Minwei Shen",
+  "license": "MIT",
+  "description": "A cli tool to manage your AI skills with skills.json",
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.0.0"
+  }
+}