skild 0.0.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peiiii
+
+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,15 @@
+# skild
+
+The npm for Agent Skills — discover, install, manage, and publish AI Agent Skills with ease.
+
+## Install
+
+```bash
+npm i -g skild
+```
+
+## Usage
+
+```bash
+skild --help
+```

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import chalk3 from "chalk";
+
+// src/commands/install.ts
+import { execSync } from "child_process";
+import path2 from "path";
+import fs2 from "fs";
+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");
+  }
+}
+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 });
+  }
+  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();
+  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`));
+    } else {
+      console.log(chalk.yellow(`  \u2514\u2500 Warning: No SKILL.md found`));
+    }
+  } catch (error) {
+    spinner.fail(`Failed to install ${chalk.red(skillName)}`);
+    console.error(chalk.red(error.message || error));
+    process.exit(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());
+  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.`));
+    return;
+  }
+  console.log(chalk2.bold(`
+\u{1F4E6} Installed Skills (${skills.length}):
+`));
+  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}`));
+  }
+  console.log("");
+}
+
+// src/index.ts
+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.action(() => {
+  console.log(chalk3.bold("\n\u{1F6E1}\uFE0F skild \u2014 Get your agents skilled.\n"));
+  program.outputHelp();
+});
+program.parse();

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "skild",
+  "version": "0.0.7",
+  "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"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agent-skills",
+    "ai",
+    "npm",
+    "cli",
+    "package-manager",
+    "claude",
+    "anthropic"
+  ],
+  "author": "Peiiii",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Peiiii/skild.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://skild.sh",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "degit": "^2.8.4",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "bumpp": "^10.3.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "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"
+  }
+}