claude-skills-cli 0.0.20 → 0.0.22

package/dist/package.cmd-BYhkheya.js

@@ -0,0 +1,107 @@
+import { t as ensure_dir } from "./fs-CuGv3Ob2.js";
+import { a as search, c as warning, i as package_, n as error, o as success, s as upload } from "./output-DiffPD2u.js";
+import { t as SkillValidator } from "./validator-Dp5x-OjP.js";
+import { defineCommand } from "citty";
+import { existsSync, statSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { execSync } from "node:child_process";
+//#region src/commands/package.ts
+function validate_skill(skill_path) {
+	search("Validating skill...");
+	const result = new SkillValidator(skill_path).validate_all();
+	if (result.errors.length > 0) {
+		console.log("\n❌ Errors:");
+		for (const err of result.errors) console.log(`  ${String(err)}`);
+	}
+	if (result.warnings.length > 0) {
+		console.log("\n⚠️  Warnings:");
+		for (const warn of result.warnings) console.log(`  ${warn}`);
+	}
+	if (result.is_valid) {
+		success("Skill is valid!");
+		console.log("");
+		return true;
+	} else {
+		error("Validation failed. Fix errors before packaging.");
+		return false;
+	}
+}
+function package_skill(skill_path, output_dir) {
+	const skill_name = basename(skill_path);
+	const output_file = resolve(output_dir, `${skill_name}.zip`);
+	package_(`Packaging skill: ${skill_name}`);
+	ensure_dir(output_dir);
+	if (existsSync(output_file)) execSync(`rm ${output_file}`);
+	execSync(`cd "${resolve(skill_path, "..")}" && zip -r "${output_file}" "${skill_name}" -x '${skill_name}/.*' '${skill_name}/*.swp' '${skill_name}/*~' '${skill_name}/.DS_Store'`);
+	return output_file;
+}
+async function package_command(options) {
+	const { skill_path, output, skip_validation } = options;
+	if (!existsSync(skill_path)) {
+		error(`Skill directory does not exist: ${skill_path}`);
+		process.exit(1);
+	}
+	if (!statSync(skill_path).isDirectory()) {
+		error(`Path is not a directory: ${skill_path}`);
+		process.exit(1);
+	}
+	if (!existsSync(join(skill_path, "SKILL.md"))) {
+		error(`SKILL.md not found in ${skill_path}`);
+		process.exit(1);
+	}
+	if (!skip_validation) {
+		if (!validate_skill(skill_path)) process.exit(1);
+	}
+	try {
+		const output_file = package_skill(skill_path, output || "dist");
+		const size_kb = statSync(output_file).size / 1024;
+		console.log("");
+		success("Skill packaged successfully!");
+		console.log(`   File: ${output_file}`);
+		console.log(`   Size: ${size_kb.toFixed(1)} KB`);
+		console.log("");
+		warning("Note: ZIP packaging is not an official Claude Code distribution method.");
+		console.log("   Official distribution uses the plugin system (/plugin install)");
+		console.log("   or direct file placement in .claude/skills/.");
+		console.log("   See: https://code.claude.com/docs/en/plugins");
+		console.log("");
+		upload("Upload to Claude.ai: Settings > Features > Skills > Upload");
+	} catch (err) {
+		error(`Failed to package skill: ${String(err)}`);
+		process.exit(1);
+	}
+}
+//#endregion
+//#region src/commands/package.cmd.ts
+var package_cmd_default = defineCommand({
+	meta: {
+		name: "package",
+		description: "Package a skill to zip"
+	},
+	args: {
+		skill_path: {
+			type: "positional",
+			description: "Path to skill directory",
+			required: true
+		},
+		output: {
+			type: "string",
+			description: "Output path for zip file"
+		},
+		"skip-validation": {
+			type: "boolean",
+			description: "Skip validation before packaging"
+		}
+	},
+	async run({ args }) {
+		await package_command({
+			skill_path: args.skill_path,
+			output: args.output,
+			skip_validation: args["skip-validation"]
+		});
+	}
+});
+//#endregion
+export { package_cmd_default as default };
+
+//# sourceMappingURL=package.cmd-BYhkheya.js.map

package/dist/package.cmd-BYhkheya.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.cmd-BYhkheya.js","names":[],"sources":["../src/commands/package.ts","../src/commands/package.cmd.ts"],"sourcesContent":["import { execSync } from 'node:child_process';\nimport { existsSync, statSync } from 'node:fs';\nimport { basename, join, resolve } from 'node:path';\nimport { SkillValidator } from '../core/validator.js';\nimport type { PackageOptions } from '../types.js';\nimport { ensure_dir } from '../utils/fs.js';\nimport {\n\terror,\n\tpackage_,\n\tsearch,\n\tsuccess,\n\tupload,\n\twarning,\n} from '../utils/output.js';\n\nfunction validate_skill(skill_path: string): boolean {\n\tsearch('Validating skill...');\n\n\tconst validator = new SkillValidator(skill_path);\n\tconst result = validator.validate_all();\n\n\tif (result.errors.length > 0) {\n\t\tconsole.log('\\n❌ Errors:');\n\t\tfor (const err of result.errors) {\n\t\t\tconsole.log(`  ${String(err)}`);\n\t\t}\n\t}\n\n\tif (result.warnings.length > 0) {\n\t\tconsole.log('\\n⚠️  Warnings:');\n\t\tfor (const warn of result.warnings) {\n\t\t\tconsole.log(`  ${warn}`);\n\t\t}\n\t}\n\n\tif (result.is_valid) {\n\t\tsuccess('Skill is valid!');\n\t\tconsole.log('');\n\t\treturn true;\n\t} else {\n\t\terror('Validation failed. Fix errors before packaging.');\n\t\treturn false;\n\t}\n}\n\nfunction package_skill(\n\tskill_path: string,\n\toutput_dir: string,\n): string {\n\tconst skill_name = basename(skill_path);\n\tconst output_file = resolve(output_dir, `${skill_name}.zip`);\n\n\tpackage_(`Packaging skill: ${skill_name}`);\n\n\tensure_dir(output_dir);\n\n\t// Remove existing zip if present\n\tif (existsSync(output_file)) {\n\t\texecSync(`rm ${output_file}`);\n\t}\n\n\t// Use system zip command — available on all target platforms\n\tconst parent_dir = resolve(skill_path, '..');\n\texecSync(\n\t\t`cd \"${parent_dir}\" && zip -r \"${output_file}\" \"${skill_name}\" -x '${skill_name}/.*' '${skill_name}/*.swp' '${skill_name}/*~' '${skill_name}/.DS_Store'`,\n\t);\n\n\treturn output_file;\n}\n\nexport async function package_command(\n\toptions: PackageOptions,\n): Promise<void> {\n\tconst { skill_path, output, skip_validation } = options;\n\n\t// Validate path\n\tif (!existsSync(skill_path)) {\n\t\terror(`Skill directory does not exist: ${skill_path}`);\n\t\tprocess.exit(1);\n\t}\n\n\tconst stats = statSync(skill_path);\n\tif (!stats.isDirectory()) {\n\t\terror(`Path is not a directory: ${skill_path}`);\n\t\tprocess.exit(1);\n\t}\n\n\t// Check for SKILL.md\n\tif (!existsSync(join(skill_path, 'SKILL.md'))) {\n\t\terror(`SKILL.md not found in ${skill_path}`);\n\t\tprocess.exit(1);\n\t}\n\n\t// Validate skill\n\tif (!skip_validation) {\n\t\tif (!validate_skill(skill_path)) {\n\t\t\tprocess.exit(1);\n\t\t}\n\t}\n\n\t// Package skill\n\ttry {\n\t\tconst output_dir = output || 'dist';\n\t\tconst output_file = package_skill(skill_path, output_dir);\n\n\t\t// Print success\n\t\tconst file_stats = statSync(output_file);\n\t\tconst size_kb = file_stats.size / 1024;\n\n\t\tconsole.log('');\n\t\tsuccess('Skill packaged successfully!');\n\t\tconsole.log(`   File: ${output_file}`);\n\t\tconsole.log(`   Size: ${size_kb.toFixed(1)} KB`);\n\t\tconsole.log('');\n\t\twarning(\n\t\t\t'Note: ZIP packaging is not an official Claude Code distribution method.',\n\t\t);\n\t\tconsole.log(\n\t\t\t'   Official distribution uses the plugin system (/plugin install)',\n\t\t);\n\t\tconsole.log('   or direct file placement in .claude/skills/.');\n\t\tconsole.log('   See: https://code.claude.com/docs/en/plugins');\n\t\tconsole.log('');\n\t\tupload(\n\t\t\t'Upload to Claude.ai: Settings > Features > Skills > Upload',\n\t\t);\n\t} catch (err) {\n\t\terror(`Failed to package skill: ${String(err)}`);\n\t\tprocess.exit(1);\n\t}\n}\n","import { defineCommand } from 'citty';\nimport { package_command } from './package.js';\n\nexport default defineCommand({\n\tmeta: { name: 'package', description: 'Package a skill to zip' },\n\targs: {\n\t\tskill_path: {\n\t\t\ttype: 'positional',\n\t\t\tdescription: 'Path to skill directory',\n\t\t\trequired: true,\n\t\t},\n\t\toutput: {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Output path for zip file',\n\t\t},\n\t\t'skip-validation': {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Skip validation before packaging',\n\t\t},\n\t},\n\tasync run({ args }) {\n\t\tawait package_command({\n\t\t\tskill_path: args.skill_path,\n\t\t\toutput: args.output,\n\t\t\tskip_validation: args['skip-validation'],\n\t\t});\n\t},\n});\n"],"mappings":";;;;;;;;AAeA,SAAS,eAAe,YAA6B;AACpD,QAAO,sBAAsB;CAG7B,MAAM,SADY,IAAI,eAAe,WAAW,CACvB,cAAc;AAEvC,KAAI,OAAO,OAAO,SAAS,GAAG;AAC7B,UAAQ,IAAI,cAAc;AAC1B,OAAK,MAAM,OAAO,OAAO,OACxB,SAAQ,IAAI,KAAK,OAAO,IAAI,GAAG;;AAIjC,KAAI,OAAO,SAAS,SAAS,GAAG;AAC/B,UAAQ,IAAI,kBAAkB;AAC9B,OAAK,MAAM,QAAQ,OAAO,SACzB,SAAQ,IAAI,KAAK,OAAO;;AAI1B,KAAI,OAAO,UAAU;AACpB,UAAQ,kBAAkB;AAC1B,UAAQ,IAAI,GAAG;AACf,SAAO;QACD;AACN,QAAM,kDAAkD;AACxD,SAAO;;;AAIT,SAAS,cACR,YACA,YACS;CACT,MAAM,aAAa,SAAS,WAAW;CACvC,MAAM,cAAc,QAAQ,YAAY,GAAG,WAAW,MAAM;AAE5D,UAAS,oBAAoB,aAAa;AAE1C,YAAW,WAAW;AAGtB,KAAI,WAAW,YAAY,CAC1B,UAAS,MAAM,cAAc;AAK9B,UACC,OAFkB,QAAQ,YAAY,KAAK,CAEzB,eAAe,YAAY,KAAK,WAAW,QAAQ,WAAW,QAAQ,WAAW,WAAW,WAAW,QAAQ,WAAW,aAC5I;AAED,QAAO;;AAGR,eAAsB,gBACrB,SACgB;CAChB,MAAM,EAAE,YAAY,QAAQ,oBAAoB;AAGhD,KAAI,CAAC,WAAW,WAAW,EAAE;AAC5B,QAAM,mCAAmC,aAAa;AACtD,UAAQ,KAAK,EAAE;;AAIhB,KAAI,CADU,SAAS,WAAW,CACvB,aAAa,EAAE;AACzB,QAAM,4BAA4B,aAAa;AAC/C,UAAQ,KAAK,EAAE;;AAIhB,KAAI,CAAC,WAAW,KAAK,YAAY,WAAW,CAAC,EAAE;AAC9C,QAAM,yBAAyB,aAAa;AAC5C,UAAQ,KAAK,EAAE;;AAIhB,KAAI,CAAC;MACA,CAAC,eAAe,WAAW,CAC9B,SAAQ,KAAK,EAAE;;AAKjB,KAAI;EAEH,MAAM,cAAc,cAAc,YADf,UAAU,OAC4B;EAIzD,MAAM,UADa,SAAS,YAAY,CACb,OAAO;AAElC,UAAQ,IAAI,GAAG;AACf,UAAQ,+BAA+B;AACvC,UAAQ,IAAI,YAAY,cAAc;AACtC,UAAQ,IAAI,YAAY,QAAQ,QAAQ,EAAE,CAAC,KAAK;AAChD,UAAQ,IAAI,GAAG;AACf,UACC,0EACA;AACD,UAAQ,IACP,oEACA;AACD,UAAQ,IAAI,kDAAkD;AAC9D,UAAQ,IAAI,kDAAkD;AAC9D,UAAQ,IAAI,GAAG;AACf,SACC,6DACA;UACO,KAAK;AACb,QAAM,4BAA4B,OAAO,IAAI,GAAG;AAChD,UAAQ,KAAK,EAAE;;;;;AC7HjB,IAAA,sBAAe,cAAc;CAC5B,MAAM;EAAE,MAAM;EAAW,aAAa;EAA0B;CAChE,MAAM;EACL,YAAY;GACX,MAAM;GACN,aAAa;GACb,UAAU;GACV;EACD,QAAQ;GACP,MAAM;GACN,aAAa;GACb;EACD,mBAAmB;GAClB,MAAM;GACN,aAAa;GACb;EACD;CACD,MAAM,IAAI,EAAE,QAAQ;AACnB,QAAM,gBAAgB;GACrB,YAAY,KAAK;GACjB,QAAQ,KAAK;GACb,iBAAiB,KAAK;GACtB,CAAC;;CAEH,CAAC"}

package/dist/stats.cmd-Dd46qjoV.js

@@ -0,0 +1,154 @@
+import { l as LIMITS, n as error } from "./output-DiffPD2u.js";
+import { t as SkillValidator } from "./validator-Dp5x-OjP.js";
+import { defineCommand } from "citty";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+//#region src/commands/stats.ts
+function stats_command(options) {
+	const directory = options.directory || ".claude/skills";
+	if (!existsSync(directory)) {
+		error(`Directory not found: ${directory}`);
+		process.exit(1);
+	}
+	if (!statSync(directory).isDirectory()) {
+		error(`Path is not a directory: ${directory}`);
+		process.exit(1);
+	}
+	const entries = readdirSync(directory);
+	const skills = [];
+	for (const entry of entries) {
+		const skill_path = join(directory, entry);
+		if (statSync(skill_path).isDirectory()) {
+			if (existsSync(join(skill_path, "SKILL.md"))) skills.push(skill_path);
+		}
+	}
+	if (skills.length === 0) {
+		console.log(`No skills found in ${directory}`);
+		console.log("\nCreate a skill with: claude-skills-cli init --name my-skill --description \"...\"\n");
+		return;
+	}
+	console.log("📊 Skills Overview");
+	console.log("============================================================");
+	console.log(`${skills.length} skill${skills.length === 1 ? "" : "s"} found:\n`);
+	const tier_counts = {
+		simple: 0,
+		standard: 0,
+		advanced: 0
+	};
+	for (const skill_path of skills) {
+		const skill_name = skill_path.split("/").pop() || "";
+		const result = new SkillValidator(skill_path).validate_all();
+		let status_icon = "✅";
+		let status_text = "valid";
+		if (!result.is_valid) {
+			status_icon = "❌";
+			status_text = "errors";
+		} else if (result.warnings.length > 0) {
+			status_icon = "⚠️ ";
+			status_text = "warnings";
+		}
+		console.log(`${skill_name} (${status_icon} ${status_text})`);
+		const skill_md_path = join(skill_path, "SKILL.md");
+		if (existsSync(skill_md_path)) {
+			const version_match = readFileSync(skill_md_path, "utf-8").match(/^version:\s*(.+)/m);
+			if (version_match) console.log(`  Version: ${version_match[1].trim()}`);
+		}
+		const tier = classify_complexity(skill_path);
+		tier_counts[tier]++;
+		console.log(`  Complexity: ${tier}`);
+		if (result.stats) {
+			const desc_length = result.stats.description_length;
+			let desc_status = "";
+			if (desc_length > 0) {
+				if (desc_length <= 250) desc_status = "optimal";
+				else desc_status = "too long";
+				console.log(`  Description: ${desc_length} chars (${desc_status})`);
+			}
+			const lines = result.stats.line_count;
+			const words = result.stats.word_count;
+			const S = LIMITS.strict;
+			let line_status = "";
+			if (lines <= S.lines.excellent) line_status = "excellent";
+			else if (lines <= S.lines.good) line_status = "good";
+			else if (lines <= S.lines.max) line_status = "consider splitting";
+			else line_status = "too long";
+			let word_status = "";
+			if (words < S.words.excellent) word_status = "excellent";
+			else if (words < S.words.good) word_status = "good";
+			else if (words < S.words.max) word_status = "acceptable";
+			else word_status = "too long";
+			console.log(`  Body: ${lines} lines (${line_status}), ${words} words (${word_status})`);
+			const references_dir = join(skill_path, "references");
+			if (existsSync(references_dir)) {
+				const ref_files = readdirSync(references_dir).filter((f) => f.endsWith(".md"));
+				if (ref_files.length > 0) {
+					let total_size = 0;
+					for (const ref_file of ref_files) {
+						const ref_stat = statSync(join(references_dir, ref_file));
+						total_size += ref_stat.size;
+					}
+					const size_kb = (total_size / 1024).toFixed(1);
+					console.log(`  References: ${ref_files.length} file${ref_files.length === 1 ? "" : "s"} (${size_kb} KB)`);
+				}
+			}
+		}
+		if (!result.is_valid) console.log(`  ${result.errors.length} error${result.errors.length === 1 ? "" : "s"}`);
+		if (result.warnings.length > 0) console.log(`  ${result.warnings.length} warning${result.warnings.length === 1 ? "" : "s"}`);
+		console.log("");
+	}
+	const valid_skills = skills.filter((path) => {
+		return new SkillValidator(path).validate_all().is_valid;
+	}).length;
+	const skills_with_warnings = skills.filter((path) => {
+		const result = new SkillValidator(path).validate_all();
+		return result.is_valid && result.warnings.length > 0;
+	}).length;
+	const invalid_skills = skills.length - valid_skills;
+	console.log("Summary:");
+	if (invalid_skills === 0 && skills_with_warnings === 0) console.log(`✅ All ${skills.length} skills are valid with no warnings`);
+	else {
+		console.log(`  Valid: ${valid_skills}`);
+		if (skills_with_warnings > 0) console.log(`  With warnings: ${skills_with_warnings}`);
+		if (invalid_skills > 0) console.log(`  Invalid: ${invalid_skills}`);
+	}
+	if (skills.length > 1) console.log(`  Complexity: ${tier_counts.simple} simple, ${tier_counts.standard} standard, ${tier_counts.advanced} advanced`);
+}
+/**
+* Classify skill complexity based on filesystem structure
+*/
+function classify_complexity(skill_path) {
+	const has_scripts = existsSync(join(skill_path, "scripts")) && dir_has_files(join(skill_path, "scripts"));
+	const has_references = existsSync(join(skill_path, "references")) && dir_has_files(join(skill_path, "references"));
+	const has_assets = existsSync(join(skill_path, "assets")) && dir_has_files(join(skill_path, "assets"));
+	const script_count = has_scripts ? readdirSync(join(skill_path, "scripts")).length : 0;
+	if (has_assets || script_count > 2 || has_scripts && has_references) return "advanced";
+	if (has_references || has_scripts) return "standard";
+	return "simple";
+}
+function dir_has_files(dir_path) {
+	try {
+		return readdirSync(dir_path).length > 0;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/commands/stats.cmd.ts
+var stats_cmd_default = defineCommand({
+	meta: {
+		name: "stats",
+		description: "Show overview of all skills in a directory"
+	},
+	args: { directory: {
+		type: "positional",
+		description: "Directory containing skills (default: .claude/skills)",
+		required: false
+	} },
+	run({ args }) {
+		stats_command({ directory: args.directory });
+	}
+});
+//#endregion
+export { stats_cmd_default as default };
+
+//# sourceMappingURL=stats.cmd-Dd46qjoV.js.map

package/dist/stats.cmd-Dd46qjoV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.cmd-Dd46qjoV.js","names":[],"sources":["../src/commands/stats.ts","../src/commands/stats.cmd.ts"],"sourcesContent":["import {\n\texistsSync,\n\treaddirSync,\n\treadFileSync,\n\tstatSync,\n} from 'node:fs';\nimport { join } from 'node:path';\nimport { DESCRIPTION_MAX_LENGTH, LIMITS } from '../constants.js';\nimport { SkillValidator } from '../core/validator.js';\nimport type { SkillComplexityTier, StatsOptions } from '../types.js';\nimport { error } from '../utils/output.js';\n\nexport function stats_command(options: StatsOptions): void {\n\tconst directory = options.directory || '.claude/skills';\n\n\t// Verify directory exists\n\tif (!existsSync(directory)) {\n\t\terror(`Directory not found: ${directory}`);\n\t\tprocess.exit(1);\n\t}\n\n\tconst dir_stats = statSync(directory);\n\tif (!dir_stats.isDirectory()) {\n\t\terror(`Path is not a directory: ${directory}`);\n\t\tprocess.exit(1);\n\t}\n\n\t// Find all skill directories (containing SKILL.md)\n\tconst entries = readdirSync(directory);\n\tconst skills: string[] = [];\n\n\tfor (const entry of entries) {\n\t\tconst skill_path = join(directory, entry);\n\t\tconst stat = statSync(skill_path);\n\n\t\tif (stat.isDirectory()) {\n\t\t\tconst skill_md_path = join(skill_path, 'SKILL.md');\n\t\t\tif (existsSync(skill_md_path)) {\n\t\t\t\tskills.push(skill_path);\n\t\t\t}\n\t\t}\n\t}\n\n\tif (skills.length === 0) {\n\t\tconsole.log(`No skills found in ${directory}`);\n\t\tconsole.log(\n\t\t\t'\\nCreate a skill with: claude-skills-cli init --name my-skill --description \"...\"\\n',\n\t\t);\n\t\treturn;\n\t}\n\n\t// Display overview header\n\tconsole.log('📊 Skills Overview');\n\tconsole.log(\n\t\t'============================================================',\n\t);\n\tconsole.log(\n\t\t`${skills.length} skill${skills.length === 1 ? '' : 's'} found:\\n`,\n\t);\n\n\t// Track complexity tiers for summary\n\tconst tier_counts = { simple: 0, standard: 0, advanced: 0 };\n\n\t// Validate and display each skill\n\tfor (const skill_path of skills) {\n\t\tconst skill_name = skill_path.split('/').pop() || '';\n\t\tconst validator = new SkillValidator(skill_path);\n\t\tconst result = validator.validate_all();\n\n\t\t// Determine status icon\n\t\tlet status_icon = '✅';\n\t\tlet status_text = 'valid';\n\t\tif (!result.is_valid) {\n\t\t\tstatus_icon = '❌';\n\t\t\tstatus_text = 'errors';\n\t\t} else if (result.warnings.length > 0) {\n\t\t\tstatus_icon = '⚠️ ';\n\t\t\tstatus_text = 'warnings';\n\t\t}\n\n\t\tconsole.log(`${skill_name} (${status_icon} ${status_text})`);\n\n\t\t// Show version if present\n\t\tconst skill_md_path = join(skill_path, 'SKILL.md');\n\t\tif (existsSync(skill_md_path)) {\n\t\t\tconst content = readFileSync(skill_md_path, 'utf-8');\n\t\t\tconst version_match = content.match(/^version:\\s*(.+)/m);\n\t\t\tif (version_match) {\n\t\t\t\tconsole.log(`  Version: ${version_match[1].trim()}`);\n\t\t\t}\n\t\t}\n\n\t\t// Show complexity tier\n\t\tconst tier = classify_complexity(skill_path);\n\t\ttier_counts[tier]++;\n\t\tconsole.log(`  Complexity: ${tier}`);\n\n\t\tif (result.stats) {\n\t\t\t// Description length\n\t\t\tconst desc_length = result.stats.description_length;\n\t\t\tlet desc_status = '';\n\t\t\tif (desc_length > 0) {\n\t\t\t\tif (desc_length <= DESCRIPTION_MAX_LENGTH) {\n\t\t\t\t\tdesc_status = 'optimal';\n\t\t\t\t} else {\n\t\t\t\t\tdesc_status = 'too long';\n\t\t\t\t}\n\t\t\t\tconsole.log(\n\t\t\t\t\t`  Description: ${desc_length} chars (${desc_status})`,\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Body stats\n\t\t\tconst lines = result.stats.line_count;\n\t\t\tconst words = result.stats.word_count;\n\n\t\t\tconst S = LIMITS.strict;\n\t\t\tlet line_status = '';\n\t\t\tif (lines <= S.lines.excellent) {\n\t\t\t\tline_status = 'excellent';\n\t\t\t} else if (lines <= S.lines.good) {\n\t\t\t\tline_status = 'good';\n\t\t\t} else if (lines <= S.lines.max) {\n\t\t\t\tline_status = 'consider splitting';\n\t\t\t} else {\n\t\t\t\tline_status = 'too long';\n\t\t\t}\n\n\t\t\tlet word_status = '';\n\t\t\tif (words < S.words.excellent) {\n\t\t\t\tword_status = 'excellent';\n\t\t\t} else if (words < S.words.good) {\n\t\t\t\tword_status = 'good';\n\t\t\t} else if (words < S.words.max) {\n\t\t\t\tword_status = 'acceptable';\n\t\t\t} else {\n\t\t\t\tword_status = 'too long';\n\t\t\t}\n\n\t\t\tconsole.log(\n\t\t\t\t`  Body: ${lines} lines (${line_status}), ${words} words (${word_status})`,\n\t\t\t);\n\n\t\t\t// Count reference files\n\t\t\tconst references_dir = join(skill_path, 'references');\n\t\t\tif (existsSync(references_dir)) {\n\t\t\t\tconst ref_files = readdirSync(references_dir).filter((f) =>\n\t\t\t\t\tf.endsWith('.md'),\n\t\t\t\t);\n\t\t\t\tif (ref_files.length > 0) {\n\t\t\t\t\t// Calculate total size\n\t\t\t\t\tlet total_size = 0;\n\t\t\t\t\tfor (const ref_file of ref_files) {\n\t\t\t\t\t\tconst ref_path = join(references_dir, ref_file);\n\t\t\t\t\t\tconst ref_stat = statSync(ref_path);\n\t\t\t\t\t\ttotal_size += ref_stat.size;\n\t\t\t\t\t}\n\t\t\t\t\tconst size_kb = (total_size / 1024).toFixed(1);\n\t\t\t\t\tconsole.log(\n\t\t\t\t\t\t`  References: ${ref_files.length} file${ref_files.length === 1 ? '' : 's'} (${size_kb} KB)`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Show error/warning count\n\t\tif (!result.is_valid) {\n\t\t\tconsole.log(\n\t\t\t\t`  ${result.errors.length} error${result.errors.length === 1 ? '' : 's'}`,\n\t\t\t);\n\t\t}\n\t\tif (result.warnings.length > 0) {\n\t\t\tconsole.log(\n\t\t\t\t`  ${result.warnings.length} warning${result.warnings.length === 1 ? '' : 's'}`,\n\t\t\t);\n\t\t}\n\n\t\tconsole.log(''); // Blank line between skills\n\t}\n\n\t// Summary\n\tconst valid_skills = skills.filter((path) => {\n\t\tconst validator = new SkillValidator(path);\n\t\tconst result = validator.validate_all();\n\t\treturn result.is_valid;\n\t}).length;\n\n\tconst skills_with_warnings = skills.filter((path) => {\n\t\tconst validator = new SkillValidator(path);\n\t\tconst result = validator.validate_all();\n\t\treturn result.is_valid && result.warnings.length > 0;\n\t}).length;\n\n\tconst invalid_skills = skills.length - valid_skills;\n\n\tconsole.log('Summary:');\n\tif (invalid_skills === 0 && skills_with_warnings === 0) {\n\t\tconsole.log(\n\t\t\t`✅ All ${skills.length} skills are valid with no warnings`,\n\t\t);\n\t} else {\n\t\tconsole.log(`  Valid: ${valid_skills}`);\n\t\tif (skills_with_warnings > 0) {\n\t\t\tconsole.log(`  With warnings: ${skills_with_warnings}`);\n\t\t}\n\t\tif (invalid_skills > 0) {\n\t\t\tconsole.log(`  Invalid: ${invalid_skills}`);\n\t\t}\n\t}\n\n\t// Complexity tier distribution\n\tif (skills.length > 1) {\n\t\tconsole.log(\n\t\t\t`  Complexity: ${tier_counts.simple} simple, ${tier_counts.standard} standard, ${tier_counts.advanced} advanced`,\n\t\t);\n\t}\n}\n\n/**\n * Classify skill complexity based on filesystem structure\n */\nexport function classify_complexity(\n\tskill_path: string,\n): SkillComplexityTier {\n\tconst has_scripts =\n\t\texistsSync(join(skill_path, 'scripts')) &&\n\t\tdir_has_files(join(skill_path, 'scripts'));\n\tconst has_references =\n\t\texistsSync(join(skill_path, 'references')) &&\n\t\tdir_has_files(join(skill_path, 'references'));\n\tconst has_assets =\n\t\texistsSync(join(skill_path, 'assets')) &&\n\t\tdir_has_files(join(skill_path, 'assets'));\n\n\tconst script_count = has_scripts\n\t\t? readdirSync(join(skill_path, 'scripts')).length\n\t\t: 0;\n\n\t// Advanced: assets, many scripts, or both scripts + references\n\tif (\n\t\thas_assets ||\n\t\tscript_count > 2 ||\n\t\t(has_scripts && has_references)\n\t) {\n\t\treturn 'advanced';\n\t}\n\n\t// Standard: has references or scripts\n\tif (has_references || has_scripts) {\n\t\treturn 'standard';\n\t}\n\n\treturn 'simple';\n}\n\nfunction dir_has_files(dir_path: string): boolean {\n\ttry {\n\t\treturn readdirSync(dir_path).length > 0;\n\t} catch {\n\t\treturn false;\n\t}\n}\n","import { defineCommand } from 'citty';\nimport { stats_command } from './stats.js';\n\nexport default defineCommand({\n\tmeta: {\n\t\tname: 'stats',\n\t\tdescription: 'Show overview of all skills in a directory',\n\t},\n\targs: {\n\t\tdirectory: {\n\t\t\ttype: 'positional',\n\t\t\tdescription:\n\t\t\t\t'Directory containing skills (default: .claude/skills)',\n\t\t\trequired: false,\n\t\t},\n\t},\n\trun({ args }) {\n\t\tstats_command({ directory: args.directory });\n\t},\n});\n"],"mappings":"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"}

package/dist/{core/templates.js → templates-fyteNbD0.js}

@@ -1,9 +1,14 @@
-export const SKILL_MD_TEMPLATE = (name, description, title, include_examples = false) => {
-    const minimal_template = `---
+//#region src/core/templates.ts
+const SKILL_MD_TEMPLATE = (name, description, title, include_examples = false) => {
+	const minimal_template = `---
 name: ${name}
 # Keep on ONE line, third-person voice, include "Use when/for/to..." trigger
 # prettier-ignore
 description: ${description}
+# version: 0.1.0
+# depends-on-skills: []
+# depends-on-mcp: []
+# depends-on-packages: []
 ---
 
 # ${title}
@@ -43,7 +48,7 @@ For detailed documentation, see:
 PROGRESSIVE DISCLOSURE GUIDELINES:
 - Keep this file ~50 lines total (max ~150 lines)
 - Use 1-2 code blocks only (recommend 1)
-- Keep description <300 chars for Level 1 efficiency
+- Keep description <250 chars (Claude truncates at this limit)
 - Move detailed docs to references/ for Level 3 loading
 - This is Level 2 - quick reference ONLY, not a manual
 
@@ -55,7 +60,7 @@ LLM WORKFLOW (when editing this file):
 5. Validate again to confirm
 -->
 `;
-    const full_template = `---
+	const full_template = `---
 name: ${name}
 # Keep on ONE line, third-person voice, include "Use when/for/to..." trigger
 # prettier-ignore
@@ -104,7 +109,7 @@ For detailed documentation, see:
 PROGRESSIVE DISCLOSURE GUIDELINES:
 - Keep this file ~50 lines total (max ~150 lines)
 - Use 1-2 code blocks only (recommend 1)
-- Keep description <300 chars for Level 1 efficiency
+- Keep description <250 chars (Claude truncates at this limit)
 - Move detailed docs to references/ for Level 3 loading
 - This is Level 2 - quick reference ONLY, not a manual
 
@@ -116,9 +121,9 @@ LLM WORKFLOW (when editing this file):
 5. Validate again to confirm
 -->
 `;
-    return include_examples ? full_template : minimal_template;
+	return include_examples ? full_template : minimal_template;
 };
-export const REFERENCE_TEMPLATE = (title) => `# ${title} Reference
+const REFERENCE_TEMPLATE = (title) => `# ${title} Reference
 
 <!-- This is a Level 3 resource file -->
 <!-- It's loaded on-demand when Claude needs detailed information -->
@@ -173,7 +178,7 @@ export const REFERENCE_TEMPLATE = (title) => `# ${title} Reference
 **Problem:** [Description]
 **Solution:** [Detailed solution]
 `;
-export const SCRIPT_TEMPLATE = (filename) => `#!/usr/bin/env node
+const SCRIPT_TEMPLATE = (filename) => `#!/usr/bin/env node
 
 /**
  * Description of what this script does.
@@ -188,11 +193,10 @@ function main() {
 
 main();
 `;
-// Hook templates for skill activation
-export const SIMPLE_HOOK_TEMPLATE = () => `#!/bin/bash
+const SIMPLE_HOOK_TEMPLATE = () => `#!/bin/bash
 echo 'INSTRUCTION: If the prompt matches any available skill keywords, use Skill(skill-name) to activate it.'
 `;
-export const FORCED_EVAL_HOOK_TEMPLATE = () => `#!/bin/bash
+const FORCED_EVAL_HOOK_TEMPLATE = () => `#!/bin/bash
 # UserPromptSubmit hook that forces explicit skill evaluation
 #
 # This hook requires Claude to explicitly evaluate each available skill
@@ -228,7 +232,7 @@ Example of correct sequence:
 [THEN and ONLY THEN start implementation]
 EOF
 `;
-export const LLM_EVAL_HOOK_TEMPLATE = () => `#!/bin/bash
+const LLM_EVAL_HOOK_TEMPLATE = () => `#!/bin/bash
 # UserPromptSubmit hook that uses Claude API for intelligent skill evaluation
 #
 # This hook analyses each user prompt and uses the Claude API to determine which
@@ -386,4 +390,7 @@ else
 	echo "$FALLBACK_INSTRUCTION"
 fi
 `;
-//# sourceMappingURL=templates.js.map
+//#endregion
+export { SIMPLE_HOOK_TEMPLATE as a, SCRIPT_TEMPLATE as i, LLM_EVAL_HOOK_TEMPLATE as n, SKILL_MD_TEMPLATE as o, REFERENCE_TEMPLATE as r, FORCED_EVAL_HOOK_TEMPLATE as t };
+
+//# sourceMappingURL=templates-fyteNbD0.js.map

package/dist/templates-fyteNbD0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates-fyteNbD0.js","names":[],"sources":["../src/core/templates.ts"],"sourcesContent":["export const SKILL_MD_TEMPLATE = (\n\tname: string,\n\tdescription: string,\n\ttitle: string,\n\tinclude_examples: boolean = false,\n) => {\n\tconst minimal_template = `---\nname: ${name}\n# Keep on ONE line, third-person voice, include \"Use when/for/to...\" trigger\n# prettier-ignore\ndescription: ${description}\n# version: 0.1.0\n# depends-on-skills: []\n# depends-on-mcp: []\n# depends-on-packages: []\n---\n\n# ${title}\n\n## Quick Start\n\n[Provide ONE minimal working example - the most common use case]\n\n\\`\\`\\`typescript\n// Keep this concise - show essential code only\n// Move detailed examples to references/ for Level 3 loading\n\\`\\`\\`\n\n## Core Principles\n\n- Principle 1: [Key concept]\n- Principle 2: [Key concept]\n- Principle 3: [Key concept]\n\n## Common Patterns\n\n### [Most Frequent Pattern]\n\n[Brief description - keep under 100 words]\n\n## Reference Files\n\nFor detailed documentation, see:\n- [references/](references/) - Add detailed guides here\n\n## Notes\n\n- Important note 1\n- Important note 2\n\n<!--\nPROGRESSIVE DISCLOSURE GUIDELINES:\n- Keep this file ~50 lines total (max ~150 lines)\n- Use 1-2 code blocks only (recommend 1)\n- Keep description <250 chars (Claude truncates at this limit)\n- Move detailed docs to references/ for Level 3 loading\n- This is Level 2 - quick reference ONLY, not a manual\n\nLLM WORKFLOW (when editing this file):\n1. Write/edit SKILL.md\n2. Format (if formatter available)\n3. Run: claude-skills-cli validate <path>\n4. If multi-line description warning: run claude-skills-cli doctor <path>\n5. Validate again to confirm\n-->\n`;\n\n\tconst full_template = `---\nname: ${name}\n# Keep on ONE line, third-person voice, include \"Use when/for/to...\" trigger\n# prettier-ignore\ndescription: ${description}\n---\n\n# ${title}\n\n## Quick Start\n\n[Provide ONE minimal working example - the most common use case]\n\n\\`\\`\\`typescript\n// Keep this concise - show essential code only\n// Detailed examples go in references/examples.md\n\\`\\`\\`\n\n## Core Principles\n\n- Principle 1: [Key concept]\n- Principle 2: [Key concept]\n- Principle 3: [Key concept]\n\n## Common Patterns\n\n### [Most Frequent Pattern]\n\n[Brief description - keep under 100 words]\n\n## Reference Files\n\nFor detailed documentation, see:\n- [references/detailed-guide.md](references/detailed-guide.md) - Complete guide\n- [references/examples.md](references/examples.md) - Additional examples\n\n## Scripts\n\n- \\`scripts/example.js\\` - [What this script does]\n\n## Notes\n\n- Important note 1\n- Important note 2\n\n<!--\nPROGRESSIVE DISCLOSURE GUIDELINES:\n- Keep this file ~50 lines total (max ~150 lines)\n- Use 1-2 code blocks only (recommend 1)\n- Keep description <250 chars (Claude truncates at this limit)\n- Move detailed docs to references/ for Level 3 loading\n- This is Level 2 - quick reference ONLY, not a manual\n\nLLM WORKFLOW (when editing this file):\n1. Write/edit SKILL.md\n2. Format (if formatter available)\n3. Run: claude-skills-cli validate <path>\n4. If multi-line description warning: run claude-skills-cli doctor <path>\n5. Validate again to confirm\n-->\n`;\n\n\treturn include_examples ? full_template : minimal_template;\n};\n\nexport const REFERENCE_TEMPLATE = (\n\ttitle: string,\n) => `# ${title} Reference\n\n<!-- This is a Level 3 resource file -->\n<!-- It's loaded on-demand when Claude needs detailed information -->\n<!-- No size limits - include comprehensive documentation here -->\n\n## Overview\n\n[Detailed explanation of this topic]\n\n## Complete Examples\n\n### Example 1: [Scenario]\n\n[Comprehensive example with full context]\n\n\\`\\`\\`typescript\n// Detailed code with comments\n// Include edge cases and variations\n\\`\\`\\`\n\n### Example 2: [Scenario]\n\n[Another detailed example]\n\n\\`\\`\\`typescript\n// More extensive code\n\\`\\`\\`\n\n## Advanced Topics\n\n[Deep dive into complex aspects]\n\n## API Reference\n\n[Complete API documentation if applicable]\n\n## Best Practices\n\n- [Detailed best practice 1]\n- [Detailed best practice 2]\n- [Detailed best practice 3]\n\n## Troubleshooting\n\n### Issue 1\n\n**Problem:** [Description]\n**Solution:** [Detailed solution]\n\n### Issue 2\n\n**Problem:** [Description]\n**Solution:** [Detailed solution]\n`;\n\nexport const SCRIPT_TEMPLATE = (\n\tfilename: string,\n) => `#!/usr/bin/env node\n\n/**\n * Description of what this script does.\n *\n * Usage:\n *   node ${filename}\n */\n\nfunction main() {\n  console.log('Script executed successfully');\n}\n\nmain();\n`;\n\n// Hook templates for skill activation\nexport const SIMPLE_HOOK_TEMPLATE = () => `#!/bin/bash\necho 'INSTRUCTION: If the prompt matches any available skill keywords, use Skill(skill-name) to activate it.'\n`;\n\nexport const FORCED_EVAL_HOOK_TEMPLATE = () => `#!/bin/bash\n# UserPromptSubmit hook that forces explicit skill evaluation\n#\n# This hook requires Claude to explicitly evaluate each available skill\n# before proceeding with implementation.\n#\n# Installation: Copy to .claude/hooks/UserPromptSubmit\n\ncat <<'EOF'\nINSTRUCTION: MANDATORY SKILL ACTIVATION SEQUENCE\n\nStep 1 - EVALUATE (do this in your response):\nFor each skill in <available_skills>, state: [skill-name] - YES/NO - [reason]\n\nStep 2 - ACTIVATE (do this immediately after Step 1):\nIF any skills are YES → Use Skill(skill-name) tool for EACH relevant skill NOW\nIF no skills are YES → State \"No skills needed\" and proceed\n\nStep 3 - IMPLEMENT:\nOnly after Step 2 is complete, proceed with implementation.\n\nCRITICAL: You MUST call Skill() tool in Step 2. Do NOT skip to implementation.\nThe evaluation (Step 1) is WORTHLESS unless you ACTIVATE (Step 2) the skills.\n\nExample of correct sequence:\n- research: NO - not a research task\n- svelte5-runes: YES - need reactive state\n- sveltekit-structure: YES - creating routes\n\n[Then IMMEDIATELY use Skill() tool:]\n> Skill(svelte5-runes)\n> Skill(sveltekit-structure)\n\n[THEN and ONLY THEN start implementation]\nEOF\n`;\n\nexport const LLM_EVAL_HOOK_TEMPLATE = () => `#!/bin/bash\n# UserPromptSubmit hook that uses Claude API for intelligent skill evaluation\n#\n# This hook analyses each user prompt and uses the Claude API to determine which\n# skills (if any) are relevant. It then instructs Claude to activate those skills\n# before proceeding with implementation.\n#\n# COST ANALYSIS (per prompt):\n# Current model: Claude Haiku 3.5 ($0.80/$4 per MTok input/output)\n# - Estimated: ~400 input tokens + ~20 output tokens\n# - Cost: ~$0.0004 per evaluation (0.04 cents)\n# - Volume: $0.40 per 1,000 prompts\n#\n# MODEL CONFIGURATION:\n# Uncomment the model you want to use below\n#\n# Alternative: Claude Haiku 4.5 ($1/$5 per MTok) - 25% more expensive\n# - Better accuracy and alignment\n# - Cost: ~$0.0005 per evaluation (0.05 cents)\n# - Trade-off: Extra 0.01¢ per call for improved skill matching\n#\n# REQUIREMENTS:\n# 1. Set ANTHROPIC_API_KEY environment variable\n#    export ANTHROPIC_API_KEY=your-key-here\n# 2. Ensure jq is installed for JSON parsing\n\n# ============================================================================\n# MODEL CONFIGURATION - Uncomment the model you want to use\n# ============================================================================\n\n# Haiku 3.5 - Faster, cheaper, good for simple classification\nMODEL=\"claude-3-5-haiku-20241022\"\n\n# Haiku 4.5 - Better accuracy, 25% more expensive (verify model ID from Anthropic docs)\n# MODEL=\"claude-haiku-4-5-20251015\"\n\n# ============================================================================\n\n# Read JSON input from stdin with timeout\nINPUT_JSON=$(timeout 2 cat || echo '{}')\n\n# Extract user prompt and cwd from JSON\nUSER_PROMPT=$(echo \"$INPUT_JSON\" | jq -r '.prompt // \"\"' 2>/dev/null)\nCWD=$(echo \"$INPUT_JSON\" | jq -r '.cwd // \"\"' 2>/dev/null)\n\n# Use CLAUDE_PROJECT_DIR if CWD is empty\nif [ -z \"$CWD\" ] || [ \"$CWD\" = \"null\" ]; then\n\tCWD=\"\\${CLAUDE_PROJECT_DIR:-.}\"\nfi\n\n# Get available skills with descriptions from both global and project skills\nAVAILABLE_SKILLS=\"\"\n\n# Function to scan a skills directory\nscan_skills_dir() {\n\tlocal dir=\"$1\"\n\n\tif [ -d \"$dir\" ]; then\n\t\tfor skill_dir in \"$dir\"/*/; do\n\t\t\tif [ -d \"$skill_dir\" ]; then\n\t\t\t\tskill_file=\"$skill_dir/SKILL.md\"\n\t\t\t\tif [ -f \"$skill_file\" ]; then\n\t\t\t\t\tskill_name=$(basename \"$skill_dir\")\n\t\t\t\t\t# Extract description from YAML frontmatter (between --- markers)\n\t\t\t\t\tskill_desc=$(sed -n '/^---$/,/^---$/p' \"$skill_file\" | grep '^description:' | sed 's/^description: *//' | head -n 1)\n\n\t\t\t\t\tif [ -n \"$skill_desc\" ]; then\n\t\t\t\t\t\tAVAILABLE_SKILLS=\"\\${AVAILABLE_SKILLS}- \\${skill_name}: \\${skill_desc}\\\\n\"\n\t\t\t\t\telse\n\t\t\t\t\t\tAVAILABLE_SKILLS=\"\\${AVAILABLE_SKILLS}- \\${skill_name}\\\\n\"\n\t\t\t\t\tfi\n\t\t\t\tfi\n\t\t\tfi\n\t\tdone\n\tfi\n}\n\n# Scan global skills\nscan_skills_dir \"$HOME/.claude/skills\"\n\n# Scan project skills\nscan_skills_dir \"$CWD/.claude/skills\"\n\nif [ -z \"$AVAILABLE_SKILLS\" ]; then\n\tAVAILABLE_SKILLS=\"No skills found\"\nfi\n\n\n# Fallback instruction message\nFALLBACK_INSTRUCTION=\"INSTRUCTION: If the prompt matches any available skill keywords, use Skill(skill-name) to activate it.\"\n\n# If no API key in environment, fall back\nif [ -z \"$ANTHROPIC_API_KEY\" ]; then\n\techo \"$FALLBACK_INSTRUCTION\"\n\texit 0\nfi\n\n# Prepare the optimized evaluation prompt\nEVAL_PROMPT=$(cat <<EOF\nReturn ONLY a JSON array of skill names that match this request.\n\nRequest: \\${USER_PROMPT}\n\nSkills:\n\\${AVAILABLE_SKILLS}\nFormat: [\"skill-name\"] or []\nEOF\n)\n\n# Call Claude API with optimized parameters\nRESPONSE=$(curl -s https://api.anthropic.com/v1/messages \\\\\n\t-H \"content-type: application/json\" \\\\\n\t-H \"x-api-key: $ANTHROPIC_API_KEY\" \\\\\n\t-H \"anthropic-version: 2023-06-01\" \\\\\n\t-d \"{\n\t\t\\\\\"model\\\\\": \\\\\"$MODEL\\\\\",\n\t\t\\\\\"max_tokens\\\\\": 200,\n\t\t\\\\\"temperature\\\\\": 0,\n\t\t\\\\\"system\\\\\": \\\\\"You are a skill matcher. Return only valid JSON arrays.\\\\\",\n\t\t\\\\\"messages\\\\\": [{\n\t\t\t\\\\\"role\\\\\": \\\\\"user\\\\\",\n\t\t\t\\\\\"content\\\\\": $(echo \"$EVAL_PROMPT\" | jq -Rs .)\n\t\t}]\n\t}\")\n\n# Extract the skill list from response\nRAW_TEXT=$(echo \"$RESPONSE\" | jq -r '.content[0].text' 2>/dev/null)\n\n# Check if we got a valid response\nif [ $? -ne 0 ] || [ -z \"$RAW_TEXT\" ]; then\n\techo \"$FALLBACK_INSTRUCTION\"\n\texit 0\nfi\n\n# Strip markdown code fences if present and extract JSON\nSKILLS=$(echo \"$RAW_TEXT\" | sed -n '/^\\\\[/,/^\\\\]/p' | head -n 1)\n\n# If that didn't work, try the whole text\nif [ -z \"$SKILLS\" ]; then\n\tSKILLS=\"$RAW_TEXT\"\nfi\n\n# Parse the skills array\nSKILL_COUNT=$(echo \"$SKILLS\" | jq 'length' 2>/dev/null)\n\nif [ \"$SKILL_COUNT\" = \"0\" ]; then\n\techo \"INSTRUCTION: LLM evaluation determined no skills are needed for this task.\"\nelif [ -n \"$SKILL_COUNT\" ] && [ \"$SKILL_COUNT\" != \"null\" ]; then\n\tSKILL_NAMES=$(echo \"$SKILLS\" | jq -r '.[]' | paste -sd ',' -)\n\techo \"INSTRUCTION: LLM evaluation determined these skills are relevant: $SKILL_NAMES\"\n\techo \"\"\n\techo \"You MUST activate these skills using the Skill() tool BEFORE implementation:\"\n\techo \"$SKILLS\" | jq -r '.[] | \"- Skill(\\\\(.))\"'\nelse\n\t# Fallback if parsing failed\n\techo \"$FALLBACK_INSTRUCTION\"\nfi\n`;\n"],"mappings":";AAAA,MAAa,qBACZ,MACA,aACA,OACA,mBAA4B,UACxB;CACJ,MAAM,mBAAmB;QAClB,KAAK;;;eAGE,YAAY;;;;;;;IAOvB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkDT,MAAM,gBAAgB;QACf,KAAK;;;eAGE,YAAY;;;IAGvB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDT,QAAO,mBAAmB,gBAAgB;;AAG3C,MAAa,sBACZ,UACI,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDhB,MAAa,mBACZ,aACI;;;;;;YAMO,SAAS;;;;;;;;;AAWrB,MAAa,6BAA6B;;;AAI1C,MAAa,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqC/C,MAAa,+BAA+B"}

package/dist/validate.cmd-BxF4HNsu.js

@@ -0,0 +1,96 @@
+import { n as error, o as success, r as info, t as display_validation_stats } from "./output-DiffPD2u.js";
+import { t as SkillValidator } from "./validator-Dp5x-OjP.js";
+import { defineCommand } from "citty";
+import { basename } from "node:path";
+//#region src/commands/validate.ts
+function validate_command(options) {
+	const { skill_path, strict, format = "text", lenient = false, loose = false } = options;
+	const skill_name = basename(skill_path.replace(/\/+$/, ""));
+	const result = new SkillValidator(skill_path, { mode: loose ? "loose" : lenient ? "lenient" : "strict" }).validate_all();
+	if (format === "json") {
+		const json_output = {
+			skill_name,
+			valid: result.is_valid,
+			errors: result.errors,
+			warnings: result.warnings,
+			validation: result.validation,
+			stats: result.stats
+		};
+		console.log(JSON.stringify(json_output, null, 2));
+		if (!result.is_valid) process.exit(1);
+		if (strict && result.warnings.length > 0) process.exit(1);
+		process.exit(0);
+	}
+	info(`Validating skill: ${skill_name}`);
+	console.log("=".repeat(60));
+	if (result.stats) display_validation_stats(result.stats);
+	if (result.errors.length > 0) {
+		console.log("\n❌ Errors:");
+		for (const err of result.errors) console.log(`  ${err}`);
+	}
+	if (result.warnings.length > 0) {
+		console.log("\n⚠️  Warnings:");
+		for (const warn of result.warnings) console.log(`  ${warn}`);
+	}
+	if (!result.errors.length && !result.warnings.length) {
+		console.log("");
+		success("Skill is valid!");
+	} else if (!result.errors.length) {
+		console.log("");
+		success("Skill is valid (with warnings)");
+	} else {
+		console.log("");
+		error(`Skill validation failed with ${result.errors.length} error(s)`);
+	}
+	if (!result.is_valid) process.exit(1);
+	if (strict && result.warnings.length > 0) {
+		console.log("\n❌ Failed in strict mode due to warnings");
+		process.exit(1);
+	}
+	process.exit(0);
+}
+//#endregion
+//#region src/commands/validate.cmd.ts
+var validate_cmd_default = defineCommand({
+	meta: {
+		name: "validate",
+		description: "Validate a skill"
+	},
+	args: {
+		skill_path: {
+			type: "positional",
+			description: "Path to skill directory",
+			required: true
+		},
+		format: {
+			type: "string",
+			description: "Output format (json or text)",
+			default: "text"
+		},
+		strict: {
+			type: "boolean",
+			description: "Fail validation if warnings present"
+		},
+		lenient: {
+			type: "boolean",
+			description: "Use relaxed limits (150 lines max)"
+		},
+		loose: {
+			type: "boolean",
+			description: "Use Anthropic official limits (500 lines max)"
+		}
+	},
+	run({ args }) {
+		validate_command({
+			skill_path: args.skill_path,
+			strict: args.strict,
+			format: args.format === "json" ? "json" : "text",
+			lenient: args.lenient,
+			loose: args.loose
+		});
+	}
+});
+//#endregion
+export { validate_cmd_default as default };
+
+//# sourceMappingURL=validate.cmd-BxF4HNsu.js.map

package/dist/validate.cmd-BxF4HNsu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.cmd-BxF4HNsu.js","names":[],"sources":["../src/commands/validate.ts","../src/commands/validate.cmd.ts"],"sourcesContent":["import { basename } from 'node:path';\nimport { SkillValidator } from '../core/validator.js';\nimport type { ValidateOptions } from '../types.js';\nimport {\n\tdisplay_validation_stats,\n\terror,\n\tinfo,\n\tsuccess,\n} from '../utils/output.js';\n\nexport function validate_command(options: ValidateOptions): void {\n\tconst {\n\t\tskill_path,\n\t\tstrict,\n\t\tformat = 'text',\n\t\tlenient = false,\n\t\tloose = false,\n\t} = options;\n\t// Normalize path by removing trailing slashes before extracting basename\n\tconst normalized_path = skill_path.replace(/\\/+$/, '');\n\tconst skill_name = basename(normalized_path);\n\n\t// Determine validation mode: loose > lenient > strict (default)\n\tconst mode = loose ? 'loose' : lenient ? 'lenient' : 'strict';\n\tconst validator = new SkillValidator(skill_path, { mode });\n\tconst result = validator.validate_all();\n\n\t// JSON output\n\tif (format === 'json') {\n\t\tconst json_output = {\n\t\t\tskill_name,\n\t\t\tvalid: result.is_valid,\n\t\t\terrors: result.errors,\n\t\t\twarnings: result.warnings,\n\t\t\tvalidation: result.validation,\n\t\t\tstats: result.stats,\n\t\t};\n\t\tconsole.log(JSON.stringify(json_output, null, 2));\n\n\t\t// Exit codes for JSON mode\n\t\tif (!result.is_valid) {\n\t\t\tprocess.exit(1);\n\t\t}\n\t\tif (strict && result.warnings.length > 0) {\n\t\t\tprocess.exit(1);\n\t\t}\n\t\tprocess.exit(0);\n\t}\n\n\t// Text output (existing)\n\tinfo(`Validating skill: ${skill_name}`);\n\tconsole.log('='.repeat(60));\n\n\t// Display progressive disclosure stats\n\tif (result.stats) {\n\t\tdisplay_validation_stats(result.stats);\n\t}\n\n\t// Print errors\n\tif (result.errors.length > 0) {\n\t\tconsole.log('\\n❌ Errors:');\n\t\tfor (const err of result.errors) {\n\t\t\tconsole.log(`  ${err}`);\n\t\t}\n\t}\n\n\t// Print warnings\n\tif (result.warnings.length > 0) {\n\t\tconsole.log('\\n⚠️  Warnings:');\n\t\tfor (const warn of result.warnings) {\n\t\t\tconsole.log(`  ${warn}`);\n\t\t}\n\t}\n\n\t// Print final status\n\tif (!result.errors.length && !result.warnings.length) {\n\t\tconsole.log('');\n\t\tsuccess('Skill is valid!');\n\t} else if (!result.errors.length) {\n\t\tconsole.log('');\n\t\tsuccess('Skill is valid (with warnings)');\n\t} else {\n\t\tconsole.log('');\n\t\terror(\n\t\t\t`Skill validation failed with ${result.errors.length} error(s)`,\n\t\t);\n\t}\n\n\t// Handle exit codes\n\tif (!result.is_valid) {\n\t\tprocess.exit(1);\n\t}\n\n\tif (strict && result.warnings.length > 0) {\n\t\tconsole.log('\\n❌ Failed in strict mode due to warnings');\n\t\tprocess.exit(1);\n\t}\n\n\tprocess.exit(0);\n}\n","import { defineCommand } from 'citty';\nimport { validate_command } from './validate.js';\n\nexport default defineCommand({\n\tmeta: { name: 'validate', description: 'Validate a skill' },\n\targs: {\n\t\tskill_path: {\n\t\t\ttype: 'positional',\n\t\t\tdescription: 'Path to skill directory',\n\t\t\trequired: true,\n\t\t},\n\t\tformat: {\n\t\t\ttype: 'string',\n\t\t\tdescription: 'Output format (json or text)',\n\t\t\tdefault: 'text',\n\t\t},\n\t\tstrict: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Fail validation if warnings present',\n\t\t},\n\t\tlenient: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Use relaxed limits (150 lines max)',\n\t\t},\n\t\tloose: {\n\t\t\ttype: 'boolean',\n\t\t\tdescription: 'Use Anthropic official limits (500 lines max)',\n\t\t},\n\t},\n\trun({ args }) {\n\t\tvalidate_command({\n\t\t\tskill_path: args.skill_path,\n\t\t\tstrict: args.strict,\n\t\t\tformat: args.format === 'json' ? 'json' : 'text',\n\t\t\tlenient: args.lenient,\n\t\t\tloose: args.loose,\n\t\t});\n\t},\n});\n"],"mappings":";;;;;AAUA,SAAgB,iBAAiB,SAAgC;CAChE,MAAM,EACL,YACA,QACA,SAAS,QACT,UAAU,OACV,QAAQ,UACL;CAGJ,MAAM,aAAa,SADK,WAAW,QAAQ,QAAQ,GAAG,CACV;CAK5C,MAAM,SADY,IAAI,eAAe,YAAY,EAAE,MADtC,QAAQ,UAAU,UAAU,YAAY,UACI,CAAC,CACjC,cAAc;AAGvC,KAAI,WAAW,QAAQ;EACtB,MAAM,cAAc;GACnB;GACA,OAAO,OAAO;GACd,QAAQ,OAAO;GACf,UAAU,OAAO;GACjB,YAAY,OAAO;GACnB,OAAO,OAAO;GACd;AACD,UAAQ,IAAI,KAAK,UAAU,aAAa,MAAM,EAAE,CAAC;AAGjD,MAAI,CAAC,OAAO,SACX,SAAQ,KAAK,EAAE;AAEhB,MAAI,UAAU,OAAO,SAAS,SAAS,EACtC,SAAQ,KAAK,EAAE;AAEhB,UAAQ,KAAK,EAAE;;AAIhB,MAAK,qBAAqB,aAAa;AACvC,SAAQ,IAAI,IAAI,OAAO,GAAG,CAAC;AAG3B,KAAI,OAAO,MACV,0BAAyB,OAAO,MAAM;AAIvC,KAAI,OAAO,OAAO,SAAS,GAAG;AAC7B,UAAQ,IAAI,cAAc;AAC1B,OAAK,MAAM,OAAO,OAAO,OACxB,SAAQ,IAAI,KAAK,MAAM;;AAKzB,KAAI,OAAO,SAAS,SAAS,GAAG;AAC/B,UAAQ,IAAI,kBAAkB;AAC9B,OAAK,MAAM,QAAQ,OAAO,SACzB,SAAQ,IAAI,KAAK,OAAO;;AAK1B,KAAI,CAAC,OAAO,OAAO,UAAU,CAAC,OAAO,SAAS,QAAQ;AACrD,UAAQ,IAAI,GAAG;AACf,UAAQ,kBAAkB;YAChB,CAAC,OAAO,OAAO,QAAQ;AACjC,UAAQ,IAAI,GAAG;AACf,UAAQ,iCAAiC;QACnC;AACN,UAAQ,IAAI,GAAG;AACf,QACC,gCAAgC,OAAO,OAAO,OAAO,WACrD;;AAIF,KAAI,CAAC,OAAO,SACX,SAAQ,KAAK,EAAE;AAGhB,KAAI,UAAU,OAAO,SAAS,SAAS,GAAG;AACzC,UAAQ,IAAI,4CAA4C;AACxD,UAAQ,KAAK,EAAE;;AAGhB,SAAQ,KAAK,EAAE;;;;AC/FhB,IAAA,uBAAe,cAAc;CAC5B,MAAM;EAAE,MAAM;EAAY,aAAa;EAAoB;CAC3D,MAAM;EACL,YAAY;GACX,MAAM;GACN,aAAa;GACb,UAAU;GACV;EACD,QAAQ;GACP,MAAM;GACN,aAAa;GACb,SAAS;GACT;EACD,QAAQ;GACP,MAAM;GACN,aAAa;GACb;EACD,SAAS;GACR,MAAM;GACN,aAAa;GACb;EACD,OAAO;GACN,MAAM;GACN,aAAa;GACb;EACD;CACD,IAAI,EAAE,QAAQ;AACb,mBAAiB;GAChB,YAAY,KAAK;GACjB,QAAQ,KAAK;GACb,QAAQ,KAAK,WAAW,SAAS,SAAS;GAC1C,SAAS,KAAK;GACd,OAAO,KAAK;GACZ,CAAC;;CAEH,CAAC"}