skilld 0.7.0 → 0.8.2

package/README.md

@@ -8,7 +8,7 @@
 
 ## Why?
 
-Agents have [knowledge cutoffs](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) and predict the most likely code from training data, not the best code. For example, [Vue v3.5](https://blog.vuejs.org/posts/vue-3-5) was released over 16 months ago and agents refuse so use its features out-of-the-box. This is because they're trained on conventions not the latest docs.
+Agents have [knowledge cutoffs](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) and predict the most likely code from training data, not the best code. For example, [Vue v3.5](https://blog.vuejs.org/posts/vue-3-5) was released over 16 months ago and agents refuse to use its features out-of-the-box. This is because they're trained on conventions not the latest docs.
 
 Methods of getting the right context to your agent require either manual curation, author opt-in, or external servers. See [the landscape](#the-landscape)
 for more details.
@@ -59,7 +59,7 @@ If you need to re-configure skilld, just run `npx -y skilld config` to update yo
 
 ## FAQ
 
-### Why doesn't the skills run?
+### Why don't the skills run?
 
 Try this in your project/user prompt:
 
@@ -72,16 +72,16 @@ For each skill, determine YES/NO relevance and invoke all YES skills before proc
 
 Context7 is an MCP that fetches raw doc chunks at query time. You get different results each prompt, no curation, and it requires their server. Skilld is local-first: it generates a SKILL.md that lives in your project, tied to your actual package versions. No MCP dependency, no per-prompt latency, and it goes further with LLM-enhanced sections, prompt injection sanitization, and semantic search.
 
-### Will I be prompt injection?
+### Will I be prompt injected?
 
 Skilld pulls issues from GitHub which could be abused for potential prompt injection.
 
-Skilld treats all data as unstrusted, running in permissioned environments and using best practices to avoid injections.
-However, always be cautious when using skills from untrusted source.
+Skilld treats all data as untrusted, running in permissioned environments and using best practices to avoid injections.
+However, always be cautious when using skills from untrusted sources.
 
 ### Do skills update when my deps update?
 
-Yes. Run `skilld update` to regenerate outdated skills, or add `skilld --prepare -b` to your prepare script and they regenerate in the background whenever you install packages.
+Yes. Run `skilld update` to regenerate outdated skills, or add `skilld update -b` to your prepare script and they regenerate in the background whenever you install packages.
 
 ## Installation
 
@@ -102,7 +102,7 @@ Add to `package.json` to keep skills fresh on install:
 ```json
 {
   "scripts": {
-    "prepare": "skilld --prepare -b"
+    "prepare": "skilld update -b"
   }
 }
 ```
@@ -169,8 +169,6 @@ skilld config
 | `--force` | `-f` | `false` | Ignore all caches, re-fetch docs and regenerate |
 | `--model`      | `-m` | config default | LLM model for skill generation (sonnet, haiku, opus, etc.) |
 | `--debug`      |      | `false`        | Save raw LLM output to logs/ for each section |
-| `--prepare`    |      | `false`        | Non-interactive sync for prepare hook (outdated only) |
-| `--background` | `-b` | `false`        | Run `--prepare` in a detached background process |
 
 ## The Landscape
 
@@ -194,6 +192,19 @@ Several approaches exist for steering agent knowledge. Each fills a different ni
 - **[skills-npm](https://github.com/antfu/skills-npm)**: the ideal end-state: zero-token skills shipped by the package author, but requires every maintainer to opt in.
 - **skilld**: generates version-aware skills from existing docs, changelogs, issues, and discussions. Works for any package without author opt-in.
 
+## Telemetry
+
+Skilld sends anonymous install events to [skills.sh](https://skills.sh/) so skills can be discovered and ranked. No personal information is collected.
+
+Telemetry is automatically disabled in CI environments.
+
+To opt out, set either environment variable:
+
+```bash
+DISABLE_TELEMETRY=1
+DO_NOT_TRACK=1
+```
+
 ## Related
 
 - [skills-npm](https://github.com/antfu/skills-npm) - Convention for shipping agent skills in npm packages

package/dist/_chunks/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../src/cache/version.ts","../../src/cache/config.ts"],"sourcesContent":["/**\n * Version utilities\n */\n\nimport { resolve } from 'pathe'\nimport { REFERENCES_DIR } from './config'\n\n/** Validate npm package name (scoped or unscoped) */\nconst VALID_PKG_NAME = /^(?:@[a-z0-9][-a-z0-9._]*\\/)?[a-z0-9][-a-z0-9._]*$/\n\n/** Validate version string (semver-ish, no path separators) */\nconst VALID_VERSION = /^[a-z0-9][-\\w.+]*$/i\n\n/**\n * Get exact version key for cache keying\n */\nexport function getVersionKey(version: string): string {\n  return version\n}\n\n/**\n * Get cache key for a package: name@version\n */\nexport function getCacheKey(name: string, version: string): string {\n  return `${name}@${getVersionKey(version)}`\n}\n\n/**\n * Get path to cached package references.\n * Validates name/version to prevent path traversal.\n */\nexport function getCacheDir(name: string, version: string): string {\n  if (!VALID_PKG_NAME.test(name))\n    throw new Error(`Invalid package name: ${name}`)\n  if (!VALID_VERSION.test(version))\n    throw new Error(`Invalid version: ${version}`)\n\n  const dir = resolve(REFERENCES_DIR, getCacheKey(name, version))\n  if (!dir.startsWith(REFERENCES_DIR))\n    throw new Error(`Path traversal detected: ${dir}`)\n  return dir\n}\n","/**\n * Cache configuration\n */\n\nimport { homedir } from 'node:os'\nimport { join } from 'pathe'\nimport { getCacheKey } from './version'\n\n/** Global cache directory */\nexport const CACHE_DIR = join(homedir(), '.skilld')\n\n/** References subdirectory */\nexport const REFERENCES_DIR = join(CACHE_DIR, 'references')\n\n/** Get search DB path for a specific package@version */\nexport function getPackageDbPath(name: string, version: string): string {\n  return join(REFERENCES_DIR, getCacheKey(name, version), 'search.db')\n}\n"],"mappings":";;AAQA,MAAM,iBAAiB;AAGvB,MAAM,gBAAgB;AAKtB,SAAgB,cAAc,SAAyB;AACrD,QAAO;;AAMT,SAAgB,YAAY,MAAc,SAAyB;AACjE,QAAO,GAAG,KAAK,GAAG,cAAc,QAAQ;;AAO1C,SAAgB,YAAY,MAAc,SAAyB;AACjE,KAAI,CAAC,eAAe,KAAK,KAAK,CAC5B,OAAM,IAAI,MAAM,yBAAyB,OAAO;AAClD,KAAI,CAAC,cAAc,KAAK,QAAQ,CAC9B,OAAM,IAAI,MAAM,oBAAoB,UAAU;CAEhD,MAAM,MAAM,QAAQ,gBAAgB,YAAY,MAAM,QAAQ,CAAC;AAC/D,KAAI,CAAC,IAAI,WAAW,eAAe,CACjC,OAAM,IAAI,MAAM,4BAA4B,MAAM;AACpD,QAAO;;AC/BT,MAAa,YAAY,KAAK,SAAS,EAAE,UAAU;AAGnD,MAAa,iBAAiB,KAAK,WAAW,aAAa;AAG3D,SAAgB,iBAAiB,MAAc,SAAyB;AACtE,QAAO,KAAK,gBAAgB,YAAY,MAAM,QAAQ,EAAE,YAAY"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/cache/version.ts","../../src/cache/config.ts"],"sourcesContent":["/**\n * Version utilities\n */\n\nimport { resolve } from 'pathe'\nimport { REFERENCES_DIR } from './config.ts'\n\n/** Validate npm package name (scoped or unscoped) */\nconst VALID_PKG_NAME = /^(?:@[a-z0-9][-a-z0-9._]*\\/)?[a-z0-9][-a-z0-9._]*$/\n\n/** Validate version string (semver-ish, no path separators) */\nconst VALID_VERSION = /^[a-z0-9][-\\w.+]*$/i\n\n/**\n * Get exact version key for cache keying\n */\nexport function getVersionKey(version: string): string {\n  return version\n}\n\n/**\n * Get cache key for a package: name@version\n */\nexport function getCacheKey(name: string, version: string): string {\n  return `${name}@${getVersionKey(version)}`\n}\n\n/**\n * Get path to cached package references.\n * Validates name/version to prevent path traversal.\n */\nexport function getCacheDir(name: string, version: string): string {\n  if (!VALID_PKG_NAME.test(name))\n    throw new Error(`Invalid package name: ${name}`)\n  if (!VALID_VERSION.test(version))\n    throw new Error(`Invalid version: ${version}`)\n\n  const dir = resolve(REFERENCES_DIR, getCacheKey(name, version))\n  if (!dir.startsWith(REFERENCES_DIR))\n    throw new Error(`Path traversal detected: ${dir}`)\n  return dir\n}\n","/**\n * Cache configuration\n */\n\nimport { homedir } from 'node:os'\nimport { join } from 'pathe'\nimport { getCacheKey } from './version.ts'\n\n/** Global cache directory */\nexport const CACHE_DIR = join(homedir(), '.skilld')\n\n/** References subdirectory */\nexport const REFERENCES_DIR = join(CACHE_DIR, 'references')\n\n/** Get search DB path for a specific package@version */\nexport function getPackageDbPath(name: string, version: string): string {\n  return join(REFERENCES_DIR, getCacheKey(name, version), 'search.db')\n}\n"],"mappings":";;AAQA,MAAM,iBAAiB;AAGvB,MAAM,gBAAgB;AAKtB,SAAgB,cAAc,SAAyB;AACrD,QAAO;;AAMT,SAAgB,YAAY,MAAc,SAAyB;AACjE,QAAO,GAAG,KAAK,GAAG,cAAc,QAAQ;;AAO1C,SAAgB,YAAY,MAAc,SAAyB;AACjE,KAAI,CAAC,eAAe,KAAK,KAAK,CAC5B,OAAM,IAAI,MAAM,yBAAyB,OAAO;AAClD,KAAI,CAAC,cAAc,KAAK,QAAQ,CAC9B,OAAM,IAAI,MAAM,oBAAoB,UAAU;CAEhD,MAAM,MAAM,QAAQ,gBAAgB,YAAY,MAAM,QAAQ,CAAC;AAC/D,KAAI,CAAC,IAAI,WAAW,eAAe,CACjC,OAAM,IAAI,MAAM,4BAA4B,MAAM;AACpD,QAAO;;AC/BT,MAAa,YAAY,KAAK,SAAS,EAAE,UAAU;AAGnD,MAAa,iBAAiB,KAAK,WAAW,aAAa;AAG3D,SAAgB,iBAAiB,MAAc,SAAyB;AACtE,QAAO,KAAK,gBAAgB,YAAY,MAAM,QAAQ,EAAE,YAAY"}

package/dist/_chunks/detect-imports.mjs

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./chunk.mjs";
 import { _ as writeSections, b as sanitizeMarkdown, h as readCachedSection, y as repairMarkdown } from "./storage.mjs";
-import { o as getFilePatterns, t as yamlEscape } from "./yaml.mjs";
+import { l as getFilePatterns, o as mapInsert, t as yamlEscape } from "./yaml.mjs";
 import { homedir } from "node:os";
 import { dirname, join, relative } from "pathe";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
@@ -544,7 +544,21 @@ function getAgentVersion(agentType) {
 		return null;
 	}
 }
-function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasIssues, hasDiscussions, features }) {
+function maxLines(min, max, sectionCount) {
+	const scale = budgetScale(sectionCount);
+	return Math.max(min, Math.round(max * scale));
+}
+function maxItems(min, max, sectionCount) {
+	const scale = budgetScale(sectionCount);
+	return Math.max(min, Math.round(max * scale));
+}
+function budgetScale(sectionCount) {
+	if (!sectionCount || sectionCount <= 1) return 1;
+	if (sectionCount === 2) return .85;
+	if (sectionCount === 3) return .7;
+	return .6;
+}
+function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasIssues, hasDiscussions, features, enabledSectionCount }) {
 	const [, major, minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
 	const searchHints = [];
 	if (features?.search !== false) {
@@ -623,7 +637,7 @@ This section documents version-specific API changes — prioritize recent major/
 
 Each item: ⚠️ (breaking/deprecated) or ✨ (new) + API name + what changed + source link.`,
 		rules: [
-			"- **API Changes:** 8-12 items from version history, MAX 80 lines",
+			`- **API Changes:** ${maxItems(6, 12, enabledSectionCount)} items from version history, MAX ${maxLines(50, 80, enabledSectionCount)} lines`,
 			"- Prioritize recent major/minor releases over old patch versions",
 			"- Focus on APIs that CHANGED, not general conventions or gotchas",
 			"- New APIs get ✨, deprecated/breaking get ⚠️",
@@ -632,7 +646,7 @@ Each item: ⚠️ (breaking/deprecated) or ✨ (new) + API name + what changed +
 		].filter(Boolean)
 	};
 }
-function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, features }) {
+function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, features, enabledSectionCount }) {
 	const searchHints = [];
 	if (features?.search !== false) searchHints.push(`\`npx -y skilld search "recommended" -p ${packageName}\``, `\`npx -y skilld search "avoid" -p ${packageName}\``);
 	const referenceWeights = [{
@@ -691,13 +705,13 @@ async function fetchUser(id: string, signal?: AbortSignal) {
 
 Each item: ✅ + pattern name + why it's preferred + source link. Code block only when the pattern isn't obvious from the title. Use the most relevant language tag (ts, vue, css, json, etc).`,
 		rules: [
-			"- **5-10 best practice items**",
-			"- **MAX 150 lines** for best practices section",
+			`- **${maxItems(4, 10, enabledSectionCount)} best practice items**`,
+			`- **MAX ${maxLines(80, 150, enabledSectionCount)} lines** for best practices section`,
 			"- **Only link files confirmed to exist** via Glob or Read — no guessed paths"
 		]
 	};
 }
-function customSection({ heading, body }) {
+function customSection({ heading, body }, enabledSectionCount) {
 	return {
 		task: `**Custom section — "${heading}":**\n${body}`,
 		format: `Custom section format:
@@ -706,10 +720,10 @@ function customSection({ heading, body }) {
 
 Content addressing the user's instructions above, using concise examples and source links.
 \`\`\``,
-		rules: [`- **Custom section "${heading}":** MAX 80 lines, use \`## ${heading}\` heading`]
+		rules: [`- **Custom section "${heading}":** MAX ${maxLines(50, 80, enabledSectionCount)} lines, use \`## ${heading}\` heading`]
 	};
 }
-function apiSection({ hasReleases, hasChangelog, hasIssues, hasDiscussions }) {
+function apiSection({ hasReleases, hasChangelog, hasIssues, hasDiscussions, enabledSectionCount }) {
 	const referenceWeights = [{
 		name: "Docs",
 		path: "./.skilld/docs/",
@@ -769,7 +783,7 @@ useNuxtData, usePreviewMode, prerenderRoutes
 
 Comma-separated names per group. One line per doc page. Annotate version when APIs are recent additions. For single-doc packages, use a flat comma list.`,
 		rules: [
-			"- **Doc Map:** names only, grouped by doc page, MAX 25 lines",
+			`- **Doc Map:** names only, grouped by doc page, MAX ${maxLines(15, 25, enabledSectionCount)} lines`,
 			"- Skip entirely for packages with fewer than 5 exports or only 1 doc page",
 			"- Prioritize new/recent exports over well-established APIs",
 			"- No signatures, no descriptions — the linked doc IS the description",
@@ -859,7 +873,7 @@ function getSectionDef(section, ctx, customPrompt) {
 		case "api-changes": return apiChangesSection(ctx);
 		case "best-practices": return bestPracticesSection(ctx);
 		case "api": return apiSection(ctx);
-		case "custom": return customPrompt ? customSection(customPrompt) : null;
+		case "custom": return customPrompt ? customSection(customPrompt, ctx.enabledSectionCount) : null;
 	}
 }
 function buildSectionPrompt(opts) {
@@ -876,7 +890,8 @@ function buildSectionPrompt(opts) {
 		hasDiscussions,
 		hasReleases,
 		hasChangelog,
-		features: opts.features
+		features: opts.features,
+		enabledSectionCount: opts.enabledSectionCount
 	}, customPrompt);
 	if (!sectionDef) return "";
 	const outputFile = SECTION_OUTPUT_FILES[section];
@@ -914,7 +929,8 @@ function buildAllSectionPrompts(opts) {
 	for (const section of opts.sections) {
 		const prompt = buildSectionPrompt({
 			...opts,
-			section
+			section,
+			enabledSectionCount: opts.sections.length
 		});
 		if (prompt) result.set(section, prompt);
 	}
@@ -1026,15 +1042,15 @@ function generatePackageHeader({ name, description, version, releasedAt, depende
 	}
 	lines.push("");
 	const refs = [];
-	refs.push(`[package.json](./.skilld/pkg/package.json)`);
+	refs.push(`[package.json](./.skilld/pkg/package.json) — exports, entry points`);
 	if (packages && packages.length > 1) for (const pkg of packages) {
 		const shortName = pkg.name.split("/").pop().toLowerCase();
 		refs.push(`[pkg-${shortName}](./.skilld/pkg-${shortName}/package.json)`);
 	}
-	if (pkgFiles?.includes("README.md")) refs.push(`[README](./.skilld/pkg/README.md)`);
-	if (hasIssues) refs.push(`[GitHub Issues](./.skilld/issues/_INDEX.md)`);
-	if (hasDiscussions) refs.push(`[GitHub Discussions](./.skilld/discussions/_INDEX.md)`);
-	if (hasReleases) refs.push(`[Releases](./.skilld/releases/_INDEX.md)`);
+	if (pkgFiles?.includes("README.md")) refs.push(`[README](./.skilld/pkg/README.md) — setup, basic usage`);
+	if (hasIssues) refs.push(`[GitHub Issues](./.skilld/issues/_INDEX.md) — bugs, workarounds, edge cases`);
+	if (hasDiscussions) refs.push(`[GitHub Discussions](./.skilld/discussions/_INDEX.md) — Q&A, patterns, recipes`);
+	if (hasReleases) refs.push(`[Releases](./.skilld/releases/_INDEX.md) — changelog, breaking changes, new APIs`);
 	if (refs.length > 0) lines.push(`**References:** ${refs.join(" • ")}`);
 	return lines.join("\n");
 }
@@ -1063,7 +1079,8 @@ 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 descSuffix = pkgDescription ? ` (${pkgDescription.replace(/\.?\s*$/, "")})` : "";
+	const rawDesc = pkgDescription?.replace(/[<>]/g, "").replace(/\.?\s*$/, "");
+	const cleanDesc = rawDesc && rawDesc.length > 200 ? `${rawDesc.slice(0, 197)}...` : rawDesc;
 	const editHint = globHint ? `editing${globHint} or code importing` : "writing code importing";
 	let desc;
 	if (packages && packages.length > 1) {
@@ -1073,14 +1090,17 @@ function generateFrontmatter({ name, version, description: pkgDescription, globs
 			allKeywords.add(pkg.name);
 			for (const kw of expandPackageName(pkg.name)) allKeywords.add(kw);
 		}
-		desc = `ALWAYS use when ${editHint} ${importList}. Consult for debugging, best practices, or modifying ${[...allKeywords].join(", ")}.${descSuffix}`;
+		const keywordList = [...allKeywords].join(", ");
+		desc = `${cleanDesc ? `${cleanDesc}. ` : ""}ALWAYS use when ${editHint} ${importList}. Consult for debugging, best practices, or modifying ${keywordList}.`;
 	} else {
 		const allKeywords = /* @__PURE__ */ new Set();
 		allKeywords.add(name);
 		for (const kw of expandPackageName(name)) allKeywords.add(kw);
 		if (repoUrl) for (const kw of expandRepoName(repoUrl)) allKeywords.add(kw);
-		desc = `ALWAYS use when ${editHint} "${name}". Consult for debugging, best practices, or modifying ${[...allKeywords].join(", ")}.${descSuffix}`;
+		const nameList = [...allKeywords].join(", ");
+		desc = `${cleanDesc ? `${cleanDesc}. ` : ""}ALWAYS use when ${editHint} "${name}". Consult for debugging, best practices, or modifying ${nameList}.`;
 	}
+	if (desc.length > 1024) desc = `${desc.slice(0, 1021)}...`;
 	const lines = [
 		"---",
 		`name: ${dirName ?? sanitizeName(name)}`,
@@ -1161,6 +1181,8 @@ function buildArgs$2(model, skillDir, symlinkDirs) {
 			`Write(${skilldDir}/**)`,
 			`Bash(*skilld search*)`
 		].join(" "),
+		"--disallowedTools",
+		"WebSearch WebFetch Task",
 		"--add-dir",
 		skillDir,
 		...symlinkDirs.flatMap((d) => ["--add-dir", d]),
@@ -1174,7 +1196,6 @@ function parseLine$2(line) {
 			const evt = obj.event;
 			if (!evt) return {};
 			if (evt.type === "content_block_delta" && evt.delta?.type === "text_delta") return { textDelta: evt.delta.text };
-			if (evt.type === "content_block_start" && evt.content_block?.type === "tool_use") return { toolName: evt.content_block.name };
 			return {};
 		}
 		if (obj.type === "assistant" && obj.message?.content) {
@@ -1350,6 +1371,71 @@ function parseLine(line) {
 	} catch {}
 	return {};
 }
+const TOOL_VERBS = {
+	Read: "Reading",
+	Glob: "Searching",
+	Grep: "Searching",
+	Write: "Writing",
+	Bash: "Running",
+	read_file: "Reading",
+	glob_tool: "Searching",
+	write_file: "Writing"
+};
+function createToolProgress(log) {
+	const pending = /* @__PURE__ */ new Map();
+	let timer = null;
+	let lastEmitted = "";
+	function flush() {
+		const parts = [];
+		for (const [section, { verb, path, count }] of pending) {
+			const suffix = count > 1 ? ` \x1B[90m(+${count - 1})\x1B[0m` : "";
+			parts.push(`\x1B[90m[${section}]\x1B[0m ${verb} ${path}${suffix}`);
+		}
+		const msg = parts.join("  ");
+		if (msg && msg !== lastEmitted) {
+			log.message(msg);
+			lastEmitted = msg;
+		}
+		pending.clear();
+		timer = null;
+	}
+	return ({ type, chunk, section }) => {
+		if (type === "text") {
+			log.message(`${section ? `\x1B[90m[${section}]\x1B[0m ` : ""}Writing...`);
+			return;
+		}
+		if (type !== "reasoning" || !chunk.startsWith("[")) return;
+		const key = section ?? "";
+		const match = chunk.match(/^\[(\w+)(?:,\s\w+)*(?::\s(.+))?\]$/);
+		if (!match) return;
+		const rawName = match[1];
+		const hint = match[2] ?? "";
+		let verb = TOOL_VERBS[rawName] ?? rawName;
+		let path = hint || "...";
+		if (rawName === "Bash" && hint) {
+			const searchMatch = hint.match(/skilld search\s+"([^"]+)"/);
+			if (searchMatch) {
+				verb = "skilld search:";
+				path = searchMatch[1];
+			} else path = hint.length > 60 ? `${hint.slice(0, 57)}...` : hint;
+		} else path = shortenPath(path);
+		if (rawName === "Write") {
+			if (timer) flush();
+			const prefix = section ? `\x1B[90m[${section}]\x1B[0m ` : "";
+			log.message(`${prefix}Writing ${path}`);
+			return;
+		}
+		const entry = mapInsert(pending, key, () => ({
+			verb,
+			path,
+			count: 0
+		}));
+		entry.verb = verb;
+		entry.path = path;
+		entry.count++;
+		if (!timer) timer = setTimeout(flush, 400);
+	};
+}
 const CLI_DEFS = [
 	claude_exports,
 	gemini_exports,
@@ -1403,7 +1489,7 @@ async function getAvailableModels() {
 function resolveReferenceDirs(skillDir) {
 	const refsDir = join(skillDir, ".skilld");
 	if (!existsSync(refsDir)) return [];
-	return readdirSync(refsDir).map((entry) => join(refsDir, entry)).filter((p) => lstatSync(p).isSymbolicLink()).map((p) => realpathSync(p));
+	return readdirSync(refsDir).map((entry) => join(refsDir, entry)).filter((p) => lstatSync(p).isSymbolicLink() && existsSync(p)).map((p) => realpathSync(p));
 }
 const CACHE_DIR = join(homedir(), ".skilld", "llm-cache");
 function normalizePromptForHash(prompt) {
@@ -1492,7 +1578,7 @@ function optimizeSection(opts) {
 				if (evt.fullText) accumulatedText = evt.fullText;
 				if (evt.writeContent) lastWriteContent = evt.writeContent;
 				if (evt.toolName) {
-					const hint = evt.toolHint ? `[${evt.toolName}: ${shortenPath(evt.toolHint)}]` : `[${evt.toolName}]`;
+					const hint = evt.toolHint ? `[${evt.toolName}: ${evt.toolHint}]` : `[${evt.toolName}]`;
 					onProgress?.({
 						chunk: hint,
 						type: "reasoning",
@@ -1759,6 +1845,7 @@ function cleanSectionOutput(content) {
 		if (/\b(?:function|const |let |var |export |return |import |async |class )\b/.test(preamble)) cleaned = cleaned.slice(firstMarker.index).trim();
 	}
 	cleaned = sanitizeMarkdown(cleaned);
+	if (!/^##\s/m.test(cleaned) && !/⚠️|✅|✨/.test(cleaned)) return "";
 	return cleaned;
 }
 const NUXT_CONFIG_FILES = [
@@ -1910,6 +1997,6 @@ function isNodeBuiltin(pkg) {
 	const base = pkg.startsWith("node:") ? pkg.slice(5) : pkg;
 	return NODE_BUILTINS.has(base.split("/")[0]);
 }
-export { detectTargetAgent as _, optimizeDocs as a, installSkillForAgents as c, unlinkSkillFromAgents as d, SECTION_MERGE_ORDER as f, detectInstalledAgents as g, buildSectionPrompt as h, getModelName as i, linkSkillToAgents as l, buildAllSectionPrompts as m, getAvailableModels as n, generateSkillMd as o, SECTION_OUTPUT_FILES as p, getModelLabel as r, computeSkillDirName as s, detectImportedPackages as t, sanitizeName as u, getAgentVersion as v, targets as y };
+export { targets as S, maxItems as _, getModelName as a, detectTargetAgent as b, computeSkillDirName as c, sanitizeName as d, unlinkSkillFromAgents as f, buildSectionPrompt as g, buildAllSectionPrompts as h, getModelLabel as i, installSkillForAgents as l, SECTION_OUTPUT_FILES as m, createToolProgress as n, optimizeDocs as o, SECTION_MERGE_ORDER as p, getAvailableModels as r, generateSkillMd as s, detectImportedPackages as t, linkSkillToAgents as u, maxLines as v, getAgentVersion as x, detectInstalledAgents as y };
 
 //# sourceMappingURL=detect-imports.mjs.map