skild 0.0.7 → 0.1.0

package/README.md

@@ -12,4 +12,24 @@ npm i -g skild
 
 ```bash
 skild --help
+
+# Install a skill (Git URL / degit shorthand / local dir)
+skild install https://github.com/anthropics/skills/tree/main/skills/pdf
+skild install anthropics/skills/skills/pdf#main
+skild install ./path/to/your-skill
+
+# Target platform + project-level install
+skild install https://github.com/anthropics/skills/tree/main/skills/pdf -t codex --local
+
+# List installed skills
+skild list -t codex --local
+
+# Inspect / Validate / Update / Uninstall
+skild info pdf -t codex --local
+skild validate pdf -t codex --local
+skild update pdf -t codex --local
+skild uninstall pdf -t codex --local
+
+# Create a new Skill
+skild init my-skill
 ```

package/dist/index.js

@@ -2,137 +2,283 @@
 
 // src/index.ts
 import { Command } from "commander";
-import chalk3 from "chalk";
+import chalk9 from "chalk";
+import { createRequire } from "module";
 
 // src/commands/install.ts
-import { execSync } from "child_process";
-import path2 from "path";
-import fs2 from "fs";
+import chalk2 from "chalk";
+import { installSkill, SkildError } from "@skild/core";
+
+// src/utils/logger.ts
 import chalk from "chalk";
 import ora from "ora";
-
-// src/utils/config.ts
-import os from "os";
-import path from "path";
-import fs from "fs";
-function getSkillsDir(platform = "claude", projectLevel = false) {
-  const base = projectLevel ? process.cwd() : os.homedir();
-  switch (platform) {
-    case "claude":
-      return path.join(base, projectLevel ? ".claude" : ".claude", "skills");
-    case "codex":
-      return path.join(base, projectLevel ? ".codex" : ".codex", "skills");
-    case "copilot":
-      return path.join(base, ".github", "skills");
-    default:
-      return path.join(base, ".claude", "skills");
-  }
+function createSpinner(message) {
+  return ora(message).start();
 }
-var SKILLS_DIR = getSkillsDir("claude", false);
-function ensureSkillsDir(platform = "claude", projectLevel = false) {
-  const dir = getSkillsDir(platform, projectLevel);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
+var logger = {
+  /**
+   * Log a success message with green checkmark.
+   */
+  success: (message) => {
+    console.log(chalk.green("\u2713"), message);
+  },
+  /**
+   * Log a warning message with yellow color.
+   */
+  warn: (message) => {
+    console.log(chalk.yellow("\u26A0"), message);
+  },
+  /**
+   * Log an error message with red color.
+   */
+  error: (message) => {
+    console.error(chalk.red("\u2717"), message);
+  },
+  /**
+   * Log an info message with cyan color.
+   */
+  info: (message) => {
+    console.log(chalk.cyan("\u2139"), message);
+  },
+  /**
+   * Log a dimmed/subtle message.
+   */
+  dim: (message) => {
+    console.log(chalk.dim(message));
+  },
+  /**
+   * Log a bold header.
+   */
+  header: (message) => {
+    console.log(chalk.bold(message));
+  },
+  /**
+   * Log a skill entry with status indicator.
+   */
+  skillEntry: (name, path, hasSkillMd) => {
+    const status = hasSkillMd ? chalk.green("\u2713") : chalk.yellow("\u26A0");
+    console.log(`  ${status} ${chalk.cyan(name)}`);
+    console.log(chalk.dim(`    \u2514\u2500 ${path}`));
+  },
+  /**
+   * Log installation result details.
+   */
+  installDetail: (message, isWarning = false) => {
+    const color = isWarning ? chalk.yellow : chalk.dim;
+    console.log(color(`  \u2514\u2500 ${message}`));
   }
-  return dir;
-}
-function getSkillPath(skillName, platform = "claude", projectLevel = false) {
-  return path.join(getSkillsDir(platform, projectLevel), skillName);
-}
+};
 
 // src/commands/install.ts
-function extractSkillName(url) {
-  const treeMatch = url.match(/\/tree\/[^/]+\/(.+?)(?:\/)?$/);
-  if (treeMatch) {
-    return treeMatch[1].split("/").pop() || "unknown-skill";
-  }
-  const repoMatch = url.match(/github\.com\/[^/]+\/([^/]+)/);
-  if (repoMatch) {
-    return repoMatch[1].replace(/\.git$/, "");
-  }
-  return "unknown-skill";
-}
-function toDegitPath(url) {
-  const treeMatch = url.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+?)(?:\/)?$/);
-  if (treeMatch) {
-    const [, owner, repo, branch, subpath] = treeMatch;
-    return `${owner}/${repo}/${subpath}#${branch}`;
-  }
-  const repoMatch = url.match(/github\.com\/([^/]+\/[^/]+)/);
-  if (repoMatch) {
-    return repoMatch[1].replace(/\.git$/, "");
-  }
-  return url;
-}
 async function install(source, options = {}) {
   const platform = options.target || "claude";
-  const projectLevel = options.local || false;
-  ensureSkillsDir(platform, projectLevel);
-  const skillName = extractSkillName(source);
-  const targetPath = getSkillPath(skillName, platform, projectLevel);
-  const degitPath = toDegitPath(source);
-  const locationLabel = projectLevel ? "project" : "global";
-  const spinner = ora(`Installing ${chalk.cyan(skillName)} to ${chalk.dim(platform)} (${locationLabel})...`).start();
+  const scope = options.local ? "project" : "global";
+  const spinner = createSpinner(`Installing ${chalk2.cyan(source)} to ${chalk2.dim(platform)} (${scope})...`);
   try {
-    execSync(`npx degit ${degitPath} "${targetPath}" --force`, {
-      stdio: "pipe"
-    });
-    spinner.succeed(`Installed ${chalk.green(skillName)} to ${chalk.dim(targetPath)}`);
-    const skillMdPath = path2.join(targetPath, "SKILL.md");
-    const hasSkillMd = fs2.existsSync(skillMdPath);
-    if (hasSkillMd) {
-      console.log(chalk.dim(`  \u2514\u2500 SKILL.md found \u2713`));
+    const record = await installSkill(
+      { source },
+      {
+        platform,
+        scope,
+        force: Boolean(options.force)
+      }
+    );
+    spinner.succeed(`Installed ${chalk2.green(record.name)} to ${chalk2.dim(record.installDir)}`);
+    if (options.json) {
+      console.log(JSON.stringify(record, null, 2));
+      return;
+    }
+    if (record.hasSkillMd) {
+      logger.installDetail("SKILL.md found \u2713");
     } else {
-      console.log(chalk.yellow(`  \u2514\u2500 Warning: No SKILL.md found`));
+      logger.installDetail("Warning: No SKILL.md found", true);
+    }
+    if (record.skill?.validation && !record.skill.validation.ok) {
+      logger.installDetail(`Validation: ${chalk2.yellow("failed")} (${record.skill.validation.issues.length} issues)`, true);
+    } else if (record.skill?.validation?.ok) {
+      logger.installDetail(`Validation: ${chalk2.green("ok")}`);
     }
   } catch (error) {
-    spinner.fail(`Failed to install ${chalk.red(skillName)}`);
-    console.error(chalk.red(error.message || error));
-    process.exit(1);
+    spinner.fail(`Failed to install ${chalk2.red(source)}`);
+    const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk2.red(message));
+    process.exitCode = 1;
   }
 }
 
 // src/commands/list.ts
-import fs3 from "fs";
-import path3 from "path";
-import chalk2 from "chalk";
-async function list() {
-  ensureSkillsDir();
-  const entries = fs3.readdirSync(SKILLS_DIR, { withFileTypes: true });
-  const skills = entries.filter((e) => e.isDirectory());
+import chalk3 from "chalk";
+import { listSkills } from "@skild/core";
+async function list(options = {}) {
+  const platform = options.target || "claude";
+  const scope = options.local ? "project" : "global";
+  const skills = listSkills({ platform, scope });
+  if (options.json) {
+    console.log(JSON.stringify(skills, null, 2));
+    return;
+  }
   if (skills.length === 0) {
-    console.log(chalk2.dim("No skills installed."));
-    console.log(chalk2.dim(`Use ${chalk2.cyan("skild install <url>")} to install a skill.`));
+    console.log(chalk3.dim("No skills installed."));
+    console.log(chalk3.dim(`Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
     return;
   }
-  console.log(chalk2.bold(`
-\u{1F4E6} Installed Skills (${skills.length}):
+  console.log(chalk3.bold(`
+\u{1F4E6} Installed Skills (${skills.length}) \u2014 ${platform} (${scope}):
 `));
-  for (const skill of skills) {
-    const skillPath = path3.join(SKILLS_DIR, skill.name);
-    const skillMdPath = path3.join(skillPath, "SKILL.md");
-    const hasSkillMd = fs3.existsSync(skillMdPath);
-    const status = hasSkillMd ? chalk2.green("\u2713") : chalk2.yellow("\u26A0");
-    console.log(`  ${status} ${chalk2.cyan(skill.name)}`);
-    console.log(chalk2.dim(`    \u2514\u2500 ${skillPath}`));
+  for (const s of skills) {
+    const status = s.hasSkillMd ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
+    console.log(`  ${status} ${chalk3.cyan(s.name)}`);
+    console.log(chalk3.dim(`    \u2514\u2500 ${s.installDir}`));
   }
   console.log("");
 }
 
+// src/commands/info.ts
+import chalk4 from "chalk";
+import { getSkillInfo, SkildError as SkildError2 } from "@skild/core";
+async function info(skill, options = {}) {
+  const platform = options.target || "claude";
+  const scope = options.local ? "project" : "global";
+  try {
+    const record = getSkillInfo(skill, { platform, scope });
+    if (options.json) {
+      console.log(JSON.stringify(record, null, 2));
+      return;
+    }
+    console.log(chalk4.bold(`
+${chalk4.cyan(record.name)}
+`));
+    console.log(`  ${chalk4.dim("Path:")} ${record.installDir}`);
+    console.log(`  ${chalk4.dim("Source:")} ${record.source}`);
+    console.log(`  ${chalk4.dim("Target:")} ${record.platform} (${record.scope})`);
+    console.log(`  ${chalk4.dim("Installed:")} ${record.installedAt}`);
+    if (record.updatedAt) console.log(`  ${chalk4.dim("Updated:")} ${record.updatedAt}`);
+    console.log(`  ${chalk4.dim("Hash:")} ${record.contentHash}`);
+    console.log(`  ${chalk4.dim("SKILL.md:")} ${record.hasSkillMd ? chalk4.green("yes") : chalk4.yellow("no")}`);
+    const validation = record.skill?.validation;
+    if (validation) {
+      console.log(`  ${chalk4.dim("Validate:")} ${validation.ok ? chalk4.green("ok") : chalk4.red("failed")}`);
+      if (!validation.ok) {
+        for (const issue of validation.issues) {
+          const color = issue.level === "error" ? chalk4.red : chalk4.yellow;
+          console.log(`    - ${color(issue.level)}: ${issue.message}`);
+        }
+      }
+    }
+    console.log("");
+  } catch (error) {
+    const message = error instanceof SkildError2 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk4.red(message));
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/uninstall.ts
+import chalk5 from "chalk";
+import { uninstallSkill, SkildError as SkildError3 } from "@skild/core";
+async function uninstall(skill, options = {}) {
+  const platform = options.target || "claude";
+  const scope = options.local ? "project" : "global";
+  const spinner = createSpinner(`Uninstalling ${chalk5.cyan(skill)} from ${chalk5.dim(platform)} (${scope})...`);
+  try {
+    uninstallSkill(skill, { platform, scope, allowMissingMetadata: Boolean(options.force) });
+    spinner.succeed(`Uninstalled ${chalk5.green(skill)}`);
+  } catch (error) {
+    spinner.fail(`Failed to uninstall ${chalk5.red(skill)}`);
+    const message = error instanceof SkildError3 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk5.red(message));
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/update.ts
+import chalk6 from "chalk";
+import { updateSkill, SkildError as SkildError4 } from "@skild/core";
+async function update(skill, options = {}) {
+  const platform = options.target || "claude";
+  const scope = options.local ? "project" : "global";
+  const label = skill ? skill : "all skills";
+  const spinner = createSpinner(`Updating ${chalk6.cyan(label)} on ${chalk6.dim(platform)} (${scope})...`);
+  try {
+    const results = await updateSkill(skill, { platform, scope });
+    spinner.succeed(`Updated ${chalk6.green(results.length.toString())} skill(s).`);
+    if (options.json) {
+      console.log(JSON.stringify(results, null, 2));
+    }
+  } catch (error) {
+    spinner.fail(`Failed to update ${chalk6.red(label)}`);
+    const message = error instanceof SkildError4 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk6.red(message));
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/validate.ts
+import chalk7 from "chalk";
+import { validateSkill } from "@skild/core";
+async function validate(target, options = {}) {
+  const platform = options.target || "claude";
+  const scope = options.local ? "project" : "global";
+  const value = target || ".";
+  const result = validateSkill(value, { platform, scope });
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+    process.exitCode = result.ok ? 0 : 1;
+    return;
+  }
+  if (result.ok) {
+    console.log(chalk7.green("\u2713"), "Valid skill");
+    if (result.frontmatter?.name) console.log(chalk7.dim(`  name: ${result.frontmatter.name}`));
+    return;
+  }
+  console.error(chalk7.red("\u2717"), "Invalid skill");
+  for (const issue of result.issues) {
+    const color = issue.level === "error" ? chalk7.red : chalk7.yellow;
+    console.error(`  - ${color(issue.level)}: ${issue.message}`);
+  }
+  process.exitCode = 1;
+}
+
+// src/commands/init.ts
+import chalk8 from "chalk";
+import { initSkill, SkildError as SkildError5 } from "@skild/core";
+async function init(name, options = {}) {
+  const spinner = createSpinner(`Initializing ${chalk8.cyan(name)}...`);
+  try {
+    const createdDir = initSkill(name, {
+      dir: options.dir,
+      description: options.description,
+      force: Boolean(options.force)
+    });
+    spinner.succeed(`Created ${chalk8.green(name)} at ${chalk8.dim(createdDir)}`);
+    console.log(chalk8.dim(`Next: cd ${createdDir} && skild validate .`));
+  } catch (error) {
+    spinner.fail(`Failed to init ${chalk8.red(name)}`);
+    const message = error instanceof SkildError5 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk8.red(message));
+    process.exitCode = 1;
+  }
+}
+
 // src/index.ts
+import { PLATFORMS } from "@skild/core";
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
 var program = new Command();
-program.name("skild").description("The npm for Agent Skills \u2014 Discover, install, manage, and publish AI Agent Skills with ease.").version("0.0.1");
-program.command("install <source>").alias("i").description("Install a Skill from a GitHub URL or registry name").option("-t, --target <platform>", "Target platform: claude, codex, copilot", "claude").option("-l, --local", "Install to project-level directory instead of global").action(async (source, options) => {
-  await install(source, {
-    target: options.target,
-    local: options.local
-  });
-});
-program.command("list").alias("ls").description("List installed Skills").action(async () => {
-  await list();
+program.name("skild").description("The npm for Agent Skills \u2014 Discover, install, manage, and publish AI Agent Skills with ease.").version(version);
+program.command("install <source>").alias("i").description("Install a Skill from a Git URL, degit shorthand, or local directory").option("-t, --target <platform>", `Target platform: ${PLATFORMS.join(", ")}`, "claude").option("-l, --local", "Install to project-level directory instead of global").option("-f, --force", "Overwrite existing installation").option("--json", "Output JSON").action(async (source, options) => {
+  await install(source, options);
 });
+program.command("list").alias("ls").description("List installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS.join(", ")}`, "claude").option("-l, --local", "List project-level directory instead of global").option("--json", "Output JSON").action(async (options) => list(options));
+program.command("info <skill>").description("Show installed Skill details").option("-t, --target <platform>", `Target platform: ${PLATFORMS.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (skill, options) => info(skill, options));
+program.command("uninstall <skill>").alias("rm").description("Uninstall a Skill").option("-t, --target <platform>", `Target platform: ${PLATFORMS.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("-f, --force", "Uninstall even if metadata is missing").action(async (skill, options) => uninstall(skill, options));
+program.command("update [skill]").alias("up").description("Update one or all installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (skill, options) => update(skill, options));
+program.command("validate [target]").alias("v").description("Validate a Skill folder (path) or an installed Skill name").option("-t, --target <platform>", `Target platform: ${PLATFORMS.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (target, options) => validate(target, options));
+program.command("init <name>").description("Create a new Skill project").option("--dir <path>", "Target directory (defaults to <name>)").option("--description <text>", "Skill description").option("-f, --force", "Overwrite target directory if it exists").action(async (name, options) => init(name, options));
 program.action(() => {
-  console.log(chalk3.bold("\n\u{1F6E1}\uFE0F skild \u2014 Get your agents skilled.\n"));
+  console.log(chalk9.bold("\n\u{1F6E1}\uFE0F skild \u2014 Get your agents skilled.\n"));
   program.outputHelp();
 });
-program.parse();
+var argv = process.argv.slice();
+if (argv[2] === "--") argv.splice(2, 1);
+program.parse(argv);

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "skild",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "description": "The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease.",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
-    "skild": "./dist/index.js"
+    "skild": "dist/index.js"
   },
   "files": [
     "dist",
@@ -35,12 +35,11 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
-    "degit": "^2.8.4",
-    "ora": "^8.0.1"
+    "ora": "^8.0.1",
+    "@skild/core": "^0.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "bumpp": "^10.3.2",
     "tsup": "^8.0.0",
     "typescript": "^5.3.0"
   },
@@ -51,7 +50,6 @@
     "build": "tsup src/index.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts --format esm --watch",
     "start": "node dist/index.js",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "release": "pnpm build && bumpp && pnpm publish --no-git-checks"
+    "typecheck": "pnpm -C ../core build && tsc -p tsconfig.json --noEmit"
   }
 }