skilld 0.8.2 → 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

package/dist/_chunks/detect-imports.mjs

@@ -997,7 +997,7 @@ function unlinkSkillFromAgents(skillName, cwd) {
 }
 function generateSkillMd(opts) {
 	const header = generatePackageHeader(opts);
-	const search = opts.features?.search !== false ? generateSearchBlock(opts.name, opts.hasIssues, opts.hasReleases) : "";
+	const search = !opts.eject && opts.features?.search !== false ? generateSearchBlock(opts.name, opts.hasIssues, opts.hasReleases) : "";
 	const content = opts.body ? search ? `${header}\n\n${search}\n\n${opts.body}` : `${header}\n\n${opts.body}` : search ? `${header}\n\n${search}` : header;
 	const footer = generateFooter(opts.relatedSkills);
 	return sanitizeMarkdown(repairMarkdown(`${generateFrontmatter(opts)}${content}\n${footer}`));
@@ -1016,7 +1016,7 @@ function formatRelativeDate(isoDate) {
 	const years = Math.floor(diffDays / 365);
 	return `${years} year${years === 1 ? "" : "s"} ago`;
 }
-function generatePackageHeader({ name, description, version, releasedAt, dependencies, distTags, repoUrl, hasIssues, hasDiscussions, hasReleases, pkgFiles, packages }) {
+function generatePackageHeader({ name, description, version, releasedAt, dependencies, distTags, repoUrl, hasIssues, hasDiscussions, hasReleases, pkgFiles, packages, eject }) {
 	let title = `# ${name}`;
 	if (repoUrl) {
 		const url = repoUrl.startsWith("http") ? repoUrl : `https://github.com/${repoUrl}`;
@@ -1041,16 +1041,19 @@ function generatePackageHeader({ name, description, version, releasedAt, depende
 		lines.push(`**Tags:** ${tags}`);
 	}
 	lines.push("");
+	const refBase = eject ? "./references" : "./.skilld";
 	const refs = [];
-	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 (!eject) {
+		refs.push(`[package.json](${refBase}/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}](${refBase}/pkg-${shortName}/package.json)`);
+		}
+		if (pkgFiles?.includes("README.md")) refs.push(`[README](${refBase}/pkg/README.md) — setup, basic usage`);
 	}
-	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 (hasIssues) refs.push(`[GitHub Issues](${refBase}/issues/_INDEX.md) — bugs, workarounds, edge cases`);
+	if (hasDiscussions) refs.push(`[GitHub Discussions](${refBase}/discussions/_INDEX.md) — Q&A, patterns, recipes`);
+	if (hasReleases) refs.push(`[Releases](${refBase}/releases/_INDEX.md) — changelog, breaking changes, new APIs`);
 	if (refs.length > 0) lines.push(`**References:** ${refs.join(" • ")}`);
 	return lines.join("\n");
 }