skilld 1.5.5 → 1.7.0

package/dist/_chunks/sync.mjs

@@ -1,34 +1,30 @@
-import { c as getVersionKey, o as getCacheDir, t as CACHE_DIR } from "./config.mjs";
+import { i as CACHE_DIR, r as getVersionKey, t as getCacheDir } from "./version.mjs";
 import { r as resolvePkgDir } from "./prepare.mjs";
 import { n as sanitizeMarkdown } from "./sanitize.mjs";
 import { a as hasShippedDocs, f as listReferenceFiles, i as getPkgKeyFiles, l as linkPkgNamed, m as readCachedSection, o as isCached, r as ensureCacheDir } from "./cache.mjs";
 import { i as parseFrontmatter } from "./markdown.mjs";
+import { J as isPrerelease, M as resolveGitHubRepo, f as resolvePackageDocsWithAttempts, i as fetchPkgDist, m as fetchGitSkills, p as searchNpmPackages, rt as parsePackageSpec, s as readLocalDependencies, w as resolveCrateDocsWithAttempts } from "./sources.mjs";
 import { a as semverDiff, n as getSharedSkillsDir, t as SHARED_SKILLS_DIR } from "./shared.mjs";
-import { A as parseGitSkillInput, f as resolvePackageDocsWithAttempts, i as fetchPkgDist, k as fetchGitSkills, nt as parsePackageSpec, p as searchNpmPackages, q as isPrerelease, s as readLocalDependencies, x as resolveGitHubRepo } from "./sources.mjs";
 import { a as targets } from "./detect.mjs";
-import { a as sanitizeName, c as SECTION_OUTPUT_FILES, i as linkSkillToAgents, l as buildAllSectionPrompts, m as wrapSection, n as computeSkillDirName, p as portabilizePrompt, s as SECTION_MERGE_ORDER, t as generateSkillMd } from "./prompts.mjs";
+import { c as portabilizePrompt, i as buildAllSectionPrompts, l as wrapSection, n as SECTION_MERGE_ORDER, r as SECTION_OUTPUT_FILES, t as generateSkillMd } from "./prompts.mjs";
+import { i as sanitizeName, r as linkSkillToAgents, t as computeSkillDirName } from "./install.mjs";
 import { a as getModelLabel, i as getAvailableModels, s as optimizeDocs, t as detectImportedPackages } from "./agent.mjs";
-import { E as hasCompletedWizard, O as readConfig, S as suggestPrepareHook, _ as promptForAgent, b as resolveAgent, f as introLine, k as registerProject, o as getInstalledGenerators, p as isInteractive, w as defaultFeatures, x as sharedArgs } from "./cli-helpers.mjs";
+import { a as readConfig, o as registerProject, r as hasCompletedWizard, t as defaultFeatures } from "./config.mjs";
+import { S as suggestPrepareHook, _ as promptForAgent, b as resolveAgent, f as introLine, o as getInstalledGenerators, p as isInteractive, x as sharedArgs } from "./cli-helpers.mjs";
 import { a as removeLockEntry, i as readLock, n as parsePackages, s as writeLock } from "./lockfile.mjs";
 import { t as getProjectState } from "./skills.mjs";
+import { n as resolveSkillName, r as toStoragePackageName, t as parseSkillInput } from "./prefix.mjs";
 import { l as timedSpinner, n as formatDuration } from "./formatting.mjs";
 import { t as runWizard } from "./wizard.mjs";
 import { S as writePromptFiles, _ as linkAllReferences, b as selectLlmConfig, c as ejectReferences, d as ensureGitignore, f as fetchAndCacheResources, g as indexResources, h as handleShippedSkills, l as enhanceSkillWithLLM, m as forceClearCache, n as RESOLVE_STEP_LABELS, o as detectChangelog, p as findRelatedSkills, t as DEFAULT_SECTIONS, u as ensureAgentInstructions, v as resolveBaseDir, y as resolveLocalDep } from "./sync-shared2.mjs";
 import { n as shutdownWorker } from "./pool2.mjs";
 import { dirname, join, relative, resolve } from "pathe";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { isCI } from "std-env";
 import pLimit from "p-limit";
+import { isCI } from "std-env";
 import * as p from "@clack/prompts";
 import { defineCommand } from "citty";
 import logUpdate from "log-update";
-//#region src/telemetry.ts
-/**
-* Anonymous telemetry — fire-and-forget GET to add-skill.vercel.sh/t
-*
-* Opt-out: set DISABLE_TELEMETRY=1 or DO_NOT_TRACK=1
-* Auto-disabled in CI environments.
-*/
 const TELEMETRY_URL = "https://add-skill.vercel.sh/t";
 const SKILLS_VERSION = "1.3.9";
 function isEnabled() {
@@ -44,8 +40,6 @@ function track(data) {
 		fetch(`${TELEMETRY_URL}?${params.toString()}`).catch(() => {});
 	} catch {}
 }
-//#endregion
-//#region src/commands/sync-git.ts
 async function syncGitSkills(opts) {
 	const { source, agent, global: isGlobal, yes } = opts;
 	const cwd = process.cwd();
@@ -121,10 +115,6 @@ async function syncGitSkills(opts) {
 	const names = selected.map((s) => `\x1B[36m${s.name}\x1B[0m`).join(", ");
 	p.log.success(`Installed ${names}`);
 }
-/**
-* Generate a skill from a GitHub repo's docs (no npm package required).
-* Uses the same pipeline as npm packages: resolve → fetch → cache → generate → LLM enhance.
-*/
 async function syncGitHubRepo(opts) {
 	const { source, agent, global: isGlobal, yes } = opts;
 	const owner = source.owner;
@@ -274,8 +264,6 @@ async function syncGitHubRepo(opts) {
 	});
 	p.outro(`Synced ${owner}/${repo} to ${relative(cwd, skillDir)}`);
 }
-//#endregion
-//#region src/commands/sync-parallel.ts
 const STATUS_ICONS = {
 	pending: "○",
 	resolving: "◐",
@@ -496,7 +484,6 @@ async function syncPackagesParallel(config) {
 		p.log.warn(`Failed to suggest prepare hook: ${err instanceof Error ? err.message : String(err)}`);
 	}
 }
-/** Phase 1: Generate base skill (no LLM). Returns 'shipped' if shipped skill was linked, or BaseSkillData. */
 async function syncBaseSkill(packageSpec, config, cwd, update) {
 	const { name: packageName, tag: requestedTag } = parsePackageSpec(packageSpec);
 	const localVersion = (await readLocalDependencies(cwd).catch(() => [])).find((d) => d.name === packageName)?.version;
@@ -651,7 +638,6 @@ async function syncBaseSkill(packageSpec, config, cwd, update) {
 		overheadLines
 	};
 }
-/** Phase 2: Enhance skill with LLM */
 async function enhanceWithLLM(packageName, data, config, cwd, update, sections, customPrompt) {
 	const versionKey = getVersionKey(data.version);
 	const skillDir = join(resolveBaseDir(cwd, config.agent, config.global), data.skillDirName);
@@ -710,8 +696,6 @@ async function enhanceWithLLM(packageName, data, config, cwd, update, sections,
 	}
 	update(packageName, "done", "Skill optimized", versionKey);
 }
-//#endregion
-//#region src/commands/sync.ts
 const RESOLVE_SOURCE_LABELS = {
 	"npm": "npm registry",
 	"github-docs": "GitHub versioned docs",
@@ -732,10 +716,18 @@ function showResolveAttempts(attempts) {
 		p.log.message(`  ${icon} ${source}${msg}`);
 	}
 }
+function isCrateSpec(spec) {
+	return spec.startsWith("crate:");
+}
+function toCrateIdentity(crateName) {
+	return `crate:${crateName}`;
+}
 async function syncCommand(state, opts) {
 	if (opts.packages && opts.packages.length > 0) {
-		if (opts.packages.length > 1) return syncPackagesParallel({
-			packages: opts.packages,
+		const crateSpecs = opts.packages.filter(isCrateSpec);
+		const npmSpecs = opts.packages.filter((p) => !isCrateSpec(p));
+		if (npmSpecs.length > 1) await syncPackagesParallel({
+			packages: npmSpecs,
 			global: opts.global,
 			agent: opts.agent,
 			model: opts.model,
@@ -744,7 +736,8 @@ async function syncCommand(state, opts) {
 			debug: opts.debug,
 			mode: opts.mode
 		});
-		await syncSinglePackage(opts.packages[0], opts);
+		else if (npmSpecs.length === 1) await syncSinglePackage(npmSpecs[0], opts);
+		for (const spec of crateSpecs) await syncSinglePackage(spec, opts);
 		return;
 	}
 	const packages = await interactivePicker(state);
@@ -821,64 +814,79 @@ async function pickFromList(packages, state) {
 	return selected;
 }
 async function syncSinglePackage(packageSpec, config) {
-	const { name: packageName, tag: requestedTag } = parsePackageSpec(packageSpec);
+	const isCrate = isCrateSpec(packageSpec);
+	const normalizedSpec = isCrate ? packageSpec.slice(6).trim() : packageSpec;
+	if (isCrate && !normalizedSpec) {
+		p.log.error("Invalid crate spec. Use format: crate:<name>");
+		return;
+	}
+	const { name: parsedName, tag: requestedTag } = parsePackageSpec(normalizedSpec);
+	const packageName = isCrate ? parsedName.toLowerCase() : parsedName;
+	const identityPackageName = isCrate ? toCrateIdentity(packageName) : packageName;
+	const storagePackageName = toStoragePackageName(identityPackageName);
 	const spin = timedSpinner();
 	spin.start(`Resolving ${packageSpec}`);
 	const cwd = process.cwd();
-	const localVersion = (await readLocalDependencies(cwd).catch(() => [])).find((d) => d.name === packageName)?.version;
-	const resolveResult = await resolvePackageDocsWithAttempts(requestedTag ? packageSpec : packageName, {
+	const localDeps = isCrate ? [] : await readLocalDependencies(cwd).catch(() => []);
+	const localVersion = isCrate ? void 0 : localDeps.find((d) => d.name === packageName)?.version;
+	const resolveResult = isCrate ? await resolveCrateDocsWithAttempts(packageName, {
+		version: requestedTag,
+		onProgress: (step) => spin.message(`${identityPackageName}: ${step}`)
+	}) : await resolvePackageDocsWithAttempts(requestedTag ? normalizedSpec : packageName, {
 		version: localVersion,
 		cwd,
 		onProgress: (step) => spin.message(`${packageName}: ${RESOLVE_STEP_LABELS[step]}`)
 	});
 	let resolved = resolveResult.package;
-	if (!resolved) {
+	if (!resolved && !isCrate) {
 		spin.message(`Resolving local package: ${packageName}`);
 		resolved = await resolveLocalDep(packageName, cwd);
 	}
 	if (!resolved) {
-		const earlyShipped = handleShippedSkills(packageName, localVersion || resolveResult.registryVersion || "latest", cwd, config.agent, config.global);
-		if (earlyShipped) {
-			const shared = !config.global && getSharedSkillsDir(cwd);
-			for (const shipped of earlyShipped.shipped) {
-				if (shared) linkSkillToAgents(shipped.skillName, shared, cwd, config.agent);
-				p.log.success(`Using published SKILL.md: ${shipped.skillName} → ${relative(cwd, shipped.skillDir)}`);
+		if (!isCrate) {
+			const earlyShipped = handleShippedSkills(packageName, localVersion || resolveResult.registryVersion || "latest", cwd, config.agent, config.global);
+			if (earlyShipped) {
+				const shared = !config.global && getSharedSkillsDir(cwd);
+				for (const shipped of earlyShipped.shipped) {
+					if (shared) linkSkillToAgents(shipped.skillName, shared, cwd, config.agent);
+					p.log.success(`Using published SKILL.md: ${shipped.skillName} → ${relative(cwd, shipped.skillDir)}`);
+				}
+				spin.stop(`Using published SKILL.md(s) from ${packageName}`);
+				return;
+			}
+			spin.message(`Searching npm for "${packageName}"...`);
+			const suggestions = await searchNpmPackages(packageName);
+			if (suggestions.length > 0) {
+				spin.stop(`Package "${packageName}" not found on npm`);
+				showResolveAttempts(resolveResult.attempts);
+				const selected = await p.select({
+					message: "Did you mean one of these?",
+					options: [...suggestions.map((s) => ({
+						label: s.name,
+						value: s.name,
+						hint: s.description
+					})), {
+						label: "None of these",
+						value: "_none_"
+					}]
+				});
+				if (!p.isCancel(selected) && selected !== "_none_") return syncSinglePackage(selected, config);
+				return;
 			}
-			spin.stop(`Using published SKILL.md(s) from ${packageName}`);
-			return;
-		}
-		spin.message(`Searching npm for "${packageName}"...`);
-		const suggestions = await searchNpmPackages(packageName);
-		if (suggestions.length > 0) {
-			spin.stop(`Package "${packageName}" not found on npm`);
-			showResolveAttempts(resolveResult.attempts);
-			const selected = await p.select({
-				message: "Did you mean one of these?",
-				options: [...suggestions.map((s) => ({
-					label: s.name,
-					value: s.name,
-					hint: s.description
-				})), {
-					label: "None of these",
-					value: "_none_"
-				}]
-			});
-			if (!p.isCancel(selected) && selected !== "_none_") return syncSinglePackage(selected, config);
-			return;
 		}
-		spin.stop(`Could not find docs for: ${packageName}`);
+		spin.stop(`Could not find docs for: ${identityPackageName}`);
 		showResolveAttempts(resolveResult.attempts);
 		return;
 	}
-	const version = localVersion || resolved.version || "latest";
+	const version = isCrate ? resolved.version || requestedTag || "latest" : localVersion || resolved.version || "latest";
 	const versionKey = getVersionKey(version);
-	if (config.force) forceClearCache(packageName, version);
-	const useCache = isCached(packageName, version);
-	if (!existsSync(join(cwd, "node_modules", packageName))) {
+	if (config.force) forceClearCache(storagePackageName, version);
+	const useCache = isCached(storagePackageName, version);
+	if (!isCrate && !existsSync(join(cwd, "node_modules", packageName))) {
 		spin.message(`Downloading ${packageName}@${version} dist`);
 		await fetchPkgDist(packageName, version);
 	}
-	const shippedResult = handleShippedSkills(packageName, version, cwd, config.agent, config.global);
+	const shippedResult = isCrate ? null : handleShippedSkills(packageName, version, cwd, config.agent, config.global);
 	if (shippedResult) {
 		const shared = !config.global && getSharedSkillsDir(cwd);
 		for (const shipped of shippedResult.shipped) {
@@ -888,18 +896,18 @@ async function syncSinglePackage(packageSpec, config) {
 		spin.stop(`Using published SKILL.md(s) from ${packageName}`);
 		return;
 	}
-	spin.stop(`Resolved ${packageName}@${useCache ? versionKey : version}${config.force ? " (force)" : useCache ? " (cached)" : ""}`);
-	if (!localVersion && !requestedTag && !isPrerelease(version)) {
+	spin.stop(`Resolved ${identityPackageName}@${useCache ? versionKey : version}${config.force ? " (force)" : useCache ? " (cached)" : ""}`);
+	if (!isCrate && !localVersion && !requestedTag && !isPrerelease(version)) {
 		const nextTag = resolved.distTags?.next ?? resolved.distTags?.beta ?? resolved.distTags?.alpha;
 		if (nextTag && (!resolved.releasedAt || !nextTag.releasedAt || nextTag.releasedAt > resolved.releasedAt)) p.log.warn(`\x1B[33mNo local dependency found — using latest stable (${version}). Prerelease ${nextTag.version} available: skilld add ${packageName}@beta\x1B[0m`);
 	}
 	ensureCacheDir();
 	const baseDir = resolveBaseDir(cwd, config.agent, config.global);
-	let skillDirName = config.name ? sanitizeName(config.name) : computeSkillDirName(packageName);
+	let skillDirName = config.name ? sanitizeName(config.name) : computeSkillDirName(storagePackageName);
 	if (config.mode === "update" && !config.name) {
 		const lock = readLock(baseDir);
 		if (lock) {
-			for (const [name, info] of Object.entries(lock.skills)) if (info.packageName === packageName || parsePackages(info.packages).some((p) => p.name === packageName)) {
+			for (const [name, info] of Object.entries(lock.skills)) if (info.packageName === identityPackageName || parsePackages(info.packages).some((p) => p.name === identityPackageName)) {
 				skillDirName = name;
 				break;
 			}
@@ -908,7 +916,7 @@ async function syncSinglePackage(packageSpec, config) {
 	const skillDir = config.eject ? typeof config.eject === "string" ? join(resolve(cwd, config.eject), skillDirName) : join(cwd, "skills", skillDirName) : join(baseDir, skillDirName);
 	mkdirSync(skillDir, { recursive: true });
 	const existingLock = config.eject ? void 0 : readLock(baseDir)?.skills[skillDirName];
-	const isMerge = existingLock && existingLock.packageName && existingLock.packageName !== packageName;
+	const isMerge = existingLock && existingLock.packageName && existingLock.packageName !== identityPackageName;
 	const updateCtx = config.mode === "update" && existingLock ? {
 		oldVersion: existingLock.version,
 		newVersion: version,
@@ -920,11 +928,11 @@ async function syncSinglePackage(packageSpec, config) {
 		})()
 	} : void 0;
 	if (isMerge) {
-		spin.stop(`Merging ${packageName} into ${skillDirName}`);
-		linkPkgNamed(skillDir, packageName, cwd, version);
+		spin.stop(`Merging ${identityPackageName} into ${skillDirName}`);
+		linkPkgNamed(skillDir, storagePackageName, cwd, version);
 		const repoSlug = resolved.repoUrl?.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?(?:[/#]|$)/)?.[1];
 		writeLock(baseDir, skillDirName, {
-			packageName,
+			packageName: identityPackageName,
 			version,
 			repo: repoSlug,
 			source: existingLock.source,
@@ -933,9 +941,10 @@ async function syncSinglePackage(packageSpec, config) {
 		});
 		const updatedLock = readLock(baseDir)?.skills[skillDirName];
 		const allPackages = parsePackages(updatedLock?.packages).map((p) => ({ name: p.name }));
-		const relatedSkills = await findRelatedSkills(packageName, baseDir);
-		const pkgFiles = getPkgKeyFiles(existingLock.packageName, cwd, existingLock.version);
-		const shippedDocs = hasShippedDocs(existingLock.packageName, cwd, existingLock.version);
+		const relatedSkills = await findRelatedSkills(storagePackageName, baseDir);
+		const existingStorageName = toStoragePackageName(existingLock.packageName);
+		const pkgFiles = getPkgKeyFiles(existingStorageName, cwd, existingLock.version);
+		const shippedDocs = hasShippedDocs(existingStorageName, cwd, existingLock.version);
 		const mergeFeatures = readConfig().features ?? defaultFeatures;
 		const skillMd = generateSkillMd({
 			name: existingLock.packageName,
@@ -955,7 +964,7 @@ async function syncSinglePackage(packageSpec, config) {
 		const mergeShared = !config.global && getSharedSkillsDir(cwd);
 		if (mergeShared) linkSkillToAgents(skillDirName, mergeShared, cwd, config.agent);
 		if (!config.global) registerProject(cwd);
-		p.outro(`Merged ${packageName} into ${skillDirName}`);
+		p.outro(`Merged ${identityPackageName} into ${skillDirName}`);
 		return;
 	}
 	const features = { ...readConfig().features ?? defaultFeatures };
@@ -963,7 +972,7 @@ async function syncSinglePackage(packageSpec, config) {
 	const resSpin = timedSpinner();
 	resSpin.start("Finding resources");
 	const resources = await fetchAndCacheResources({
-		packageName,
+		packageName: storagePackageName,
 		resolved,
 		version,
 		useCache,
@@ -981,12 +990,12 @@ async function syncSinglePackage(packageSpec, config) {
 	if (resources.hasReleases) resParts.push("releases");
 	resSpin.stop(resources.usedCache ? `Loaded ${resParts.length > 0 ? resParts.join(", ") : "resources"} (cached)` : `Fetched ${resParts.length > 0 ? resParts.join(", ") : "resources"}`);
 	for (const w of resources.warnings) p.log.warn(`\x1B[33m${w}\x1B[0m`);
-	linkAllReferences(skillDir, packageName, cwd, version, resources.docsType, void 0, features, resources.repoInfo);
+	linkAllReferences(skillDir, storagePackageName, cwd, version, resources.docsType, void 0, features, resources.repoInfo);
 	if (features.search) {
 		const idxSpin = timedSpinner();
 		idxSpin.start("Creating search index");
 		await indexResources({
-			packageName,
+			packageName: storagePackageName,
 			version,
 			cwd,
 			docsToIndex: resources.docsToIndex,
@@ -995,15 +1004,15 @@ async function syncSinglePackage(packageSpec, config) {
 		});
 		idxSpin.stop("Search index ready");
 	}
-	const hasChangelog = detectChangelog(resolvePkgDir(packageName, cwd, version), getCacheDir(packageName, version));
-	const relatedSkills = await findRelatedSkills(packageName, baseDir);
-	const shippedDocs = hasShippedDocs(packageName, cwd, version);
-	const pkgFiles = getPkgKeyFiles(packageName, cwd, version);
+	const hasChangelog = detectChangelog(resolvePkgDir(storagePackageName, cwd, version), getCacheDir(storagePackageName, version));
+	const relatedSkills = await findRelatedSkills(storagePackageName, baseDir);
+	const shippedDocs = hasShippedDocs(storagePackageName, cwd, version);
+	const pkgFiles = getPkgKeyFiles(storagePackageName, cwd, version);
 	const repoSlug = resolved.repoUrl?.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?(?:[/#]|$)/)?.[1];
-	if (!config.eject) linkPkgNamed(skillDir, packageName, cwd, version);
+	if (!config.eject) linkPkgNamed(skillDir, storagePackageName, cwd, version);
 	if (!config.eject) {
 		writeLock(baseDir, skillDirName, {
-			packageName,
+			packageName: identityPackageName,
 			version,
 			repo: repoSlug,
 			source: resources.docSource,
@@ -1013,7 +1022,7 @@ async function syncSinglePackage(packageSpec, config) {
 		const lock = readLock(baseDir);
 		if (lock) for (const [name, info] of Object.entries(lock.skills)) {
 			if (name === skillDirName) continue;
-			if (info.packageName === packageName || parsePackages(info.packages).some((p) => p.name === packageName)) {
+			if (info.packageName === identityPackageName || parsePackages(info.packages).some((p) => p.name === identityPackageName)) {
 				removeLockEntry(baseDir, name);
 				const staleDir = join(baseDir, name);
 				if (existsSync(staleDir)) rmSync(staleDir, { recursive: true });
@@ -1023,7 +1032,7 @@ async function syncSinglePackage(packageSpec, config) {
 	const allPackages = parsePackages((config.eject ? void 0 : readLock(baseDir)?.skills[skillDirName])?.packages).map((p) => ({ name: p.name }));
 	const isEject = !!config.eject;
 	const baseSkillMd = generateSkillMd({
-		name: packageName,
+		name: identityPackageName,
 		version,
 		releasedAt: resolved.releasedAt,
 		description: resolved.description,
@@ -1047,19 +1056,19 @@ async function syncSinglePackage(packageSpec, config) {
 	p.log.success(config.mode === "update" ? `Updated skill: ${relative(cwd, skillDir)}` : `Created base skill: ${relative(cwd, skillDir)}`);
 	const allSectionsCached = !config.force && DEFAULT_SECTIONS.every((s) => {
 		const outputFile = SECTION_OUTPUT_FILES[s];
-		return readCachedSection(packageName, version, outputFile) !== null;
+		return readCachedSection(storagePackageName, version, outputFile) !== null;
 	});
 	if (allSectionsCached) {
 		const cachedParts = [];
 		for (const s of SECTION_MERGE_ORDER) {
 			if (!DEFAULT_SECTIONS.includes(s)) continue;
 			const outputFile = SECTION_OUTPUT_FILES[s];
-			const content = readCachedSection(packageName, version, outputFile);
+			const content = readCachedSection(storagePackageName, version, outputFile);
 			if (content) cachedParts.push(wrapSection(s, content));
 		}
 		const cachedBody = cachedParts.join("\n\n");
 		const skillMd = generateSkillMd({
-			name: packageName,
+			name: identityPackageName,
 			version,
 			releasedAt: resolved.releasedAt,
 			description: resolved.description,
@@ -1093,7 +1102,7 @@ async function syncSinglePackage(packageSpec, config) {
 	if (!allSectionsCached && !globalConfig.skipLlm && !(config.yes && !resolvedModel)) {
 		const llmConfig = await selectLlmConfig(resolvedModel, void 0, updateCtx);
 		if (llmConfig?.promptOnly) writePromptFiles({
-			packageName,
+			packageName: storagePackageName,
 			skillDir,
 			version,
 			hasIssues: resources.hasIssues,
@@ -1111,7 +1120,8 @@ async function syncSinglePackage(packageSpec, config) {
 		else if (llmConfig) {
 			p.log.step(getModelLabel(llmConfig.model));
 			await enhanceSkillWithLLM({
-				packageName,
+				packageName: identityPackageName,
+				cachePackageName: storagePackageName,
 				version,
 				skillDir,
 				dirName: skillDirName,
@@ -1142,7 +1152,7 @@ async function syncSinglePackage(packageSpec, config) {
 			recursive: true,
 			force: true
 		});
-		ejectReferences(skillDir, packageName, cwd, version, resources.docsType, features, resources.repoInfo);
+		ejectReferences(skillDir, storagePackageName, cwd, version, resources.docsType, features, resources.repoInfo);
 	}
 	if (!isEject) {
 		const shared = !config.global && getSharedSkillsDir(cwd);
@@ -1154,7 +1164,7 @@ async function syncSinglePackage(packageSpec, config) {
 	await shutdownWorker();
 	const ejectMsg = isEject ? " (ejected)" : "";
 	const relDir = relative(cwd, skillDir);
-	p.outro(config.mode === "update" ? `Updated ${packageName}${ejectMsg}` : `Synced ${packageName} → ${relDir}${ejectMsg}`);
+	p.outro(config.mode === "update" ? `Updated ${identityPackageName}${ejectMsg}` : `Synced ${identityPackageName} → ${relDir}${ejectMsg}`);
 	try {
 		await suggestPrepareHook(cwd);
 	} catch (err) {
@@ -1164,12 +1174,12 @@ async function syncSinglePackage(packageSpec, config) {
 const addCommandDef = defineCommand({
 	meta: {
 		name: "add",
-		description: "Add skills for package(s)"
+		description: "Install skills (npm:<pkg>, crate:<name>, gh:<owner/repo>, @<curator>)"
 	},
 	args: {
 		package: {
 			type: "positional",
-			description: "Package(s) to sync (space or comma-separated, e.g., vue nuxt pinia)",
+			description: "Package(s) to sync (space/comma-separated; npm:<pkg>, crate:<name>, or owner/repo)",
 			required: true
 		},
 		skill: {
@@ -1197,12 +1207,43 @@ const addCommandDef = defineCommand({
 			return;
 		}
 		if (!hasCompletedWizard()) await runWizard({ agent });
+		const parsedSources = rawInputs.map(parseSkillInput);
 		const gitSources = [];
-		const npmTokens = [];
-		for (const input of rawInputs) {
-			const git = parseGitSkillInput(input);
-			if (git) gitSources.push(git);
-			else npmTokens.push(input);
+		const npmEntries = [];
+		const crateSpecs = [];
+		const unsupported = [];
+		for (const source of parsedSources) switch (source.type) {
+			case "git":
+				gitSources.push(source.source);
+				break;
+			case "npm":
+				npmEntries.push({
+					name: source.package,
+					spec: source.tag ? `${source.package}@${source.tag}` : source.package
+				});
+				break;
+			case "crate":
+				crateSpecs.push(source.version ? `crate:${source.package}@${source.version}` : `crate:${source.package}`);
+				break;
+			case "bare":
+				p.log.warn(`Bare names are deprecated. Use \x1B[36mnpm:${source.package}\x1B[0m instead.`);
+				npmEntries.push({
+					name: source.package,
+					spec: source.tag ? `${source.package}@${source.tag}` : source.package
+				});
+				break;
+			case "curator":
+				unsupported.push(`@${source.handle} (curator)`);
+				break;
+			case "collection":
+				unsupported.push(`@${source.handle}/${source.name} (collection)`);
+				break;
+			default: throw new Error(`Unhandled SkillSource type: ${JSON.stringify(source)}`);
+		}
+		if (unsupported.length > 0) {
+			p.log.error(`Curator and collection installs are not yet available:\n  ${unsupported.join("\n  ")}\n\nFollow https://skilld.dev for launch updates.`);
+			process.exitCode = 1;
+			if (gitSources.length === 0 && npmEntries.length === 0 && crateSpecs.length === 0) return;
 		}
 		if (gitSources.length > 0) for (const source of gitSources) {
 			const skillFilter = args.skill ? args.skill.split(/[,\s]+/).map((s) => s.trim()).filter(Boolean) : void 0;
@@ -1217,15 +1258,50 @@ const addCommandDef = defineCommand({
 				skillFilter
 			});
 		}
-		if (npmTokens.length > 0) {
-			const packages = [...new Set(npmTokens.flatMap((s) => s.split(/[,\s]+/)).map((s) => s.trim()).filter(Boolean))];
+		if (npmEntries.length > 0) {
+			const { syncRegistrySkill } = await import("./sync-registry.mjs");
+			const seen = /* @__PURE__ */ new Set();
+			const dedupedEntries = npmEntries.filter((e) => {
+				if (seen.has(e.name)) return false;
+				seen.add(e.name);
+				return true;
+			});
+			const fallbackPackages = [];
+			for (const entry of dedupedEntries) {
+				const result = await syncRegistrySkill({
+					packageName: entry.name,
+					agent,
+					cwd
+				});
+				if (result) p.log.success(`Installed \x1B[36m${result.name}\x1B[0m from registry`);
+				else fallbackPackages.push(entry.spec);
+			}
+			if (fallbackPackages.length > 0) {
+				const state = await getProjectState(cwd);
+				p.intro(introLine({
+					state,
+					agentId: agent || void 0
+				}));
+				await syncCommand(state, {
+					packages: [...fallbackPackages, ...crateSpecs],
+					global: args.global,
+					agent,
+					model: args.model,
+					yes: args.yes,
+					force: args.force,
+					debug: args.debug
+				});
+				return;
+			}
+		}
+		if (crateSpecs.length > 0) {
 			const state = await getProjectState(cwd);
 			p.intro(introLine({
 				state,
 				agentId: agent || void 0
 			}));
-			return syncCommand(state, {
-				packages,
+			await syncCommand(state, {
+				packages: crateSpecs,
 				global: args.global,
 				agent,
 				model: args.model,
@@ -1337,7 +1413,7 @@ const updateCommandDef = defineCommand({
 		}
 		if (agent === "none") {
 			const state = await getProjectState(cwd);
-			const packages = args.package ? [...new Set([args.package, ...args._ || []].flatMap((s) => s.split(/[,\s]+/)).map((s) => s.trim()).filter(Boolean))] : state.outdated.map((s) => s.packageName || s.name);
+			const packages = args.package ? Array.from(new Set([args.package, ...args._ || []].flatMap((s) => s.split(/[,\s]+/)).map((s) => s.trim()).filter(Boolean)), (s) => resolveSkillName(s)).filter((s) => s !== null) : state.outdated.map((s) => s.packageName || s.name);
 			if (packages.length === 0) {
 				if (!silent) p.log.success("All skills up to date");
 				return;
@@ -1359,22 +1435,36 @@ const updateCommandDef = defineCommand({
 				agentId: config.agent || agent || void 0
 			}));
 		}
-		if (args.package) return syncCommand(state, {
-			packages: [...new Set([args.package, ...args._ || []].flatMap((s) => s.split(/[,\s]+/)).map((s) => s.trim()).filter(Boolean))],
-			global: args.global,
-			agent,
-			model: args.model || (silent ? config.model : void 0),
-			yes: args.yes || silent,
-			force: args.force,
-			debug: args.debug,
-			mode: "update"
-		});
-		if (state.outdated.length === 0) {
+		if (args.package) {
+			const raw = [...new Set([args.package, ...args._ || []].flatMap((s) => s.split(/[,\s]+/)).map((s) => s.trim()).filter(Boolean))];
+			const packages = [];
+			for (const r of raw) {
+				const name = resolveSkillName(r);
+				if (!name) {
+					p.log.warn(`Cannot update \x1B[36m${r}\x1B[0m: curator/collection inputs are not addressable here.`);
+					continue;
+				}
+				packages.push(name);
+			}
+			if (packages.length === 0) return;
+			return syncCommand(state, {
+				packages,
+				global: args.global,
+				agent,
+				model: args.model || (silent ? config.model : void 0),
+				yes: args.yes || silent,
+				force: args.force,
+				debug: args.debug,
+				mode: "update"
+			});
+		}
+		const crateSpecs = state.skills.map((s) => s.info?.packageName).filter((name) => !!name && name.startsWith("crate:"));
+		if (state.outdated.length === 0 && crateSpecs.length === 0) {
 			p.log.success("All skills up to date");
 			return;
 		}
 		return syncCommand(state, {
-			packages: state.outdated.map((s) => s.packageName || s.name),
+			packages: [...state.outdated.map((s) => s.packageName || s.name), ...crateSpecs],
 			global: args.global,
 			agent,
 			model: args.model || (silent ? config.model : void 0),
@@ -1509,7 +1599,6 @@ async function exportPortablePrompts(packageSpec, opts) {
 	const outputFileList = sectionList.map((s) => SECTION_OUTPUT_FILES[s]).join(", ");
 	p.log.info(`Have your agent enhance the skill. Give it this prompt:\n\x1B[2m\x1B[3m  Read each prompt file (${promptFiles}) in ${relDir}/, read the\n  referenced files, then write your output to the matching file (${outputFileList}).\n  When done, run: skilld assemble\x1B[0m`);
 }
-//#endregion
-export { updateCommandDef as a, syncCommand as i, ejectCommandDef as n, exportPortablePrompts as r, addCommandDef as t };
+export { syncCommand as a, isCrateSpec as i, ejectCommandDef as n, updateCommandDef as o, exportPortablePrompts as r, addCommandDef as t };
 
 //# sourceMappingURL=sync.mjs.map