skilld 0.15.0 → 0.15.1

package/README.md

@@ -59,33 +59,21 @@ If you need to re-configure skilld, just run `npx -y skilld config` to update yo
 - **LLM is optional** - Skills work without any LLM, but enhancing with one makes them significantly better.
 - **Multi-agent** - Run `skilld install --agent gemini-cli` to sync skills to another agent. The doc cache is shared.
 
-## FAQ
+## Installation
 
-### Why don't the skills run?
+### Global
 
-Try this in your project/user prompt:
+Install globally to use `skilld` across all projects without `npx`:
 
-```md
-Before modifying code, evaluate each installed skill against the current task.
-For each skill, determine YES/NO relevance and invoke all YES skills before proceeding.
+```bash
+npm install -g skilld
+# or
+pnpm add -g skilld
 ```
 
-### How is this different from Context7?
-
-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.
+Then run `skilld` in any project directory.
 
-### Will I be prompt injected?
-
-Skilld pulls issues from GitHub which could be abused for potential prompt injection.
-
-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 update -b` to your prepare script and they regenerate in the background whenever you install packages.
-
-## Installation
+### Per-Project
 
 If you'd like to install skilld and track the lock file references, add it as a dev dependency:
 
@@ -109,6 +97,32 @@ Add to `package.json` to keep skills fresh on install:
 }
 ```
 
+## FAQ
+
+### Why don't the skills run?
+
+Try this in your project/user prompt:
+
+```md
+Before modifying code, evaluate each installed skill against the current task.
+For each skill, determine YES/NO relevance and invoke all YES skills before proceeding.
+```
+
+### How is this different from Context7?
+
+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 injected?
+
+Skilld pulls issues from GitHub which could be abused for potential prompt injection.
+
+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 update -b` to your prepare script and they regenerate in the background whenever you install packages.
+
 ## CLI Usage
 
 ```bash

package/dist/cli.mjs

@@ -1304,7 +1304,8 @@ async function fetchAndCacheResources(opts) {
 		hasDiscussions: features.discussions && existsSync(discussionsDir),
 		hasReleases: features.releases && existsSync(releasesPath),
 		warnings,
-		repoInfo
+		repoInfo,
+		usedCache: useCache
 	};
 }
 async function indexResources(opts) {
@@ -1527,7 +1528,7 @@ async function selectSkillSections(message = "Generate SKILL.md with LLM") {
 		cancelled: false
 	};
 }
-async function selectLlmConfig(presetModel, message) {
+async function selectLlmConfig(presetModel, message, usedCache) {
 	if (presetModel) return {
 		model: presetModel,
 		sections: DEFAULT_SECTIONS
@@ -1535,6 +1536,10 @@ async function selectLlmConfig(presetModel, message) {
 	if (!isInteractive()) return null;
 	const defaultModel = await selectModel(true);
 	if (!defaultModel) return null;
+	if (usedCache) return {
+		model: defaultModel,
+		sections: DEFAULT_SECTIONS
+	};
 	const defaultModelName = getModelName(defaultModel);
 	const choice = await p.select({
 		message: "Generate enhanced SKILL.md?",
@@ -1943,8 +1948,9 @@ async function syncPackagesParallel(config) {
 	for (const [, data] of skillData) for (const w of data.warnings) p.log.warn(`\x1B[33m${w}\x1B[0m`);
 	if (errors.length > 0) for (const { pkg, reason } of errors) p.log.error(`  ${pkg}: ${reason}`);
 	const globalConfig = readConfig();
+	const allCached = successfulPkgs.every((pkg) => skillData.get(pkg)?.usedCache);
 	if (successfulPkgs.length > 0 && !globalConfig.skipLlm && !(config.yes && !config.model)) {
-		const llmConfig = await selectLlmConfig(config.model);
+		const llmConfig = await selectLlmConfig(config.model, void 0, allCached);
 		if (llmConfig) {
 			p.log.step(getModelLabel(llmConfig.model));
 			for (const pkg of successfulPkgs) states.set(pkg, {
@@ -2089,7 +2095,8 @@ async function syncBaseSkill(packageSpec, config, cwd, update) {
 		relatedSkills,
 		packages: allPackages.length > 1 ? allPackages : void 0,
 		warnings: resources.warnings,
-		features
+		features,
+		usedCache: resources.usedCache
 	};
 }
 async function enhanceWithLLM(packageName, data, config, cwd, update, sections, customPrompt) {
@@ -2470,7 +2477,7 @@ async function syncSinglePackage(packageSpec, config) {
 	if (resources.hasIssues) resParts.push("issues");
 	if (resources.hasDiscussions) resParts.push("discussions");
 	if (resources.hasReleases) resParts.push("releases");
-	resSpin.stop(`Fetched ${resParts.length > 0 ? resParts.join(", ") : "resources"}`);
+	resSpin.stop(resources.usedCache ? `Loaded ${resParts.length > 0 ? resParts.join(", ") : "resources"} (cached)` : `Fetched ${resParts.length > 0 ? resParts.join(", ") : "resources"}`);
 	for (const w of resources.warnings) p.log.warn(`\x1B[33m${w}\x1B[0m`);
 	linkAllReferences(skillDir, packageName, cwd, version, resources.docsType, void 0, features, resources.repoInfo);
 	if (features.search) {
@@ -2526,7 +2533,7 @@ async function syncSinglePackage(packageSpec, config) {
 	writeFileSync(join(skillDir, "SKILL.md"), baseSkillMd);
 	p.log.success(config.mode === "update" ? `Updated skill: ${relative(cwd, skillDir)}` : `Created base skill: ${relative(cwd, skillDir)}`);
 	if (!readConfig().skipLlm && (!config.yes || config.model)) {
-		const llmConfig = await selectLlmConfig(config.model);
+		const llmConfig = await selectLlmConfig(config.model, void 0, resources.usedCache);
 		if (llmConfig) {
 			p.log.step(getModelLabel(llmConfig.model));
 			await enhanceSkillWithLLM({