@skild/core 0.10.22 → 0.13.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@ declare class SkildError extends Error {
     constructor(code: SkildErrorCode, message: string, details?: Record<string, unknown>);
 }
 
-declare const PLATFORMS: readonly ["claude", "codex", "copilot", "antigravity", "opencode", "cursor", "windsurf"];
+declare const PLATFORMS: readonly ["claude", "codex", "copilot", "antigravity", "opencode", "cursor", "windsurf", "agents"];
 type Platform = (typeof PLATFORMS)[number];
 type InstallScope = 'global' | 'project';
 type SourceType = 'local' | 'github-url' | 'degit-shorthand' | 'registry';
@@ -112,6 +112,9 @@ interface GlobalConfig {
     schemaVersion: 1;
     defaultPlatform: Platform;
     defaultScope: InstallScope;
+    push?: {
+        defaultRepo?: string;
+    };
 }
 interface RegistryAuth {
     schemaVersion: 1;
@@ -126,6 +129,7 @@ interface RegistryAuth {
 }
 
 declare function loadOrCreateGlobalConfig(): GlobalConfig;
+declare function saveGlobalConfig(config: GlobalConfig): void;
 declare function loadRegistryAuth(): RegistryAuth | null;
 declare function saveRegistryAuth(auth: RegistryAuth): void;
 declare function clearRegistryAuth(): void;
@@ -251,4 +255,4 @@ declare function uninstallSkill(name: string, options?: InstallOptions & {
 }): void;
 declare function updateSkill(name?: string, options?: UpdateOptions): Promise<InstallRecord[]>;
 
-export { DEFAULT_REGISTRY_URL, type DependencySourceType, type GlobalConfig, type InstallOptions, type InstallRecord, type InstallScope, type InstalledDependency, type ListOptions, type Lockfile, PLATFORMS, type Platform, type RegistryAuth, SkildError, type SkillFrontmatter, type SkillValidationIssue, type SkillValidationResult, type UpdateOptions, assertValidAlias, canonicalNameToInstallDirName, clearRegistryAuth, deriveChildSource, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, isValidAlias, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, materializeSourceToDir, materializeSourceToTemp, normalizeAlias, parseRegistrySpecifier, parseSkillFrontmatter, readSkillMd, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, stripSourceRef, toDegitPath, uninstallSkill, updateSkill, validateSkill, validateSkillDir };
+export { DEFAULT_REGISTRY_URL, type DependencySourceType, type GlobalConfig, type InstallOptions, type InstallRecord, type InstallScope, type InstalledDependency, type ListOptions, type Lockfile, PLATFORMS, type Platform, type RegistryAuth, SkildError, type SkillFrontmatter, type SkillValidationIssue, type SkillValidationResult, type UpdateOptions, assertValidAlias, canonicalNameToInstallDirName, clearRegistryAuth, deriveChildSource, downloadAndExtractTarball, fetchWithTimeout, getSkillInfo, getSkillInstallDir, getSkillsDir, initSkill, installRegistrySkill, installSkill, isValidAlias, listAllSkills, listSkills, loadOrCreateGlobalConfig, loadRegistryAuth, materializeSourceToDir, materializeSourceToTemp, normalizeAlias, parseRegistrySpecifier, parseSkillFrontmatter, readSkillMd, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveGlobalConfig, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, stripSourceRef, toDegitPath, uninstallSkill, updateSkill, validateSkill, validateSkillDir };

package/dist/index.js

@@ -10,7 +10,7 @@ var SkildError = class extends Error {
 };
 
 // src/types.ts
-var PLATFORMS = ["claude", "codex", "copilot", "antigravity", "opencode", "cursor", "windsurf"];
+var PLATFORMS = ["claude", "codex", "copilot", "antigravity", "opencode", "cursor", "windsurf", "agents"];
 
 // src/storage.ts
 import fs2 from "fs";
@@ -51,6 +51,8 @@ function getSkillsDir(platform, scope) {
       return scope === "project" ? path.join(getProjectDir(), ".cursor", "skills") : path.join(getHomeDir(), ".cursor", "skills");
     case "windsurf":
       return scope === "project" ? path.join(getProjectDir(), ".windsurf", "skills") : path.join(getHomeDir(), ".windsurf", "skills");
+    case "agents":
+      return scope === "project" ? path.join(getProjectDir(), ".agents", "skills") : path.join(getHomeDir(), ".agents", "skills");
   }
 }
 function getProjectSkildDir() {
@@ -124,18 +126,30 @@ function sanitizeLockfile(lockfile) {
   );
   return { ...lockfile, entries };
 }
+var GLOBAL_CONFIG_DEFAULTS = {
+  schemaVersion: 1,
+  defaultPlatform: PLATFORMS[0],
+  defaultScope: "global"
+};
+function applyGlobalConfigDefaults(existing) {
+  if (!existing) return { ...GLOBAL_CONFIG_DEFAULTS };
+  return {
+    ...GLOBAL_CONFIG_DEFAULTS,
+    ...existing,
+    push: existing.push ? { ...existing.push } : void 0
+  };
+}
 function loadOrCreateGlobalConfig() {
   const filePath = getGlobalConfigPath();
   const existing = readJsonFile(filePath);
-  if (existing) return existing;
-  const created = {
-    schemaVersion: 1,
-    defaultPlatform: PLATFORMS[0],
-    defaultScope: "global"
-  };
+  if (existing) return applyGlobalConfigDefaults(existing);
+  const created = applyGlobalConfigDefaults();
   writeJsonFile(filePath, created);
   return created;
 }
+function saveGlobalConfig(config) {
+  writeJsonFile(getGlobalConfigPath(), applyGlobalConfigDefaults(config));
+}
 function loadRegistryAuth() {
   return readJsonFile(getGlobalRegistryAuthPath());
 }
@@ -331,6 +345,7 @@ import fs6 from "fs";
 import os2 from "os";
 import path7 from "path";
 import degit from "degit";
+import simpleGit from "simple-git";
 
 // src/source.ts
 import path6 from "path";
@@ -491,6 +506,81 @@ function resetTargetDir(targetPath) {
   removeDir(targetPath);
   fs6.mkdirSync(targetPath, { recursive: true });
 }
+function splitSourceRef(source) {
+  const [base, ref] = source.split("#", 2);
+  return { base, ref: ref?.trim() || void 0 };
+}
+function parseGitCloneSpec(source) {
+  const trimmed = source.trim();
+  if (!trimmed) return null;
+  if (resolveLocalPath(trimmed)) return null;
+  const { base, ref } = splitSourceRef(trimmed);
+  const githubTreeWithPathMatch = base.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)\/(.+)/);
+  if (githubTreeWithPathMatch) {
+    const [, owner, repo, branch, subpath] = githubTreeWithPathMatch;
+    return { url: `https://github.com/${owner}/${repo}.git`, ref: branch, subpath };
+  }
+  const githubTreeMatch = base.match(/github\.com\/([^/]+)\/([^/]+)\/tree\/([^/]+)$/);
+  if (githubTreeMatch) {
+    const [, owner, repo, branch] = githubTreeMatch;
+    return { url: `https://github.com/${owner}/${repo}.git`, ref: branch };
+  }
+  const githubRepoMatch = base.match(/github\.com\/([^/]+)\/([^/]+)/);
+  if (githubRepoMatch) {
+    const [, owner, repoRaw] = githubRepoMatch;
+    const repo = repoRaw.replace(/\.git$/, "");
+    return { url: `https://github.com/${owner}/${repo}.git`, ref };
+  }
+  const gitlabTreeWithPathMatch = base.match(/gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)\/(.+)/);
+  if (gitlabTreeWithPathMatch) {
+    const [, owner, repo, branch, subpath] = gitlabTreeWithPathMatch;
+    return { url: `https://gitlab.com/${owner}/${repo}.git`, ref: branch, subpath };
+  }
+  const gitlabTreeMatch = base.match(/gitlab\.com\/([^/]+)\/([^/]+)\/-\/tree\/([^/]+)$/);
+  if (gitlabTreeMatch) {
+    const [, owner, repo, branch] = gitlabTreeMatch;
+    return { url: `https://gitlab.com/${owner}/${repo}.git`, ref: branch };
+  }
+  const gitlabRepoMatch = base.match(/gitlab\.com\/([^/]+)\/([^/]+)/);
+  if (gitlabRepoMatch) {
+    const [, owner, repoRaw] = gitlabRepoMatch;
+    const repo = repoRaw.replace(/\.git$/, "");
+    return { url: `https://gitlab.com/${owner}/${repo}.git`, ref };
+  }
+  const shorthandMatch = base.match(/^([^/]+)\/([^/]+)(?:\/(.+))?$/);
+  if (shorthandMatch && !base.includes(":") && !base.startsWith(".") && !base.startsWith("/")) {
+    const [, owner, repo, subpath] = shorthandMatch;
+    return { url: `https://github.com/${owner}/${repo}.git`, ref, subpath };
+  }
+  if (/^(https?:|git@|ssh:)/i.test(base)) {
+    return { url: base, ref };
+  }
+  return null;
+}
+async function cloneWithGit(spec, targetPath) {
+  const cloneOptions = spec.ref ? ["--depth", "1", "--branch", spec.ref] : ["--depth", "1"];
+  const git = simpleGit();
+  if (!spec.subpath) {
+    resetTargetDir(targetPath);
+    await git.clone(spec.url, targetPath, cloneOptions);
+    return spec.url;
+  }
+  const tempRoot = createTempDir(path7.join(os2.tmpdir(), "skild-git"), extractSkillName(spec.url));
+  try {
+    await git.clone(spec.url, tempRoot, cloneOptions);
+    const resolvedSubpath = path7.resolve(tempRoot, spec.subpath);
+    const resolvedRoot = path7.resolve(tempRoot);
+    if (!resolvedSubpath.startsWith(`${resolvedRoot}${path7.sep}`)) {
+      throw new SkildError("INVALID_SOURCE", `Subpath escapes repository root: ${spec.subpath}`, { subpath: spec.subpath });
+    }
+    ensureInstallableDir(resolvedSubpath);
+    resetTargetDir(targetPath);
+    copyDir(resolvedSubpath, targetPath);
+    return spec.url;
+  } finally {
+    removeDir(tempRoot);
+  }
+}
 async function cloneRemote(degitSrc, targetPath, mode) {
   const emitter = degit(degitSrc, { force: true, verbose: false, mode });
   await emitter.clone(targetPath);
@@ -543,6 +633,14 @@ async function materializeSourceToDir(input) {
     copyDir(localPath, targetDir);
     return { sourceType: "local", materializedFrom: localPath };
   }
+  const gitSpec = parseGitCloneSpec(input.source);
+  if (gitSpec) {
+    try {
+      const materializedFrom2 = await cloneWithGit(gitSpec, targetDir);
+      return { sourceType, materializedFrom: materializedFrom2 };
+    } catch {
+    }
+  }
   const degitPath = toDegitPath(input.source);
   const materializedFrom = await cloneRemoteWithFallback(degitPath, targetDir);
   return { sourceType, materializedFrom };
@@ -1287,6 +1385,7 @@ export {
   resolveRegistryAlias,
   resolveRegistryUrl,
   resolveRegistryVersion,
+  saveGlobalConfig,
   saveRegistryAuth,
   searchRegistrySkills,
   splitCanonicalName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skild/core",
-  "version": "0.10.22",
+  "version": "0.13.0",
   "description": "Skild core library (headless) for installing, validating, and managing Agent Skills locally.",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,6 +20,7 @@
     "degit": "^2.8.4",
     "js-yaml": "^4.1.0",
     "semver": "^7.6.3",
+    "simple-git": "^3.27.0",
     "tar": "^7.4.3"
   },
   "devDependencies": {