skilld 1.7.4 → 2.0.0

package/dist/_chunks/prompts.mjs

@@ -1,12 +1,13 @@
-import { p as skillInternalDir } from "./paths.mjs";
-import { t as yamlEscape } from "./yaml.mjs";
+import { a as targets } from "./detect.mjs";
+import "./paths.mjs";
+import { c as NPM_SCOPE_PREFIX_RE, f as SEMVER_MAJOR_MINOR_RE } from "./regex.mjs";
 import { n as sanitizeMarkdown, t as repairMarkdown } from "./sanitize.mjs";
-import { a as getPackageRules, i as getFilePatterns } from "./package-registry.mjs";
-import { a as targets, t as detectInstalledAgents } from "./detect.mjs";
+import { t as yamlEscape } from "./yaml.mjs";
 import { existsSync, lstatSync, mkdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { styleText } from "node:util";
+import * as p from "@clack/prompts";
 import { dirname, join, relative } from "pathe";
 import { execSync } from "node:child_process";
-import * as p from "@clack/prompts";
 import { isWindows } from "std-env";
 let cached;
 function resolveSkilldCommand() {
@@ -19,6 +20,455 @@ function resolveSkilldCommand() {
 	}
 	return cached;
 }
+const REPO_REGISTRY = {
+	"vuejs/core": {
+		owner: "vuejs",
+		repo: "core",
+		docsRepo: "docs",
+		docsPath: "src",
+		homepage: "https://vuejs.org",
+		prereleaseChangelogRef: "minor",
+		packages: {
+			"vue": {
+				primary: true,
+				filePatterns: ["*.vue"],
+				rules: ["ALWAYS use `<script setup lang=\"ts\">`", "Use ```vue code fences for SFC examples containing `<script>` or `<template>` tags, ```ts for plain TypeScript"]
+			},
+			"@vue/compiler-core": {},
+			"@vue/compiler-dom": {},
+			"@vue/reactivity": {},
+			"@vue/runtime-core": {},
+			"@vue/runtime-dom": {},
+			"@vue/shared": {}
+		},
+		blogReleases: [
+			{
+				version: "3.5",
+				url: "https://blog.vuejs.org/posts/vue-3-5",
+				date: "2024-09-01"
+			},
+			{
+				version: "3.4",
+				url: "https://blog.vuejs.org/posts/vue-3-4",
+				date: "2023-12-28"
+			},
+			{
+				version: "3.3",
+				url: "https://blog.vuejs.org/posts/vue-3-3",
+				date: "2023-05-11"
+			},
+			{
+				version: "3.2",
+				url: "https://blog.vuejs.org/posts/vue-3-2",
+				date: "2021-08-05"
+			},
+			{
+				version: "3.1",
+				url: "https://blog.vuejs.org/posts/vue-3-1",
+				date: "2021-06-07"
+			},
+			{
+				version: "3.0",
+				url: "https://blog.vuejs.org/posts/vue-3-0",
+				date: "2020-09-18"
+			}
+		]
+	},
+	"tailwindlabs/tailwindcss": {
+		owner: "tailwindlabs",
+		repo: "tailwindcss",
+		docsRepo: "tailwindcss.com",
+		docsPath: "src/docs",
+		homepage: "https://tailwindcss.com",
+		packages: { tailwindcss: { primary: true } }
+	},
+	"withastro/astro": {
+		owner: "withastro",
+		repo: "astro",
+		docsRepo: "docs",
+		docsPath: "src/content/docs/en",
+		homepage: "https://docs.astro.build",
+		packages: { astro: {
+			primary: true,
+			filePatterns: ["*.astro"]
+		} }
+	},
+	"vueuse/vueuse": {
+		owner: "vueuse",
+		repo: "vueuse",
+		docsPath: "packages",
+		packages: { "@vueuse/core": { primary: true } }
+	},
+	"sveltejs/svelte": {
+		owner: "sveltejs",
+		repo: "svelte",
+		packages: { svelte: {
+			primary: true,
+			filePatterns: ["*.svelte"],
+			rules: ["ALWAYS use runes syntax ($state, $derived, $effect, $props)"]
+		} }
+	},
+	"solidjs/solid": {
+		owner: "solidjs",
+		repo: "solid",
+		packages: { "solid-js": {
+			primary: true,
+			filePatterns: ["*.jsx", "*.tsx"]
+		} }
+	},
+	"QwikDev/qwik": {
+		owner: "QwikDev",
+		repo: "qwik",
+		packages: { qwik: {
+			primary: true,
+			filePatterns: ["*.tsx"]
+		} }
+	},
+	"marko-js/marko": {
+		owner: "marko-js",
+		repo: "marko",
+		packages: { marko: {
+			primary: true,
+			filePatterns: ["*.marko"]
+		} }
+	},
+	"riot/riot": {
+		owner: "riot",
+		repo: "riot",
+		packages: { riot: {
+			primary: true,
+			filePatterns: ["*.riot"]
+		} }
+	},
+	"microsoft/TypeScript": {
+		owner: "microsoft",
+		repo: "TypeScript",
+		packages: { typescript: {
+			primary: true,
+			filePatterns: [
+				"*.ts",
+				"*.tsx",
+				"*.mts",
+				"*.cts"
+			]
+		} },
+		blogReleases: [
+			{
+				version: "6.0",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-6-0-beta/",
+				date: "2026-02-11",
+				title: "Announcing TypeScript 6.0 Beta"
+			},
+			{
+				version: "5.9",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-9/",
+				date: "2025-08-01",
+				title: "Announcing TypeScript 5.9"
+			},
+			{
+				version: "5.8",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-8/",
+				date: "2025-02-28",
+				title: "Announcing TypeScript 5.8"
+			},
+			{
+				version: "5.7",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-7/",
+				date: "2024-11-22",
+				title: "Announcing TypeScript 5.7"
+			},
+			{
+				version: "5.6",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-6/",
+				date: "2024-09-09",
+				title: "Announcing TypeScript 5.6"
+			},
+			{
+				version: "5.5",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/",
+				date: "2024-06-20",
+				title: "Announcing TypeScript 5.5"
+			}
+		]
+	},
+	"jashkenas/coffeescript": {
+		owner: "jashkenas",
+		repo: "coffeescript",
+		packages: { coffeescript: {
+			primary: true,
+			filePatterns: ["*.coffee"]
+		} }
+	},
+	"gkz/LiveScript": {
+		owner: "gkz",
+		repo: "LiveScript",
+		packages: { livescript: {
+			primary: true,
+			filePatterns: ["*.ls"]
+		} }
+	},
+	"elm/compiler": {
+		owner: "elm",
+		repo: "compiler",
+		packages: { elm: {
+			primary: true,
+			filePatterns: ["*.elm"]
+		} }
+	},
+	"sass/dart-sass": {
+		owner: "sass",
+		repo: "dart-sass",
+		packages: { sass: {
+			primary: true,
+			filePatterns: ["*.scss", "*.sass"]
+		} }
+	},
+	"less/less.js": {
+		owner: "less",
+		repo: "less.js",
+		packages: { less: {
+			primary: true,
+			filePatterns: ["*.less"]
+		} }
+	},
+	"stylus/stylus": {
+		owner: "stylus",
+		repo: "stylus",
+		packages: { stylus: {
+			primary: true,
+			filePatterns: ["*.styl"]
+		} }
+	},
+	"postcss/postcss": {
+		owner: "postcss",
+		repo: "postcss",
+		packages: { postcss: {
+			primary: true,
+			filePatterns: ["*.css", "*.pcss"]
+		} }
+	},
+	"pugjs/pug": {
+		owner: "pugjs",
+		repo: "pug",
+		packages: { pug: {
+			primary: true,
+			filePatterns: ["*.pug"]
+		} }
+	},
+	"mde/ejs": {
+		owner: "mde",
+		repo: "ejs",
+		packages: { ejs: {
+			primary: true,
+			filePatterns: ["*.ejs"]
+		} }
+	},
+	"handlebars-lang/handlebars.js": {
+		owner: "handlebars-lang",
+		repo: "handlebars.js",
+		packages: { handlebars: {
+			primary: true,
+			filePatterns: ["*.hbs", "*.handlebars"]
+		} }
+	},
+	"janl/mustache.js": {
+		owner: "janl",
+		repo: "mustache.js",
+		packages: { mustache: {
+			primary: true,
+			filePatterns: ["*.mustache"]
+		} }
+	},
+	"mozilla/nunjucks": {
+		owner: "mozilla",
+		repo: "nunjucks",
+		packages: { nunjucks: {
+			primary: true,
+			filePatterns: ["*.njk"]
+		} }
+	},
+	"Shopify/liquid": {
+		owner: "Shopify",
+		repo: "liquid",
+		packages: { liquid: {
+			primary: true,
+			filePatterns: ["*.liquid"]
+		} }
+	},
+	"eemeli/yaml": {
+		owner: "eemeli",
+		repo: "yaml",
+		packages: { yaml: {
+			primary: true,
+			filePatterns: ["*.yaml", "*.yml"]
+		} }
+	},
+	"nodeca/js-yaml": {
+		owner: "nodeca",
+		repo: "js-yaml",
+		packages: { "js-yaml": {
+			primary: true,
+			filePatterns: ["*.yaml", "*.yml"]
+		} }
+	},
+	"BinaryMuse/toml-node": {
+		owner: "BinaryMuse",
+		repo: "toml-node",
+		packages: {
+			"toml": {
+				primary: true,
+				filePatterns: ["*.toml"]
+			},
+			"@iarna/toml": { filePatterns: ["*.toml"] }
+		}
+	},
+	"json5/json5": {
+		owner: "json5",
+		repo: "json5",
+		packages: { json5: {
+			primary: true,
+			filePatterns: ["*.json5"]
+		} }
+	},
+	"microsoft/node-jsonc-parser": {
+		owner: "microsoft",
+		repo: "node-jsonc-parser",
+		packages: { "jsonc-parser": {
+			primary: true,
+			filePatterns: ["*.jsonc"]
+		} }
+	},
+	"markdown-it/markdown-it": {
+		owner: "markdown-it",
+		repo: "markdown-it",
+		packages: { "markdown-it": {
+			primary: true,
+			filePatterns: ["*.md"]
+		} }
+	},
+	"markedjs/marked": {
+		owner: "markedjs",
+		repo: "marked",
+		packages: { marked: {
+			primary: true,
+			filePatterns: ["*.md"]
+		} }
+	},
+	"remarkjs/remark": {
+		owner: "remarkjs",
+		repo: "remark",
+		packages: { remark: {
+			primary: true,
+			filePatterns: ["*.md", "*.mdx"]
+		} }
+	},
+	"mdx-js/mdx": {
+		owner: "mdx-js",
+		repo: "mdx",
+		packages: { "@mdx-js/mdx": {
+			primary: true,
+			filePatterns: ["*.mdx"]
+		} }
+	},
+	"graphql/graphql-js": {
+		owner: "graphql",
+		repo: "graphql-js",
+		packages: {
+			"graphql": {
+				primary: true,
+				filePatterns: ["*.graphql", "*.gql"]
+			},
+			"graphql-tag": { filePatterns: ["*.graphql", "*.gql"] }
+		}
+	},
+	"dotansimha/graphql-code-generator": {
+		owner: "dotansimha",
+		repo: "graphql-code-generator",
+		packages: { "@graphql-codegen/cli": {
+			primary: true,
+			filePatterns: ["*.graphql", "*.gql"]
+		} }
+	},
+	"quasarframework/quasar": {
+		owner: "quasarframework",
+		repo: "quasar",
+		docsPath: "docs/src/pages",
+		docsRef: "dev",
+		homepage: "https://quasar.dev",
+		packages: { quasar: { primary: true } }
+	},
+	"motiondivision/motion-vue": {
+		owner: "motiondivision",
+		repo: "motion-vue",
+		homepage: "https://motion.dev",
+		crawlUrl: "https://motion.dev/docs/vue**",
+		packages: { "motion-v": { primary: true } }
+	},
+	"prisma/prisma": {
+		owner: "prisma",
+		repo: "prisma",
+		packages: {
+			"prisma": {
+				primary: true,
+				filePatterns: ["*.prisma"]
+			},
+			"@prisma/client": { filePatterns: ["*.prisma"] }
+		}
+	},
+	"nicolo-ribaudo/tc39-proposal-wasm-esm-integration": {
+		owner: "nicolo-ribaudo",
+		repo: "tc39-proposal-wasm-esm-integration",
+		packages: { "wasm-pack": {
+			primary: true,
+			filePatterns: ["*.wasm"]
+		} }
+	}
+};
+const PACKAGE_TO_REPO_MAP = {};
+for (const [repoKey, entry] of Object.entries(REPO_REGISTRY)) for (const packageName of Object.keys(entry.packages)) PACKAGE_TO_REPO_MAP[packageName] = repoKey;
+function getDocOverride(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	const entry = REPO_REGISTRY[repoKey];
+	if (!entry?.docsRepo && !entry?.docsPath) return void 0;
+	return {
+		owner: entry.owner,
+		repo: entry.docsRepo || entry.repo,
+		path: entry.docsPath || "",
+		ref: entry.docsRef,
+		homepage: entry.homepage
+	};
+}
+function getBlogPreset(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	const entry = REPO_REGISTRY[repoKey];
+	if (!entry?.blogReleases) return void 0;
+	return {
+		packageName,
+		releases: entry.blogReleases
+	};
+}
+function getFilePatterns(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	return REPO_REGISTRY[repoKey]?.packages[packageName]?.filePatterns;
+}
+function getPackageRules(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return [];
+	return REPO_REGISTRY[repoKey]?.packages[packageName]?.rules ?? [];
+}
+function getPrereleaseChangelogRef(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	return REPO_REGISTRY[repoKey]?.prereleaseChangelogRef;
+}
+function getCrawlUrl(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	return REPO_REGISTRY[repoKey]?.crawlUrl;
+}
 const TOTAL_TARGET = 500;
 const DEFAULT_OVERHEAD = 30;
 function remainingLines(overheadLines) {
@@ -72,8 +522,9 @@ function checkAbsolutePaths(content) {
 	if (absPaths?.length) return [{ warning: `${absPaths.length} source links use absolute paths — must use relative ./.skilld/ paths` }];
 	return [];
 }
+const STATIC_REGEX_2$4 = /^## API Changes/im;
 function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasDocs, hasIssues, hasDiscussions, pkgFiles, features, enabledSectionCount, releaseCount, overheadLines }) {
-	const [, major, minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
+	const [, major, minor] = version?.match(SEMVER_MAJOR_MINOR_RE) ?? [];
 	const boost = releaseBoost(releaseCount, minor ? Number(minor) : void 0);
 	const cmd = resolveSkilldCommand();
 	const searchHints = [];
@@ -152,7 +603,7 @@ The "Older" column means ≤ v${Number(major) - 2}.x — these changes are NOT u
 			const labeledBullets = (content.match(/^- (?:\*\*)?(?:BREAKING|DEPRECATED|NEW):(?:\*\*)? /gm) || []).length;
 			const alsoChangedItems = (content.match(/\*\*Also changed:\*\*/g) || []).length;
 			if (detailedBullets > 2 && labeledBullets / (detailedBullets - alsoChangedItems || 1) < .8) warnings.push({ warning: `Only ${labeledBullets}/${detailedBullets} items have BREAKING/DEPRECATED/NEW labels` });
-			if (!/^## API Changes/im.test(content)) warnings.push({ warning: "Missing required \"## API Changes\" heading" });
+			if (!STATIC_REGEX_2$4.test(content)) warnings.push({ warning: "Missing required \"## API Changes\" heading" });
 			return warnings;
 		},
 		task: `**Find new, deprecated, and renamed APIs from version history.** Focus exclusively on APIs that changed between versions — LLMs trained on older data will use the wrong names, wrong signatures, or non-existent functions.
@@ -194,8 +645,9 @@ Each item: BREAKING/DEPRECATED/NEW label + API name + what changed + source link
 		].filter(Boolean)
 	};
 }
+const STATIC_REGEX_2$3 = /^## Best Practices/im;
 function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, hasDocs, pkgFiles, features, enabledSectionCount, releaseCount, version, overheadLines }) {
-	const [, , minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
+	const [, , minor] = version?.match(SEMVER_MAJOR_MINOR_RE) ?? [];
 	const boost = 1 + (releaseBoost(releaseCount, minor ? Number(minor) : void 0) - 1) * .5;
 	const cmd = resolveSkilldCommand();
 	const searchHints = [];
@@ -245,7 +697,7 @@ function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasRelea
 			const bullets = (content.match(/^- /gm) || []).length;
 			const codeBlocks = (content.match(/^```/gm) || []).length / 2;
 			if (bullets > 2 && codeBlocks / bullets > .5) warnings.push({ warning: `${Math.round(codeBlocks)}/${bullets} items have code blocks — prefer concise descriptions with source links` });
-			if (!/^## Best Practices/im.test(content)) warnings.push({ warning: "Missing required \"## Best Practices\" heading" });
+			if (!STATIC_REGEX_2$3.test(content)) warnings.push({ warning: "Missing required \"## Best Practices\" heading" });
 			return warnings;
 		},
 		task: `**Extract non-obvious best practices from the references.** Focus on recommended patterns the LLM wouldn't already know: idiomatic usage, preferred configurations, performance tips, patterns that differ from what a developer would assume. Surface new patterns from recent minor releases that may post-date training data.
@@ -329,6 +781,10 @@ const SECTION_MERGE_ORDER = SECTIONS.map((s) => s.id);
 function getSectionModule(id) {
 	return SECTIONS.find((s) => s.id === id);
 }
+const STATIC_REGEX_1$1 = /v\d+\.(\d+)\.(\d+)\.md$/;
+const STATIC_REGEX_2$2 = /[^`]*\/\.skilld\//;
+const STATIC_REGEX_3 = /\n## Output\n[\s\S]*$/;
+const STATIC_REGEX_4 = /\n## Search\n[\s\S]*?(?=\n\n(?:\||## |<|\*\*))/;
 function wrapSection(section, content) {
 	return `<!-- skilld:${section} -->\n${content}\n<!-- /skilld:${section} -->`;
 }
@@ -420,7 +876,7 @@ function buildSectionPrompt(opts) {
 	const hasDocs = !!opts.docFiles?.some((f) => f.includes("/docs/"));
 	const releaseCount = opts.docFiles?.filter((f) => {
 		if (!f.includes("/releases/")) return false;
-		const m = f.match(/v\d+\.(\d+)\.(\d+)\.md$/);
+		const m = f.match(STATIC_REGEX_1$1);
 		return m && (m[1] === "0" || m[2] === "0");
 	}).length;
 	const sectionDef = getSectionDef(section, {
@@ -489,12 +945,12 @@ function buildAllSectionPrompts(opts) {
 }
 function portabilizePrompt(prompt, section) {
 	let out = prompt;
-	out = out.replace(/`[^`]*\/\.skilld\//g, (m) => m.replace(/[^`]*\/\.skilld\//, "./references/"));
+	out = out.replace(/`[^`]*\/\.skilld\//g, (m) => m.replace(STATIC_REGEX_2$2, "./references/"));
 	out = out.replace(/\(\.\/\.skilld\//g, "(./references/");
 	out = out.replace(/`\.\/\.skilld\//g, "`./references/");
 	out = out.replace(/\.skilld\//g, "./references/");
-	out = out.replace(/\n## Output\n[\s\S]*$/, "");
-	out = out.replace(/\n## Search\n[\s\S]*?(?=\n\n(?:\||## |<|\*\*))/, "");
+	out = out.replace(STATIC_REGEX_3, "");
+	out = out.replace(STATIC_REGEX_4, "");
 	out = out.replace(/^- .*`skilld search`.*$/gm, "");
 	out = out.replace(/^- .*`skilld validate`.*$/gm, "");
 	out = out.replace(/,? and `skilld search`/g, "");
@@ -513,6 +969,8 @@ function portabilizePrompt(prompt, section) {
 	out = out.replace(/\n{3,}/g, "\n\n");
 	return out;
 }
+const STATIC_REGEX_1 = /https?:\/\/github\.com\//;
+const STATIC_REGEX_2$1 = /^#+\s*$/;
 function todayIsoDate() {
 	return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
 }
@@ -530,7 +988,7 @@ function formatSource(source) {
 	if (!source) return "";
 	if (source === "shipped") return "shipped";
 	if (source.includes("llms.txt")) return "llms.txt";
-	if (source.includes("github.com")) return source.replace(/https?:\/\/github\.com\//, "");
+	if (source.includes("github.com")) return source.replace(STATIC_REGEX_1, "");
 	return source;
 }
 function formatDuration(ms) {
@@ -550,7 +1008,7 @@ function timedSpinner() {
 		},
 		stop(msg) {
 			const elapsed = startedAt ? formatDuration(Date.now() - startedAt) : "";
-			spin.stop(elapsed ? `${msg} \x1B[90m[${elapsed}]\x1B[0m` : msg);
+			spin.stop(elapsed ? `${msg} ${styleText("gray", `[${elapsed}]`)}` : msg);
 		}
 	};
 }
@@ -558,10 +1016,10 @@ function highlightTerms(content, terms) {
 	if (terms.length === 0) return content;
 	const sorted = terms.toSorted((a, b) => b.length - a.length);
 	const pattern = new RegExp(`(${sorted.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})`, "gi");
-	return content.replace(pattern, "\x1B[33m$1\x1B[0m");
+	return content.replace(pattern, (m) => styleText("yellow", m));
 }
 function scoreLabel(pct) {
-	return `${pct >= 70 ? "\x1B[32m" : pct >= 40 ? "\x1B[33m" : "\x1B[90m"}${pct}%\x1B[0m`;
+	return styleText(pct >= 70 ? "green" : pct >= 40 ? "yellow" : "gray", `${pct}%`);
 }
 function normalizeScores(results) {
 	const map = /* @__PURE__ */ new Map();
@@ -572,15 +1030,15 @@ function normalizeScores(results) {
 function formatSnippet(r, versions, pct) {
 	const refPath = `.claude/skills/${r.package}/.skilld/${r.source}`;
 	const lineRange = r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`;
-	const score = pct != null ? scoreLabel(pct) : `\x1B[90m${r.score.toFixed(2)}\x1B[0m`;
+	const score = pct != null ? scoreLabel(pct) : styleText("gray", r.score.toFixed(2));
 	const version = versions?.get(r.package);
 	const pkgLabel = version ? `${r.package}@${version}` : r.package;
 	const scopeStr = r.scope?.length ? `${r.scope.map((e) => e.name).join(".")} → ` : "";
 	const entityStr = r.entities?.map((e) => e.signature || `${e.type} ${e.name}`).join(", ");
 	const highlighted = highlightTerms(r.content, r.highlights);
 	return [
-		`${pkgLabel} ${score}${entityStr ? `  \x1B[36m${scopeStr}${entityStr}\x1B[0m` : ""}`,
-		`\x1B[90m${refPath}:${lineRange}\x1B[0m`,
+		`${pkgLabel} ${score}${entityStr ? `  ${styleText("cyan", `${scopeStr}${entityStr}`)}` : ""}`,
+		styleText("gray", `${refPath}:${lineRange}`),
 		`  ${highlighted.replace(/\n/g, "\n  ")}`
 	].join("\n");
 }
@@ -590,7 +1048,7 @@ function formatCompactSnippet(r, cols) {
 	const title = entityStr ? `${scopeStr}${entityStr}` : r.source.split("/").pop() || r.source;
 	const path = `${`.claude/skills/${r.package}/.skilld/${r.source}`}:${r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`}`;
 	const maxPreview = cols - 6;
-	const firstLine = r.content.split("\n").find((l) => l.trim() && l.trim() !== "---" && !/^#+\s*$/.test(l.trim())) || "";
+	const firstLine = r.content.split("\n").find((l) => l.trim() && l.trim() !== "---" && !STATIC_REGEX_2$1.test(l.trim())) || "";
 	return {
 		title,
 		path,
@@ -603,55 +1061,6 @@ function sanitizeName(name) {
 function computeSkillDirName(packageName) {
 	return `${sanitizeName(packageName)}-skilld`;
 }
-function installSkillForAgents(skillName, skillContent, options = {}) {
-	const isGlobal = options.global ?? false;
-	const cwd = options.cwd || process.cwd();
-	const sanitized = sanitizeName(skillName);
-	const explicit = !!options.agents;
-	const targetAgents = options.agents || detectInstalledAgents();
-	const installed = [];
-	const skipped = [];
-	const paths = [];
-	const writtenDirs = /* @__PURE__ */ new Set();
-	for (const agentType of targetAgents) {
-		const agent = targets[agentType];
-		if (isGlobal && !agent.globalSkillsDir) {
-			skipped.push({
-				agent: agentType,
-				reason: "no global support"
-			});
-			continue;
-		}
-		const baseDir = isGlobal ? agent.globalSkillsDir : join(cwd, agent.skillsDir);
-		if (!explicit && !existsSync(baseDir)) {
-			skipped.push({
-				agent: agentType,
-				reason: "skills dir not found"
-			});
-			continue;
-		}
-		if (isGlobal && (writtenDirs.has(baseDir) || agent.additionalSkillsDirs.some((d) => writtenDirs.has(d)))) {
-			skipped.push({
-				agent: agentType,
-				reason: "already covered by another agent dir"
-			});
-			continue;
-		}
-		const skillDir = join(baseDir, sanitized);
-		const skilldDir = skillInternalDir(skillDir);
-		mkdirSync(skilldDir, { recursive: true });
-		writeFileSync(join(skilldDir, "_SKILL.md"), sanitizeMarkdown(repairMarkdown(skillContent)));
-		if (options.files) for (const [filename, content] of Object.entries(options.files)) writeFileSync(join(skillDir, filename), filename.endsWith(".md") ? sanitizeMarkdown(repairMarkdown(content)) : content);
-		installed.push(agentType);
-		paths.push(skillDir);
-		writtenDirs.add(baseDir);
-	}
-	return {
-		installed,
-		skipped,
-		paths
-	};
-}
 function linkSkillToAgents(skillName, sharedDir, cwd, agentType) {
 	const targetAgents = agentType ? [[agentType, targets[agentType]]] : Object.entries(targets);
 	const linkedDirs = /* @__PURE__ */ new Set();
@@ -691,6 +1100,7 @@ function unlinkSkillFromAgents(skillName, cwd, agentType) {
 		} catch {}
 	}
 }
+const STATIC_REGEX_2 = /\.?\s*$/;
 function writeSkillMd(skillDir, content) {
 	writeFileSync(join(skillDir, "SKILL.md"), content);
 }
@@ -764,13 +1174,13 @@ function generatePackageHeader({ name, version, distTags, repoUrl, hasIssues, ha
 }
 function expandPackageName(name) {
 	const variants = /* @__PURE__ */ new Set();
-	const unscoped = name.replace(/^@/, "");
+	const unscoped = name.replace(NPM_SCOPE_PREFIX_RE, "");
 	if (unscoped !== name) {
 		variants.add(unscoped);
 		variants.add(unscoped.replace(/\//g, " "));
 	}
 	if (name.includes("-")) {
-		const spaced = name.replace(/^@/, "").replace(/\//g, " ").replace(/-/g, " ");
+		const spaced = name.replace(NPM_SCOPE_PREFIX_RE, "").replace(/\//g, " ").replace(/-/g, " ");
 		variants.add(spaced);
 	}
 	variants.delete(name);
@@ -787,7 +1197,7 @@ function expandRepoName(repoUrl) {
 function generateFrontmatter({ name, version, description: pkgDescription, globs, body, generatedBy, dirName, packages, repoUrl }) {
 	const patterns = globs ?? getFilePatterns(name);
 	const globHint = patterns?.length ? ` or working with ${patterns.join(", ")} files` : "";
-	const rawDesc = pkgDescription?.replace(/[<>]/g, "").replace(/\.?\s*$/, "");
+	const rawDesc = pkgDescription?.replace(/[<>]/g, "").replace(STATIC_REGEX_2, "");
 	const cleanDesc = rawDesc && rawDesc.length > 200 ? `${rawDesc.slice(0, 197)}...` : rawDesc;
 	const editHint = globHint ? `editing${globHint} or code importing` : "writing code importing";
 	let desc;
@@ -835,6 +1245,6 @@ function generateFooter(relatedSkills) {
 	if (relatedSkills.length === 0) return "";
 	return `\nRelated: ${relatedSkills.join(", ")}\n`;
 }
-export { portabilizePrompt as C, maxItems as D, SECTION_OUTPUT_FILES as E, maxLines as O, getSectionValidator as S, SECTION_MERGE_ORDER as T, timedSpinner as _, installSkillForAgents as a, buildSectionPrompt as b, unlinkSkillFromAgents as c, formatSnippet as d, formatSource as f, timeAgo as g, scoreLabel as h, computeSkillDirName as i, resolveSkilldCommand as k, formatCompactSnippet as l, normalizeScores as m, writeGeneratedSkillMd as n, linkSkillToAgents as o, highlightTerms as p, writeSkillMd as r, sanitizeName as s, generateSkillMd as t, formatDuration as u, todayIsoDate as v, wrapSection as w, extractMarkedSections as x, buildAllSectionPrompts as y };
+export { resolveSkilldCommand as A, SECTION_OUTPUT_FILES as C, getCrawlUrl as D, getBlogPreset as E, getDocOverride as O, SECTION_MERGE_ORDER as S, maxLines as T, buildAllSectionPrompts as _, sanitizeName as a, portabilizePrompt as b, formatDuration as c, highlightTerms as d, normalizeScores as f, todayIsoDate as g, timedSpinner as h, linkSkillToAgents as i, getPrereleaseChangelogRef as k, formatSnippet as l, timeAgo as m, writeSkillMd as n, unlinkSkillFromAgents as o, scoreLabel as p, computeSkillDirName as r, formatCompactSnippet as s, writeGeneratedSkillMd as t, formatSource as u, extractMarkedSections as v, maxItems as w, wrapSection as x, getSectionValidator as y };
 
 //# sourceMappingURL=prompts.mjs.map