skilld 0.3.2 → 0.4.1

package/README.md

@@ -34,22 +34,23 @@ Skilld leverages maintainers existing effort. Maintainers write great docs for u
 
 ## Features
 
-- 🌍 **Full Context SKILL.md** - Generates with the repo code, docs, releases, issues, discussions
-- 🤖 **BYO Agent** - Generate SKILL.md with or without an LLM
-- 📚 **Customizable** - `Best practices`, `LLM Gaps`, `Doc Map` or your own prompts
-- 🔍 **Semantic Search** - Token-optimized search via [retriv](https://github.com/harlan-zw/retriv)
-- 🎯 **Safe** - Prompt injection sanitization, version-aware output
-- 🤝 **Ecosystem** - [skills-npm](https://github.com/antfu/skills-npm) and `/llms.txt` support
+- 🌍 **Any Source: Opt-in** - Any NPM dependency or GitHub source, docs auto-resolved
+- 📦 **Bleeding Edge Context** - Latest issues, discussions, and releases synced on
+every update. Always use the latest best practices and avoid deprecated patterns.
+- 📚 **Opt-in LLM Sections** - Enhance skills with LLM-generated `Best practices`, `LLM Gaps`, `Doc Map`, or your own prompts
+- 🔍 **Semantic Search** - Query indexed docs across all skills via [retriv](https://github.com/harlan-zw/retriv) embeddings
+- 🎯 **Safe & Versioned** - Prompt injection sanitization, version-aware caching, auto-updates on new releases
+- 🤝 **Ecosystem** - Compatible with [`npx skills`](https://skills.sh/) and [skills-npm](https://github.com/antfu/skills-npm)
 
 ## Quick Start
 
 Run skilld in a project to generate skills for your dependencies through a simple interactive wizard:
 
 ```bash
-npx skilld
+npx -y skilld
 ```
 
-If you need to re-configure skilld, just run `npx skilld config` to update your agent, model, or preferences.
+If you need to re-configure skilld, just run `npx -y skilld config` to update your agent, model, or preferences.
 
 ### Tips
 

package/dist/_chunks/detect-imports.mjs

@@ -1,13 +1,16 @@
 import { _ as writeSections, b as sanitizeMarkdown, h as readCachedSection, y as repairMarkdown } from "./storage.mjs";
+import { t as yamlEscape } from "./yaml.mjs";
 import { createRequire } from "node:module";
 import { homedir } from "node:os";
-import { dirname, join } from "pathe";
-import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, relative } from "pathe";
+import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { exec, spawn, spawnSync } from "node:child_process";
 import { globby } from "globby";
 import { findDynamicImports, findStaticImports } from "mlly";
 import { createHash } from "node:crypto";
+import { promisify } from "node:util";
 import { readFile } from "node:fs/promises";
+import { parseSync } from "oxc-parser";
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
 	let target = {};
@@ -695,16 +698,24 @@ function generateImportantBlock({ packageName, hasIssues, hasDiscussions, hasRel
 	if (hasDiscussions) rows.push(["Discussions", `\`${skillDir}/.skilld/discussions/\``]);
 	if (hasChangelog) rows.push(["Changelog", `\`${skillDir}/.skilld/pkg/${hasChangelog}\``]);
 	if (hasReleases) rows.push(["Releases", `\`${skillDir}/.skilld/releases/\``]);
-	return `**IMPORTANT:** Use these references
-
-| Resource | Command |
-|----------|---------|
-| Search all | \`Bash 'npx skilld search "<query>" -p ${packageName}'\` |
-${[
+	const table = [
 		"| Resource | Path |",
 		"|----------|------|",
 		...rows.map(([desc, cmd]) => `| ${desc} | ${cmd} |`)
-	].join("\n")}`;
+	].join("\n");
+	return `**IMPORTANT:** Use these references
+
+## Search
+
+Use \`npx -y skilld search\` as your primary research tool — search before manually reading files. Hybrid semantic + keyword search across all indexed docs, issues, and releases.
+
+\`\`\`bash
+npx -y skilld search "<query>" -p ${packageName}
+${hasIssues ? `npx -y skilld search "issues:<query>" -p ${packageName}\n` : ""}${hasReleases ? `npx -y skilld search "releases:<query>" -p ${packageName}\n` : ""}\`\`\`
+
+Filters: \`docs:\`, \`issues:\`, \`releases:\` prefix narrows by source type.
+
+${table}`;
 }
 function buildPreamble(opts) {
 	const { packageName, skillDir, hasIssues, hasDiscussions, hasReleases, hasChangelog, docFiles, docsType = "docs", hasShippedDocs = false, versionContext } = opts;
@@ -803,27 +814,6 @@ function buildAllSectionPrompts(opts) {
 	}
 	return result;
 }
-const NEEDS_QUOTING = /[:"'\\\n\r\t#{}[\],&*!|>%@`]/;
-function yamlEscape(value) {
-	if (!NEEDS_QUOTING.test(value)) return value;
-	return `"${value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")}"`;
-}
-function yamlUnescape(raw) {
-	const trimmed = raw.trim();
-	if (!trimmed) return "";
-	if (trimmed.startsWith("\"") && trimmed.endsWith("\"")) return trimmed.slice(1, -1).replace(/\\n/g, "\n").replace(/\\r/g, "\r").replace(/\\t/g, "	").replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
-	if (trimmed.startsWith("'") && trimmed.endsWith("'")) return trimmed.slice(1, -1);
-	return trimmed;
-}
-function yamlParseKV(line) {
-	const trimmed = line.trim();
-	const colonIdx = trimmed.indexOf(":");
-	if (colonIdx === -1) return null;
-	const key = trimmed.slice(0, colonIdx).trim();
-	const rawValue = trimmed.slice(colonIdx + 1);
-	if (!key) return null;
-	return [key, yamlUnescape(rawValue)];
-}
 function sanitizeName(name) {
 	return name.toLowerCase().replace(/[^a-z0-9._]+/g, "-").replace(/^[.\-]+|[.\-]+$/g, "").slice(0, 255) || "unnamed-skill";
 }
@@ -857,6 +847,32 @@ function installSkillForAgents(skillName, skillContent, options = {}) {
 		paths
 	};
 }
+function linkSkillToAgents(skillName, sharedDir, cwd) {
+	for (const [, agent] of Object.entries(targets)) {
+		const agentSkillsDir = join(cwd, agent.skillsDir);
+		if (!existsSync(join(cwd, agent.skillsDir.split("/")[0]))) continue;
+		const target = join(agentSkillsDir, skillName);
+		let isSymlink = false;
+		let targetExists = false;
+		try {
+			const stat = lstatSync(target);
+			targetExists = true;
+			isSymlink = stat.isSymbolicLink();
+		} catch {}
+		if (targetExists && !isSymlink) continue;
+		if (isSymlink) unlinkSync(target);
+		mkdirSync(agentSkillsDir, { recursive: true });
+		symlinkSync(relative(agentSkillsDir, join(sharedDir, skillName)), target);
+	}
+}
+function unlinkSkillFromAgents(skillName, cwd) {
+	for (const [, agent] of Object.entries(targets)) {
+		const target = join(cwd, agent.skillsDir, skillName);
+		try {
+			if (lstatSync(target).isSymbolicLink()) unlinkSync(target);
+		} catch {}
+	}
+}
 const FILE_PATTERN_MAP = {
 	"vue": ["*.vue"],
 	"svelte": ["*.svelte"],
@@ -1018,12 +1034,12 @@ function generateFrontmatter({ name, version, description: pkgDescription, globs
 	return lines.join("\n");
 }
 function generateSearchBlock(name, hasIssues, hasReleases) {
-	const examples = [`npx skilld search "query" -p ${name}`];
-	if (hasIssues) examples.push(`npx skilld search "issues:error handling" -p ${name}`);
-	if (hasReleases) examples.push(`npx skilld search "releases:deprecated" -p ${name}`);
+	const examples = [`npx -y skilld search "query" -p ${name}`];
+	if (hasIssues) examples.push(`npx -y skilld search "issues:error handling" -p ${name}`);
+	if (hasReleases) examples.push(`npx -y skilld search "releases:deprecated" -p ${name}`);
 	return `## Search
 
-Use \`npx skilld search\` instead of grepping \`.skilld/\` directories — hybrid semantic + keyword search across all indexed docs, issues, and releases.
+Use \`npx -y skilld search\` instead of grepping \`.skilld/\` directories — hybrid semantic + keyword search across all indexed docs, issues, and releases.
 
 \`\`\`bash
 ${examples.join("\n")}
@@ -1300,7 +1316,6 @@ function getModelLabel(id) {
 	return `${targets[config.agentId]?.displayName ?? config.cli} · ${config.name}`;
 }
 async function getAvailableModels() {
-	const { promisify } = await import("node:util");
 	const execAsync = promisify(exec);
 	const agentsWithCli = detectInstalledAgents().filter((id) => targets[id].cli);
 	const cliChecks = await Promise.all(agentsWithCli.map(async (agentId) => {
@@ -1718,7 +1733,6 @@ function extractModuleStrings(node) {
 async function detectNuxtModules(cwd) {
 	const config = await findNuxtConfig(cwd);
 	if (!config) return [];
-	const { parseSync } = await import("oxc-parser");
 	const modules = extractModuleStrings(parseSync(config.path, config.content).program);
 	const seen = /* @__PURE__ */ new Set();
 	const packages = [];
@@ -1832,6 +1846,6 @@ function isNodeBuiltin(pkg) {
 	const base = pkg.startsWith("node:") ? pkg.slice(5) : pkg;
 	return NODE_BUILTINS.has(base.split("/")[0]);
 }
-export { buildSectionPrompt as _, optimizeDocs as a, getAgentVersion as b, computeSkillDirName as c, yamlEscape as d, yamlParseKV as f, buildAllSectionPrompts as g, SECTION_OUTPUT_FILES as h, getModelName as i, installSkillForAgents as l, SECTION_MERGE_ORDER as m, getAvailableModels as n, generateSkillMd as o, yamlUnescape as p, getModelLabel as r, FILE_PATTERN_MAP as s, detectImportedPackages as t, sanitizeName as u, detectInstalledAgents as v, targets as x, detectTargetAgent as y };
+export { detectInstalledAgents as _, optimizeDocs as a, targets as b, computeSkillDirName as c, sanitizeName as d, unlinkSkillFromAgents as f, buildSectionPrompt as g, buildAllSectionPrompts as h, getModelName as i, installSkillForAgents as l, SECTION_OUTPUT_FILES as m, getAvailableModels as n, generateSkillMd as o, SECTION_MERGE_ORDER as p, getModelLabel as r, FILE_PATTERN_MAP as s, detectImportedPackages as t, linkSkillToAgents as u, detectTargetAgent as v, __exportAll as x, getAgentVersion as y };
 
 //# sourceMappingURL=detect-imports.mjs.map