@skill-toolbox/cli 0.0.1

package/README.md

@@ -0,0 +1,62 @@
+# @skill-toolbox/cli
+
+Command-line interface for managing Claude Code skills.
+
+## Installation
+
+```bash
+pnpm add -g @skill-toolbox/cli
+```
+
+## Usage
+
+### Install a Skill
+
+```bash
+# From GitHub
+skill-toolbox install github:user/skill-repo
+
+# From user/repo shorthand
+skill-toolbox install user/skill-repo
+
+# From local path
+skill-toolbox install ./local/skill
+
+# Custom installation directory
+skill-toolbox install user/skill-repo --dir ./my-skills
+```
+
+### List Installed Skills
+
+```bash
+skill-toolbox list
+
+# Custom skills directory
+skill-toolbox list --dir ./my-skills
+```
+
+### Validate a Skill
+
+```bash
+# Validate skill file
+skill-toolbox validate ./skills/my-skill/SKILL.md
+
+# Validate skill directory
+skill-toolbox validate ./skills/my-skill
+```
+
+## Commands
+
+- `install <source>` - Install a skill from git or local path
+- `list` - List installed skills
+- `validate <path>` - Validate skill format
+
+## Options
+
+- `-d, --dir <directory>` - Skills directory (default: ./skills)
+- `-h, --help` - Show help
+- `-V, --version` - Show version
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,220 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/index.ts
+var import_commander = require("commander");
+
+// src/commands/list.ts
+var import_chalk = __toESM(require("chalk"));
+
+// src/registry.ts
+var import_fs_extra = __toESM(require("fs-extra"));
+var import_path = __toESM(require("path"));
+var import_core = require("@skill-toolbox/core");
+var import_plugin_metadata = require("@skill-toolbox/plugin-metadata");
+var import_utils = require("@skill-toolbox/utils");
+var SkillRegistry = class {
+  constructor(skillsDir) {
+    this.skillsDir = skillsDir;
+  }
+  async listAll() {
+    const skills = [];
+    if (!await import_fs_extra.default.pathExists(this.skillsDir)) {
+      return skills;
+    }
+    const entries = await import_fs_extra.default.readdir(this.skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const skill = await this.get(entry.name);
+      if (skill) {
+        skills.push(skill);
+      }
+    }
+    return skills;
+  }
+  async get(name) {
+    const skillPath = import_path.default.join(this.skillsDir, name);
+    if (!await import_fs_extra.default.pathExists(skillPath)) {
+      return null;
+    }
+    const skillFile = await (0, import_utils.findSkillFile)(skillPath);
+    if (!skillFile) {
+      return null;
+    }
+    const markdown = await import_fs_extra.default.readFile(skillFile, "utf-8");
+    const parser = new import_core.SkillParser().use((0, import_plugin_metadata.metadataPlugin)());
+    return parser.parse(markdown);
+  }
+};
+
+// src/commands/list.ts
+async function listCommand(skillsDir) {
+  const registry = new SkillRegistry(skillsDir);
+  const skills = await registry.listAll();
+  if (skills.length === 0) {
+    console.log(import_chalk.default.yellow("No skills found."));
+    console.log(import_chalk.default.gray("\nInstall skills with: skill-toolbox install <source>"));
+    return;
+  }
+  console.log(import_chalk.default.bold("\nInstalled Skills:\n"));
+  for (const skill of skills) {
+    console.log(import_chalk.default.green(`  ${skill.metadata.name}`) + import_chalk.default.gray(`@${skill.metadata.version}`));
+    if (skill.metadata.description) {
+      console.log(import_chalk.default.gray(`    ${skill.metadata.description}`));
+    }
+  }
+  console.log(import_chalk.default.gray(`
+Total: ${skills.length} skill(s)
+`));
+}
+
+// src/commands/validate.ts
+var import_chalk2 = __toESM(require("chalk"));
+var import_fs_extra2 = __toESM(require("fs-extra"));
+var import_core2 = require("@skill-toolbox/core");
+var import_plugin_metadata2 = require("@skill-toolbox/plugin-metadata");
+var import_utils2 = require("@skill-toolbox/utils");
+async function validateCommand(skillPath) {
+  const parser = new import_core2.SkillParser().use((0, import_plugin_metadata2.metadataPlugin)());
+  try {
+    const stat = await import_fs_extra2.default.stat(skillPath);
+    if (stat.isDirectory()) {
+      const skillFile = await (0, import_utils2.findSkillFile)(skillPath);
+      if (!skillFile) {
+        console.log(import_chalk2.default.red("\u2717"), skillPath);
+        console.log(import_chalk2.default.red("  Error: No skill file found (SKILL.md or README.md)"));
+        process.exit(1);
+      }
+      skillPath = skillFile;
+    }
+    const markdown = await import_fs_extra2.default.readFile(skillPath, "utf-8");
+    const skill = await parser.parse(markdown);
+    if (!skill.metadata.name) {
+      console.log(import_chalk2.default.red("\u2717"), skillPath);
+      console.log(import_chalk2.default.red("  Error: Missing required metadata field: name"));
+      process.exit(1);
+    }
+    if (!skill.metadata.version) {
+      console.log(import_chalk2.default.red("\u2717"), skillPath);
+      console.log(import_chalk2.default.red("  Error: Missing required metadata field: version"));
+      process.exit(1);
+    }
+    console.log(import_chalk2.default.green("\u2713"), skillPath);
+    console.log(import_chalk2.default.gray(`  Name: ${skill.metadata.name}`));
+    console.log(import_chalk2.default.gray(`  Version: ${skill.metadata.version}`));
+    if (skill.metadata.description) {
+      console.log(import_chalk2.default.gray(`  Description: ${skill.metadata.description}`));
+    }
+    console.log();
+  } catch (error) {
+    console.log(import_chalk2.default.red("\u2717"), skillPath);
+    console.log(import_chalk2.default.red(`  Error: ${error instanceof Error ? error.message : "Unknown error"}`));
+    process.exit(1);
+  }
+}
+
+// src/commands/install.ts
+var import_chalk3 = __toESM(require("chalk"));
+var import_ora = __toESM(require("ora"));
+var import_fs_extra3 = __toESM(require("fs-extra"));
+var import_path2 = __toESM(require("path"));
+var import_git_source = require("@skill-toolbox/git-source");
+var import_filesystem_source = require("@skill-toolbox/filesystem-source");
+var import_plugin_metadata3 = require("@skill-toolbox/plugin-metadata");
+var import_core3 = require("@skill-toolbox/core");
+function isGitSource(source) {
+  return source.startsWith("github:") || source.startsWith("https://") || source.startsWith("git@") || source.endsWith(".git") || /^[\w-]+\/[\w-]+(:[\w\/-]*)?$/.test(source);
+}
+async function installCommand(source, options) {
+  const spinner = (0, import_ora.default)("Installing skill...").start();
+  try {
+    let skillSource;
+    if (isGitSource(source)) {
+      spinner.text = "Cloning repository...";
+      skillSource = new import_git_source.GitSource({
+        source,
+        skillPath: ""
+        // Auto-discover
+      });
+    } else {
+      spinner.text = "Loading from local path...";
+      skillSource = new import_filesystem_source.FilesystemSource({
+        path: source
+      });
+    }
+    const parser = new import_core3.SkillParser().use((0, import_plugin_metadata3.metadataPlugin)());
+    spinner.text = "Loading skills...";
+    const result = await skillSource.load();
+    if (result.errors.length > 0) {
+      for (const error of result.errors) {
+        spinner.fail(import_chalk3.default.red(`Error loading from ${error.path}: ${error.error.message}`));
+      }
+    }
+    if (result.skills.length === 0) {
+      spinner.fail(import_chalk3.default.red("No skills found"));
+      await skillSource.cleanup();
+      process.exit(1);
+    }
+    spinner.text = "Installing skills...";
+    await import_fs_extra3.default.ensureDir(options.dir);
+    const installedSkills = [];
+    for (const skillData of result.skills) {
+      const skill = await parser.parse(skillData.content);
+      const targetDir = import_path2.default.join(options.dir, skillData.baseName);
+      await import_fs_extra3.default.copy(skillData.directory, targetDir, { overwrite: true });
+      installedSkills.push({
+        name: skillData.baseName,
+        version: skill.metadata.version,
+        description: skill.metadata.description
+      });
+    }
+    await skillSource.cleanup();
+    spinner.succeed(import_chalk3.default.green(`\u2713 ${installedSkills.length} skill(s) installed successfully!`));
+    console.log("\nInstalled Skills:");
+    for (const skill of installedSkills) {
+      console.log(import_chalk3.default.gray("  \u2022"), import_chalk3.default.cyan(skill.name), skill.version ? import_chalk3.default.gray(`v${skill.version}`) : "");
+      if (skill.description) {
+        console.log(import_chalk3.default.gray("    "), skill.description);
+      }
+    }
+  } catch (error) {
+    spinner.fail(import_chalk3.default.red(`Failed to install skill: ${error instanceof Error ? error.message : "Unknown error"}`));
+    process.exit(1);
+  }
+}
+
+// src/index.ts
+var program = new import_commander.Command();
+program.name("skill-toolbox").description("CLI tool for discovering and managing Claude Code skills").version("1.0.0");
+program.command("install <source>").description("Install a skill from git repository or local path").option("-d, --dir <directory>", "Installation directory", "./skills").action(async (source, options) => {
+  await installCommand(source, options);
+});
+program.command("list").description("List installed skills").option("-d, --dir <directory>", "Skills directory", "./skills").action(async (options) => {
+  await listCommand(options.dir);
+});
+program.command("validate <path>").description("Validate skill format").action(async (skillPath) => {
+  await validateCommand(skillPath);
+});
+program.parse();

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@skill-toolbox/cli",
+  "version": "0.0.1",
+  "description": "Command-line interface for skill-toolbox",
+  "bin": {
+    "skill-toolbox": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsup src/index.ts --format cjs --watch",
+    "build": "tsup src/index.ts --format cjs",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@skill-toolbox/core": "workspace:*",
+    "@skill-toolbox/utils": "workspace:*",
+    "@skill-toolbox/git-source": "workspace:*",
+    "@skill-toolbox/filesystem-source": "workspace:*",
+    "@skill-toolbox/plugin-metadata": "workspace:*",
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "tsup": "^8.0.0",
+    "vitest": "^1.2.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Link-Reverie/skill-toolbox.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Link-Reverie/skill-toolbox/issues"
+  },
+  "homepage": "https://github.com/Link-Reverie/skill-toolbox#readme",
+  "license": "MIT",
+  "keywords": [
+    "skill",
+    "ai-agent",
+    "claude",
+    "llm",
+    "typescript",
+    "cli"
+  ]
+}