agent-skills-standard 2.2.4 → 2.3.0

package/README.md

@@ -122,6 +122,7 @@ The CLI **never** modifies user-home files (`~/.cursor/mcp.json`, `~/.gemini/set
 
 | Version | Date | Skills | Avg Tokens | Savings (%) | Report |
 | --- | --- | --- | --- | --- | --- |
+| v2.3.0 | 2026-05-13 | 246 | 540 | 85% | [Report](benchmarks/archive/v2.3.0.md) |
 | v2.2.2 | 2026-05-09 | 249 | 539 | 85% | [Report](benchmarks/archive/v2.2.2.md) |
 | v2.2.0 | 2026-04-22 | 242 | 538 | 85% | [Report](benchmarks/archive/v2.2.0.md) |
 | v2.1.2 | 2026-04-11 | 237 | 516 | 86% | [Report](benchmarks/archive/v2.1.2.md) |
@@ -131,4 +132,3 @@ The CLI **never** modifies user-home files (`~/.cursor/mcp.json`, `~/.gemini/set
 | v2.0.0 | 2026-03-25 | 235 | 523 | 86% | [Report](benchmarks/archive/v2.0.0.md) |
 | v1.10.3 | 2026-03-21 | 234 | 505 | 86% | [Report](benchmarks/archive/v1.10.3.md) |
 | v1.10.1 | 2026-03-16 | 229 | 428 | 88% | [Report](benchmarks/archive/v1.10.1.md) |
-| v1.10.0 | 2026-03-16 | 229 | 434 | 88% | [Report](benchmarks/archive/v1.10.0.md) |

package/dist/index.js

@@ -3657,10 +3657,22 @@ Follow the exact steps in the workflow file.
 	* Invoked through each platform's skill mechanism.
 	*/
 	static toSkillMarkdown(name, description, body) {
-		return `# ${name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ")} Skill
+		const normalizedDescription = description || `Workflow skill for ${name.replace(/-/g, " ")}.`;
+		const escapedDescription = normalizedDescription.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+		const title = name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+		return `---
+name: ${name}
+description: "${escapedDescription}"
+metadata:
+  triggers:
+    keywords:
+    - ${name.replace(/-/g, " ")}
+    - workflow
+---
+# ${title} Skill
 
 > [!IMPORTANT]
-> ${description}
+> ${normalizedDescription}
 
 ## Instructions
 
@@ -4370,7 +4382,7 @@ var SyncCommand = class {
 };
 var package_default = {
 	name: "agent-skills-standard",
-	version: "2.2.4",
+	version: "2.3.0",
 	description: "A CLI to manage and sync AI agent skills standard for Cursor, Claude, Copilot, Windsurf, and more.",
 	main: "dist/index.js",
 	bin: {
@@ -4465,40 +4477,44 @@ var UpgradeCommand = class {
 		console.log(picocolors.default.yellow(`📦 Upgrading to v${latestVersion} using ${pm}...`));
 		try {
 			console.log(picocolors.default.gray(`  Running: ${upgradeCmd}`));
-			(0, child_process.execSync)(upgradeCmd, { stdio: "inherit" });
 			try {
-				const lines = (0, child_process.execSync)("ags -V", { encoding: "utf8" }).trim().split("\n");
+				(0, child_process.execSync)(upgradeCmd, { stdio: "inherit" });
+			} catch {
+				console.log(picocolors.default.yellow(`⚠️  Failed to install v${latestVersion}. Retrying with @latest...`));
+				(0, child_process.execSync)(this.getUpgradeCommand(pm, "latest"), { stdio: "inherit" });
+			}
+			try {
+				const lines = (0, child_process.execSync)("ags -V", {
+					encoding: "utf8",
+					stdio: "pipe"
+				}).trim().split("\n");
 				const installedVersion = lines[lines.length - 1].trim();
-				if (installedVersion === latestVersion) console.log(picocolors.default.green(`✅ Successfully upgraded to v${latestVersion}!`));
+				if (installedVersion.includes(latestVersion)) console.log(picocolors.default.green(`✅ Successfully upgraded to v${latestVersion}!`));
 				else {
-					console.log("\n" + picocolors.default.yellow(`⚠️  Install finished, but 'ags -V' still reports v${installedVersion}.`));
-					console.log(picocolors.default.gray("   This is likely due to package manager caching or a PATH conflict."));
-					console.log(picocolors.default.cyan(`👉 Recommendation: Run '${picocolors.default.bold(upgradeCmd + " --force")}' manually.`));
+					console.log("\n" + picocolors.default.yellow(`⚠️  Installation complete, but 'ags -V' still reports v${installedVersion}.`));
+					console.log(picocolors.default.gray("   This is common if multiple versions are installed or your shell needs a restart."));
+					console.log(picocolors.default.cyan(`👉 Recommendation: Restart your terminal or run: ${picocolors.default.bold(this.getUpgradeCommand(pm, latestVersion) + " --force")}`));
 				}
 			} catch {
-				console.log(picocolors.default.green(`✅ Install command completed.`));
+				console.log(picocolors.default.green("\n✅ Upgrade command finished."));
+				console.log(picocolors.default.gray("   (Unable to verify version automatically, please check with 'ags -V')"));
 			}
-			console.log(picocolors.default.cyan("Please restart your terminal if the version doesn't update immediately."));
+			console.log(picocolors.default.cyan("\nNote: You may need to restart your terminal session for changes to take effect."));
 		} catch {
 			console.log("\n" + picocolors.default.red("❌ Automatic upgrade failed."));
 			this.printManualInstructions(pm, latestVersion);
 		}
 	}
 	detectPackageManager() {
-		const userAgent = process.env.npm_config_user_agent || "";
-		if (userAgent.includes("pnpm")) return "pnpm";
-		if (userAgent.includes("yarn")) return "yarn";
+		const execPath = process.argv[1] || "";
+		if (execPath.includes("pnpm") || (process.env.npm_config_user_agent || "").includes("pnpm")) return "pnpm";
+		if (execPath.includes("yarn") || (process.env.npm_config_user_agent || "").includes("yarn")) return "yarn";
+		if (execPath.includes("nvm") || execPath.includes("npm")) return "npm";
 		try {
 			(0, child_process.execSync)("pnpm --version", { stdio: "ignore" });
-			return "pnpm";
-		} catch {
-			try {
-				(0, child_process.execSync)("yarn --version", { stdio: "ignore" });
-				return "yarn";
-			} catch {
-				return "npm";
-			}
-		}
+			if (execPath.includes("pnpm")) return "pnpm";
+		} catch {}
+		return "npm";
 	}
 	getUpgradeCommand(pm, version) {
 		switch (pm) {
@@ -4852,7 +4868,7 @@ var ValidateCommand = class {
 //#region src/index.ts
 dotenv.default.config();
 var program = new commander.Command();
-program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.2.4");
+program.name("agent-skills-standard").description("A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, Windsurf, and more.").version("2.3.0");
 program.command("init").description("Initialize a .skillsrc configuration file interactively").action(async () => {
 	await new InitCommand().run();
 });