@skild/core 0.4.7 → 0.5.1

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"];
+declare const PLATFORMS: readonly ["claude", "codex", "copilot", "antigravity", "opencode", "cursor", "windsurf"];
 type Platform = (typeof PLATFORMS)[number];
 type InstallScope = 'global' | 'project';
 type SourceType = 'local' | 'github-url' | 'degit-shorthand' | 'registry';
@@ -159,6 +159,7 @@ declare function materializeSourceToTemp(source: string): Promise<{
 }>;
 
 declare function toDegitPath(url: string): string;
+declare function stripSourceRef(source: string): string;
 /**
  * Derive a child source spec from a base source and a relative path.
  *
@@ -244,4 +245,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, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, saveRegistryAuth, searchRegistrySkills, splitCanonicalName, 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, resolveRegistryAlias, resolveRegistryUrl, resolveRegistryVersion, 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"];
+var PLATFORMS = ["claude", "codex", "copilot", "antigravity", "opencode", "cursor", "windsurf"];
 
 // src/storage.ts
 import fs2 from "fs";
@@ -47,6 +47,10 @@ function getSkillsDir(platform, scope) {
       return scope === "project" ? path.join(getProjectDir(), ".agent", "skills") : path.join(getHomeDir(), ".gemini", "antigravity", "skills");
     case "opencode":
       return scope === "project" ? path.join(getProjectDir(), ".opencode", "skill") : path.join(getHomeDir(), ".config", "opencode", "skill");
+    case "cursor":
+      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");
   }
 }
 function getProjectSkildDir() {
@@ -429,6 +433,11 @@ function toDegitPath(url) {
   if (repoMatch) return repoMatch[1].replace(/\.git$/, "");
   return url;
 }
+function stripSourceRef(source) {
+  const hashIndex = source.indexOf("#");
+  if (hashIndex === -1) return source;
+  return source.slice(0, hashIndex);
+}
 function normalizeRelPath(relPath) {
   return relPath.split(path6.sep).join("/").replace(/^\/+/, "").replace(/\/+$/, "");
 }
@@ -451,6 +460,24 @@ async function cloneRemote(degitSrc, targetPath) {
   const emitter = degit(degitSrc, { force: true, verbose: false });
   await emitter.clone(targetPath);
 }
+function isMissingRefError(error) {
+  if (!error) return false;
+  const message = error instanceof Error ? error.message : String(error);
+  return /could not find commit hash/i.test(message);
+}
+async function cloneRemoteWithFallback(degitSrc, targetPath) {
+  try {
+    await cloneRemote(degitSrc, targetPath);
+    return degitSrc;
+  } catch (error) {
+    if (!degitSrc.includes("#") || !isMissingRefError(error)) {
+      throw error;
+    }
+  }
+  const fallbackSrc = stripSourceRef(degitSrc);
+  await cloneRemote(fallbackSrc, targetPath);
+  return fallbackSrc;
+}
 async function materializeSourceToDir(input) {
   const sourceType = classifySource(input.source);
   const targetDir = path7.resolve(input.targetDir);
@@ -468,8 +495,8 @@ async function materializeSourceToDir(input) {
     return { sourceType: "local", materializedFrom: localPath };
   }
   const degitPath = toDegitPath(input.source);
-  await cloneRemote(degitPath, targetDir);
-  return { sourceType, materializedFrom: degitPath };
+  const materializedFrom = await cloneRemoteWithFallback(degitPath, targetDir);
+  return { sourceType, materializedFrom };
 }
 async function materializeSourceToTemp(source) {
   const sourceType = classifySource(source);
@@ -1198,6 +1225,7 @@ export {
   saveRegistryAuth,
   searchRegistrySkills,
   splitCanonicalName,
+  stripSourceRef,
   toDegitPath,
   uninstallSkill,
   updateSkill,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skild/core",
-  "version": "0.4.7",
+  "version": "0.5.1",
   "description": "Skild core library (headless) for installing, validating, and managing Agent Skills locally.",
   "type": "module",
   "main": "./dist/index.js",