ccski 1.0.2 → 1.1.0

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { A as intersectionType, D as custom, E as booleanType, F as recordType, G as __require, H as SkillNotFoundError, I as stringType, K as __toESM, L as unionType, M as numberType, N as objectType, O as discriminatedUnionType, P as optionalType, R as unknownType, T as arrayType, W as __commonJS, _ as tone, b as parseSkillFile, c as colors$3, d as formatBytes, f as heading, g as success, h as setColorEnabled, j as literalType, k as enumType, l as dim, m as renderList, n as containsCaseInsensitive, p as highlight, r as rankStrings, t as SkillRegistry, u as error, v as warn, x as validateSkillFile, y as wrap } from "./registry-ChUc2356.mjs";
+import { A as intersectionType, D as custom, E as booleanType, F as recordType, G as __require, H as SkillNotFoundError, I as stringType, K as __toESM, L as unionType, M as numberType, N as objectType, O as discriminatedUnionType, P as optionalType, R as unknownType, T as arrayType, W as __commonJS, _ as tone, b as parseSkillFile, c as colors$3, d as formatBytes, f as heading, g as success, h as setColorEnabled, j as literalType, k as enumType, l as dim, m as renderList, n as containsCaseInsensitive, p as highlight, r as rankStrings, t as SkillRegistry, u as error, v as warn, x as validateSkillFile, y as wrap } from "./registry-DtGaEhsM.mjs";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, statSync } from "node:fs";
 import { stripVTControlCharacters } from "node:util";
 import { readFileSync as readFileSync$1, readdirSync as readdirSync$1, statSync as statSync$1, writeFile } from "fs";
@@ -4219,7 +4219,7 @@ async function infoCommand(argv) {
 async function listCommand(argv) {
 	if (argv.noColor || process.env.FORCE_COLOR === "0") setColorEnabled(false);
 	if (argv.color) setColorEnabled(true);
-	let skills = new SkillRegistry(buildRegistryOptions(argv, { includeDisabled: argv.all || argv.disabled })).getAll();
+	let skills = new SkillRegistry(buildRegistryOptions(argv, { includeDisabled: Boolean(argv.all || argv.disabled) })).getAll();
 	if (argv.disabled) skills = skills.filter((s) => s.disabled);
 	else if (!argv.all) skills = skills.filter((s) => !s.disabled);
 	skills = skills.sort((a, b) => a.name.localeCompare(b.name));
@@ -4249,13 +4249,20 @@ async function listCommand(argv) {
 		const list = groups[location];
 		if (!list.length) continue;
 		sections.push(`${colors$3.underline(colors$3.bold(labels[location]))} (${list.length})`);
-		sections.push(renderList(list.map((skill) => ({
-			title: skill.name,
-			color: skill.disabled ? colors$3.red : void 0,
-			badge: skill.disabled ? colors$3.red("[disabled]") : void 0,
-			meta: location === "plugin" ? skill.pluginInfo?.pluginName ?? dim(location) : dim(location),
-			description: skill.description
-		}))));
+		const listItems = list.map((skill) => {
+			const base = {
+				title: skill.name,
+				meta: location === "plugin" ? skill.pluginInfo?.pluginName ?? dim(location) : dim(location),
+				...skill.description ? { description: skill.description } : {}
+			};
+			if (skill.disabled) return {
+				...base,
+				color: colors$3.red,
+				badge: colors$3.red("[disabled]")
+			};
+			return base;
+		});
+		sections.push(renderList(listItems));
 	}
 	if (sections.length === 0) {
 		console.log(argv.disabled ? "No disabled skills found." : "No skills found.");
@@ -22930,309 +22937,113 @@ function resolveSkillFile(input) {
 }
 
 //#endregion
-//#region node_modules/.pnpm/@inquirer+figures@1.0.0/node_modules/@inquirer/figures/dist/esm/index.mjs
-function isUnicodeSupported$1() {
-	if (process$1.platform !== "win32") return process$1.env["TERM"] !== "linux";
-	return Boolean(process$1.env["WT_SESSION"]) || Boolean(process$1.env["TERMINUS_SUBLIME"]) || process$1.env["ConEmuTask"] === "{cmd::Cmder}" || process$1.env["TERM_PROGRAM"] === "Terminus-Sublime" || process$1.env["TERM_PROGRAM"] === "vscode" || process$1.env["TERM"] === "xterm-256color" || process$1.env["TERM"] === "alacritty" || process$1.env["TERMINAL_EMULATOR"] === "JetBrains-JediTerm";
+//#region src/utils/git-url-parser.ts
+/**
+* 内部辅助函数：标准化仓库 URL
+* 1. 去除尾部斜杠
+* 2. 确保以 .git 结尾
+*/
+function normalizeRepoUrl(origin, path) {
+	let cleanPath = path.replace(/\/+$/, "");
+	if (cleanPath.endsWith(".git")) cleanPath = cleanPath.slice(0, -4);
+	return `${origin}${cleanPath}.git`;
 }
-const common$1 = {
-	circleQuestionMark: "(?)",
-	questionMarkPrefix: "(?)",
-	square: "█",
-	squareDarkShade: "▓",
-	squareMediumShade: "▒",
-	squareLightShade: "░",
-	squareTop: "▀",
-	squareBottom: "▄",
-	squareLeft: "▌",
-	squareRight: "▐",
-	squareCenter: "■",
-	bullet: "●",
-	dot: "․",
-	ellipsis: "…",
-	pointerSmall: "›",
-	triangleUp: "▲",
-	triangleUpSmall: "▴",
-	triangleDown: "▼",
-	triangleDownSmall: "▾",
-	triangleLeftSmall: "◂",
-	triangleRightSmall: "▸",
-	home: "⌂",
-	heart: "♥",
-	musicNote: "♪",
-	musicNoteBeamed: "♫",
-	arrowUp: "↑",
-	arrowDown: "↓",
-	arrowLeft: "←",
-	arrowRight: "→",
-	arrowLeftRight: "↔",
-	arrowUpDown: "↕",
-	almostEqual: "≈",
-	notEqual: "≠",
-	lessOrEqual: "≤",
-	greaterOrEqual: "≥",
-	identical: "≡",
-	infinity: "∞",
-	subscriptZero: "₀",
-	subscriptOne: "₁",
-	subscriptTwo: "₂",
-	subscriptThree: "₃",
-	subscriptFour: "₄",
-	subscriptFive: "₅",
-	subscriptSix: "₆",
-	subscriptSeven: "₇",
-	subscriptEight: "₈",
-	subscriptNine: "₉",
-	oneHalf: "½",
-	oneThird: "⅓",
-	oneQuarter: "¼",
-	oneFifth: "⅕",
-	oneSixth: "⅙",
-	oneEighth: "⅛",
-	twoThirds: "⅔",
-	twoFifths: "⅖",
-	threeQuarters: "¾",
-	threeFifths: "⅗",
-	threeEighths: "⅜",
-	fourFifths: "⅘",
-	fiveSixths: "⅚",
-	fiveEighths: "⅝",
-	sevenEighths: "⅞",
-	line: "─",
-	lineBold: "━",
-	lineDouble: "═",
-	lineDashed0: "┄",
-	lineDashed1: "┅",
-	lineDashed2: "┈",
-	lineDashed3: "┉",
-	lineDashed4: "╌",
-	lineDashed5: "╍",
-	lineDashed6: "╴",
-	lineDashed7: "╶",
-	lineDashed8: "╸",
-	lineDashed9: "╺",
-	lineDashed10: "╼",
-	lineDashed11: "╾",
-	lineDashed12: "−",
-	lineDashed13: "–",
-	lineDashed14: "‐",
-	lineDashed15: "⁃",
-	lineVertical: "│",
-	lineVerticalBold: "┃",
-	lineVerticalDouble: "║",
-	lineVerticalDashed0: "┆",
-	lineVerticalDashed1: "┇",
-	lineVerticalDashed2: "┊",
-	lineVerticalDashed3: "┋",
-	lineVerticalDashed4: "╎",
-	lineVerticalDashed5: "╏",
-	lineVerticalDashed6: "╵",
-	lineVerticalDashed7: "╷",
-	lineVerticalDashed8: "╹",
-	lineVerticalDashed9: "╻",
-	lineVerticalDashed10: "╽",
-	lineVerticalDashed11: "╿",
-	lineDownLeft: "┐",
-	lineDownLeftArc: "╮",
-	lineDownBoldLeftBold: "┓",
-	lineDownBoldLeft: "┒",
-	lineDownLeftBold: "┑",
-	lineDownDoubleLeftDouble: "╗",
-	lineDownDoubleLeft: "╖",
-	lineDownLeftDouble: "╕",
-	lineDownRight: "┌",
-	lineDownRightArc: "╭",
-	lineDownBoldRightBold: "┏",
-	lineDownBoldRight: "┎",
-	lineDownRightBold: "┍",
-	lineDownDoubleRightDouble: "╔",
-	lineDownDoubleRight: "╓",
-	lineDownRightDouble: "╒",
-	lineUpLeft: "┘",
-	lineUpLeftArc: "╯",
-	lineUpBoldLeftBold: "┛",
-	lineUpBoldLeft: "┚",
-	lineUpLeftBold: "┙",
-	lineUpDoubleLeftDouble: "╝",
-	lineUpDoubleLeft: "╜",
-	lineUpLeftDouble: "╛",
-	lineUpRight: "└",
-	lineUpRightArc: "╰",
-	lineUpBoldRightBold: "┗",
-	lineUpBoldRight: "┖",
-	lineUpRightBold: "┕",
-	lineUpDoubleRightDouble: "╚",
-	lineUpDoubleRight: "╙",
-	lineUpRightDouble: "╘",
-	lineUpDownLeft: "┤",
-	lineUpBoldDownBoldLeftBold: "┫",
-	lineUpBoldDownBoldLeft: "┨",
-	lineUpDownLeftBold: "┥",
-	lineUpBoldDownLeftBold: "┩",
-	lineUpDownBoldLeftBold: "┪",
-	lineUpDownBoldLeft: "┧",
-	lineUpBoldDownLeft: "┦",
-	lineUpDoubleDownDoubleLeftDouble: "╣",
-	lineUpDoubleDownDoubleLeft: "╢",
-	lineUpDownLeftDouble: "╡",
-	lineUpDownRight: "├",
-	lineUpBoldDownBoldRightBold: "┣",
-	lineUpBoldDownBoldRight: "┠",
-	lineUpDownRightBold: "┝",
-	lineUpBoldDownRightBold: "┡",
-	lineUpDownBoldRightBold: "┢",
-	lineUpDownBoldRight: "┟",
-	lineUpBoldDownRight: "┞",
-	lineUpDoubleDownDoubleRightDouble: "╠",
-	lineUpDoubleDownDoubleRight: "╟",
-	lineUpDownRightDouble: "╞",
-	lineDownLeftRight: "┬",
-	lineDownBoldLeftBoldRightBold: "┳",
-	lineDownLeftBoldRightBold: "┯",
-	lineDownBoldLeftRight: "┰",
-	lineDownBoldLeftBoldRight: "┱",
-	lineDownBoldLeftRightBold: "┲",
-	lineDownLeftRightBold: "┮",
-	lineDownLeftBoldRight: "┭",
-	lineDownDoubleLeftDoubleRightDouble: "╦",
-	lineDownDoubleLeftRight: "╥",
-	lineDownLeftDoubleRightDouble: "╤",
-	lineUpLeftRight: "┴",
-	lineUpBoldLeftBoldRightBold: "┻",
-	lineUpLeftBoldRightBold: "┷",
-	lineUpBoldLeftRight: "┸",
-	lineUpBoldLeftBoldRight: "┹",
-	lineUpBoldLeftRightBold: "┺",
-	lineUpLeftRightBold: "┶",
-	lineUpLeftBoldRight: "┵",
-	lineUpDoubleLeftDoubleRightDouble: "╩",
-	lineUpDoubleLeftRight: "╨",
-	lineUpLeftDoubleRightDouble: "╧",
-	lineUpDownLeftRight: "┼",
-	lineUpBoldDownBoldLeftBoldRightBold: "╋",
-	lineUpDownBoldLeftBoldRightBold: "╈",
-	lineUpBoldDownLeftBoldRightBold: "╇",
-	lineUpBoldDownBoldLeftRightBold: "╊",
-	lineUpBoldDownBoldLeftBoldRight: "╉",
-	lineUpBoldDownLeftRight: "╀",
-	lineUpDownBoldLeftRight: "╁",
-	lineUpDownLeftBoldRight: "┽",
-	lineUpDownLeftRightBold: "┾",
-	lineUpBoldDownBoldLeftRight: "╂",
-	lineUpDownLeftBoldRightBold: "┿",
-	lineUpBoldDownLeftBoldRight: "╃",
-	lineUpBoldDownLeftRightBold: "╄",
-	lineUpDownBoldLeftBoldRight: "╅",
-	lineUpDownBoldLeftRightBold: "╆",
-	lineUpDoubleDownDoubleLeftDoubleRightDouble: "╬",
-	lineUpDoubleDownDoubleLeftRight: "╫",
-	lineUpDownLeftDoubleRightDouble: "╪",
-	lineCross: "╳",
-	lineBackslash: "╲",
-	lineSlash: "╱"
-};
-const specialMainSymbols$1 = {
-	tick: "✔",
-	info: "ℹ",
-	warning: "⚠",
-	cross: "✘",
-	squareSmall: "◻",
-	squareSmallFilled: "◼",
-	circle: "◯",
-	circleFilled: "◉",
-	circleDotted: "◌",
-	circleDouble: "◎",
-	circleCircle: "ⓞ",
-	circleCross: "ⓧ",
-	circlePipe: "Ⓘ",
-	radioOn: "◉",
-	radioOff: "◯",
-	checkboxOn: "☒",
-	checkboxOff: "☐",
-	checkboxCircleOn: "ⓧ",
-	checkboxCircleOff: "Ⓘ",
-	pointer: "❯",
-	triangleUpOutline: "△",
-	triangleLeft: "◀",
-	triangleRight: "▶",
-	lozenge: "◆",
-	lozengeOutline: "◇",
-	hamburger: "☰",
-	smiley: "㋡",
-	mustache: "෴",
-	star: "★",
-	play: "▶",
-	nodejs: "⬢",
-	oneSeventh: "⅐",
-	oneNinth: "⅑",
-	oneTenth: "⅒"
-};
-const specialFallbackSymbols$1 = {
-	tick: "√",
-	info: "i",
-	warning: "‼",
-	cross: "×",
-	squareSmall: "□",
-	squareSmallFilled: "■",
-	circle: "( )",
-	circleFilled: "(*)",
-	circleDotted: "( )",
-	circleDouble: "( )",
-	circleCircle: "(○)",
-	circleCross: "(×)",
-	circlePipe: "(│)",
-	radioOn: "(*)",
-	radioOff: "( )",
-	checkboxOn: "[×]",
-	checkboxOff: "[ ]",
-	checkboxCircleOn: "(×)",
-	checkboxCircleOff: "( )",
-	pointer: ">",
-	triangleUpOutline: "∆",
-	triangleLeft: "◄",
-	triangleRight: "►",
-	lozenge: "♦",
-	lozengeOutline: "◊",
-	hamburger: "≡",
-	smiley: "☺",
-	mustache: "┌─┐",
-	star: "✶",
-	play: "►",
-	nodejs: "♦",
-	oneSeventh: "1/7",
-	oneNinth: "1/9",
-	oneTenth: "1/10"
-};
-const mainSymbols$1 = {
-	...common$1,
-	...specialMainSymbols$1
-};
-const fallbackSymbols$1 = {
-	...common$1,
-	...specialFallbackSymbols$1
-};
-const shouldUseMain$1 = isUnicodeSupported$1();
-const figures$1 = shouldUseMain$1 ? mainSymbols$1 : fallbackSymbols$1;
-var esm_default = figures$1;
-const replacements$1 = Object.entries(specialMainSymbols$1);
-
-//#endregion
-//#region node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.1/node_modules/@inquirer/core/dist/esm/lib/key.js
-const isUpKey = (key$1, keybindings = []) => key$1.name === "up" || keybindings.includes("vim") && key$1.name === "k" || keybindings.includes("emacs") && key$1.ctrl && key$1.name === "p";
-const isDownKey = (key$1, keybindings = []) => key$1.name === "down" || keybindings.includes("vim") && key$1.name === "j" || keybindings.includes("emacs") && key$1.ctrl && key$1.name === "n";
-const isSpaceKey = (key$1) => key$1.name === "space";
-const isNumberKey = (key$1) => "1234567890".includes(key$1.name);
-const isEnterKey = (key$1) => key$1.name === "enter" || key$1.name === "return";
-
-//#endregion
-//#region node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.1/node_modules/@inquirer/core/dist/esm/lib/errors.js
-var AbortPromptError = class extends Error {
-	name = "AbortPromptError";
-	message = "Prompt was aborted";
-	constructor(options) {
-		super();
-		this.cause = options?.cause;
-	}
+/**
+* Git URL 嗅探与解析器
+*
+* @param inputUrl 用户输入的任意 URL 字符串
+* @returns 解析结果对象，如果 URL 无效则返回 null
+*/
+function parseGitUrl(inputUrl) {
+	if (!inputUrl || typeof inputUrl !== "string" || !inputUrl.trim()) return null;
+	try {
+		const url = new URL(inputUrl.trim());
+		if (!["http:", "https:"].includes(url.protocol)) return null;
+		const normalizedPath = url.pathname.replace(/\/+/g, "/");
+		if (normalizedPath === "/" || normalizedPath === "") return null;
+		const strategies = [
+			{
+				pattern: "/-/blob/",
+				type: "blob"
+			},
+			{
+				pattern: "/-/tree/",
+				type: "tree"
+			},
+			{
+				pattern: "/src/",
+				type: "blob"
+			},
+			{
+				pattern: "/blob/",
+				type: "blob"
+			},
+			{
+				pattern: "/tree/",
+				type: "tree"
+			}
+		];
+		let bestStrategy = null;
+		let minIndex = Infinity;
+		for (const strategy of strategies) {
+			const index = normalizedPath.indexOf(strategy.pattern);
+			if (index !== -1 && index < minIndex) {
+				minIndex = index;
+				bestStrategy = strategy;
+			}
+		}
+		let repoPathPart = "";
+		let remainingPart = "";
+		let type = "tree";
+		if (bestStrategy && minIndex !== Infinity) {
+			type = bestStrategy.type;
+			repoPathPart = normalizedPath.substring(0, minIndex);
+			remainingPart = normalizedPath.substring(minIndex + bestStrategy.pattern.length);
+		} else {
+			repoPathPart = normalizedPath;
+			type = "tree";
+		}
+		if (!repoPathPart || repoPathPart === "/") return null;
+		const result = {
+			repo: normalizeRepoUrl(url.origin, repoPathPart),
+			type
+		};
+		if (remainingPart) {
+			const segments = remainingPart.split("/").map((s) => {
+				try {
+					return decodeURIComponent(s);
+				} catch {
+					return s;
+				}
+			}).filter(Boolean);
+			if (segments.length > 0) {
+				result.branch = segments[0];
+				if (segments.length > 1) result.path = segments.slice(1).join("/");
+			} else result.type = "tree";
+		} else if (bestStrategy) result.type = "tree";
+		return result;
+	} catch (error$2) {
+		return null;
+	}
+}
+
+//#endregion
+//#region node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.1/node_modules/@inquirer/core/dist/esm/lib/key.js
+const isUpKey = (key$1, keybindings = []) => key$1.name === "up" || keybindings.includes("vim") && key$1.name === "k" || keybindings.includes("emacs") && key$1.ctrl && key$1.name === "p";
+const isDownKey = (key$1, keybindings = []) => key$1.name === "down" || keybindings.includes("vim") && key$1.name === "j" || keybindings.includes("emacs") && key$1.ctrl && key$1.name === "n";
+const isSpaceKey = (key$1) => key$1.name === "space";
+const isNumberKey = (key$1) => "1234567890".includes(key$1.name);
+const isEnterKey = (key$1) => key$1.name === "enter" || key$1.name === "return";
+
+//#endregion
+//#region node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.1/node_modules/@inquirer/core/dist/esm/lib/errors.js
+var AbortPromptError = class extends Error {
+	name = "AbortPromptError";
+	message = "Prompt was aborted";
+	constructor(options) {
+		super();
+		this.cause = options?.cause;
+	}
 };
 var CancelPromptError = class extends Error {
 	name = "CancelPromptError";
@@ -23443,11 +23254,11 @@ var require_yoctocolors_cjs = /* @__PURE__ */ __commonJS({ "node_modules/.pnpm/y
 
 //#endregion
 //#region node_modules/.pnpm/@inquirer+figures@1.0.15/node_modules/@inquirer/figures/dist/esm/index.js
-function isUnicodeSupported() {
+function isUnicodeSupported$1() {
 	if (process$1.platform !== "win32") return process$1.env["TERM"] !== "linux";
 	return Boolean(process$1.env["WT_SESSION"]) || Boolean(process$1.env["TERMINUS_SUBLIME"]) || process$1.env["ConEmuTask"] === "{cmd::Cmder}" || process$1.env["TERM_PROGRAM"] === "Terminus-Sublime" || process$1.env["TERM_PROGRAM"] === "vscode" || process$1.env["TERM"] === "xterm-256color" || process$1.env["TERM"] === "alacritty" || process$1.env["TERMINAL_EMULATOR"] === "JetBrains-JediTerm";
 }
-const common = {
+const common$1 = {
 	circleQuestionMark: "(?)",
 	questionMarkPrefix: "(?)",
 	square: "█",
@@ -23643,7 +23454,7 @@ const common = {
 	lineBackslash: "╲",
 	lineSlash: "╱"
 };
-const specialMainSymbols = {
+const specialMainSymbols$1 = {
 	tick: "✔",
 	info: "ℹ",
 	warning: "⚠",
@@ -23679,7 +23490,7 @@ const specialMainSymbols = {
 	oneNinth: "⅑",
 	oneTenth: "⅒"
 };
-const specialFallbackSymbols = {
+const specialFallbackSymbols$1 = {
 	tick: "√",
 	info: "i",
 	warning: "‼",
@@ -23715,18 +23526,18 @@ const specialFallbackSymbols = {
 	oneNinth: "1/9",
 	oneTenth: "1/10"
 };
-const mainSymbols = {
-	...common,
-	...specialMainSymbols
+const mainSymbols$1 = {
+	...common$1,
+	...specialMainSymbols$1
 };
-const fallbackSymbols = {
-	...common,
-	...specialFallbackSymbols
+const fallbackSymbols$1 = {
+	...common$1,
+	...specialFallbackSymbols$1
 };
-const shouldUseMain = isUnicodeSupported();
-const figures = shouldUseMain ? mainSymbols : fallbackSymbols;
-var esm_default$1 = figures;
-const replacements = Object.entries(specialMainSymbols);
+const shouldUseMain$1 = isUnicodeSupported$1();
+const figures$1 = shouldUseMain$1 ? mainSymbols$1 : fallbackSymbols$1;
+var esm_default$1 = figures$1;
+const replacements$1 = Object.entries(specialMainSymbols$1);
 
 //#endregion
 //#region node_modules/.pnpm/@inquirer+core@10.3.2_@types+node@22.19.1/node_modules/@inquirer/core/dist/esm/lib/theme.js
@@ -26433,6 +26244,293 @@ var Separator = class {
 	}
 };
 
+//#endregion
+//#region node_modules/.pnpm/@inquirer+figures@1.0.0/node_modules/@inquirer/figures/dist/esm/index.mjs
+function isUnicodeSupported() {
+	if (process$1.platform !== "win32") return process$1.env["TERM"] !== "linux";
+	return Boolean(process$1.env["WT_SESSION"]) || Boolean(process$1.env["TERMINUS_SUBLIME"]) || process$1.env["ConEmuTask"] === "{cmd::Cmder}" || process$1.env["TERM_PROGRAM"] === "Terminus-Sublime" || process$1.env["TERM_PROGRAM"] === "vscode" || process$1.env["TERM"] === "xterm-256color" || process$1.env["TERM"] === "alacritty" || process$1.env["TERMINAL_EMULATOR"] === "JetBrains-JediTerm";
+}
+const common = {
+	circleQuestionMark: "(?)",
+	questionMarkPrefix: "(?)",
+	square: "█",
+	squareDarkShade: "▓",
+	squareMediumShade: "▒",
+	squareLightShade: "░",
+	squareTop: "▀",
+	squareBottom: "▄",
+	squareLeft: "▌",
+	squareRight: "▐",
+	squareCenter: "■",
+	bullet: "●",
+	dot: "․",
+	ellipsis: "…",
+	pointerSmall: "›",
+	triangleUp: "▲",
+	triangleUpSmall: "▴",
+	triangleDown: "▼",
+	triangleDownSmall: "▾",
+	triangleLeftSmall: "◂",
+	triangleRightSmall: "▸",
+	home: "⌂",
+	heart: "♥",
+	musicNote: "♪",
+	musicNoteBeamed: "♫",
+	arrowUp: "↑",
+	arrowDown: "↓",
+	arrowLeft: "←",
+	arrowRight: "→",
+	arrowLeftRight: "↔",
+	arrowUpDown: "↕",
+	almostEqual: "≈",
+	notEqual: "≠",
+	lessOrEqual: "≤",
+	greaterOrEqual: "≥",
+	identical: "≡",
+	infinity: "∞",
+	subscriptZero: "₀",
+	subscriptOne: "₁",
+	subscriptTwo: "₂",
+	subscriptThree: "₃",
+	subscriptFour: "₄",
+	subscriptFive: "₅",
+	subscriptSix: "₆",
+	subscriptSeven: "₇",
+	subscriptEight: "₈",
+	subscriptNine: "₉",
+	oneHalf: "½",
+	oneThird: "⅓",
+	oneQuarter: "¼",
+	oneFifth: "⅕",
+	oneSixth: "⅙",
+	oneEighth: "⅛",
+	twoThirds: "⅔",
+	twoFifths: "⅖",
+	threeQuarters: "¾",
+	threeFifths: "⅗",
+	threeEighths: "⅜",
+	fourFifths: "⅘",
+	fiveSixths: "⅚",
+	fiveEighths: "⅝",
+	sevenEighths: "⅞",
+	line: "─",
+	lineBold: "━",
+	lineDouble: "═",
+	lineDashed0: "┄",
+	lineDashed1: "┅",
+	lineDashed2: "┈",
+	lineDashed3: "┉",
+	lineDashed4: "╌",
+	lineDashed5: "╍",
+	lineDashed6: "╴",
+	lineDashed7: "╶",
+	lineDashed8: "╸",
+	lineDashed9: "╺",
+	lineDashed10: "╼",
+	lineDashed11: "╾",
+	lineDashed12: "−",
+	lineDashed13: "–",
+	lineDashed14: "‐",
+	lineDashed15: "⁃",
+	lineVertical: "│",
+	lineVerticalBold: "┃",
+	lineVerticalDouble: "║",
+	lineVerticalDashed0: "┆",
+	lineVerticalDashed1: "┇",
+	lineVerticalDashed2: "┊",
+	lineVerticalDashed3: "┋",
+	lineVerticalDashed4: "╎",
+	lineVerticalDashed5: "╏",
+	lineVerticalDashed6: "╵",
+	lineVerticalDashed7: "╷",
+	lineVerticalDashed8: "╹",
+	lineVerticalDashed9: "╻",
+	lineVerticalDashed10: "╽",
+	lineVerticalDashed11: "╿",
+	lineDownLeft: "┐",
+	lineDownLeftArc: "╮",
+	lineDownBoldLeftBold: "┓",
+	lineDownBoldLeft: "┒",
+	lineDownLeftBold: "┑",
+	lineDownDoubleLeftDouble: "╗",
+	lineDownDoubleLeft: "╖",
+	lineDownLeftDouble: "╕",
+	lineDownRight: "┌",
+	lineDownRightArc: "╭",
+	lineDownBoldRightBold: "┏",
+	lineDownBoldRight: "┎",
+	lineDownRightBold: "┍",
+	lineDownDoubleRightDouble: "╔",
+	lineDownDoubleRight: "╓",
+	lineDownRightDouble: "╒",
+	lineUpLeft: "┘",
+	lineUpLeftArc: "╯",
+	lineUpBoldLeftBold: "┛",
+	lineUpBoldLeft: "┚",
+	lineUpLeftBold: "┙",
+	lineUpDoubleLeftDouble: "╝",
+	lineUpDoubleLeft: "╜",
+	lineUpLeftDouble: "╛",
+	lineUpRight: "└",
+	lineUpRightArc: "╰",
+	lineUpBoldRightBold: "┗",
+	lineUpBoldRight: "┖",
+	lineUpRightBold: "┕",
+	lineUpDoubleRightDouble: "╚",
+	lineUpDoubleRight: "╙",
+	lineUpRightDouble: "╘",
+	lineUpDownLeft: "┤",
+	lineUpBoldDownBoldLeftBold: "┫",
+	lineUpBoldDownBoldLeft: "┨",
+	lineUpDownLeftBold: "┥",
+	lineUpBoldDownLeftBold: "┩",
+	lineUpDownBoldLeftBold: "┪",
+	lineUpDownBoldLeft: "┧",
+	lineUpBoldDownLeft: "┦",
+	lineUpDoubleDownDoubleLeftDouble: "╣",
+	lineUpDoubleDownDoubleLeft: "╢",
+	lineUpDownLeftDouble: "╡",
+	lineUpDownRight: "├",
+	lineUpBoldDownBoldRightBold: "┣",
+	lineUpBoldDownBoldRight: "┠",
+	lineUpDownRightBold: "┝",
+	lineUpBoldDownRightBold: "┡",
+	lineUpDownBoldRightBold: "┢",
+	lineUpDownBoldRight: "┟",
+	lineUpBoldDownRight: "┞",
+	lineUpDoubleDownDoubleRightDouble: "╠",
+	lineUpDoubleDownDoubleRight: "╟",
+	lineUpDownRightDouble: "╞",
+	lineDownLeftRight: "┬",
+	lineDownBoldLeftBoldRightBold: "┳",
+	lineDownLeftBoldRightBold: "┯",
+	lineDownBoldLeftRight: "┰",
+	lineDownBoldLeftBoldRight: "┱",
+	lineDownBoldLeftRightBold: "┲",
+	lineDownLeftRightBold: "┮",
+	lineDownLeftBoldRight: "┭",
+	lineDownDoubleLeftDoubleRightDouble: "╦",
+	lineDownDoubleLeftRight: "╥",
+	lineDownLeftDoubleRightDouble: "╤",
+	lineUpLeftRight: "┴",
+	lineUpBoldLeftBoldRightBold: "┻",
+	lineUpLeftBoldRightBold: "┷",
+	lineUpBoldLeftRight: "┸",
+	lineUpBoldLeftBoldRight: "┹",
+	lineUpBoldLeftRightBold: "┺",
+	lineUpLeftRightBold: "┶",
+	lineUpLeftBoldRight: "┵",
+	lineUpDoubleLeftDoubleRightDouble: "╩",
+	lineUpDoubleLeftRight: "╨",
+	lineUpLeftDoubleRightDouble: "╧",
+	lineUpDownLeftRight: "┼",
+	lineUpBoldDownBoldLeftBoldRightBold: "╋",
+	lineUpDownBoldLeftBoldRightBold: "╈",
+	lineUpBoldDownLeftBoldRightBold: "╇",
+	lineUpBoldDownBoldLeftRightBold: "╊",
+	lineUpBoldDownBoldLeftBoldRight: "╉",
+	lineUpBoldDownLeftRight: "╀",
+	lineUpDownBoldLeftRight: "╁",
+	lineUpDownLeftBoldRight: "┽",
+	lineUpDownLeftRightBold: "┾",
+	lineUpBoldDownBoldLeftRight: "╂",
+	lineUpDownLeftBoldRightBold: "┿",
+	lineUpBoldDownLeftBoldRight: "╃",
+	lineUpBoldDownLeftRightBold: "╄",
+	lineUpDownBoldLeftBoldRight: "╅",
+	lineUpDownBoldLeftRightBold: "╆",
+	lineUpDoubleDownDoubleLeftDoubleRightDouble: "╬",
+	lineUpDoubleDownDoubleLeftRight: "╫",
+	lineUpDownLeftDoubleRightDouble: "╪",
+	lineCross: "╳",
+	lineBackslash: "╲",
+	lineSlash: "╱"
+};
+const specialMainSymbols = {
+	tick: "✔",
+	info: "ℹ",
+	warning: "⚠",
+	cross: "✘",
+	squareSmall: "◻",
+	squareSmallFilled: "◼",
+	circle: "◯",
+	circleFilled: "◉",
+	circleDotted: "◌",
+	circleDouble: "◎",
+	circleCircle: "ⓞ",
+	circleCross: "ⓧ",
+	circlePipe: "Ⓘ",
+	radioOn: "◉",
+	radioOff: "◯",
+	checkboxOn: "☒",
+	checkboxOff: "☐",
+	checkboxCircleOn: "ⓧ",
+	checkboxCircleOff: "Ⓘ",
+	pointer: "❯",
+	triangleUpOutline: "△",
+	triangleLeft: "◀",
+	triangleRight: "▶",
+	lozenge: "◆",
+	lozengeOutline: "◇",
+	hamburger: "☰",
+	smiley: "㋡",
+	mustache: "෴",
+	star: "★",
+	play: "▶",
+	nodejs: "⬢",
+	oneSeventh: "⅐",
+	oneNinth: "⅑",
+	oneTenth: "⅒"
+};
+const specialFallbackSymbols = {
+	tick: "√",
+	info: "i",
+	warning: "‼",
+	cross: "×",
+	squareSmall: "□",
+	squareSmallFilled: "■",
+	circle: "( )",
+	circleFilled: "(*)",
+	circleDotted: "( )",
+	circleDouble: "( )",
+	circleCircle: "(○)",
+	circleCross: "(×)",
+	circlePipe: "(│)",
+	radioOn: "(*)",
+	radioOff: "( )",
+	checkboxOn: "[×]",
+	checkboxOff: "[ ]",
+	checkboxCircleOn: "(×)",
+	checkboxCircleOff: "( )",
+	pointer: ">",
+	triangleUpOutline: "∆",
+	triangleLeft: "◄",
+	triangleRight: "►",
+	lozenge: "♦",
+	lozengeOutline: "◊",
+	hamburger: "≡",
+	smiley: "☺",
+	mustache: "┌─┐",
+	star: "✶",
+	play: "►",
+	nodejs: "♦",
+	oneSeventh: "1/7",
+	oneNinth: "1/9",
+	oneTenth: "1/10"
+};
+const mainSymbols = {
+	...common,
+	...specialMainSymbols
+};
+const fallbackSymbols = {
+	...common,
+	...specialFallbackSymbols
+};
+const shouldUseMain = isUnicodeSupported();
+const figures = shouldUseMain ? mainSymbols : fallbackSymbols;
+var esm_default = figures;
+const replacements = Object.entries(specialMainSymbols);
+
 //#endregion
 //#region src/cli/prompts/multiSelect.ts
 const checkboxTheme = {
@@ -26453,15 +26551,18 @@ const checkboxTheme = {
 const isSelectable = (item) => !Separator.isSeparator(item) && !item.disabled;
 const isChecked = (item) => isSelectable(item) && item.checked === true;
 function normalizeChoices(choices, defaultChecked) {
-	return choices.map((choice) => ({
-		value: choice.value,
-		name: choice.label,
-		short: choice.label,
-		checkedName: choice.label,
-		description: choice.description,
-		checked: choice.checked ?? defaultChecked,
-		disabled: false
-	}));
+	return choices.map((choice) => {
+		const desc = choice.description;
+		return {
+			value: choice.value,
+			name: choice.label,
+			short: choice.label,
+			checkedName: choice.label,
+			...desc ? { description: desc } : {},
+			checked: choice.checked ?? defaultChecked,
+			disabled: false
+		};
+	});
 }
 function buildPreview(command$1, selected) {
 	if (!command$1) return void 0;
@@ -26473,20 +26574,38 @@ function buildPreview(command$1, selected) {
 	return `${tone.info(`${label}:`)} ${renderedBase}${suffix}`;
 }
 const promptImpl = createPrompt((config, done) => {
-	const { instructions, pageSize = 12, loop = false, required, validate = () => true, defaultChecked = false, command: command$1 } = config;
+	const { instructions, pageSize, loop = false, required, validate = () => true, defaultChecked = false, command: command$1 } = config;
 	const shortcuts = {
 		all: "a",
 		invert: "i",
 		...config.shortcuts
 	};
 	const theme = makeTheme(checkboxTheme, config.theme);
-	const { keybindings } = theme;
+	const keybindings = theme.keybindings;
 	const [status$1, setStatus] = useState("idle");
 	const prefix = usePrefix({
 		status: status$1,
 		theme
 	});
 	const [items, setItems] = useState(normalizeChoices(config.choices, defaultChecked));
+	const [termSize, setTermSize] = useState(() => ({
+		rows: process.stdout?.rows ?? 24,
+		cols: process.stdout?.columns ?? 80
+	}));
+	useEffect(() => {
+		const stdout = process.stdout;
+		if (!stdout?.on || !stdout?.off) return;
+		const handleResize = () => {
+			setTermSize({
+				rows: stdout.rows ?? termSize.rows,
+				cols: stdout.columns ?? termSize.cols
+			});
+		};
+		stdout.on("resize", handleResize);
+		return () => {
+			stdout.off("resize", handleResize);
+		};
+	}, []);
 	const bounds = useMemo(() => {
 		const first = items.findIndex(isSelectable);
 		let last = -1;
@@ -26569,6 +26688,29 @@ const promptImpl = createPrompt((config, done) => {
 	});
 	const message = theme.style.message(config.message, status$1);
 	const preview = buildPreview(command$1, items.filter(isChecked).map((c) => c.value));
+	const termRows = termSize.rows;
+	const usableRows = Math.max(1, termRows);
+	const termCols = Math.max(40, termSize.cols - 4);
+	const activeDescriptionRaw = config.showActiveDescription && items[active]?.description ? items[active]?.description : void 0;
+	const wrappedDescription = activeDescriptionRaw && activeDescriptionRaw.length > 0 ? wrap(activeDescriptionRaw, {
+		width: termCols,
+		cut: false,
+		trim: true
+	}) : void 0;
+	const descriptionLineCount = wrappedDescription ? wrappedDescription.split("\n").length : 0;
+	const wrappedPreview = preview && preview.length > 0 ? wrap(preview, {
+		width: termCols,
+		cut: false,
+		trim: true
+	}) : void 0;
+	const previewLineCount = wrappedPreview ? wrappedPreview.split("\n").length : 0;
+	const helpLinesReserved = instructions === false ? 0 : 1;
+	const errorLinesReserved = errorMsg ? 1 : 0;
+	const leadingLines = 0;
+	const reservedLines = 2 + previewLineCount + descriptionLineCount + errorLinesReserved + helpLinesReserved;
+	const maxPageSize = Math.max(1, usableRows - reservedLines - leadingLines);
+	const basePageSize = pageSize ?? maxPageSize;
+	const finalPageSize = Math.max(1, Math.min(basePageSize, maxPageSize));
 	let description;
 	const page = usePagination({
 		items,
@@ -26579,12 +26721,12 @@ const promptImpl = createPrompt((config, done) => {
 				const disabledLabel = typeof item.disabled === "string" ? item.disabled : "(disabled)";
 				return theme.style.disabledChoice(`${item.name} ${disabledLabel}`);
 			}
-			if (isActive && config.showActiveDescription) description = item.description;
+			if (isActive && config.showActiveDescription) description = wrappedDescription ?? item.description;
 			const checkbox = item.checked ? theme.icon.checked : theme.icon.unchecked;
 			const name = item.checked ? item.checkedName : item.name;
 			return (isActive ? theme.style.highlight : (x) => x)(`${isActive ? theme.icon.cursor : " "}${checkbox} ${name}`);
 		},
-		pageSize,
+		pageSize: finalPageSize,
 		loop
 	});
 	if (status$1 === "done") {
@@ -26592,11 +26734,11 @@ const promptImpl = createPrompt((config, done) => {
 		return [
 			prefix,
 			message,
-			theme.style.answer(theme.style.renderSelectedChoices(selection, items))
+			theme.style.answer(theme.style.renderSelectedChoices(selection))
 		].filter(Boolean).join(" ");
 	}
 	let helpLine;
-	if (theme.helpMode !== "never" && instructions !== false) if (typeof instructions === "string") helpLine = instructions;
+	if (instructions !== false) if (typeof instructions === "string") helpLine = instructions;
 	else {
 		const keys = [["↑↓", "navigate"], ["space", "select"]];
 		if (shortcuts.all) keys.push([shortcuts.all, "all"]);
@@ -26604,15 +26746,31 @@ const promptImpl = createPrompt((config, done) => {
 		keys.push(["⏎", "submit"]);
 		helpLine = theme.style.keysHelpTip(keys);
 	}
-	return [
+	const renderedLines = [
 		[prefix, message].filter(Boolean).join(" "),
 		page,
 		" ",
-		preview,
+		wrappedPreview ?? preview,
 		description ? theme.style.description(description) : "",
 		errorMsg ? theme.style.error(errorMsg) : "",
 		helpLine
-	].filter(Boolean).join("\n").trimEnd();
+	].filter(Boolean).join("\n").replace(/\n+$/, "").split("\n");
+	if (process.env.CCSKI_PROMPT_DEBUG === "1") console.error([
+		"[prompt-debug]",
+		`rows=${termRows}`,
+		`usable=${usableRows}`,
+		`leading=${leadingLines}`,
+		`reserved=${reservedLines}`,
+		`preview=${previewLineCount}`,
+		`desc=${descriptionLineCount}`,
+		`pageSize=${finalPageSize}`,
+		`items=${items.length}`,
+		`rendered=${renderedLines.length}`
+	].join(" "));
+	renderedLines.unshift("");
+	const padding = Math.max(0, usableRows - renderedLines.length);
+	if (padding > 0) renderedLines.push(...Array(padding).fill(""));
+	return renderedLines.join("\n");
 });
 function promptMultiSelect(options) {
 	return promptImpl(options);
@@ -26651,11 +26809,16 @@ async function installCommand(argv) {
 	if (argv.color) setColorEnabled(true);
 	try {
 		const targetRoot = argv.global ? join(process.env.HOME ?? "~", ".claude/skills") : join(process.cwd(), ".claude/skills");
-		const materialized = await materializeSource(argv.source);
-		const targets = resolveInstallTargets(materialized.base, argv.use ?? materialized.useHint);
-		if (targets.length === 0) throw new Error(`No skills found to install in ${materialized.base}`);
+		const materialized = await materializeSource(argv.source, {
+			...argv.mode ? { mode: argv.mode } : {},
+			...argv.branch ? { branch: argv.branch } : {}
+		});
+		const explicitPath = argv.path ?? materialized.useHint;
+		const sourceLabel = formatSourceLabel(argv.source, materialized.branch ?? argv.branch, explicitPath, materialized.repo);
+		const targets = resolveInstallTargets(materialized.base, explicitPath, sourceLabel);
+		if (targets.length === 0) throw new Error(`No skills found for ${sourceLabel}. Resolved directory: ${materialized.base}`);
 		const force = argv.force === true || argv.override === true;
-		const selection = await selectSkills(targets, argv, argv.source);
+		const selection = await selectSkills(targets, argv, sourceLabel);
 		const installed = [];
 		for (const entry of selection) installed.push(installSkillDir(entry.dir, targetRoot, force));
 		console.log(success(`Installed ${installed.length} skill(s):`));
@@ -26670,99 +26833,92 @@ async function installCommand(argv) {
 		process.exitCode = 1;
 	}
 }
-function parseGithubTree(url) {
-	const parts = url.pathname.split("/").filter(Boolean);
-	if (parts.length >= 4 && parts[2] === "tree") {
-		const [owner, repo, , ref, ...rest] = parts;
-		return {
-			repo: `https://github.com/${owner}/${repo}.git`,
-			ref,
-			subdir: rest.length ? rest.join("/") : void 0
-		};
-	}
-	return null;
+function formatSourceLabel(input, branch, path, repo) {
+	const pieces = [repo ?? input];
+	if (branch) pieces.push(`branch=${branch}`);
+	if (path) pieces.push(`path=${path}`);
+	return pieces.join(" ");
 }
-function parseGithubBlob(url) {
-	const parts = url.pathname.split("/").filter(Boolean);
-	if (parts.length >= 5 && parts[2] === "blob") {
-		const [owner, repo, , ref, ...rest] = parts;
-		return {
-			repo: `https://github.com/${owner}/${repo}.git`,
-			ref,
-			path: rest.join("/")
-		};
-	}
-	return null;
+function defaultMode(source, explicit) {
+	if (explicit) return explicit;
+	if (source.endsWith(".git")) return "git";
+	return source.startsWith("http://") || source.startsWith("https://") ? "git" : "file";
 }
-async function materializeSource(source) {
-	if (source.startsWith("file://")) return { base: new URL(source).pathname };
-	if (source.startsWith("http://") || source.startsWith("https://") || source.endsWith(".git")) {
-		let repo = source;
-		let ref;
-		let subdir;
-		let useHint;
-		try {
-			const url = new URL(source);
-			const ghTree = parseGithubTree(url);
-			if (ghTree) {
-				repo = ghTree.repo;
-				ref = ghTree.ref;
-				subdir = ghTree.subdir;
-			} else {
-				const ghBlob = parseGithubBlob(url);
-				if (ghBlob) {
-					repo = ghBlob.repo;
-					ref = ghBlob.ref;
-					useHint = ghBlob.path;
-				}
-			}
-		} catch {}
-		const tmp = mkdtempSync(join(tmpdir(), "ccski-install-"));
-		const clone = [
-			"git",
-			"clone",
-			"--depth",
-			"1"
-		];
-		if (ref) clone.push("--branch", ref);
-		clone.push(repo, tmp);
-		execSync(clone.join(" "), { stdio: "ignore" });
+async function materializeSource(source, options) {
+	const mode = defaultMode(source, options.mode);
+	if (mode === "file") {
+		if (source.startsWith("http://") || source.startsWith("https://")) throw new Error("mode=file requires a local path; http(s) sources must use --mode git (default).");
 		return {
-			base: subdir ? join(tmp, subdir) : tmp,
-			useHint
+			base: normalizeSourcePath(source),
+			label: formatSourceLabel(source, void 0, void 0),
+			mode
 		};
 	}
-	return { base: normalizeSourcePath(source) };
+	const parsed = parseGitUrl(source);
+	const repo = parsed?.repo ?? source;
+	const branch = options.branch ?? parsed?.branch;
+	const tmp = mkdtempSync(join(tmpdir(), "ccski-install-"));
+	const clone = [
+		"git",
+		"clone",
+		"--depth",
+		"1"
+	];
+	if (branch) clone.push("--branch", branch);
+	clone.push(repo, tmp);
+	execSync(clone.join(" "), { stdio: "ignore" });
+	const useHint = parsed?.type === "blob" ? parsed.path : void 0;
+	const result = {
+		base: parsed?.type === "tree" && parsed.path ? join(tmp, parsed.path) : tmp,
+		label: formatSourceLabel(source, branch, useHint, repo),
+		mode
+	};
+	if (useHint) result.useHint = useHint;
+	if (branch) result.branch = branch;
+	if (repo) result.repo = repo;
+	return result;
 }
-function resolveSkillPath(baseDir, rel) {
+function resolveSkillPath(baseDirs, rel) {
 	const cleaned = rel.replace(/^\.\//, "");
+	const bases = Array.isArray(baseDirs) ? baseDirs : [baseDirs];
 	const candidates = [];
-	if (cleaned.endsWith("SKILL.md")) {
-		candidates.push(dirname(join(baseDir, cleaned)));
-		candidates.push(dirname(join(baseDir, "..", cleaned)));
-	} else {
-		candidates.push(join(baseDir, cleaned));
-		candidates.push(join(baseDir, "..", cleaned));
+	for (const baseDir of bases) {
+		const resolvedBase = resolve(baseDir);
+		if (cleaned.endsWith("SKILL.md")) {
+			candidates.push(dirname(join(resolvedBase, cleaned)));
+			candidates.push(dirname(join(resolvedBase, "..", cleaned)));
+		} else {
+			candidates.push(join(resolvedBase, cleaned));
+			candidates.push(join(resolvedBase, "..", cleaned));
+		}
 	}
 	for (const dir of candidates) if (existsSync(join(dir, "SKILL.md"))) return dir;
 	return null;
 }
 function marketplaceSkills(marketplacePath) {
 	const data = JSON.parse(readFileSync(marketplacePath, "utf8"));
-	const dir = dirname(marketplacePath);
+	const marketplaceDir = dirname(marketplacePath);
+	const repoRoot = resolve(marketplaceDir, "..");
 	const plugins = Array.isArray(data.plugins) ? data.plugins : [];
 	const skillPaths = /* @__PURE__ */ new Set();
 	for (const plugin of plugins) {
 		if (!plugin || !Array.isArray(plugin.skills)) continue;
+		const pluginSource = typeof plugin.source === "string" ? plugin.source : void 0;
+		const baseCandidates = new Set([marketplaceDir, repoRoot]);
+		if (pluginSource) {
+			const cleanedSource = pluginSource.replace(/^\.\//, "");
+			baseCandidates.add(resolve(marketplaceDir, cleanedSource));
+			baseCandidates.add(resolve(repoRoot, cleanedSource));
+		}
 		for (const rel of plugin.skills) {
 			if (typeof rel !== "string") continue;
-			const resolved = resolveSkillPath(dir, rel);
+			const resolved = resolveSkillPath(Array.from(baseCandidates), rel);
 			if (resolved) skillPaths.add(resolve(resolved));
 		}
 	}
 	return Array.from(skillPaths);
 }
-function resolveInstallTargets(root, usePath) {
+function resolveInstallTargets(root, usePath, label) {
 	const base = resolve(root);
 	const candidatePath = usePath ? resolve(base, usePath) : base;
 	if (!usePath && base.toLowerCase().endsWith("skill.md") && existsSync(base)) return [dirname(base)];
@@ -26775,7 +26931,7 @@ function resolveInstallTargets(root, usePath) {
 	if (existsSync(join(base, ".claude-plugin", "marketplace.json"))) return marketplaceSkills(join(base, ".claude-plugin", "marketplace.json"));
 	if (existsSync(join(base, "SKILL.md"))) return [base];
 	if (existsSync(join(base, "marketplace.json"))) return marketplaceSkills(join(base, "marketplace.json"));
-	throw new Error(`No SKILL.md or marketplace.json found in ${base}${usePath ? ` (use: ${usePath})` : ""}`);
+	throw new Error(`No SKILL.md or marketplace.json found for ${label}${usePath ? ` (path: ${usePath})` : ""}. Resolved directory: ${base}`);
 }
 function buildSkillEntries(dirs) {
 	return dirs.map((dir) => {
@@ -26790,12 +26946,14 @@ function buildSkillEntries(dirs) {
 async function promptSelectSkills(entries, sourceLabel) {
 	const pickedNames = await promptMultiSelect({
 		message: `Select skills to install from ${sourceLabel}`,
-		choices: entries.map((e) => ({
-			value: e.name,
-			label: formatChoiceLabel$1(e),
-			description: e.description,
-			checked: true
-		})),
+		choices: entries.map((e) => {
+			return {
+				value: e.name,
+				label: formatChoiceLabel$1(e),
+				description: e.description,
+				checked: true
+			};
+		}),
 		defaultChecked: true,
 		command: {
 			base: "ccski install",
@@ -26850,13 +27008,15 @@ function formatSkillListing(entries, label) {
 }
 function formatChoiceLabel$1(entry) {
 	const wrapWidth = Math.max(24, Math.min(process.stdout?.columns ?? 80, 120) - 6);
-	const description = entry.description ? "\n    " + wrap(entry.description, {
+	const descriptionText = entry.description ?? "";
+	const wrapped = descriptionText ? wrap(descriptionText, {
 		width: wrapWidth,
 		indent: "",
 		newline: "\n",
 		trim: true,
 		cut: false
-	}).replace(/\n/g, "\n    ") : "";
+	}) : "";
+	const description = wrapped && wrapped.length > 0 ? "\n    " + wrapped.replace(/\n/g, "\n    ") : "";
 	return `${tone.primary(entry.name)}${description}`;
 }
 
@@ -26988,23 +27148,30 @@ function enableSkill(skill, force) {
 	renameSync(disabledFile, skillFile);
 }
 function toListItems(skills) {
-	return skills.map((skill) => ({
-		title: skill.name,
-		color: skill.disabled ? tone.danger : void 0,
-		badge: skill.disabled ? tone.danger("[disabled]") : void 0,
-		meta: skill.location === "plugin" ? skill.pluginInfo?.pluginName ?? dim(skill.location) : dim(skill.location),
-		description: skill.description
-	}));
+	return skills.map((skill) => {
+		const base = {
+			title: skill.name,
+			meta: skill.location === "plugin" ? skill.pluginInfo?.pluginName ?? dim(skill.location) : dim(skill.location),
+			...skill.description ? { description: skill.description } : {}
+		};
+		if (skill.disabled) return {
+			...base,
+			color: tone.danger,
+			badge: tone.danger("[disabled]")
+		};
+		return base;
+	});
 }
 function formatChoiceLabel(skill) {
 	const wrapWidth = Math.max(24, Math.min(process.stdout?.columns ?? 80, 120) - 6);
-	const description = skill.description ? "\n    " + wrap(skill.description, {
+	const wrapped = wrap(skill.description, {
 		width: wrapWidth,
 		indent: "",
 		newline: "\n",
 		trim: true,
 		cut: false
-	}).replace(/\n/g, "\n    ") : "";
+	});
+	const description = wrapped && wrapped.length > 0 ? "\n    " + wrapped.replace(/\n/g, "\n    ") : "";
 	return `${tone.primary(skill.name)}${description}`;
 }
 function capitalize(value) {
@@ -27130,9 +27297,15 @@ const installModule = {
 		type: "boolean",
 		default: false,
 		description: "Alias for --force"
-	}).option("use", {
+	}).option("path", {
 		type: "string",
 		description: "Explicit SKILL.md or marketplace.json path inside source"
+	}).option("mode", {
+		choices: ["git", "file"],
+		description: "Materialization mode (default: git for http/https sources, file otherwise)"
+	}).option("branch", {
+		type: "string",
+		description: "Branch to checkout when using git mode"
 	}).option("interactive", {
 		alias: "i",
 		type: "boolean",