@bud-fe/skills 0.0.3 → 0.0.4

package/dist/_chunks/libs/xdg-basedir.mjs

@@ -1,5 +1,5 @@
-import path from "path";
 import os from "os";
+import path from "path";
 const homeDirectory = os.homedir();
 const { env } = process;
 const xdgData = env.XDG_DATA_HOME || (homeDirectory ? path.join(homeDirectory, ".local", "share") : void 0);

package/dist/cli.mjs

@@ -9,17 +9,17 @@ import "./_chunks/libs/esprima.mjs";
 import "./_chunks/libs/@kwsites/file-exists.mjs";
 import "./_chunks/libs/@kwsites/promise-deferred.mjs";
 import { t as esm_default } from "./_chunks/libs/simple-git.mjs";
-import { execSync, spawn, spawnSync } from "child_process";
+import { execSync, spawnSync } from "child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { basename, dirname, extname, isAbsolute, join, normalize, relative, resolve, sep } from "path";
 import { homedir, platform, tmpdir } from "os";
-import { createHash } from "crypto";
+import { basename, dirname, extname, isAbsolute, join, normalize, relative, resolve, sep } from "path";
 import { fileURLToPath } from "url";
 import { access, cp, lstat, mkdir, mkdtemp, readFile, readdir, readlink, realpath, rm, stat, symlink, writeFile } from "fs/promises";
+import { createHash } from "crypto";
 import * as readline from "readline";
 import { Writable } from "stream";
 var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
-var version$1 = "0.0.3";
+var version$1 = "0.0.4";
 const home = homedir();
 const configHome = xdgConfig ?? join(home, ".config");
 const codexHome = process.env.CODEX_HOME?.trim() || join(home, ".codex");
@@ -1297,6 +1297,72 @@ async function listInstalledSkills(options = {}) {
 	} catch {}
 	return Array.from(skillsMap.values());
 }
+const LOCAL_LOCK_FILE = "skills-lock.json";
+const CURRENT_VERSION$1 = 1;
+function getLocalLockPath(cwd) {
+	return join(cwd || process.cwd(), LOCAL_LOCK_FILE);
+}
+async function readLocalLock(cwd) {
+	const lockPath = getLocalLockPath(cwd);
+	try {
+		const content = await readFile(lockPath, "utf-8");
+		const parsed = JSON.parse(content);
+		if (typeof parsed.version !== "number" || !parsed.skills) return createEmptyLocalLock();
+		if (parsed.version < CURRENT_VERSION$1) return createEmptyLocalLock();
+		return parsed;
+	} catch {
+		return createEmptyLocalLock();
+	}
+}
+async function writeLocalLock(lock, cwd) {
+	const lockPath = getLocalLockPath(cwd);
+	const sortedSkills = {};
+	for (const key of Object.keys(lock.skills).sort()) sortedSkills[key] = lock.skills[key];
+	const sorted = {
+		version: lock.version,
+		skills: sortedSkills
+	};
+	await writeFile(lockPath, JSON.stringify(sorted, null, 2) + "\n", "utf-8");
+}
+async function computeSkillFolderHash(skillDir) {
+	const files = [];
+	await collectFiles(skillDir, skillDir, files);
+	files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+	const hash = createHash("sha256");
+	for (const file of files) {
+		hash.update(file.relativePath);
+		hash.update(file.content);
+	}
+	return hash.digest("hex");
+}
+async function collectFiles(baseDir, currentDir, results) {
+	const entries = await readdir(currentDir, { withFileTypes: true });
+	await Promise.all(entries.map(async (entry) => {
+		const fullPath = join(currentDir, entry.name);
+		if (entry.isDirectory()) {
+			if (entry.name === ".git" || entry.name === "node_modules") return;
+			await collectFiles(baseDir, fullPath, results);
+		} else if (entry.isFile()) {
+			const content = await readFile(fullPath);
+			const relativePath = relative(baseDir, fullPath).split("\\").join("/");
+			results.push({
+				relativePath,
+				content
+			});
+		}
+	}));
+}
+async function addSkillToLocalLock(skillName, entry, cwd) {
+	const lock = await readLocalLock(cwd);
+	lock.skills[skillName] = entry;
+	await writeLocalLock(lock, cwd);
+}
+function createEmptyLocalLock() {
+	return {
+		version: CURRENT_VERSION$1,
+		skills: {}
+	};
+}
 async function fetchMintlifySkill(url) {
 	try {
 		const response = await fetch(url, { signal: AbortSignal.timeout(3e4) });
@@ -1772,7 +1838,7 @@ registerProvider(mintlifyProvider);
 registerProvider(huggingFaceProvider);
 const AGENTS_DIR$1 = ".agents";
 const LOCK_FILE$1 = ".skill-lock.json";
-const CURRENT_VERSION$1 = 3;
+const CURRENT_VERSION = 3;
 function getSkillLockPath$1() {
 	return join(homedir(), AGENTS_DIR$1, LOCK_FILE$1);
 }
@@ -1782,7 +1848,7 @@ async function readSkillLock$1() {
 		const content = await readFile(lockPath, "utf-8");
 		const parsed = JSON.parse(content);
 		if (typeof parsed.version !== "number" || !parsed.skills) return createEmptyLockFile();
-		if (parsed.version < CURRENT_VERSION$1) return createEmptyLockFile();
+		if (parsed.version < CURRENT_VERSION) return createEmptyLockFile();
 		return parsed;
 	} catch (error) {
 		return createEmptyLockFile();
@@ -1855,7 +1921,7 @@ async function getSkillFromLock(skillName) {
 }
 function createEmptyLockFile() {
 	return {
-		version: CURRENT_VERSION$1,
+		version: CURRENT_VERSION,
 		skills: {},
 		dismissed: {}
 	};
@@ -1877,72 +1943,6 @@ async function saveSelectedAgents(agents) {
 	lock.lastSelectedAgents = agents;
 	await writeSkillLock(lock);
 }
-const LOCAL_LOCK_FILE = "skills-lock.json";
-const CURRENT_VERSION = 1;
-function getLocalLockPath(cwd) {
-	return join(cwd || process.cwd(), LOCAL_LOCK_FILE);
-}
-async function readLocalLock(cwd) {
-	const lockPath = getLocalLockPath(cwd);
-	try {
-		const content = await readFile(lockPath, "utf-8");
-		const parsed = JSON.parse(content);
-		if (typeof parsed.version !== "number" || !parsed.skills) return createEmptyLocalLock();
-		if (parsed.version < CURRENT_VERSION) return createEmptyLocalLock();
-		return parsed;
-	} catch {
-		return createEmptyLocalLock();
-	}
-}
-async function writeLocalLock(lock, cwd) {
-	const lockPath = getLocalLockPath(cwd);
-	const sortedSkills = {};
-	for (const key of Object.keys(lock.skills).sort()) sortedSkills[key] = lock.skills[key];
-	const sorted = {
-		version: lock.version,
-		skills: sortedSkills
-	};
-	await writeFile(lockPath, JSON.stringify(sorted, null, 2) + "\n", "utf-8");
-}
-async function computeSkillFolderHash(skillDir) {
-	const files = [];
-	await collectFiles(skillDir, skillDir, files);
-	files.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
-	const hash = createHash("sha256");
-	for (const file of files) {
-		hash.update(file.relativePath);
-		hash.update(file.content);
-	}
-	return hash.digest("hex");
-}
-async function collectFiles(baseDir, currentDir, results) {
-	const entries = await readdir(currentDir, { withFileTypes: true });
-	await Promise.all(entries.map(async (entry) => {
-		const fullPath = join(currentDir, entry.name);
-		if (entry.isDirectory()) {
-			if (entry.name === ".git" || entry.name === "node_modules") return;
-			await collectFiles(baseDir, fullPath, results);
-		} else if (entry.isFile()) {
-			const content = await readFile(fullPath);
-			const relativePath = relative(baseDir, fullPath).split("\\").join("/");
-			results.push({
-				relativePath,
-				content
-			});
-		}
-	}));
-}
-async function addSkillToLocalLock(skillName, entry, cwd) {
-	const lock = await readLocalLock(cwd);
-	lock.skills[skillName] = entry;
-	await writeLocalLock(lock, cwd);
-}
-function createEmptyLocalLock() {
-	return {
-		version: CURRENT_VERSION,
-		skills: {}
-	};
-}
 function getOwnerRepo(parsed) {
 	if (parsed.type === "local") return null;
 	if (!parsed.url.startsWith("http://") && !parsed.url.startsWith("https://")) return null;
@@ -2075,8 +2075,7 @@ function parseSource(input) {
 		url: input
 	};
 	if (input.match(/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/i) && !input.includes("/") && !input.includes(":") && !input.startsWith(".")) return {
-		type: "github",
-		url: DEFAULT_REGISTRY_URL,
+		...parseSource(DEFAULT_REGISTRY_URL),
 		subpath: DEFAULT_REGISTRY_SUBPATH,
 		skillFilter: input
 	};
@@ -3057,12 +3056,12 @@ async function runAdd(args, options = {}) {
 		console.log(import_picocolors.default.bgRed(import_picocolors.default.white(import_picocolors.default.bold(" ERROR "))) + " " + import_picocolors.default.red("Missing required argument: source"));
 		console.log();
 		console.log(import_picocolors.default.dim("  Usage:"));
-		console.log(`    ${import_picocolors.default.cyan("npx skills add")} ${import_picocolors.default.yellow("<source>")} ${import_picocolors.default.dim("[options]")}`);
-		console.log(`    ${import_picocolors.default.cyan("npx skills add")} ${import_picocolors.default.yellow("[options]")} ${import_picocolors.default.dim("(uses default registry)")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add")} ${import_picocolors.default.yellow("<source>")} ${import_picocolors.default.dim("[options]")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add")} ${import_picocolors.default.yellow("[options]")} ${import_picocolors.default.dim("(uses default registry)")}`);
 		console.log();
 		console.log(import_picocolors.default.dim("  Example:"));
-		console.log(`    ${import_picocolors.default.cyan("npx skills add")} ${import_picocolors.default.yellow("vercel-labs/agent-skills")}`);
-		console.log(`    ${import_picocolors.default.cyan("npx skills add")} ${import_picocolors.default.yellow("--all")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add")} ${import_picocolors.default.yellow("vercel-labs/agent-skills")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add")} ${import_picocolors.default.yellow("--all")}`);
 		console.log();
 		process.exit(1);
 	}
@@ -3482,12 +3481,12 @@ async function runAddCommand(args, options = {}) {
 		console.log(import_picocolors.default.bgRed(import_picocolors.default.white(import_picocolors.default.bold(" ERROR "))) + " " + import_picocolors.default.red("Missing required argument: command"));
 		console.log();
 		console.log(import_picocolors.default.dim("  Usage:"));
-		console.log(`    ${import_picocolors.default.cyan("npx skills add-c")} ${import_picocolors.default.yellow("<command>")} ${import_picocolors.default.dim("[options]")}`);
-		console.log(`    ${import_picocolors.default.cyan("npx skills add-c")} ${import_picocolors.default.yellow("[options]")} ${import_picocolors.default.dim("(uses default registry)")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add-c")} ${import_picocolors.default.yellow("<command>")} ${import_picocolors.default.dim("[options]")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add-c")} ${import_picocolors.default.yellow("[options]")} ${import_picocolors.default.dim("(uses default registry)")}`);
 		console.log();
 		console.log(import_picocolors.default.dim("  Example:"));
-		console.log(`    ${import_picocolors.default.cyan("npx skills add-c")} ${import_picocolors.default.yellow("my-command")}`);
-		console.log(`    ${import_picocolors.default.cyan("npx skills add-c")} ${import_picocolors.default.yellow("--list")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add-c")} ${import_picocolors.default.yellow("my-command")}`);
+		console.log(`    ${import_picocolors.default.cyan("npx @bud-fe/skills add-c")} ${import_picocolors.default.yellow("--list")}`);
 		console.log();
 		process.exit(1);
 	}
@@ -3831,11 +3830,11 @@ async function promptForFindSkills(options, targetAgents) {
 				});
 			} catch {
 				M.warn("Failed to install find-skills. You can try again with:");
-				M.message(import_picocolors.default.dim("  npx skills add vercel-labs/skills@find-skills -g -y --all"));
+				M.message(import_picocolors.default.dim("  npx @bud-fe/skills add vercel-labs/skills@find-skills -g -y --all"));
 			}
 		} else {
 			await dismissPrompt("findSkillsPrompt");
-			M.message(import_picocolors.default.dim("You can install it later with: npx skills add vercel-labs/skills@find-skills"));
+			M.message(import_picocolors.default.dim("You can install it later with: npx @bud-fe/skills add vercel-labs/skills@find-skills"));
 		}
 	} catch {}
 }
@@ -4019,7 +4018,7 @@ function formatNonInteractiveResults(mode, defaultResults, apiResults) {
 	const hasDefault = mode === "default" && defaultResults.length > 0;
 	const hasApi = mode === "global" && apiResults.length > 0;
 	if (hasDefault) {
-		lines.push(`${DIM$2}Install with${RESET$2} npx skills add <name>${DIM$2} (From default registry)${RESET$2}`);
+		lines.push(`${DIM$2}Install with${RESET$2} npx @bud-fe/skills add <name>${DIM$2} (From default registry)${RESET$2}`);
 		lines.push("");
 		for (const skill of defaultResults) {
 			lines.push(`${TEXT$1}${skill.name}${RESET$2}`);
@@ -4028,7 +4027,7 @@ function formatNonInteractiveResults(mode, defaultResults, apiResults) {
 		}
 	}
 	if (hasApi) {
-		lines.push(`${DIM$2}Install with${RESET$2} npx skills add <owner/repo@skill>${DIM$2} (From https://skills.sh)${RESET$2}`);
+		lines.push(`${DIM$2}Install with${RESET$2} npx @bud-fe/skills add <owner/repo@skill>${DIM$2} (From https://skills.sh)${RESET$2}`);
 		lines.push("");
 		for (const skill of apiResults.slice(0, 6)) {
 			const pkg = skill.source || skill.slug;
@@ -4213,9 +4212,9 @@ async function runFind(args) {
 	const { mode, query } = parseFindArgs(args);
 	const isNonInteractive = !process.stdin.isTTY;
 	const agentTip = `${DIM$2}Tip: if running in a coding agent, follow these steps:${RESET$2}
-${DIM$2}  1) npx skills find [query]${RESET$2}
-${DIM$2}  2) npx skills find -g [query]${RESET$2}
-${DIM$2}  3) npx skills add <owner/repo@skill>${RESET$2}`;
+${DIM$2}  1) npx @bud-fe/skills find [query]${RESET$2}
+${DIM$2}  2) npx @bud-fe/skills find -g [query]${RESET$2}
+${DIM$2}  3) npx @bud-fe/skills add <owner/repo@skill>${RESET$2}`;
 	if (query) {
 		const { defaultResults, apiResults } = await searchSkillsByMode(query, mode);
 		const totalResults = defaultResults.length + apiResults.length;
@@ -4562,7 +4561,7 @@ async function runInstallFromLock(args) {
 	const skillEntries = Object.entries(lock.skills);
 	if (skillEntries.length === 0) {
 		M.warn("No project skills found in skills-lock.json");
-		M.info(`Add project-level skills with ${import_picocolors.default.cyan("npx skills add <package>")} (without ${import_picocolors.default.cyan("-g")})`);
+		M.info(`Add project-level skills with ${import_picocolors.default.cyan("npx @bud-fe/skills add <package>")} (without ${import_picocolors.default.cyan("-g")})`);
 		return;
 	}
 	const universalAgentNames = getUniversalAgents();
@@ -5038,20 +5037,20 @@ function showBanner() {
 	console.log();
 	console.log(`${DIM}The open agent skills ecosystem${RESET}`);
 	console.log();
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills add ${DIM}<package>${RESET}        ${DIM}Add a new skill${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills add-c ${DIM}<command>${RESET} ${DIM}Install a command${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills remove${RESET}               ${DIM}Remove installed skills${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills list${RESET}                 ${DIM}List installed skills${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills find ${DIM}[query] [-g]${RESET}    ${DIM}Search skills (default registry or global)${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills add ${DIM}<package>${RESET}        ${DIM}Add a new skill${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills add-c ${DIM}<command>${RESET} ${DIM}Install a command${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills remove${RESET}               ${DIM}Remove installed skills${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills list${RESET}                 ${DIM}List installed skills${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills find ${DIM}[query] [-g]${RESET}    ${DIM}Search skills (default registry or global)${RESET}`);
 	console.log();
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills check${RESET}                ${DIM}Check for updates${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills update${RESET}               ${DIM}Update all skills${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills check${RESET}                ${DIM}Check for updates${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills update${RESET}               ${DIM}Update all skills${RESET}`);
 	console.log();
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills experimental_install${RESET} ${DIM}Restore from skills-lock.json${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills init ${DIM}[name]${RESET}          ${DIM}Create a new skill${RESET}`);
-	console.log(`  ${DIM}$${RESET} ${TEXT}npx skills experimental_sync${RESET}    ${DIM}Sync skills from node_modules${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills experimental_install${RESET} ${DIM}Restore from skills-lock.json${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills init ${DIM}[name]${RESET}          ${DIM}Create a new skill${RESET}`);
+	console.log(`  ${DIM}$${RESET} ${TEXT}npx @bud-fe/skills experimental_sync${RESET}    ${DIM}Sync skills from node_modules${RESET}`);
 	console.log();
-	console.log(`${DIM}try:${RESET} npx skills add vercel-labs/agent-skills`);
+	console.log(`${DIM}try:${RESET} npx @bud-fe/skills add vercel-labs/agent-skills`);
 	console.log();
 	console.log(`Discover more skills at ${TEXT}https://skills.sh/${RESET}`);
 	console.log();
@@ -5215,8 +5214,8 @@ Describe when this skill should be used.
 	console.log(`  2. Update the ${TEXT}name${RESET} and ${TEXT}description${RESET} in the frontmatter`);
 	console.log();
 	console.log(`${DIM}Publishing:${RESET}`);
-	console.log(`  ${DIM}GitHub:${RESET}  Push to a repo, then ${TEXT}npx skills add <owner>/<repo>${RESET}`);
-	console.log(`  ${DIM}URL:${RESET}     Host the file, then ${TEXT}npx skills add https://example.com/${displayPath}${RESET}`);
+	console.log(`  ${DIM}GitHub:${RESET}  Push to a repo, then ${TEXT}npx @bud-fe/skills add <owner>/<repo>${RESET}`);
+	console.log(`  ${DIM}URL:${RESET}     Host the file, then ${TEXT}npx @bud-fe/skills add https://example.com/${displayPath}${RESET}`);
 	console.log();
 	console.log(`Browse existing skills for inspiration at ${TEXT}https://skills.sh/${RESET}`);
 	console.log();
@@ -5254,14 +5253,14 @@ async function runCheck(args = []) {
 	const lock = readSkillLock();
 	if (Object.keys(lock.skills).length === 0) {
 		console.log(`${DIM}No skills tracked in lock file.${RESET}`);
-		console.log(`${DIM}Install skills with${RESET} ${TEXT}npx skills add <package>${RESET}`);
+		console.log(`${DIM}Install skills with${RESET} ${TEXT}npx @bud-fe/skills add <package>${RESET}`);
 		return;
 	}
 	const result = await detectSkillUpdates(lock, { githubToken: getGitHubToken() });
 	const totalSkills = result.checkedCount;
 	if (totalSkills === 0) {
 		console.log(`${DIM}No skills with update metadata to check.${RESET}`);
-		if (result.skippedMissingMetadata > 0) console.log(`${DIM}${result.skippedMissingMetadata} skill(s) are missing hash metadata (run${RESET} ${TEXT}npx skills add <source> -g${RESET} ${DIM}to reinstall and track updates).${RESET}`);
+		if (result.skippedMissingMetadata > 0) console.log(`${DIM}${result.skippedMissingMetadata} skill(s) are missing hash metadata (run${RESET} ${TEXT}npx @bud-fe/skills add <source> -g${RESET} ${DIM}to reinstall and track updates).${RESET}`);
 		return;
 	}
 	console.log(`${DIM}Checking ${totalSkills} skill(s) for updates...${RESET}`);
@@ -5277,7 +5276,7 @@ async function runCheck(args = []) {
 			console.log(`    ${DIM}source: ${update.source}${RESET}`);
 		}
 		console.log();
-		console.log(`${DIM}Run${RESET} ${TEXT}npx skills update${RESET} ${DIM}to update all skills${RESET}`);
+		console.log(`${DIM}Run${RESET} ${TEXT}npx @bud-fe/skills update${RESET} ${DIM}to update all skills${RESET}`);
 	}
 	if (errors.length > 0) {
 		console.log();
@@ -5300,7 +5299,7 @@ async function runUpdate() {
 	const lock = readSkillLock();
 	if (Object.keys(lock.skills).length === 0) {
 		console.log(`${DIM}No skills tracked in lock file.${RESET}`);
-		console.log(`${DIM}Install skills with${RESET} ${TEXT}npx skills add <package>${RESET}`);
+		console.log(`${DIM}Install skills with${RESET} ${TEXT}npx @bud-fe/skills add <package>${RESET}`);
 		return;
 	}
 	const result = await detectSkillUpdates(lock, { githubToken: getGitHubToken() });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bud-fe/skills",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "The open agent skills ecosystem",
   "type": "module",
   "bin": {