@agentrules/cli 0.2.1 → 0.3.1

package/dist/index.js

@@ -9,6 +9,7 @@ import { chmod, constants as constants$1 } from "fs";
 import * as client from "openid-client";
 import { promisify } from "util";
 import { exec } from "child_process";
+import * as p$2 from "@clack/prompts";
 import * as p$1 from "@clack/prompts";
 import * as p from "@clack/prompts";
 
@@ -63,6 +64,11 @@ const PLATFORMS = {
 				description: "Custom tool",
 				project: "{platformDir}/tool/{name}.ts",
 				global: "{platformDir}/tool/{name}.ts"
+			},
+			skill: {
+				description: "Agent skill",
+				project: "{platformDir}/skill/{name}/SKILL.md",
+				global: "{platformDir}/skill/{name}/SKILL.md"
 			}
 		}
 	},
@@ -112,6 +118,11 @@ const PLATFORMS = {
 				description: "Custom slash command",
 				project: "{platformDir}/commands/{name}.md",
 				global: "{platformDir}/commands/{name}.md"
+			},
+			skill: {
+				description: "Agent skill",
+				project: "{platformDir}/skills/{name}/SKILL.md",
+				global: "{platformDir}/skills/{name}/SKILL.md"
 			}
 		}
 	},
@@ -129,6 +140,11 @@ const PLATFORMS = {
 				description: "Custom prompt",
 				project: null,
 				global: "{platformDir}/prompts/{name}.md"
+			},
+			skill: {
+				description: "Agent skill",
+				project: "{platformDir}/skills/{name}/SKILL.md",
+				global: "{platformDir}/skills/{name}/SKILL.md"
 			}
 		}
 	}
@@ -265,6 +281,41 @@ function inferTypeFromPath(platform, filePath) {
 	if (!nextDir) return;
 	return getProjectTypeDirMap(platform).get(nextDir);
 }
+/**
+* Get the install directory for a type (parent directory of the install path).
+* For skills, this is the directory containing SKILL.md.
+*/
+function getInstallDir({ platform, type, name }) {
+	const installPath = getInstallPath({
+		platform,
+		type,
+		name,
+		scope: "project"
+	});
+	if (!installPath) return null;
+	const lastSlash = installPath.lastIndexOf("/");
+	if (lastSlash === -1) return null;
+	return installPath.slice(0, lastSlash);
+}
+/**
+* Normalize skill files by finding SKILL.md anchor and adjusting all paths.
+* Strips any existing path prefix to prevent duplication.
+*/
+function normalizeSkillFiles({ files, installDir }) {
+	const marker = files.find((f) => f.path === "SKILL.md" || f.path.endsWith("/SKILL.md"));
+	if (!marker) throw new Error("SKILL.md not found in files");
+	const skillRoot = marker.path === "SKILL.md" ? "." : marker.path.slice(0, marker.path.lastIndexOf("/"));
+	return files.map((f) => {
+		let relative$1;
+		if (skillRoot === ".") relative$1 = f.path;
+		else if (f.path.startsWith(`${skillRoot}/`)) relative$1 = f.path.slice(skillRoot.length + 1);
+		else relative$1 = f.path;
+		return {
+			...f,
+			path: `${installDir}/${relative$1}`
+		};
+	});
+}
 
 //#endregion
 //#region ../core/src/utils/encoding.ts
@@ -1939,7 +1990,7 @@ const $ZodUnion = /* @__PURE__ */ $constructor("$ZodUnion", (inst, def) => {
 	defineLazy(inst._zod, "pattern", () => {
 		if (def.options.every((o) => o._zod.pattern)) {
 			const patterns = def.options.map((o) => o._zod.pattern);
-			return new RegExp(`^(${patterns.map((p$2) => cleanRegex(p$2.source)).join("|")})$`);
+			return new RegExp(`^(${patterns.map((p$3) => cleanRegex(p$3.source)).join("|")})$`);
 		}
 		return void 0;
 	});
@@ -2318,9 +2369,9 @@ var $ZodRegistry = class {
 		return this;
 	}
 	get(schema) {
-		const p$2 = schema._zod.parent;
-		if (p$2) {
-			const pm = { ...this.get(p$2) ?? {} };
+		const p$3 = schema._zod.parent;
+		if (p$3) {
+			const pm = { ...this.get(p$3) ?? {} };
 			delete pm.id;
 			const f = {
 				...pm,
@@ -4325,8 +4376,8 @@ function command(cmd) {
 	return theme.command(cmd);
 }
 /** Format a file path */
-function path(p$2) {
-	return theme.path(p$2);
+function path(p$3) {
+	return theme.path(p$3);
 }
 /** Format as muted/secondary text */
 function muted(text) {
@@ -4644,6 +4695,22 @@ function fileTree(files, options) {
 	});
 	return lines.join("\n");
 }
+function rulePreview(options) {
+	const lines = [];
+	lines.push(header(options.header));
+	if (options.path) lines.push(keyValue(options.pathLabel ?? "Path", path(options.path)));
+	lines.push(keyValue("Name", code(options.name)));
+	lines.push(keyValue("Title", options.title));
+	lines.push(keyValue("Description", options.description || dim("—")));
+	lines.push(keyValue("Platforms", options.platforms.join(", ")));
+	if (options.type) lines.push(keyValue("Type", options.type));
+	if (options.tags && options.tags.length > 0) lines.push(keyValue("Tags", options.tags.join(", ")));
+	else if (options.showHints) lines.push(keyValue("Tags", dim("— (add to improve discoverability)")));
+	if (options.features && options.features.length > 0) lines.push(keyValue("Features", options.features.join(", ")));
+	else if (options.showHints) lines.push(keyValue("Features", dim("— (highlight what this rule does)")));
+	if (options.license) lines.push(keyValue("License", options.license));
+	return lines.join("\n");
+}
 const ui = {
 	theme,
 	symbols,
@@ -4680,6 +4747,7 @@ const ui = {
 	fileCounts,
 	hint,
 	link,
+	rulePreview,
 	stripAnsi,
 	truncate,
 	formatBytes: formatBytes$1,
@@ -5832,11 +5900,43 @@ async function directoryExists(path$1) {
 	}
 }
 
+//#endregion
+//#region src/lib/zod-validator.ts
+/**
+* Creates a validator function from a Zod schema.
+* Returns error message if invalid, undefined if valid.
+*/
+function check(schema) {
+	return (value) => {
+		const result = schema.safeParse(value);
+		if (!result.success) return result.error.issues[0]?.message;
+		return;
+	};
+}
+
 //#endregion
 //#region src/lib/rule-utils.ts
-const INSTALL_FILENAME = "INSTALL.txt";
-const README_FILENAME = "README.md";
-const LICENSE_FILENAME = "LICENSE.md";
+const SKILL_FILENAME = "SKILL.md";
+/**
+* Parse SKILL.md frontmatter for name and license.
+* Only extracts simple key: value pairs we need for quick publish defaults.
+*/
+function parseSkillFrontmatter(content) {
+	const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+	if (!match?.[1]) return {};
+	const frontmatter = match[1];
+	const result = {};
+	const nameMatch = frontmatter.match(/^name:\s*["']?([^"'\n]+)["']?\s*$/m);
+	if (nameMatch?.[1]) result.name = nameMatch[1].trim();
+	const licenseMatch = frontmatter.match(/^license:\s*["']?([^"'\n]+)["']?\s*$/m);
+	if (licenseMatch?.[1]) result.license = licenseMatch[1].trim();
+	return result;
+}
+const METADATA_FILES = {
+	install: ["INSTALL.txt"],
+	readme: ["README.md"],
+	license: ["LICENSE.md", "LICENSE.txt"]
+};
 /**
 * Files/directories that are always excluded from rules.
 * These are never useful in a rule bundle.
@@ -5937,7 +6037,7 @@ async function loadConfig(inputPath, overrides) {
 		platforms
 	};
 	const configDir = dirname(configPath);
-	const platformNames = platforms.map((p$2) => p$2.platform).join(", ");
+	const platformNames = platforms.map((plat) => plat.platform).join(", ");
 	log.debug(`Loaded config: ${config$1.name}, platforms: ${platformNames}`);
 	return {
 		configPath,
@@ -5970,9 +6070,9 @@ async function loadRule(ruleDir, overrides) {
 }
 async function collectMetadata(loaded) {
 	const { configDir } = loaded;
-	const installMessage = await readFileIfExists(join(configDir, INSTALL_FILENAME));
-	const readmeContent = await readFileIfExists(join(configDir, README_FILENAME));
-	const licenseContent = await readFileIfExists(join(configDir, LICENSE_FILENAME));
+	const installMessage = await readFirstMatch(configDir, METADATA_FILES.install);
+	const readmeContent = await readFirstMatch(configDir, METADATA_FILES.readme);
+	const licenseContent = await readFirstMatch(configDir, METADATA_FILES.license);
 	return {
 		installMessage,
 		readmeContent,
@@ -5990,6 +6090,34 @@ async function collectPlatformFiles(loaded) {
 		const resolvedSourcePath = sourcePath ?? ".";
 		const filesDir = join(configDir, resolvedSourcePath);
 		log.debug(`Files for ${platform}: source=${resolvedSourcePath}, dir=${filesDir}`);
+		const filesDirExists = await directoryExists(filesDir);
+		const rootExclude = [RULE_CONFIG_FILENAME];
+		if (filesDir === configDir) rootExclude.push(...METADATA_FILES.readme, ...METADATA_FILES.license, ...METADATA_FILES.install);
+		const collectedFiles = filesDirExists ? await collectFiles(filesDir, rootExclude, ignorePatterns) : [];
+		if (collectedFiles.length === 0) {
+			if (!filesDirExists) throw new Error(`Files directory not found: ${filesDir}. Create the directory or set "path" in the platform entry.`);
+			throw new Error(`No files found in ${filesDir}. Rules must include at least one file.`);
+		}
+		if (config$1.type === "skill") {
+			const installDir = getInstallDir({
+				platform,
+				type: "skill",
+				name: config$1.name
+			});
+			if (!installDir) throw new Error(`Platform "${platform}" does not support skill type.`);
+			const normalizedFiles = normalizeSkillFiles({
+				files: collectedFiles,
+				installDir
+			});
+			platformFiles.push({
+				platform,
+				files: normalizedFiles.map((f) => ({
+					path: f.path,
+					content: typeof f.content === "string" ? f.content : new TextDecoder().decode(f.content)
+				}))
+			});
+			continue;
+		}
 		const treatInstructionAsRoot = config$1.type === void 0 || config$1.type === "instruction";
 		const instructionProjectPath = treatInstructionAsRoot ? getInstallPath({
 			platform,
@@ -5997,10 +6125,6 @@ async function collectPlatformFiles(loaded) {
 			scope: "project"
 		}) : null;
 		const instructionContent = instructionProjectPath ? await readFileIfExists(join(configDir, instructionProjectPath)) : void 0;
-		const filesDirExists = await directoryExists(filesDir);
-		const rootExclude = [RULE_CONFIG_FILENAME];
-		if (filesDir === configDir) rootExclude.push(README_FILENAME, LICENSE_FILENAME, INSTALL_FILENAME);
-		const collectedFiles = filesDirExists ? await collectFiles(filesDir, rootExclude, ignorePatterns) : [];
 		const publishFiles = [];
 		const seenPublishPaths = new Set();
 		for (const file of collectedFiles) {
@@ -6020,10 +6144,7 @@ async function collectPlatformFiles(loaded) {
 				content: instructionContent
 			});
 		}
-		if (publishFiles.length === 0) {
-			if (!filesDirExists) throw new Error(`Files directory not found: ${filesDir}. Create the directory or set "path" in the platform entry.`);
-			throw new Error(`No files found in ${filesDir}. Rules must include at least one file.`);
-		}
+		if (publishFiles.length === 0) throw new Error(`No files found in ${filesDir}. Rules must include at least one file.`);
 		platformFiles.push({
 			platform,
 			files: publishFiles
@@ -6092,18 +6213,280 @@ async function readFileIfExists(path$1) {
 	if (await fileExists(path$1)) return await readFile(path$1, "utf8");
 	return;
 }
+/**
+* Try reading files from a list of candidates, return first match.
+*/
+async function readFirstMatch(dir, filenames) {
+	for (const filename of filenames) {
+		const content = await readFileIfExists(join(dir, filename));
+		if (content !== void 0) return content;
+	}
+	return;
+}
+/**
+* Detect if directory contains SKILL.md and extract frontmatter defaults.
+*/
+async function detectSkillDirectory$1(directory) {
+	const skillPath = join(directory, SKILL_FILENAME);
+	if (!await fileExists(skillPath)) return;
+	const content = await readFile(skillPath, "utf8");
+	const frontmatter = parseSkillFrontmatter(content);
+	return {
+		name: frontmatter.name,
+		license: frontmatter.license
+	};
+}
+function parseTags(input) {
+	if (typeof input !== "string") return [];
+	if (input.trim().length === 0) return [];
+	return input.split(",").map((tag) => tag.trim().toLowerCase()).filter((tag) => tag.length > 0);
+}
+function checkTags(value) {
+	const tags = parseTags(value);
+	const result = tagsSchema.safeParse(tags);
+	if (!result.success) return result.error.issues[0]?.message;
+}
+/**
+* Collect rule inputs via interactive prompts or defaults.
+*
+* Handles:
+* - Skill detection with SKILL.md frontmatter
+* - Platform multiselect with keyboard hints
+* - Per-platform path prompting (for non-skill multi-platform)
+* - Name, title, description, tags, license prompts
+*/
+async function collectRuleInputs(options) {
+	const { directory, defaults = {}, nonInteractive = false } = options;
+	const skillInfo = await detectSkillDirectory$1(directory);
+	let isSkill = false;
+	if (skillInfo && !nonInteractive) {
+		const confirm = await p$2.confirm({
+			message: `Detected SKILL.md${skillInfo.name ? ` (${skillInfo.name})` : ""}. Initialize as skill?`,
+			initialValue: true
+		});
+		if (p$2.isCancel(confirm)) throw new Error("Cancelled");
+		isSkill = confirm;
+	} else if (skillInfo && nonInteractive) isSkill = true;
+	const defaultName = isSkill && skillInfo?.name ? normalizeName(skillInfo.name) : defaults.name ?? "my-rule";
+	const defaultLicense = isSkill && skillInfo?.license ? skillInfo.license : defaults.license ?? "MIT";
+	const validatedPlatforms = [];
+	if (defaults.platforms) for (const platform of defaults.platforms) {
+		if (!isSupportedPlatform(platform)) throw new Error(`Unknown platform "${platform}"`);
+		validatedPlatforms.push(platform);
+	}
+	const selectedPlatforms = validatedPlatforms.length > 0 ? validatedPlatforms : await (async () => {
+		if (nonInteractive) throw new Error("Missing --platform in non-interactive mode");
+		const platformChoices = await p$2.multiselect({
+			message: `Platforms ${ui.dim("(space to toggle, 'a' to select all)")}`,
+			options: PLATFORM_IDS.map((id) => ({
+				value: id,
+				label: id
+			})),
+			required: true
+		});
+		if (p$2.isCancel(platformChoices)) throw new Error("Cancelled");
+		return platformChoices;
+	})();
+	const platformPaths = {};
+	if (selectedPlatforms.length > 1 && !isSkill && !nonInteractive) {
+		const hasCompletePathMapping = selectedPlatforms.every((platform) => {
+			const value = defaults.platformPaths?.[platform];
+			return typeof value === "string" && value.trim().length > 0;
+		});
+		if (hasCompletePathMapping && defaults.platformPaths) for (const platform of selectedPlatforms) {
+			const pathVal = defaults.platformPaths[platform]?.trim();
+			if (pathVal && pathVal !== ".") platformPaths[platform] = pathVal;
+		}
+		else for (const platform of selectedPlatforms) {
+			const mappedPath = defaults.platformPaths?.[platform]?.trim();
+			const suggestedPath = mappedPath ?? (await directoryExists(join(directory, platform)) ? platform : ".");
+			const input = await p$2.text({
+				message: `Folder for ${platform} files ('.' = same folder as agentrules.json)`,
+				placeholder: suggestedPath,
+				defaultValue: suggestedPath
+			});
+			if (p$2.isCancel(input)) throw new Error("Cancelled");
+			const trimmed = input.trim();
+			const resolvedPath = trimmed.length > 0 ? trimmed : suggestedPath;
+			if (resolvedPath !== ".") platformPaths[platform] = resolvedPath;
+		}
+	} else if (defaults.platformPaths) for (const platform of selectedPlatforms) {
+		const pathVal = defaults.platformPaths[platform]?.trim();
+		if (pathVal && pathVal !== ".") platformPaths[platform] = pathVal;
+	}
+	if (nonInteractive) {
+		const name = normalizeName(defaults.name ?? defaultName);
+		const nameCheck = nameSchema.safeParse(name);
+		if (!nameCheck.success) throw new Error(nameCheck.error.issues[0]?.message ?? "Invalid name");
+		return {
+			platforms: selectedPlatforms,
+			platformPaths,
+			name,
+			title: defaults.title ?? toTitleCase(name),
+			description: defaults.description ?? "",
+			tags: defaults.tags ?? [],
+			license: defaultLicense,
+			isSkill,
+			ruleType: isSkill ? "skill" : defaults.ruleType
+		};
+	}
+	const result = await p$2.group({
+		name: () => {
+			const normalizedDefault = normalizeName(defaultName);
+			return p$2.text({
+				message: "Rule name",
+				placeholder: normalizedDefault,
+				defaultValue: normalizedDefault,
+				validate: (value) => {
+					if (!value || value.trim() === "") return;
+					return check(nameSchema)(value);
+				}
+			});
+		},
+		title: ({ results }) => {
+			const defaultTitle = defaults.title ?? toTitleCase(results.name ?? defaultName);
+			return p$2.text({
+				message: "Title",
+				defaultValue: defaultTitle,
+				placeholder: defaultTitle
+			});
+		},
+		description: () => p$2.text({
+			message: "Description",
+			placeholder: "Describe what this rule does...",
+			defaultValue: defaults.description,
+			validate: check(descriptionSchema)
+		}),
+		tags: () => p$2.text({
+			message: "Tags (comma-separated, optional)",
+			placeholder: "e.g., typescript, testing, react",
+			validate: checkTags
+		}),
+		license: async () => {
+			const choice = await p$2.select({
+				message: "License",
+				options: [...COMMON_LICENSES.map((id) => ({
+					value: id,
+					label: id
+				})), {
+					value: "__other__",
+					label: "Other (enter SPDX identifier)"
+				}],
+				initialValue: defaultLicense
+			});
+			if (p$2.isCancel(choice)) throw new Error("Cancelled");
+			if (choice === "__other__") {
+				const custom = await p$2.text({
+					message: "License (SPDX identifier)",
+					placeholder: "e.g., MPL-2.0, AGPL-3.0-only",
+					validate: check(licenseSchema)
+				});
+				if (p$2.isCancel(custom)) throw new Error("Cancelled");
+				return custom;
+			}
+			return choice;
+		}
+	}, { onCancel: () => {
+		throw new Error("Cancelled");
+	} });
+	const tags = parseTags(result.tags);
+	return {
+		platforms: selectedPlatforms,
+		platformPaths,
+		name: result.name,
+		title: result.title.trim() || toTitleCase(result.name),
+		description: result.description ?? "",
+		tags,
+		license: result.license,
+		isSkill,
+		ruleType: isSkill ? "skill" : defaults.ruleType
+	};
+}
 
 //#endregion
-//#region src/lib/zod-validator.ts
+//#region src/commands/rule/init.ts
+/** Default rule name when none specified */
+const DEFAULT_RULE_NAME = "my-rule";
 /**
-* Creates a validator function from a Zod schema.
-* Returns error message if invalid, undefined if valid.
+* Detect if directory contains SKILL.md and extract frontmatter defaults.
 */
-function check(schema) {
-	return (value) => {
-		const result = schema.safeParse(value);
-		if (!result.success) return result.error.issues[0]?.message;
-		return;
+async function detectSkillDirectory(directory) {
+	const skillPath = join(directory, SKILL_FILENAME);
+	if (!await fileExists(skillPath)) return;
+	const content = await readFile(skillPath, "utf8");
+	const frontmatter = parseSkillFrontmatter(content);
+	return {
+		name: frontmatter.name,
+		license: frontmatter.license
+	};
+}
+/**
+* Initialize a rule in a directory (rule root).
+*
+* Structure:
+* - ruleDir/agentrules.json - rule config
+* - ruleDir/* - rule files (collected by default)
+* - ruleDir/README.md, ruleDir/LICENSE.md, ruleDir/INSTALL.txt - optional metadata (not bundled)
+*/
+async function initRule(options) {
+	const ruleDir = options.directory ?? process.cwd();
+	log.debug(`Initializing rule in: ${ruleDir}`);
+	const skillInfo = await detectSkillDirectory(ruleDir);
+	const isSkillDirectory = skillInfo !== void 0;
+	const inferredPlatform = getPlatformFromDir(basename(ruleDir));
+	const platformInputs = options.platforms ?? (inferredPlatform ? [inferredPlatform] : []);
+	if (platformInputs.length === 0) throw new Error(`Cannot determine platform. Specify --platform (${PLATFORM_IDS.join(", ")}).`);
+	const platforms = platformInputs.map(normalizePlatformEntryInput);
+	const name = normalizeName(options.name ?? skillInfo?.name ?? DEFAULT_RULE_NAME);
+	const title = options.title ?? toTitleCase(name);
+	const description = options.description ?? "";
+	const license = options.license ?? skillInfo?.license ?? "MIT";
+	const ruleType = isSkillDirectory ? "skill" : options.type;
+	const platformLabels = platforms.map((p$3) => typeof p$3 === "string" ? p$3 : p$3.platform).join(", ");
+	log.debug(`Rule name: ${name}, platforms: ${platformLabels}`);
+	const configPath = join(ruleDir, RULE_CONFIG_FILENAME);
+	if (!options.force && await fileExists(configPath)) throw new Error(`${RULE_CONFIG_FILENAME} already exists. Use --force to overwrite.`);
+	const config$1 = {
+		$schema: RULE_SCHEMA_URL,
+		name,
+		...ruleType && { type: ruleType },
+		title,
+		version: 1,
+		description,
+		tags: options.tags ?? [],
+		license,
+		platforms
+	};
+	let createdDir;
+	if (await directoryExists(ruleDir)) log.debug(`Directory exists: ${ruleDir}`);
+	else {
+		await mkdir(ruleDir, { recursive: true });
+		createdDir = ruleDir;
+		log.debug(`Created directory: ${ruleDir}`);
+	}
+	const content = `${JSON.stringify(config$1, null, 2)}\n`;
+	await writeFile(configPath, content, "utf8");
+	log.debug(`Wrote config file: ${configPath}`);
+	log.debug("Rule initialization complete.");
+	return {
+		configPath,
+		rule: config$1,
+		createdDir
+	};
+}
+function normalizePlatform(input) {
+	const normalized = input.toLowerCase();
+	if (!isSupportedPlatform(normalized)) throw new Error(`Unknown platform "${input}". Supported: ${PLATFORM_IDS.join(", ")}`);
+	return normalized;
+}
+function normalizePlatformEntryInput(input) {
+	if (typeof input === "string") return normalizePlatform(input);
+	const platform = normalizePlatform(input.platform);
+	const path$1 = typeof input.path === "string" ? input.path.trim() : "";
+	if (path$1.length === 0 || path$1 === ".") return platform;
+	return {
+		platform,
+		path: path$1
 	};
 }
 
@@ -6111,14 +6494,46 @@ function check(schema) {
 //#region src/commands/publish.ts
 /** Maximum size per variant/platform bundle in bytes (1MB) */
 const MAX_VARIANT_SIZE_BYTES = 1 * 1024 * 1024;
-/** Schema for parsing comma-separated tags input */
-const tagsInputSchema = string().transform((input) => input.split(",").map((t) => t.trim().toLowerCase()).filter((t) => t.length > 0)).pipe(tagsSchema);
 function formatBytes(bytes) {
 	if (bytes < 1024) return `${bytes} B`;
 	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
 	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
 /**
+* Prompts to create agentrules.json after quick publish (or dry run).
+* With --yes, creates without prompting.
+*/
+async function promptToCreateConfig(quickPublish, yes) {
+	if (!quickPublish) return false;
+	let createConfig = yes ?? false;
+	if (!yes && process.stdin.isTTY) {
+		log.print("");
+		const answer = await p$1.confirm({
+			message: "Create agentrules.json for future publishes?",
+			initialValue: true
+		});
+		createConfig = !p$1.isCancel(answer) && answer;
+	}
+	if (createConfig) {
+		const sourceDir = quickPublish.source.type === "directory" ? quickPublish.source.path : void 0;
+		const configDir = sourceDir ?? (quickPublish.source.path.replace(/[/\\][^/\\]+$/, "") || ".");
+		await initRule({
+			directory: configDir,
+			name: quickPublish.name,
+			title: quickPublish.title,
+			description: quickPublish.description || void 0,
+			platforms: quickPublish.platforms,
+			type: quickPublish.ruleType,
+			tags: quickPublish.tags,
+			license: quickPublish.license,
+			force: false
+		});
+		log.success(`Created ${ui.path(join(configDir, "agentrules.json"))}`);
+		return true;
+	}
+	return false;
+}
+/**
 * Publishes a rule to the registry.
 *
 * Supports:
@@ -6139,11 +6554,12 @@ async function publish(options = {}) {
 	}
 	if (!dryRun) log.debug(`Authenticated as user, publishing to ${ctx.registry.url}`);
 	const filePath = await getSingleFilePath(path$1);
+	const quickDir = await getQuickPublishDirectory(path$1);
 	let publishInput;
 	if (filePath) {
 		let resolved;
 		try {
-			resolved = await resolveSingleFileInputs({
+			resolved = await resolveQuickPublishInputs({
 				name,
 				platform,
 				type,
@@ -6151,7 +6567,10 @@ async function publish(options = {}) {
 				description,
 				tags,
 				license
-			}, filePath, {
+			}, {
+				type: "file",
+				path: filePath
+			}, {
 				dryRun,
 				yes
 			});
@@ -6166,7 +6585,7 @@ async function publish(options = {}) {
 		const fileSpinner = await log.spinner("Building bundle...");
 		try {
 			publishInput = await buildPublishInput({
-				rule: await buildRuleInputFromSingleFile(resolved),
+				rule: await buildRuleInputFromQuickPublish(resolved),
 				version: version$2
 			});
 			log.debug(`Built publish input for platforms: ${publishInput.variants.map((v) => v.platform).join(", ")}`);
@@ -6184,7 +6603,61 @@ async function publish(options = {}) {
 			dryRun,
 			version: version$2,
 			spinner: fileSpinner,
-			ctx
+			ctx,
+			quickPublish: resolved,
+			yes
+		});
+	}
+	if (quickDir) {
+		let resolved;
+		try {
+			resolved = await resolveQuickPublishInputs({
+				name,
+				platform,
+				type,
+				title,
+				description,
+				tags,
+				license
+			}, {
+				type: "directory",
+				path: quickDir
+			}, {
+				dryRun,
+				yes
+			});
+		} catch (error$2) {
+			const message = getErrorMessage(error$2);
+			log.error(message);
+			return {
+				success: false,
+				error: message
+			};
+		}
+		const dirSpinner = await log.spinner("Building bundle...");
+		try {
+			publishInput = await buildPublishInput({
+				rule: await buildRuleInputFromQuickPublish(resolved),
+				version: version$2
+			});
+			log.debug(`Built publish input for platforms: ${publishInput.variants.map((v) => v.platform).join(", ")}`);
+		} catch (error$2) {
+			const message = getErrorMessage(error$2);
+			dirSpinner.fail("Failed to build bundle");
+			log.error(message);
+			return {
+				success: false,
+				error: message
+			};
+		}
+		return await finalizePublish({
+			publishInput,
+			dryRun,
+			version: version$2,
+			spinner: dirSpinner,
+			ctx,
+			quickPublish: resolved,
+			yes
 		});
 	}
 	const spinner$1 = await log.spinner("Validating rule...");
@@ -6275,19 +6748,27 @@ async function getSingleFilePath(inputPath) {
 	if (basename(inputPath) === RULE_CONFIG_FILENAME) return;
 	return inputPath;
 }
+async function getQuickPublishDirectory(inputPath) {
+	if (!inputPath) return;
+	const pathStat = await stat(inputPath).catch(() => null);
+	if (!pathStat?.isDirectory()) return;
+	const configStat = await stat(`${inputPath}/${RULE_CONFIG_FILENAME}`).catch(() => null);
+	if (configStat?.isFile()) return;
+	return inputPath;
+}
 function normalizePathForInference(value) {
 	return value.replace(/\\/g, "/");
 }
 function stripExtension(value) {
 	return value.replace(/\.[^/.]+$/, "");
 }
-function inferSingleFileDefaults(filePath) {
+function inferFileDefaults(filePath) {
 	const normalized = normalizePathForInference(filePath);
 	const segments = normalized.split("/").filter(Boolean);
 	const fileName = segments.at(-1) ?? "";
 	const instructionPlatforms = inferInstructionPlatformsFromFileName(fileName);
 	if (instructionPlatforms.length > 0) return {
-		type: "instruction",
+		ruleType: "instruction",
 		...instructionPlatforms.length === 1 ? { platform: instructionPlatforms[0] } : {}
 	};
 	const platform = inferPlatformFromPath(filePath);
@@ -6295,7 +6776,7 @@ function inferSingleFileDefaults(filePath) {
 	const inferredType = inferTypeFromPath(platform, filePath);
 	const result = { platform };
 	if (inferredType) {
-		result.type = inferredType;
+		result.ruleType = inferredType;
 		if (inferredType !== "instruction") result.name = normalizeName(stripExtension(fileName));
 	}
 	return result;
@@ -6311,34 +6792,24 @@ function buildConfigPublishOverrides(options) {
 	if (options.tags !== void 0) overrides.tags = options.tags;
 	return Object.keys(overrides).length > 0 ? overrides : void 0;
 }
-async function resolveSingleFileInputs(options, filePath, ctx) {
-	const inferred = inferSingleFileDefaults(filePath);
+async function resolveQuickPublishInputs(options, source, ctx) {
 	const isInteractive = !ctx.yes && process.stdin.isTTY;
-	const hasRequiredArgs = options.name !== void 0 && options.platform !== void 0 && options.type !== void 0;
-	if (!(isInteractive || hasRequiredArgs)) throw new Error("Publishing a single file in non-interactive mode requires --name, --platform, and --type.");
-	const selectedPlatforms = options.platform ? parsePlatformSelection(options.platform) : void 0;
-	if (selectedPlatforms && selectedPlatforms.length > 1) throw new Error("Publishing a single file requires exactly one --platform value.");
-	let selectedPlatform = selectedPlatforms?.[0] ? normalizePlatformInput(selectedPlatforms[0]) : inferred.platform;
-	if (!selectedPlatform) {
-		if (!isInteractive) throw new Error("Missing --platform");
-		const selection = await p$1.select({
-			message: "Platform",
-			options: PLATFORM_IDS.map((id) => ({
-				value: id,
-				label: id
-			}))
-		});
-		if (p$1.isCancel(selection)) throw new Error("Cancelled");
-		selectedPlatform = selection;
-	}
-	let selectedType = options.type ?? inferred.type;
-	if (!selectedType) {
-		if (!isInteractive) throw new Error("Missing --type");
-		const candidates = getValidTypes(selectedPlatform).filter((t) => supportsInstallPath({
-			platform: selectedPlatform,
+	const isDirectory = source.type === "directory";
+	const isFile = source.type === "file";
+	const fileInferred = isFile ? inferFileDefaults(source.path) : {};
+	const parsedPlatforms = options.platform ? parsePlatformSelection(options.platform).map(normalizePlatformInput) : void 0;
+	let selectedType = options.type ?? fileInferred.ruleType;
+	const platformsForTypeCheck = parsedPlatforms && parsedPlatforms.length > 0 ? parsedPlatforms : fileInferred.platform ? [fileInferred.platform] : [];
+	if (isFile && !selectedType) {
+		if (!isInteractive) throw new Error("Publishing a single file in non-interactive mode requires --name, --platform, and --type.");
+		if (platformsForTypeCheck.length === 0) throw new Error("Missing --platform");
+		const candidateSets = platformsForTypeCheck.map((plat) => getValidTypes(plat).filter((t) => supportsInstallPath({
+			platform: plat,
 			type: t,
 			scope: "project"
-		}));
+		})));
+		const candidates = candidateSets.length === 1 ? candidateSets[0] : candidateSets.reduce((acc, set) => acc.filter((t) => set.includes(t)));
+		if (candidates.length === 0) throw new Error(`No common type supports all selected platforms: ${platformsForTypeCheck.join(", ")}`);
 		const selection = await p$1.select({
 			message: "Type",
 			options: candidates.map((t) => ({
@@ -6349,117 +6820,127 @@ async function resolveSingleFileInputs(options, filePath, ctx) {
 		if (p$1.isCancel(selection)) throw new Error("Cancelled");
 		selectedType = selection;
 	}
-	const platform = selectedPlatform;
-	const type = selectedType;
-	const nameValue = options.name ?? await (async () => {
-		if (!isInteractive) throw new Error("Missing --name");
-		const input = await p$1.text({
-			message: "Rule name",
-			placeholder: "my-rule",
-			validate: check(nameSchema)
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return input;
-	})();
-	const normalizedName = normalizeName(nameValue);
-	const nameCheck = nameSchema.safeParse(normalizedName);
-	if (!nameCheck.success) throw new Error(nameCheck.error.issues[0]?.message ?? "Invalid name");
-	const bundlePath = getInstallPath({
+	if (options.type && platformsForTypeCheck.length > 0) {
+		const ruleType = selectedType;
+		for (const platform of platformsForTypeCheck) if (!supportsInstallPath({
+			platform,
+			type: ruleType,
+			scope: "project"
+		})) throw new Error(`Type "${ruleType}" is not supported for project installs on platform "${platform}".`);
+	}
+	const collected = await collectRuleInputs({
+		directory: isDirectory ? source.path : dirname(source.path),
+		defaults: {
+			name: options.name ?? fileInferred.name,
+			title: options.title,
+			description: options.description,
+			platforms: parsedPlatforms,
+			license: options.license ?? fileInferred.license,
+			tags: options.tags,
+			ruleType: selectedType
+		},
+		nonInteractive: !isInteractive,
+		detectType: isDirectory
+	});
+	const finalRuleType = isFile ? selectedType : collected.ruleType ?? (collected.isSkill ? "skill" : "instruction");
+	for (const platform of collected.platforms) if (!supportsInstallPath({
 		platform,
-		type,
-		name: normalizedName,
+		type: finalRuleType,
 		scope: "project"
-	});
-	if (!bundlePath) throw new Error(`Type "${type}" is not supported for project installs on platform "${platform}".`);
-	const defaultTitle = toTitleCase(normalizedName);
-	const finalTitle = options.title ?? await (async () => {
-		if (!isInteractive) return defaultTitle;
-		const input = await p$1.text({
-			message: "Title",
-			defaultValue: defaultTitle,
-			placeholder: defaultTitle
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return input;
-	})();
-	const finalDescription = options.description ?? await (async () => {
-		if (!isInteractive) return "";
-		const input = await p$1.text({
-			message: "Description (optional)",
-			placeholder: "Describe what this rule does...",
-			validate: check(descriptionSchema)
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return input;
-	})();
-	const finalTags = await (async () => {
-		if (options.tags) return tagsSchema.parse(options.tags);
-		if (!isInteractive) return [];
-		const input = await p$1.text({
-			message: "Tags (optional)",
-			placeholder: "comma-separated, e.g. typescript, react",
-			validate: check(tagsInputSchema)
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return tagsInputSchema.parse(input);
-	})();
-	const finalLicense = options.license ?? "MIT";
+	})) throw new Error(`Type "${finalRuleType}" is not supported for project installs on platform "${platform}".`);
 	if (isInteractive && !ctx.dryRun) {
 		log.print("");
-		log.print(ui.header("Quick publish"));
-		log.print(ui.keyValue("File", ui.path(filePath)));
-		log.print(ui.keyValue("Name", ui.code(normalizedName)));
-		log.print(ui.keyValue("Title", finalTitle));
-		log.print(ui.keyValue("Description", finalDescription));
-		log.print(ui.keyValue("Platform", platform));
-		log.print(ui.keyValue("Type", type));
-		log.print(ui.keyValue("Installs to", ui.path(bundlePath)));
-		if (finalTags.length > 0) log.print(ui.keyValue("Tags", finalTags.join(", ")));
+		log.print(ui.rulePreview({
+			header: "Quick publish",
+			path: source.path,
+			pathLabel: isDirectory ? "Directory" : "File",
+			name: collected.name,
+			title: collected.title,
+			description: collected.description,
+			platforms: collected.platforms,
+			type: finalRuleType,
+			tags: collected.tags,
+			showHints: true
+		}));
 		log.print("");
 		const confirm = await p$1.confirm({
-			message: "Publish this file?",
+			message: isDirectory ? "Publish this directory?" : "Publish this file?",
 			initialValue: true
 		});
 		if (p$1.isCancel(confirm) || !confirm) throw new Error("Cancelled");
 	}
 	return {
-		filePath,
-		name: normalizedName,
-		platform,
-		type,
-		title: finalTitle,
-		description: finalDescription,
-		tags: finalTags,
-		license: finalLicense,
-		bundlePath
+		source,
+		name: collected.name,
+		platforms: collected.platforms,
+		platformPaths: isFile ? {} : collected.platformPaths,
+		ruleType: finalRuleType,
+		title: collected.title,
+		description: collected.description,
+		tags: collected.tags,
+		license: collected.license
 	};
 }
-async function buildRuleInputFromSingleFile(inputs) {
-	const content = await readFile(inputs.filePath);
+async function buildRuleInputFromQuickPublish(inputs) {
+	const platformEntries = inputs.platforms.map((platform) => {
+		const path$1 = inputs.platformPaths[platform];
+		return path$1 ? {
+			platform,
+			path: path$1
+		} : { platform };
+	});
 	const config$1 = {
 		$schema: RULE_SCHEMA_URL,
 		name: inputs.name,
-		type: inputs.type,
+		type: inputs.ruleType,
 		title: inputs.title,
 		description: inputs.description,
 		license: inputs.license,
 		tags: inputs.tags,
-		platforms: [{ platform: inputs.platform }]
+		platforms: platformEntries
+	};
+	if (inputs.source.type === "file") {
+		const content = await readFile(inputs.source.path);
+		const platformFiles$1 = [];
+		for (const platform of inputs.platforms) {
+			const bundlePath = getInstallPath({
+				platform,
+				type: inputs.ruleType,
+				name: inputs.name,
+				scope: "project"
+			});
+			if (!bundlePath) throw new Error(`Type "${inputs.ruleType}" is not supported for project installs on platform "${platform}".`);
+			platformFiles$1.push({
+				platform,
+				files: [{
+					path: bundlePath,
+					content
+				}]
+			});
+		}
+		return {
+			name: inputs.name,
+			config: config$1,
+			platformFiles: platformFiles$1
+		};
+	}
+	const loadedConfig = {
+		configPath: `${inputs.source.path}/agentrules.json`,
+		config: {
+			...config$1,
+			platforms: platformEntries
+		},
+		configDir: inputs.source.path
 	};
+	const platformFiles = await collectPlatformFiles(loadedConfig);
 	return {
 		name: inputs.name,
 		config: config$1,
-		platformFiles: [{
-			platform: inputs.platform,
-			files: [{
-				path: inputs.bundlePath,
-				content
-			}]
-		}]
+		platformFiles
 	};
 }
 async function finalizePublish(options) {
-	const { publishInput, dryRun, version: version$2, spinner: spinner$1, ctx } = options;
+	const { publishInput, dryRun, version: version$2, spinner: spinner$1, ctx, quickPublish, yes } = options;
 	const totalFileCount = publishInput.variants.reduce((sum, v) => sum + v.files.length, 0);
 	const platformList = publishInput.variants.map((v) => v.platform).join(", ");
 	let totalSize = 0;
@@ -6498,6 +6979,7 @@ async function finalizePublish(options) {
 			log.print("");
 		}
 		log.print(ui.hint("Run without --dry-run to publish."));
+		await promptToCreateConfig(quickPublish, yes);
 		return {
 			success: true,
 			preview: {
@@ -6545,6 +7027,7 @@ async function finalizePublish(options) {
 	}
 	log.info("");
 	log.info(ui.keyValue("Now live at", ui.link(data.url)));
+	await promptToCreateConfig(quickPublish, yes);
 	return {
 		success: true,
 		rule: {
@@ -6635,165 +7118,15 @@ async function discoverRuleDirs(inputDir) {
 	return ruleDirs.sort();
 }
 
-//#endregion
-//#region src/commands/rule/init.ts
-/** Default rule name when none specified */
-const DEFAULT_RULE_NAME$1 = "my-rule";
-/**
-* Initialize a rule in a directory (rule root).
-*
-* Structure:
-* - ruleDir/agentrules.json - rule config
-* - ruleDir/* - rule files (collected by default)
-* - ruleDir/README.md, ruleDir/LICENSE.md, ruleDir/INSTALL.txt - optional metadata (not bundled)
-*/
-async function initRule(options) {
-	const ruleDir = options.directory ?? process.cwd();
-	log.debug(`Initializing rule in: ${ruleDir}`);
-	const inferredPlatform = getPlatformFromDir(basename(ruleDir));
-	const platformInputs = options.platforms ?? (inferredPlatform ? [inferredPlatform] : []);
-	if (platformInputs.length === 0) throw new Error(`Cannot determine platform. Specify --platform (${PLATFORM_IDS.join(", ")}).`);
-	const platforms = platformInputs.map(normalizePlatformEntryInput);
-	const name = normalizeName(options.name ?? DEFAULT_RULE_NAME$1);
-	const title = options.title ?? toTitleCase(name);
-	const description = options.description ?? "";
-	const license = options.license ?? "MIT";
-	const platformLabels = platforms.map((p$2) => typeof p$2 === "string" ? p$2 : p$2.platform).join(", ");
-	log.debug(`Rule name: ${name}, platforms: ${platformLabels}`);
-	const configPath = join(ruleDir, RULE_CONFIG_FILENAME);
-	if (!options.force && await fileExists(configPath)) throw new Error(`${RULE_CONFIG_FILENAME} already exists. Use --force to overwrite.`);
-	const config$1 = {
-		$schema: RULE_SCHEMA_URL,
-		name,
-		...options.type && { type: options.type },
-		title,
-		version: 1,
-		description,
-		tags: options.tags ?? [],
-		license,
-		platforms
-	};
-	let createdDir;
-	if (await directoryExists(ruleDir)) log.debug(`Directory exists: ${ruleDir}`);
-	else {
-		await mkdir(ruleDir, { recursive: true });
-		createdDir = ruleDir;
-		log.debug(`Created directory: ${ruleDir}`);
-	}
-	const content = `${JSON.stringify(config$1, null, 2)}\n`;
-	await writeFile(configPath, content, "utf8");
-	log.debug(`Wrote config file: ${configPath}`);
-	log.debug("Rule initialization complete.");
-	return {
-		configPath,
-		rule: config$1,
-		createdDir
-	};
-}
-function normalizePlatform(input) {
-	const normalized = input.toLowerCase();
-	if (!isSupportedPlatform(normalized)) throw new Error(`Unknown platform "${input}". Supported: ${PLATFORM_IDS.join(", ")}`);
-	return normalized;
-}
-function normalizePlatformEntryInput(input) {
-	if (typeof input === "string") return normalizePlatform(input);
-	const platform = normalizePlatform(input.platform);
-	const path$1 = typeof input.path === "string" ? input.path.trim() : "";
-	if (path$1.length === 0 || path$1 === ".") return platform;
-	return {
-		platform,
-		path: path$1
-	};
-}
-
 //#endregion
 //#region src/commands/rule/init-interactive.ts
-const DEFAULT_RULE_NAME = "my-rule";
-/**
-* Parse comma-separated tags string into array.
-*/
-function parseTags(input) {
-	if (typeof input !== "string") return [];
-	if (input.trim().length === 0) return [];
-	return input.split(",").map((tag) => tag.trim().toLowerCase()).filter((tag) => tag.length > 0);
-}
-/**
-* Validator for comma-separated tags input.
-*/
-function checkTags(value) {
-	const tags = parseTags(value);
-	const result = tagsSchema.safeParse(tags);
-	if (!result.success) return result.error.issues[0]?.message;
-}
 /**
 * Run interactive init flow with clack prompts.
 */
 async function initInteractive(options) {
-	const { directory, name: nameOption, title: titleOption, description: descriptionOption, platforms: platformsOption, platformPaths, license: licenseOption } = options;
+	const { directory, platformPaths } = options;
 	let { force } = options;
-	const defaultName = nameOption ?? DEFAULT_RULE_NAME;
 	p.intro("Create a new rule");
-	const validatedPlatforms = [];
-	if (platformsOption) for (const platform of platformsOption) {
-		if (!isSupportedPlatform(platform)) {
-			p.cancel(`Unknown platform "${platform}"`);
-			process.exit(1);
-		}
-		validatedPlatforms.push(platform);
-	}
-	const selectedPlatforms = validatedPlatforms.length > 0 ? validatedPlatforms : await (async () => {
-		const platformChoices = await p.multiselect({
-			message: "Platforms (select one or more)",
-			options: PLATFORM_IDS.map((id) => ({
-				value: id,
-				label: id
-			})),
-			required: true
-		});
-		if (p.isCancel(platformChoices)) {
-			p.cancel("Cancelled");
-			process.exit(0);
-		}
-		return platformChoices;
-	})();
-	const platformEntries = await (async () => {
-		if (selectedPlatforms.length === 0) return [];
-		const hasCompletePathMapping = selectedPlatforms.every((platform) => {
-			const value = platformPaths?.[platform];
-			return typeof value === "string" && value.trim().length > 0;
-		});
-		if (hasCompletePathMapping) return selectedPlatforms.map((platform) => {
-			const path$1 = platformPaths?.[platform]?.trim();
-			if (!path$1 || path$1 === ".") return platform;
-			return {
-				platform,
-				path: path$1
-			};
-		});
-		if (selectedPlatforms.length === 1) return selectedPlatforms;
-		const entries = [];
-		for (const platform of selectedPlatforms) {
-			const mappedPath = platformPaths?.[platform]?.trim();
-			const suggestedPath = mappedPath ?? (await directoryExists(join(directory, platform)) ? platform : ".");
-			const input = await p.text({
-				message: `Folder for ${platform} files ('.' = same folder as agentrules.json)`,
-				placeholder: suggestedPath,
-				defaultValue: suggestedPath
-			});
-			if (p.isCancel(input)) {
-				p.cancel("Cancelled");
-				process.exit(0);
-			}
-			const trimmed = input.trim();
-			const resolvedPath = trimmed.length > 0 ? trimmed : suggestedPath;
-			if (resolvedPath === ".") entries.push(platform);
-			else entries.push({
-				platform,
-				path: resolvedPath
-			});
-		}
-		return entries;
-	})();
 	const configPath = join(directory, RULE_CONFIG_FILENAME);
 	if (!force && await fileExists(configPath)) {
 		const overwrite = await p.confirm({
@@ -6806,75 +7139,58 @@ async function initInteractive(options) {
 		}
 		force = true;
 	}
-	const result = await p.group({
-		name: () => p.text({
-			message: "Rule name",
-			placeholder: normalizeName(defaultName),
-			defaultValue: normalizeName(defaultName),
-			validate: check(nameSchema)
-		}),
-		title: ({ results }) => {
-			const defaultTitle = titleOption ?? toTitleCase(results.name ?? defaultName);
-			return p.text({
-				message: "Title",
-				defaultValue: defaultTitle,
-				placeholder: defaultTitle
-			});
-		},
-		description: () => p.text({
-			message: "Description",
-			placeholder: "Describe what this rule does...",
-			defaultValue: descriptionOption,
-			validate: check(descriptionSchema)
-		}),
-		tags: () => p.text({
-			message: "Tags (comma-separated, optional)",
-			placeholder: "e.g., typescript, testing, react",
-			validate: checkTags
-		}),
-		license: async () => {
-			const defaultLicense = licenseOption ?? "MIT";
-			const choice = await p.select({
-				message: "License",
-				options: [...COMMON_LICENSES.map((id) => ({
-					value: id,
-					label: id
-				})), {
-					value: "__other__",
-					label: "Other (enter SPDX identifier)"
-				}],
-				initialValue: defaultLicense
-			});
-			if (p.isCancel(choice)) {
-				p.cancel("Cancelled");
-				process.exit(0);
-			}
-			if (choice === "__other__") {
-				const custom = await p.text({
-					message: "License (SPDX identifier)",
-					placeholder: "e.g., MPL-2.0, AGPL-3.0-only",
-					validate: check(licenseSchema)
-				});
-				if (p.isCancel(custom)) {
-					p.cancel("Cancelled");
-					process.exit(0);
-				}
-				return custom;
-			}
-			return choice;
+	let collected;
+	try {
+		collected = await collectRuleInputs({
+			directory,
+			defaults: {
+				name: options.name,
+				title: options.title,
+				description: options.description,
+				platforms: options.platforms,
+				platformPaths,
+				license: options.license
+			},
+			nonInteractive: false
+		});
+	} catch (error$2) {
+		if (error$2 instanceof Error && error$2.message === "Cancelled") {
+			p.cancel("Cancelled");
+			process.exit(0);
 		}
-	}, { onCancel: () => {
-		p.cancel("Cancelled");
-		return process.exit(0);
-	} });
+		throw error$2;
+	}
+	const platformEntries = collected.platforms.map((platform) => {
+		const path$1 = collected.platformPaths[platform];
+		return path$1 ? {
+			platform,
+			path: path$1
+		} : platform;
+	});
+	log.print("");
+	log.print(ui.rulePreview({
+		header: "Rule configuration",
+		path: directory,
+		pathLabel: "Directory",
+		name: collected.name,
+		title: collected.title || toTitleCase(collected.name),
+		description: collected.description,
+		platforms: collected.platforms,
+		type: collected.isSkill ? "skill" : void 0,
+		tags: collected.tags,
+		license: collected.license,
+		showHints: true
+	}));
+	log.print("");
 	const initOptions = {
 		directory,
-		name: result.name,
-		title: result.title.trim() || void 0,
-		description: result.description,
-		tags: parseTags(result.tags),
+		name: collected.name,
+		type: collected.isSkill ? "skill" : void 0,
+		title: collected.title || void 0,
+		description: collected.description,
+		tags: collected.tags,
 		platforms: platformEntries,
-		license: result.license,
+		license: collected.license,
 		force
 	};
 	const initResult = await initRule(initOptions);
@@ -7347,7 +7663,7 @@ program.command("add <item>").description("Download and install a rule from the
 program.command("init").description("Initialize a new rule").argument("[directory]", "Directory to initialize (created if it doesn't exist)").option("-y, --yes", "Accept defaults without prompting").option("-n, --name <name>", "Rule name").option("-t, --title <title>", "Display title").option("--description <text>", "Rule description").option("-p, --platform <platform>", "Target platform(s). Repeatable, accepts comma-separated. Supports <platform>=<path> mappings.", (value, previous) => previous ? [...previous, value] : [value]).option("-l, --license <license>", "License (e.g., MIT)").option("-f, --force", "Overwrite existing agentrules.json").action(handle(async (directory, options) => {
 	const targetDir = directory ?? process.cwd();
 	const defaultName = directory ? basename(directory) : void 0;
-	const platformInputs = options.platform?.flatMap((p$2) => p$2.split(",").map((s) => s.trim())).filter((p$2) => p$2.length > 0);
+	const platformInputs = options.platform?.flatMap((p$3) => p$3.split(",").map((s) => s.trim())).filter((p$3) => p$3.length > 0);
 	const platformIds = [];
 	const platformPaths = {};
 	if (platformInputs) for (const input of platformInputs) {
@@ -7388,7 +7704,7 @@ program.command("init").description("Initialize a new rule").argument("[director
 		}
 		const nextSteps$1 = [
 			"Add your rule files in this directory",
-			"Add tags (recommended) and features (recommended) to agentrules.json",
+			"Add tags and features to agentrules.json",
 			`Run ${ui.command("agentrules publish")} to publish your rule`
 		];
 		log.print(`\n${ui.header("Next steps")}`);
@@ -7412,7 +7728,7 @@ program.command("init").description("Initialize a new rule").argument("[director
 	}
 	const nextSteps = [
 		"Add your rule files in this directory",
-		"Add tags (recommended) and features (recommended) to agentrules.json",
+		"Add tags and features to agentrules.json",
 		`Run ${ui.command("agentrules publish")} to publish your rule`
 	];
 	log.print(`\n${ui.header("Next steps")}`);
@@ -7421,13 +7737,13 @@ program.command("init").description("Initialize a new rule").argument("[director
 program.command("validate").description("Validate an agentrules.json configuration").argument("[path]", "Path to agentrules.json or directory").action(handle(async (path$1) => {
 	const result = await validateRule({ path: path$1 });
 	if (result.valid && result.rule) {
-		const p$2 = result.rule;
-		const platforms = p$2.platforms.map((entry) => entry.platform).join(", ");
-		log.success(p$2.title);
-		if (p$2.description) log.print(ui.keyValue("Description", p$2.description));
-		log.print(ui.keyValue("License", p$2.license));
+		const p$3 = result.rule;
+		const platforms = p$3.platforms.map((entry) => entry.platform).join(", ");
+		log.success(p$3.title);
+		if (p$3.description) log.print(ui.keyValue("Description", p$3.description));
+		log.print(ui.keyValue("License", p$3.license));
 		log.print(ui.keyValue("Platforms", platforms));
-		if (p$2.tags?.length) log.print(ui.keyValue("Tags", p$2.tags.join(", ")));
+		if (p$3.tags?.length) log.print(ui.keyValue("Tags", p$3.tags.join(", ")));
 	} else if (!result.valid) log.error(`Invalid: ${ui.path(result.configPath)}`);
 	if (result.errors.length > 0) {
 		log.print("");