skilld 0.8.1 → 0.9.0

package/README.md

@@ -159,6 +159,20 @@ skilld config
 | `skilld uninstall`      | Remove all skilld data |
 | `skilld cache`          | Cache management (clean expired LLM cache entries) |
 
+### Eject
+
+Export a skill as a portable, self-contained directory with references copied as real files instead of symlinks. Useful for sharing skills via git repos.
+
+```bash
+# Eject to the default skill directory
+skilld add vue --eject
+
+# Eject to a custom path
+skilld add vue --eject ./skills/vue/
+```
+
+The ejected skill contains `SKILL.md` plus a `references/` directory with docs, issues, and releases as real files. Share it via `skilld add owner/repo` — consumers get fully functional skills with no LLM cost.
+
 ### CLI Options
 
 | Option | Alias | Default | Description |
@@ -168,6 +182,7 @@ skilld config
 | `--yes` | `-y` | `false` | Skip prompts, use defaults |
 | `--force` | `-f` | `false` | Ignore all caches, re-fetch docs and regenerate |
 | `--model`      | `-m` | config default | LLM model for skill generation (sonnet, haiku, opus, etc.) |
+| `--eject`      | `-e` |                | Eject skill with references as real files (optional path override) |
 | `--debug`      |      | `false`        | Save raw LLM output to logs/ for each section |
 
 ## The Landscape
@@ -192,6 +207,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/chunk.mjs

@@ -0,0 +1,13 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+export { __require as n, __exportAll as t };

package/dist/_chunks/config.mjs

@@ -0,0 +1,25 @@
+import { homedir } from "node:os";
+import { join, resolve } from "pathe";
+const VALID_PKG_NAME = /^(?:@[a-z0-9][-a-z0-9._]*\/)?[a-z0-9][-a-z0-9._]*$/;
+const VALID_VERSION = /^[a-z0-9][-\w.+]*$/i;
+function getVersionKey(version) {
+	return version;
+}
+function getCacheKey(name, version) {
+	return `${name}@${getVersionKey(version)}`;
+}
+function getCacheDir(name, version) {
+	if (!VALID_PKG_NAME.test(name)) throw new Error(`Invalid package name: ${name}`);
+	if (!VALID_VERSION.test(version)) throw new Error(`Invalid version: ${version}`);
+	const dir = resolve(REFERENCES_DIR, getCacheKey(name, version));
+	if (!dir.startsWith(REFERENCES_DIR)) throw new Error(`Path traversal detected: ${dir}`);
+	return dir;
+}
+const CACHE_DIR = join(homedir(), ".skilld");
+const REFERENCES_DIR = join(CACHE_DIR, "references");
+function getPackageDbPath(name, version) {
+	return join(REFERENCES_DIR, getCacheKey(name, version), "search.db");
+}
+export { getCacheKey as a, getCacheDir as i, REFERENCES_DIR as n, getVersionKey as o, getPackageDbPath as r, CACHE_DIR as t };
+
+//# sourceMappingURL=config.mjs.map

package/dist/_chunks/config.mjs.map

@@ -0,0 +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.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"}