skild 0.11.1 → 0.12.0

package/README.md

@@ -43,6 +43,7 @@ Your agent is now equipped with new capabilities!
 - **Multiple Sources** — Install from GitHub, the Skild Registry, or local directories
 - **Skillsets** — Install bundles of related skills with one command
 - **Sync** — Keep skills synchronized across all your platforms
+- **Push** — Upload or update skills in a Git repository
 - **Publish** — Share your skills with the community via the registry
 
 ## 📦 Installation
@@ -76,6 +77,7 @@ Requires **Node.js ≥18**.
 | `skild search <query>` | Search the registry |
 | `skild init <name>` | Create a new skill |
 | `skild publish` | Publish to the registry |
+| `skild push <repo>` | Push a skill to a Git repository |
 
 ## 📥 Installing Skills
 

package/dist/index.js

@@ -8,7 +8,7 @@ import {
 
 // src/index.ts
 import { Command } from "commander";
-import chalk20 from "chalk";
+import chalk21 from "chalk";
 import { createRequire } from "module";
 
 // src/commands/install.ts
@@ -77,10 +77,10 @@ var logger = {
   /**
    * Log a skill entry with status indicator.
    */
-  skillEntry: (name, path6, hasSkillMd) => {
+  skillEntry: (name, path7, hasSkillMd) => {
     const status = hasSkillMd ? chalk.green("\u2713") : chalk.yellow("\u26A0");
     console.log(`  ${status} ${chalk.cyan(name)}`);
-    console.log(chalk.dim(`    \u2514\u2500 ${path6}`));
+    console.log(chalk.dim(`    \u2514\u2500 ${path7}`));
   },
   /**
    * Log installation result details.
@@ -3401,6 +3401,191 @@ Cross-platform sync (scope: ${scope})`);
   }
 }
 
+// src/commands/push.ts
+import fs6 from "fs";
+import os3 from "os";
+import path6 from "path";
+import { execSync } from "child_process";
+import simpleGit from "simple-git";
+import chalk20 from "chalk";
+import { SkildError as SkildError12, validateSkillDir as validateSkillDir2 } from "@skild/core";
+function expandHome(input) {
+  if (!input.startsWith("~")) return input;
+  return path6.join(os3.homedir(), input.slice(1));
+}
+function isExplicitLocalSpec(input) {
+  return input.startsWith(".") || input.startsWith("/") || input.startsWith("~") || input.startsWith("file://");
+}
+function resolveRepoSource(raw, preferLocal) {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    throw new SkildError12("INVALID_SOURCE", "Missing repo. Provide a Git URL, local path, or owner/repo.");
+  }
+  if (preferLocal || isExplicitLocalSpec(trimmed)) {
+    if (trimmed.startsWith("file://")) {
+      return { url: trimmed, label: trimmed };
+    }
+    const expanded = expandHome(trimmed);
+    const resolved = path6.resolve(expanded);
+    if (!fs6.existsSync(resolved)) {
+      throw new SkildError12("INVALID_SOURCE", `Local repo not found: ${resolved}`);
+    }
+    return { url: resolved, label: resolved };
+  }
+  if (/^[^/]+\/[^/]+$/.test(trimmed) && !trimmed.includes(":") && !trimmed.startsWith("http")) {
+    const preferSsh = hasSshAgentKeys() || Boolean(process.env.GIT_SSH_COMMAND);
+    const url = preferSsh ? `git@github.com:${trimmed}.git` : `https://github.com/${trimmed}.git`;
+    return { url, label: trimmed };
+  }
+  if (/^(https?:|git@|ssh:)/i.test(trimmed) || trimmed.includes("github.com") || trimmed.includes("gitlab.com")) {
+    return { url: trimmed, label: trimmed };
+  }
+  throw new SkildError12(
+    "INVALID_SOURCE",
+    `Unsupported repo "${raw}". Use owner/repo, a Git URL, or pass --local for a local path.`
+  );
+}
+function hasSshAgentKeys() {
+  if (!process.env.SSH_AUTH_SOCK) return false;
+  try {
+    const out = execSync("ssh-add -L", { stdio: ["ignore", "pipe", "ignore"] }).toString();
+    return /ssh-(rsa|ed25519)|ecdsa-/.test(out);
+  } catch {
+    return false;
+  }
+}
+function normalizeSkillSegment(name, fallback) {
+  const base = name.replace(/^@/, "").trim();
+  const segment = base.includes("/") ? base.split("/").pop() || "" : base;
+  const sanitized = segment.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  if (sanitized) return sanitized;
+  const fallbackSanitized = fallback.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return fallbackSanitized || "skill";
+}
+function normalizeTargetPath(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed || trimmed === "." || trimmed === "./") {
+    throw new SkildError12("INVALID_SOURCE", "Target path cannot be repo root; provide a subdirectory.");
+  }
+  const normalized = path6.posix.normalize(trimmed.replace(/\\/g, "/")).replace(/^\/+/, "");
+  if (!normalized || normalized === "." || normalized.startsWith("..")) {
+    throw new SkildError12("INVALID_SOURCE", "Target path must stay within the repo.");
+  }
+  return normalized.replace(/\/+$/, "");
+}
+function resolveTargetAbs(repoRoot, targetRel) {
+  const root = path6.resolve(repoRoot);
+  const targetAbs = path6.resolve(root, targetRel);
+  if (!targetAbs.startsWith(`${root}${path6.sep}`)) {
+    throw new SkildError12("INVALID_SOURCE", "Target path escapes repo root.");
+  }
+  return targetAbs;
+}
+function copySkillDir(src, dest) {
+  const blocked = /* @__PURE__ */ new Set([".git", ".skild", "node_modules", ".DS_Store"]);
+  fs6.cpSync(src, dest, {
+    recursive: true,
+    filter: (source) => {
+      const base = path6.basename(source);
+      if (blocked.has(base)) return false;
+      return true;
+    }
+  });
+}
+async function hasHeadCommit(git) {
+  try {
+    await git.revparse(["--verify", "HEAD"]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function ensureBranch(git, requested) {
+  const branchName = requested?.trim() || "";
+  const hasHead = await hasHeadCommit(git);
+  if (!hasHead) {
+    const target = branchName || "main";
+    await git.checkoutLocalBranch(target);
+    return { branch: target, setUpstream: true };
+  }
+  if (branchName) {
+    const branches = await git.branch(["-a"]);
+    if (branches.all.includes(`remotes/origin/${branchName}`) || branches.all.includes(branchName)) {
+      await git.checkout(branchName);
+    } else {
+      await git.checkoutLocalBranch(branchName);
+    }
+    return { branch: branchName, setUpstream: true };
+  }
+  const current = await git.branchLocal();
+  return { branch: current.current || "main", setUpstream: false };
+}
+function buildCommitMessage(name, version2) {
+  const v = version2?.trim();
+  return v ? `skild push: ${name}@${v}` : `skild push: ${name}`;
+}
+async function push(repo, options = {}) {
+  let repoSpec = repo.trim();
+  let requestedBranch = options.branch;
+  const hashIndex = repoSpec.indexOf("#");
+  if (hashIndex !== -1) {
+    const base = repoSpec.slice(0, hashIndex);
+    const ref = repoSpec.slice(hashIndex + 1).trim();
+    if (ref && !requestedBranch) requestedBranch = ref;
+    repoSpec = base;
+  }
+  const { url, label } = resolveRepoSource(repoSpec, Boolean(options.local));
+  const dir = path6.resolve(options.dir || process.cwd());
+  const validation = validateSkillDir2(dir);
+  if (!validation.ok) {
+    console.error(chalk20.red("Skill validation failed:"));
+    for (const issue of validation.issues) console.error(chalk20.red(`- ${issue.message}`));
+    process.exitCode = 1;
+    return;
+  }
+  const frontmatter = validation.frontmatter;
+  const skillName = String(frontmatter.name || path6.basename(dir) || "skill");
+  const fallback = path6.basename(dir) || "skill";
+  const defaultTarget = `skills/${normalizeSkillSegment(skillName, fallback)}`;
+  const targetRel = normalizeTargetPath(options.path || defaultTarget);
+  const spinner = createSpinner(`Preparing ${chalk20.cyan(skillName)}...`);
+  const tempRoot = fs6.mkdtempSync(path6.join(os3.tmpdir(), "skild-push-"));
+  try {
+    spinner.text = `Cloning ${chalk20.cyan(label)}...`;
+    await simpleGit().clone(url, tempRoot);
+    const repoGit = simpleGit(tempRoot);
+    const { branch, setUpstream } = await ensureBranch(repoGit, requestedBranch);
+    spinner.text = `Updating ${chalk20.cyan(targetRel)}...`;
+    const targetAbs = resolveTargetAbs(tempRoot, targetRel);
+    if (fs6.existsSync(targetAbs)) fs6.rmSync(targetAbs, { recursive: true, force: true });
+    fs6.mkdirSync(path6.dirname(targetAbs), { recursive: true });
+    copySkillDir(dir, targetAbs);
+    await repoGit.add(["-A", targetRel]);
+    const status = await repoGit.status();
+    if (status.isClean()) {
+      spinner.succeed(`No changes to push for ${chalk20.green(skillName)}.`);
+      return;
+    }
+    spinner.text = "Committing changes...";
+    const message = options.message?.trim() || buildCommitMessage(skillName, frontmatter.version);
+    await repoGit.commit(message);
+    spinner.text = "Pushing to remote...";
+    if (setUpstream) {
+      await repoGit.push(["-u", "origin", branch]);
+    } else {
+      await repoGit.push();
+    }
+    spinner.succeed(`Pushed ${chalk20.green(skillName)} to ${chalk20.cyan(label)}:${chalk20.cyan(targetRel)}`);
+  } catch (error) {
+    spinner.fail("Push failed");
+    const message = error instanceof SkildError12 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk20.red(message));
+    process.exitCode = 1;
+  } finally {
+    fs6.rmSync(tempRoot, { recursive: true, force: true });
+  }
+}
+
 // src/index.ts
 import { PLATFORMS as PLATFORMS6 } from "@skild/core";
 var require2 = createRequire(import.meta.url);
@@ -3421,6 +3606,7 @@ program.command("login").description("Login to a registry and store an access to
 program.command("logout").description("Remove stored registry credentials").action(async () => logout());
 program.command("whoami").description("Show current registry identity").action(async () => whoami());
 program.command("publish").description("Publish a Skill directory to the registry (hosted tarball)").option("--dir <path>", "Skill directory (defaults to cwd)").option("--name <@publisher/skill>", "Override skill name (defaults to SKILL.md frontmatter)").option("--skill-version <semver>", "Override version (defaults to SKILL.md frontmatter)").option("--alias <alias>", "Optional short identifier (global unique) for `skild install <alias>`").option("--description <text>", "Override description (defaults to SKILL.md frontmatter)").option("--targets <list>", "Comma-separated target platforms metadata (optional)").option("--tag <tag>", "Dist-tag (default: latest)", "latest").option("--registry <url>", "Registry base URL (defaults to saved login)").option("--json", "Output JSON").action(async (options) => publish(options));
+program.command("push <repo>").description("Upload/update a Skill directory to a Git repository").option("--dir <path>", "Skill directory (defaults to cwd)").option("--path <path>", "Target path inside repo (defaults to skills/<skill-name>)").option("--branch <branch>", "Target branch (defaults to repo default)").option("--message <text>", "Custom commit message").option("--local", "Treat <repo> as a local path (default: remote)").action(async (repo, options) => push(repo, options));
 program.command("search <query>").description("Search Skills in the registry").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--limit <n>", "Max results (default: 50)", "50").option("--json", "Output JSON").action(async (query, options) => search(query, options));
 program.command("extract-github-skills <source>").description("Extract GitHub skills into a local catalog directory").option("--out <dir>", "Output directory (default: ./skild-github-skills)").option("-f, --force", "Overwrite existing output directory").option("--depth <n>", "Max markdown recursion depth (default: 0)", "0").option("--scan-depth <n>", "Max directory depth to scan for SKILL.md (default: 6)", "6").option("--max-skills <n>", "Max discovered skills to export (default: 200)", "200").option("--json", "Output JSON").action(async (source, options) => {
   await extractGithubSkills(source, options);
@@ -3429,10 +3615,10 @@ program.command("sync [skills...]").description("Sync missing skills across plat
   await sync(skills, options);
 });
 program.action(() => {
-  const dim = chalk20.dim;
-  const cyan = chalk20.cyan;
-  const bold = chalk20.bold;
-  const green = chalk20.green;
+  const dim = chalk21.dim;
+  const cyan = chalk21.cyan;
+  const bold = chalk21.bold;
+  const green = chalk21.green;
   console.log("");
   console.log(cyan("   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2588\u2588\u2588\u2588\u2557 "));
   console.log(cyan("   \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551 \u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skild",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease.",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,6 +40,7 @@
     "mdast-util-to-string": "^4.0.0",
     "ora": "^8.0.1",
     "remark-parse": "^11.0.0",
+    "simple-git": "^3.27.0",
     "string-width": "^8.1.0",
     "tar": "^7.4.3",
     "unified": "^11.0.4",