@buiducnhat/agent-skills 0.4.2 → 0.4.3

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
 import fs, { existsSync, lstatSync, mkdtempSync, readdirSync } from "node:fs";
+import os, { tmpdir } from "node:os";
 import path, { dirname, join } from "node:path";
 import N, { stdin, stdout } from "node:process";
 import * as k from "node:readline";
@@ -8,7 +9,6 @@ import ot from "node:readline";
 import { ReadStream } from "node:tty";
 import { stripVTControlCharacters } from "node:util";
 import { execSync, spawn } from "node:child_process";
-import { tmpdir } from "node:os";
 
 //#region \0rolldown/runtime.js
 var __create = Object.create;
@@ -2217,7 +2217,7 @@ function injectRules(projectDir, agents, agentsContent) {
 
 //#endregion
 //#region src/skills.ts
-async function runSkillsAdd(projectDir, agents, copy = false) {
+async function runSkillsAdd(projectDir, agents, copy = false, global = false) {
 	const args = agents.length === 0 ? [
 		"skills",
 		"add",
@@ -2236,6 +2236,7 @@ async function runSkillsAdd(projectDir, agents, copy = false) {
 		"-y"
 	];
 	if (copy) args.push("--copy");
+	if (global) args.push("-g");
 	return new Promise((resolve) => {
 		const child = spawn("npx", args, {
 			cwd: projectDir,
@@ -2257,7 +2258,8 @@ function parseArgs(argv) {
 		nonInteractive: false,
 		help: false,
 		version: false,
-		copy: false
+		copy: false,
+		global: false
 	};
 	for (let i = 0; i < argv.length; i++) switch (argv[i]) {
 		case "--non-interactive":
@@ -2274,6 +2276,10 @@ function parseArgs(argv) {
 		case "--copy":
 			args.copy = true;
 			break;
+		case "--global":
+		case "-g":
+			args.global = true;
+			break;
 	}
 	return args;
 }
@@ -2316,7 +2322,12 @@ function printHelp() {
 
   Options:
     --non-interactive    Skip interactive prompts (installs all skills to all agents)
-    --copy               Copy skill files instead of symlinking
+    --copy               Copy skill files instead of symlinking. Use this
+                         when your environment doesn’t support symlinks or you
+                         prefer independent copies; symlinks are recommended so
+                         updates propagate automatically.
+    -g, --global         Install skills to user home directory (~/<agent>/skills/)
+                         instead of the current project directory.
     -h, --help           Show this help message
     -v, --version        Show version
 
@@ -2324,6 +2335,8 @@ function printHelp() {
     npx @buiducnhat/agent-skills
     npx @buiducnhat/agent-skills --non-interactive
     npx @buiducnhat/agent-skills --copy
+    npx @buiducnhat/agent-skills --global
+    npx @buiducnhat/agent-skills --global --non-interactive
 `);
 }
 function printSummary(agents, results) {
@@ -2363,21 +2376,23 @@ async function main() {
 	}
 	We(import_picocolors.default.bold(import_picocolors.default.cyan(" Agent Skills Installer ")));
 	const cwd = process.cwd();
+	const baseDir = args.global ? os.homedir() : cwd;
+	if (args.global) R.info(`Global mode: installing to ${import_picocolors.default.cyan(os.homedir())}`);
 	let selectedAgents;
 	if (args.nonInteractive) {
 		R.step("Installing skills to all agents (non-interactive)...");
-		if (!(await runSkillsAdd(cwd, [], args.copy)).success) {
+		if (!(await runSkillsAdd(cwd, [], args.copy, args.global)).success) {
 			Ne(import_picocolors.default.red("Skills CLI failed. See errors above.\nYou can try running manually: npx skills add buiducnhat/agent-skills --skill '*' --all -y"));
 			process.exit(1);
 		}
-		selectedAgents = detectAgentsFromFilesystem(cwd);
+		selectedAgents = detectAgentsFromFilesystem(baseDir);
 		if (selectedAgents.length === 0) {
 			R.warn("No agents detected from filesystem. Skills may have been installed but rules injection was skipped.");
 			Le(import_picocolors.default.yellow("Done. No agent rules files were updated."));
 			process.exit(0);
 		}
 	} else {
-		const preSelected = detectAgentsFromFilesystem(cwd);
+		const preSelected = detectAgentsFromFilesystem(baseDir);
 		const selection = await je({
 			message: "Select agents to install skills for:",
 			options: SUPPORTED_AGENTS.map((a) => ({
@@ -2396,8 +2411,24 @@ async function main() {
 			Le(import_picocolors.default.yellow("No agents selected. Nothing to install."));
 			process.exit(0);
 		}
+		const installMode = await Je({
+			message: "How should the skills be installed?",
+			options: [{
+				label: "Symlink (recommended)",
+				value: "symlink"
+			}, {
+				label: "Copy",
+				value: "copy"
+			}],
+			initialValue: args.copy ? "copy" : "symlink"
+		});
+		if (Ct$1(installMode)) {
+			Ne("Installation cancelled.");
+			process.exit(0);
+		}
+		const copyFlag = installMode === "copy";
 		R.step("Installing skills via skills CLI...");
-		if (!(await runSkillsAdd(cwd, selectedAgents, args.copy)).success) {
+		if (!(await runSkillsAdd(cwd, selectedAgents, copyFlag, args.global)).success) {
 			Ne(import_picocolors.default.red("Skills CLI failed. See errors above.\nYou can try running manually: npx skills add buiducnhat/agent-skills --skill '*' -a <agent> -y"));
 			process.exit(1);
 		}
@@ -2407,8 +2438,8 @@ async function main() {
 	try {
 		tempDir = await fetchTemplates();
 		const agentsContent = fs.readFileSync(path.join(tempDir, "templates", "AGENTS.md"), "utf-8");
-		const results = injectRules(cwd, selectedAgents, agentsContent);
-		copyClaudeTemplate(tempDir, cwd);
+		const results = injectRules(baseDir, selectedAgents, agentsContent);
+		copyClaudeTemplate(tempDir, baseDir);
 		printSummary(selectedAgents, results);
 		Le(import_picocolors.default.green("Done! Your AI agent skills are ready."));
 	} catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@buiducnhat/agent-skills",
-	"version": "0.4.2",
+	"version": "0.4.3",
 	"description": "Install AI agent workflow skills for coding assistants",
 	"type": "module",
 	"bin": {