skilld 1.6.2 → 1.7.1

package/dist/_chunks/sync.mjs

@@ -1,17 +1,19 @@
-import { c as getVersionKey, o as getCacheDir, t as CACHE_DIR } from "./config.mjs";
+import { a as getModelLabel, i as getAvailableModels, s as optimizeDocs, t as detectImportedPackages } from "./agent.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 { a as hasShippedDocs, d as linkPkgNamed, g as readCachedSection, i as getPkgKeyFiles, m as listReferenceFiles, r as ensureCacheDir, s as isCached } from "./cache.mjs";
 import { i as parseFrontmatter } from "./markdown.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 { J as isPrerelease, M as resolveGitHubRepo, f as resolvePackageDocsWithAttempts, i as fetchPkgDist, it as parsePackageSpec, m as fetchGitSkills, nt as parseGitHubRepoSlug, p as searchNpmPackages, s as readLocalDependencies, w as resolveCrateDocsWithAttempts } 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 { 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 removeLockEntry, i as readLock, n as parsePackages, s as writeLock } from "./lockfile.mjs";
+import { c as wrapSection, n as SECTION_OUTPUT_FILES, r as buildAllSectionPrompts, s as portabilizePrompt, t as SECTION_MERGE_ORDER } from "./prompts.mjs";
+import { _ as timedSpinner, i as computeSkillDirName, n as writeGeneratedSkillMd, o as linkSkillToAgents, r as writeSkillMd, s as sanitizeName, u as formatDuration, v as todayIsoDate } from "./skill.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 readLock, c as writeLock, n as parsePackageNames, o as removeLockEntry, r as parsePackages } from "./lockfile.mjs";
 import { t as getProjectState } from "./skills.mjs";
-import { l as timedSpinner, n as formatDuration } from "./formatting.mjs";
+import { n as resolveSkillName, r as toStoragePackageName, t as parseSkillInput } from "./prefix.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";
@@ -84,7 +86,7 @@ async function syncGitSkills(opts) {
 	for (const skill of selected) {
 		const skillDir = join(baseDir, skill.name);
 		mkdirSync(skillDir, { recursive: true });
-		writeFileSync(join(skillDir, "SKILL.md"), sanitizeMarkdown(skill.content));
+		writeSkillMd(skillDir, sanitizeMarkdown(skill.content));
 		if (skill.files.length > 0) for (const f of skill.files) {
 			const filePath = join(skillDir, f.path);
 			mkdirSync(dirname(filePath), { recursive: true });
@@ -96,7 +98,7 @@ async function syncGitSkills(opts) {
 			repo: source.type === "local" ? source.localPath : `${source.owner}/${source.repo}`,
 			path: skill.path || void 0,
 			ref: source.ref || "main",
-			syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+			syncedAt: todayIsoDate(),
 			generator: "external"
 		});
 	}
@@ -179,10 +181,10 @@ async function syncGitHubRepo(opts) {
 		version,
 		repo: `${owner}/${repo}`,
 		source: resources.docSource,
-		syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+		syncedAt: todayIsoDate(),
 		generator: "skilld"
 	});
-	const baseSkillMd = generateSkillMd({
+	writeGeneratedSkillMd(skillDir, {
 		name: packageName,
 		version,
 		releasedAt: resolved.releasedAt,
@@ -199,7 +201,6 @@ async function syncGitHubRepo(opts) {
 		repoUrl,
 		features
 	});
-	writeFileSync(join(skillDir, "SKILL.md"), baseSkillMd);
 	p.log.success(`Created base skill: ${relative(cwd, skillDir)}`);
 	if (!readConfig().skipLlm && (!yes || opts.model)) {
 		const llmConfig = await selectLlmConfig(opts.model);
@@ -366,7 +367,7 @@ async function syncPackagesParallel(config) {
 				if (content) cachedParts.push(wrapSection(s, content));
 			}
 			const cachedBody = cachedParts.join("\n\n");
-			const skillMd = generateSkillMd({
+			writeGeneratedSkillMd(skillDir, {
 				name: resolvedName,
 				version: data.version,
 				releasedAt: data.resolved.releasedAt,
@@ -386,7 +387,6 @@ async function syncPackagesParallel(config) {
 				repoUrl: data.resolved.repoUrl,
 				features: data.features
 			});
-			writeFileSync(join(skillDir, "SKILL.md"), skillMd);
 			cachedPkgs.push(pkg);
 		}
 	}
@@ -576,19 +576,19 @@ async function syncBaseSkill(packageSpec, config, cwd, update) {
 	const relatedSkills = await findRelatedSkills(packageName, baseDir);
 	const shippedDocs = hasShippedDocs(packageName, cwd, version);
 	const pkgFiles = getPkgKeyFiles(packageName, cwd, version);
-	const repoSlug = resolved.repoUrl?.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?(?:[/#]|$)/)?.[1];
+	const repoSlug = parseGitHubRepoSlug(resolved.repoUrl);
 	linkPkgNamed(skillDir, packageName, cwd, version);
 	writeLock(baseDir, skillDirName, {
 		packageName,
 		version,
 		repo: repoSlug,
 		source: resources.docSource,
-		syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+		syncedAt: todayIsoDate(),
 		generator: "skilld"
 	});
 	const updatedLock = readLock(baseDir)?.skills[skillDirName];
-	const allPackages = parsePackages(updatedLock?.packages).map((p) => ({ name: p.name }));
-	const skillMd = generateSkillMd({
+	const allPackages = parsePackageNames(updatedLock?.packages);
+	const overheadLines = writeGeneratedSkillMd(skillDir, {
 		name: packageName,
 		version,
 		releasedAt: resolved.releasedAt,
@@ -606,9 +606,7 @@ async function syncBaseSkill(packageSpec, config, cwd, update) {
 		packages: allPackages.length > 1 ? allPackages : void 0,
 		repoUrl: resolved.repoUrl,
 		features
-	});
-	writeFileSync(join(skillDir, "SKILL.md"), skillMd);
-	const overheadLines = skillMd.split("\n").length;
+	}).split("\n").length;
 	const shared = !config.global && getSharedSkillsDir(cwd);
 	if (shared) linkSkillToAgents(skillDirName, shared, cwd, config.agent);
 	if (!config.global) registerProject(cwd);
@@ -669,28 +667,25 @@ async function enhanceWithLLM(packageName, data, config, cwd, update, sections,
 		update(packageName, "error", error, versionKey);
 		throw new Error(error);
 	}
-	if (wasOptimized) {
-		const skillMd = generateSkillMd({
-			name: packageName,
-			version: data.version,
-			releasedAt: data.resolved.releasedAt,
-			distTags: data.resolved.distTags,
-			body: optimized,
-			relatedSkills: data.relatedSkills,
-			hasIssues: data.hasIssues,
-			hasDiscussions: data.hasDiscussions,
-			hasReleases: data.hasReleases,
-			hasChangelog: data.hasChangelog,
-			docsType: data.docsType,
-			hasShippedDocs: data.shippedDocs,
-			pkgFiles: data.pkgFiles,
-			dirName: data.skillDirName,
-			packages: data.packages,
-			repoUrl: data.resolved.repoUrl,
-			features: data.features
-		});
-		writeFileSync(join(skillDir, "SKILL.md"), skillMd);
-	}
+	if (wasOptimized) writeGeneratedSkillMd(skillDir, {
+		name: packageName,
+		version: data.version,
+		releasedAt: data.resolved.releasedAt,
+		distTags: data.resolved.distTags,
+		body: optimized,
+		relatedSkills: data.relatedSkills,
+		hasIssues: data.hasIssues,
+		hasDiscussions: data.hasDiscussions,
+		hasReleases: data.hasReleases,
+		hasChangelog: data.hasChangelog,
+		docsType: data.docsType,
+		hasShippedDocs: data.shippedDocs,
+		pkgFiles: data.pkgFiles,
+		dirName: data.skillDirName,
+		packages: data.packages,
+		repoUrl: data.resolved.repoUrl,
+		features: data.features
+	});
 	update(packageName, "done", "Skill optimized", versionKey);
 }
 const RESOLVE_SOURCE_LABELS = {
@@ -713,10 +708,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,
@@ -725,7 +728,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);
@@ -802,64 +806,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) {
@@ -869,18 +888,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;
 			}
@@ -889,7 +908,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,
@@ -901,24 +920,25 @@ async function syncSinglePackage(packageSpec, config) {
 		})()
 	} : void 0;
 	if (isMerge) {
-		spin.stop(`Merging ${packageName} into ${skillDirName}`);
-		linkPkgNamed(skillDir, packageName, cwd, version);
-		const repoSlug = resolved.repoUrl?.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?(?:[/#]|$)/)?.[1];
+		spin.stop(`Merging ${identityPackageName} into ${skillDirName}`);
+		linkPkgNamed(skillDir, storagePackageName, cwd, version);
+		const repoSlug = parseGitHubRepoSlug(resolved.repoUrl);
 		writeLock(baseDir, skillDirName, {
-			packageName,
+			packageName: identityPackageName,
 			version,
 			repo: repoSlug,
 			source: existingLock.source,
-			syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+			syncedAt: todayIsoDate(),
 			generator: "skilld"
 		});
 		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 allPackages = parsePackageNames(updatedLock?.packages);
+		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({
+		writeGeneratedSkillMd(skillDir, {
 			name: existingLock.packageName,
 			version: existingLock.version,
 			relatedSkills,
@@ -932,11 +952,10 @@ async function syncSinglePackage(packageSpec, config) {
 			packages: allPackages,
 			features: mergeFeatures
 		});
-		writeFileSync(join(skillDir, "SKILL.md"), skillMd);
 		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 };
@@ -944,7 +963,7 @@ async function syncSinglePackage(packageSpec, config) {
 	const resSpin = timedSpinner();
 	resSpin.start("Finding resources");
 	const resources = await fetchAndCacheResources({
-		packageName,
+		packageName: storagePackageName,
 		resolved,
 		version,
 		useCache,
@@ -962,12 +981,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,
@@ -976,35 +995,35 @@ 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 repoSlug = resolved.repoUrl?.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?(?:[/#]|$)/)?.[1];
-	if (!config.eject) linkPkgNamed(skillDir, 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 = parseGitHubRepoSlug(resolved.repoUrl);
+	if (!config.eject) linkPkgNamed(skillDir, storagePackageName, cwd, version);
 	if (!config.eject) {
 		writeLock(baseDir, skillDirName, {
-			packageName,
+			packageName: identityPackageName,
 			version,
 			repo: repoSlug,
 			source: resources.docSource,
-			syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+			syncedAt: todayIsoDate(),
 			generator: "skilld"
 		});
 		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 });
 			}
 		}
 	}
-	const allPackages = parsePackages((config.eject ? void 0 : readLock(baseDir)?.skills[skillDirName])?.packages).map((p) => ({ name: p.name }));
+	const allPackages = parsePackageNames((config.eject ? void 0 : readLock(baseDir)?.skills[skillDirName])?.packages);
 	const isEject = !!config.eject;
-	const baseSkillMd = generateSkillMd({
-		name: packageName,
+	const overheadLines = writeGeneratedSkillMd(skillDir, {
+		name: identityPackageName,
 		version,
 		releasedAt: resolved.releasedAt,
 		description: resolved.description,
@@ -1022,25 +1041,23 @@ async function syncSinglePackage(packageSpec, config) {
 		repoUrl: resolved.repoUrl,
 		features,
 		eject: isEject
-	});
-	writeFileSync(join(skillDir, "SKILL.md"), baseSkillMd);
-	const overheadLines = baseSkillMd.split("\n").length;
+	}).split("\n").length;
 	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,
+		writeGeneratedSkillMd(skillDir, {
+			name: identityPackageName,
 			version,
 			releasedAt: resolved.releasedAt,
 			description: resolved.description,
@@ -1061,7 +1078,6 @@ async function syncSinglePackage(packageSpec, config) {
 			features,
 			eject: isEject
 		});
-		writeFileSync(join(skillDir, "SKILL.md"), skillMd);
 		p.log.success("Applied cached SKILL.md sections");
 	}
 	const globalConfig = readConfig();
@@ -1074,7 +1090,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,
@@ -1092,7 +1108,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,
@@ -1123,7 +1140,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);
@@ -1135,7 +1152,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) {
@@ -1145,12 +1162,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: {
@@ -1178,12 +1195,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;
@@ -1198,15 +1246,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,
@@ -1318,7 +1401,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;
@@ -1340,22 +1423,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),
@@ -1448,7 +1545,7 @@ async function exportPortablePrompts(packageSpec, opts) {
 		writeFileSync(join(skillDir, `PROMPT_${section}.md`), portable);
 	}
 	const relatedSkills = await findRelatedSkills(packageName, join(skillDir, ".."));
-	const skillMd = generateSkillMd({
+	writeGeneratedSkillMd(skillDir, {
 		name: packageName,
 		version,
 		releasedAt: resolved.releasedAt,
@@ -1466,14 +1563,12 @@ async function exportPortablePrompts(packageSpec, opts) {
 		features,
 		eject: true
 	});
-	writeFileSync(join(skillDir, "SKILL.md"), skillMd);
-	const repoSlug = resolved.repoUrl?.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?(?:[/#]|$)/)?.[1];
 	writeLock(baseDir, skillDirName, {
 		packageName,
 		version,
-		repo: repoSlug,
+		repo: parseGitHubRepoSlug(resolved.repoUrl),
 		source: resources.docSource,
-		syncedAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+		syncedAt: todayIsoDate(),
 		generator: "skilld"
 	});
 	if (agent) {
@@ -1490,6 +1585,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`);
 }
-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