@yolk-sdk/skillset 0.0.1-canary.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yolk SDK contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @yolk-sdk/skillset
+
+Domain-free parsing and catalog primitives for portable skills and slash commands.
+
+## Install
+
+```bash
+pnpm add @yolk-sdk/skillset@canary effect
+```
+
+Canary APIs are unstable. Keep all `@yolk-sdk/*` packages on the same version.
+
+## Subpaths
+
+| Subpath | Purpose |
+| --- | --- |
+| `@yolk-sdk/skillset` | Skill markdown, command markdown, manifest, and merge APIs |
+
+## Imports
+
+```ts
+import {
+  formatAvailableSkills,
+  mergeSkillsets,
+  parseCommandMarkdown,
+  parseSkillMarkdown,
+  renderCommand,
+  validateSkillsetName
+} from '@yolk-sdk/skillset'
+```
+
+## Skill markdown
+
+```md
+---
+name: web-search
+description: Search the web. Use when current public web context is needed.
+---
+
+# Web Search
+
+Instructions...
+```
+
+```ts
+const skill = parseSkillMarkdown({ path: 'web-search/SKILL.md', content })
+```
+
+## Command markdown
+
+```md
+---
+description: Run a guided package release
+---
+
+First load the package-release skill.
+
+<user-request>
+$ARGUMENTS
+</user-request>
+```
+
+```ts
+const command = parseCommandMarkdown({ path: 'package-release.md', content })
+const prompt = renderCommand(command, 'publish first canary')
+```
+
+## Merge model
+
+`mergeSkillsets` combines multiple host-provided sources deterministically. Hosts decide source priority and policy.
+
+## Host responsibilities
+
+- Load skills/commands from filesystem, DB, KV, bundles, or remote sources.
+- Enforce policy, permissions, runtime tool wiring, and UI.
+- Decide when to inject `formatAvailableSkills` into model context.
+
+## Boundaries
+
+- No filesystem, Next.js, Cloudflare, DB, auth, provider SDKs, or tool execution.
+- Package owns schemas, markdown parsing, command rendering, manifests, and merge helpers only.

package/dist/command.d.mts

@@ -0,0 +1,56 @@
+import { SkillsetError } from "./errors.mjs";
+import { Effect } from "effect";
+import * as Schema from "effect/Schema";
+
+//#region src/command.d.ts
+declare const CommandArgument: Schema.Struct<{
+  readonly name: Schema.String;
+  readonly required: Schema.Boolean;
+  readonly description: Schema.optional<Schema.String>;
+}>;
+type CommandArgument = typeof CommandArgument.Type;
+declare const CommandAccess: Schema.Union<readonly [Schema.Literal<"read">, Schema.Literal<"write">, Schema.Literal<"destructive">]>;
+type CommandAccess = typeof CommandAccess.Type;
+declare const CommandInfo: Schema.Struct<{
+  readonly name: Schema.String;
+  readonly description: Schema.optional<Schema.String>;
+  readonly template: Schema.String;
+  readonly hints: Schema.$Array<Schema.String>;
+  readonly arguments: Schema.optional<Schema.$Array<Schema.Struct<{
+    readonly name: Schema.String;
+    readonly required: Schema.Boolean;
+    readonly description: Schema.optional<Schema.String>;
+  }>>>;
+  readonly access: Schema.optional<Schema.Union<readonly [Schema.Literal<"read">, Schema.Literal<"write">, Schema.Literal<"destructive">]>>;
+  readonly fileRefs: Schema.optional<Schema.Boolean>;
+  readonly location: Schema.optional<Schema.String>;
+  readonly source: Schema.optional<Schema.String>;
+}>;
+type CommandInfo = typeof CommandInfo.Type;
+type ParseCommandInput = {
+  readonly markdown: string;
+  readonly name: string;
+  readonly location?: string;
+  readonly source?: string;
+};
+declare const commandHints: (template: string) => string[];
+declare const parseCommandMarkdown: (input: ParseCommandInput) => Effect.Effect<{
+  location: string | undefined;
+  source: string | undefined;
+  fileRefs?: boolean | undefined;
+  access?: "read" | "write" | "destructive" | undefined;
+  arguments?: readonly {
+    readonly required: boolean;
+    readonly name: string;
+    readonly description?: string | undefined;
+  }[] | undefined;
+  name: string;
+  description: string | undefined;
+  template: string;
+  hints: string[];
+}, SkillsetError, never>;
+declare const parseCommandArguments: (input: string) => string[];
+declare const renderCommand: (command: CommandInfo, argumentsText: string) => string;
+//#endregion
+export { CommandAccess, CommandArgument, CommandInfo, ParseCommandInput, commandHints, parseCommandArguments, parseCommandMarkdown, renderCommand };
+//# sourceMappingURL=command.d.mts.map

package/dist/command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.mts","names":[],"sources":["../src/command.ts"],"mappings":";;;;;cAMa,eAAA,EAAe,MAAA,CAAA,MAAA;EAAA;;;;KAKhB,eAAA,UAAyB,eAAA,CAAgB,IAAI;AAAA,cAE5C,aAAA,EAAa,MAAA,CAAA,KAAA,WAAA,MAAA,CAAA,OAAA,UAAA,MAAA,CAAA,OAAA,WAAA,MAAA,CAAA,OAAA;AAAA,KAKd,aAAA,UAAuB,aAAA,CAAc,IAAI;AAAA,cAExC,WAAA,EAAW,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;KAWZ,WAAA,UAAqB,WAAA,CAAY,IAAI;AAAA,KAErC,iBAAA;EAAA,SACD,QAAA;EAAA,SACA,IAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;AAAA,cAsEE,YAAA,GAAgB,QAAgB;AAAA,cAUhC,oBAAA,GAAwB,KAAA,EAAO,iBAAA,KAAiB,MAAA,CAAA,MAAA;;;;;;;;;;;;;;;cAsBhD,qBAAA,GAAyB,KAAa;AAAA,cAkCtC,aAAA,GAAiB,OAAA,EAAS,WAAW,EAAE,aAAA"}

package/dist/command.mjs

@@ -0,0 +1,135 @@
+import { SkillsetError } from "./errors.mjs";
+import { parseMarkdownDocument } from "./markdown.mjs";
+import { validateSkillsetName } from "./name.mjs";
+import { Effect } from "effect";
+import * as Schema from "effect/Schema";
+//#region src/command.ts
+const CommandArgument = Schema.Struct({
+	name: Schema.String,
+	required: Schema.Boolean,
+	description: Schema.optional(Schema.String)
+});
+const CommandAccess = Schema.Union([
+	Schema.Literal("read"),
+	Schema.Literal("write"),
+	Schema.Literal("destructive")
+]);
+const CommandInfo = Schema.Struct({
+	name: Schema.String,
+	description: Schema.optional(Schema.String),
+	template: Schema.String,
+	hints: Schema.Array(Schema.String),
+	arguments: Schema.optional(Schema.Array(CommandArgument)),
+	access: Schema.optional(CommandAccess),
+	fileRefs: Schema.optional(Schema.Boolean),
+	location: Schema.optional(Schema.String),
+	source: Schema.optional(Schema.String)
+});
+const numberedPlaceholderPattern = /\$(\d+)/g;
+const parseCommandAccess = (value) => {
+	if (value === void 0 || value.length === 0) return Effect.succeed(void 0);
+	switch (value) {
+		case "read":
+		case "write":
+		case "destructive": return Effect.succeed(value);
+		default: return Effect.fail(new SkillsetError({
+			cause: "frontmatter_invalid",
+			message: "Command access must be read, write, or destructive"
+		}));
+	}
+};
+const parseBooleanField = (field, value) => {
+	if (value === void 0 || value.length === 0) return Effect.succeed(void 0);
+	switch (value) {
+		case "true": return Effect.succeed(true);
+		case "false": return Effect.succeed(false);
+		default: return Effect.fail(new SkillsetError({
+			cause: "frontmatter_invalid",
+			message: `${field} must be true or false`
+		}));
+	}
+};
+const parseArgumentToken = (token) => {
+	const trimmed = token.trim();
+	if (trimmed.length === 0) return;
+	const required = !trimmed.endsWith("?");
+	const name = required ? trimmed : trimmed.slice(0, -1);
+	return name.length === 0 ? void 0 : {
+		name,
+		required
+	};
+};
+const parseCommandArgumentsField = (value) => {
+	if (value === void 0 || value.length === 0) return [];
+	return value.split(",").flatMap((token) => {
+		const argument = parseArgumentToken(token);
+		return argument === void 0 ? [] : [argument];
+	});
+};
+const commandHints = (template) => {
+	const numbered = Array.from(template.matchAll(numberedPlaceholderPattern), (match) => `$${match[1]}`);
+	const unique = [...new Set(numbered)].sort((a, b) => Number(a.slice(1)) - Number(b.slice(1)));
+	return template.includes("$ARGUMENTS") ? [...unique, "$ARGUMENTS"] : unique;
+};
+const parseCommandMarkdown = (input) => Effect.gen(function* () {
+	const name = yield* validateSkillsetName(input.name);
+	const document = yield* parseMarkdownDocument(input.markdown);
+	const description = document.data.description;
+	const access = yield* parseCommandAccess(document.data.access);
+	const fileRefs = yield* parseBooleanField("fileRefs", document.data.fileRefs);
+	const commandArguments = parseCommandArgumentsField(document.data.arguments);
+	return {
+		name,
+		description: description === void 0 || description.length === 0 ? void 0 : description,
+		template: document.content,
+		hints: commandHints(document.content),
+		...commandArguments.length === 0 ? {} : { arguments: commandArguments },
+		...access === void 0 ? {} : { access },
+		...fileRefs === void 0 ? {} : { fileRefs },
+		location: input.location,
+		source: input.source
+	};
+});
+const parseCommandArguments = (input) => {
+	const result = [];
+	let current = "";
+	let quote;
+	for (const char of input.trim()) {
+		if (char === "'" && quote !== "double") {
+			quote = quote === "single" ? void 0 : "single";
+			continue;
+		}
+		if (char === "\"" && quote !== "single") {
+			quote = quote === "double" ? void 0 : "double";
+			continue;
+		}
+		if (/\s/.test(char) && quote === void 0) {
+			if (current.length > 0) {
+				result.push(current);
+				current = "";
+			}
+			continue;
+		}
+		current = `${current}${char}`;
+	}
+	if (current.length > 0) result.push(current);
+	return result;
+};
+const renderCommand = (command, argumentsText) => {
+	const args = parseCommandArguments(argumentsText);
+	const placeholders = Array.from(command.template.matchAll(numberedPlaceholderPattern), (match) => Number(match[1]));
+	const lastPlaceholder = placeholders.reduce((max, value) => Math.max(max, value), 0);
+	const withNumbered = command.template.replace(numberedPlaceholderPattern, (_, index) => {
+		const position = Number(index);
+		const argIndex = position - 1;
+		if (argIndex >= args.length) return "";
+		return position === lastPlaceholder ? args.slice(argIndex).join(" ") : args[argIndex] ?? "";
+	});
+	const usesArguments = command.template.includes("$ARGUMENTS");
+	const rendered = withNumbered.replaceAll("$ARGUMENTS", argumentsText);
+	return placeholders.length === 0 && !usesArguments && argumentsText.trim().length > 0 ? `${rendered}\n\n${argumentsText}`.trim() : rendered.trim();
+};
+//#endregion
+export { CommandAccess, CommandArgument, CommandInfo, commandHints, parseCommandArguments, parseCommandMarkdown, renderCommand };
+
+//# sourceMappingURL=command.mjs.map

package/dist/command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.mjs","names":[],"sources":["../src/command.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport { SkillsetError } from './errors.ts'\nimport { parseMarkdownDocument } from './markdown.ts'\nimport { validateSkillsetName } from './name.ts'\n\nexport const CommandArgument = Schema.Struct({\n  name: Schema.String,\n  required: Schema.Boolean,\n  description: Schema.optional(Schema.String)\n})\nexport type CommandArgument = typeof CommandArgument.Type\n\nexport const CommandAccess = Schema.Union([\n  Schema.Literal('read'),\n  Schema.Literal('write'),\n  Schema.Literal('destructive')\n])\nexport type CommandAccess = typeof CommandAccess.Type\n\nexport const CommandInfo = Schema.Struct({\n  name: Schema.String,\n  description: Schema.optional(Schema.String),\n  template: Schema.String,\n  hints: Schema.Array(Schema.String),\n  arguments: Schema.optional(Schema.Array(CommandArgument)),\n  access: Schema.optional(CommandAccess),\n  fileRefs: Schema.optional(Schema.Boolean),\n  location: Schema.optional(Schema.String),\n  source: Schema.optional(Schema.String)\n})\nexport type CommandInfo = typeof CommandInfo.Type\n\nexport type ParseCommandInput = {\n  readonly markdown: string\n  readonly name: string\n  readonly location?: string\n  readonly source?: string\n}\n\nconst numberedPlaceholderPattern = /\\$(\\d+)/g\n\nconst parseCommandAccess = (value: string | undefined) => {\n  if (value === undefined || value.length === 0) {\n    return Effect.succeed(undefined)\n  }\n\n  switch (value) {\n    case 'read':\n    case 'write':\n    case 'destructive':\n      return Effect.succeed(value)\n    default:\n      return Effect.fail(\n        new SkillsetError({\n          cause: 'frontmatter_invalid',\n          message: 'Command access must be read, write, or destructive'\n        })\n      )\n  }\n}\n\nconst parseBooleanField = (field: string, value: string | undefined) => {\n  if (value === undefined || value.length === 0) {\n    return Effect.succeed(undefined)\n  }\n\n  switch (value) {\n    case 'true':\n      return Effect.succeed(true)\n    case 'false':\n      return Effect.succeed(false)\n    default:\n      return Effect.fail(\n        new SkillsetError({\n          cause: 'frontmatter_invalid',\n          message: `${field} must be true or false`\n        })\n      )\n  }\n}\n\nconst parseArgumentToken = (token: string) => {\n  const trimmed = token.trim()\n\n  if (trimmed.length === 0) {\n    return undefined\n  }\n\n  const required = !trimmed.endsWith('?')\n  const name = required ? trimmed : trimmed.slice(0, -1)\n\n  return name.length === 0 ? undefined : { name, required }\n}\n\nconst parseCommandArgumentsField = (value: string | undefined): ReadonlyArray<CommandArgument> => {\n  if (value === undefined || value.length === 0) {\n    return []\n  }\n\n  return value.split(',').flatMap(token => {\n    const argument = parseArgumentToken(token)\n\n    return argument === undefined ? [] : [argument]\n  })\n}\n\nexport const commandHints = (template: string) => {\n  const numbered = Array.from(\n    template.matchAll(numberedPlaceholderPattern),\n    match => `$${match[1]}`\n  )\n  const unique = [...new Set(numbered)].sort((a, b) => Number(a.slice(1)) - Number(b.slice(1)))\n\n  return template.includes('$ARGUMENTS') ? [...unique, '$ARGUMENTS'] : unique\n}\n\nexport const parseCommandMarkdown = (input: ParseCommandInput) =>\n  Effect.gen(function* () {\n    const name = yield* validateSkillsetName(input.name)\n    const document = yield* parseMarkdownDocument(input.markdown)\n    const description = document.data.description\n    const access = yield* parseCommandAccess(document.data.access)\n    const fileRefs = yield* parseBooleanField('fileRefs', document.data.fileRefs)\n    const commandArguments = parseCommandArgumentsField(document.data.arguments)\n\n    return {\n      name,\n      description: description === undefined || description.length === 0 ? undefined : description,\n      template: document.content,\n      hints: commandHints(document.content),\n      ...(commandArguments.length === 0 ? {} : { arguments: commandArguments }),\n      ...(access === undefined ? {} : { access }),\n      ...(fileRefs === undefined ? {} : { fileRefs }),\n      location: input.location,\n      source: input.source\n    }\n  })\n\nexport const parseCommandArguments = (input: string) => {\n  const result: string[] = []\n  let current = ''\n  let quote: 'single' | 'double' | undefined\n\n  for (const char of input.trim()) {\n    if (char === \"'\" && quote !== 'double') {\n      quote = quote === 'single' ? undefined : 'single'\n      continue\n    }\n\n    if (char === '\"' && quote !== 'single') {\n      quote = quote === 'double' ? undefined : 'double'\n      continue\n    }\n\n    if (/\\s/.test(char) && quote === undefined) {\n      if (current.length > 0) {\n        result.push(current)\n        current = ''\n      }\n      continue\n    }\n\n    current = `${current}${char}`\n  }\n\n  if (current.length > 0) {\n    result.push(current)\n  }\n\n  return result\n}\n\nexport const renderCommand = (command: CommandInfo, argumentsText: string) => {\n  const args = parseCommandArguments(argumentsText)\n  const placeholders = Array.from(command.template.matchAll(numberedPlaceholderPattern), match =>\n    Number(match[1])\n  )\n  const lastPlaceholder = placeholders.reduce((max, value) => Math.max(max, value), 0)\n  const withNumbered = command.template.replace(numberedPlaceholderPattern, (_, index: string) => {\n    const position = Number(index)\n    const argIndex = position - 1\n\n    if (argIndex >= args.length) {\n      return ''\n    }\n\n    return position === lastPlaceholder ? args.slice(argIndex).join(' ') : (args[argIndex] ?? '')\n  })\n  const usesArguments = command.template.includes('$ARGUMENTS')\n  const rendered = withNumbered.replaceAll('$ARGUMENTS', argumentsText)\n\n  return placeholders.length === 0 && !usesArguments && argumentsText.trim().length > 0\n    ? `${rendered}\\n\\n${argumentsText}`.trim()\n    : rendered.trim()\n}\n"],"mappings":"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"}

package/dist/errors.d.mts

@@ -0,0 +1,13 @@
+import * as Schema from "effect/Schema";
+
+//#region src/errors.d.ts
+declare const SkillsetErrorCause: Schema.Literals<readonly ["duplicate_entry", "frontmatter_field_missing", "frontmatter_invalid", "frontmatter_missing", "invalid_name", "name_mismatch"]>;
+type SkillsetErrorCause = typeof SkillsetErrorCause.Type;
+declare const SkillsetError_base: Schema.Class<SkillsetError, Schema.TaggedStruct<"SkillsetError", {
+  readonly cause: Schema.Literals<readonly ["duplicate_entry", "frontmatter_field_missing", "frontmatter_invalid", "frontmatter_missing", "invalid_name", "name_mismatch"]>;
+  readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+declare class SkillsetError extends SkillsetError_base {}
+//#endregion
+export { SkillsetError, SkillsetErrorCause };
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";;;cAEa,kBAAA,EAAkB,MAAA,CAAA,QAAA;AAAA,KAQnB,kBAAA,UAA4B,kBAAA,CAAmB,IAAI;AAAA,cAAA,kBAAA;;;;cAElD,aAAA,SAAsB,kBAGjC"}

package/dist/errors.mjs

@@ -0,0 +1,18 @@
+import * as Schema from "effect/Schema";
+//#region src/errors.ts
+const SkillsetErrorCause = Schema.Literals([
+	"duplicate_entry",
+	"frontmatter_field_missing",
+	"frontmatter_invalid",
+	"frontmatter_missing",
+	"invalid_name",
+	"name_mismatch"
+]);
+var SkillsetError = class extends Schema.TaggedErrorClass()("SkillsetError", {
+	cause: SkillsetErrorCause,
+	message: Schema.String
+}) {};
+//#endregion
+export { SkillsetError, SkillsetErrorCause };
+
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\n\nexport const SkillsetErrorCause = Schema.Literals([\n  'duplicate_entry',\n  'frontmatter_field_missing',\n  'frontmatter_invalid',\n  'frontmatter_missing',\n  'invalid_name',\n  'name_mismatch'\n])\nexport type SkillsetErrorCause = typeof SkillsetErrorCause.Type\n\nexport class SkillsetError extends Schema.TaggedErrorClass<SkillsetError>()('SkillsetError', {\n  cause: SkillsetErrorCause,\n  message: Schema.String\n}) {}\n"],"mappings":";;AAEA,MAAa,qBAAqB,OAAO,SAAS;CAChD;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAGD,IAAa,gBAAb,cAAmC,OAAO,iBAAgC,EAAE,iBAAiB;CAC3F,OAAO;CACP,SAAS,OAAO;AAClB,CAAC,EAAE,CAAC"}

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+import { SkillsetError, SkillsetErrorCause } from "./errors.mjs";
+import { CommandAccess, CommandArgument, CommandInfo, ParseCommandInput, commandHints, parseCommandArguments, parseCommandMarkdown, renderCommand } from "./command.mjs";
+import { isValidSkillsetName, validateDirectoryName, validateSkillsetName } from "./name.mjs";
+import { MarkdownDocument, parseMarkdownDocument } from "./markdown.mjs";
+import { ParseSkillInput, SkillInfo, formatAvailableSkills, parseSkillMarkdown } from "./skill.mjs";
+import { SkillsetManifest, emptySkillsetManifest } from "./manifest.mjs";
+import { MergedSkillset, SkillsetSource, mergeSkillsets } from "./merge.mjs";
+export { CommandAccess, CommandArgument, CommandInfo, type MarkdownDocument, type MergedSkillset, type ParseCommandInput, type ParseSkillInput, SkillInfo, SkillsetError, SkillsetErrorCause, SkillsetManifest, type SkillsetSource, commandHints, emptySkillsetManifest, formatAvailableSkills, isValidSkillsetName, mergeSkillsets, parseCommandArguments, parseCommandMarkdown, parseMarkdownDocument, parseSkillMarkdown, renderCommand, validateDirectoryName, validateSkillsetName };

package/dist/index.mjs

@@ -0,0 +1,8 @@
+import { SkillsetError, SkillsetErrorCause } from "./errors.mjs";
+import { parseMarkdownDocument } from "./markdown.mjs";
+import { isValidSkillsetName, validateDirectoryName, validateSkillsetName } from "./name.mjs";
+import { CommandAccess, CommandArgument, CommandInfo, commandHints, parseCommandArguments, parseCommandMarkdown, renderCommand } from "./command.mjs";
+import { SkillInfo, formatAvailableSkills, parseSkillMarkdown } from "./skill.mjs";
+import { SkillsetManifest, emptySkillsetManifest } from "./manifest.mjs";
+import { mergeSkillsets } from "./merge.mjs";
+export { CommandAccess, CommandArgument, CommandInfo, SkillInfo, SkillsetError, SkillsetErrorCause, SkillsetManifest, commandHints, emptySkillsetManifest, formatAvailableSkills, isValidSkillsetName, mergeSkillsets, parseCommandArguments, parseCommandMarkdown, parseMarkdownDocument, parseSkillMarkdown, renderCommand, validateDirectoryName, validateSkillsetName };

package/dist/manifest.d.mts

@@ -0,0 +1,33 @@
+import * as Schema from "effect/Schema";
+
+//#region src/manifest.d.ts
+declare const SkillsetManifest: Schema.Struct<{
+  readonly version: Schema.Literal<1>;
+  readonly skills: Schema.$Array<Schema.Struct<{
+    readonly name: Schema.String;
+    readonly description: Schema.String;
+    readonly location: Schema.String;
+    readonly content: Schema.String;
+    readonly source: Schema.optional<Schema.String>;
+  }>>;
+  readonly commands: Schema.$Array<Schema.Struct<{
+    readonly name: Schema.String;
+    readonly description: Schema.optional<Schema.String>;
+    readonly template: Schema.String;
+    readonly hints: Schema.$Array<Schema.String>;
+    readonly arguments: Schema.optional<Schema.$Array<Schema.Struct<{
+      readonly name: Schema.String;
+      readonly required: Schema.Boolean;
+      readonly description: Schema.optional<Schema.String>;
+    }>>>;
+    readonly access: Schema.optional<Schema.Union<readonly [Schema.Literal<"read">, Schema.Literal<"write">, Schema.Literal<"destructive">]>>;
+    readonly fileRefs: Schema.optional<Schema.Boolean>;
+    readonly location: Schema.optional<Schema.String>;
+    readonly source: Schema.optional<Schema.String>;
+  }>>;
+}>;
+type SkillsetManifest = typeof SkillsetManifest.Type;
+declare const emptySkillsetManifest: SkillsetManifest;
+//#endregion
+export { SkillsetManifest, emptySkillsetManifest };
+//# sourceMappingURL=manifest.d.mts.map

package/dist/manifest.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.mts","names":[],"sources":["../src/manifest.ts"],"mappings":";;;cAIa,gBAAA,EAAgB,MAAA,CAAA,MAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;KAKjB,gBAAA,UAA0B,gBAAA,CAAiB,IAAI;AAAA,cAE9C,qBAAA,EAAuB,gBAInC"}

package/dist/manifest.mjs

@@ -0,0 +1,18 @@
+import { CommandInfo } from "./command.mjs";
+import { SkillInfo } from "./skill.mjs";
+import * as Schema from "effect/Schema";
+//#region src/manifest.ts
+const SkillsetManifest = Schema.Struct({
+	version: Schema.Literal(1),
+	skills: Schema.Array(SkillInfo),
+	commands: Schema.Array(CommandInfo)
+});
+const emptySkillsetManifest = {
+	version: 1,
+	skills: [],
+	commands: []
+};
+//#endregion
+export { SkillsetManifest, emptySkillsetManifest };
+
+//# sourceMappingURL=manifest.mjs.map

package/dist/manifest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.mjs","names":[],"sources":["../src/manifest.ts"],"sourcesContent":["import * as Schema from 'effect/Schema'\nimport { CommandInfo } from './command.ts'\nimport { SkillInfo } from './skill.ts'\n\nexport const SkillsetManifest = Schema.Struct({\n  version: Schema.Literal(1),\n  skills: Schema.Array(SkillInfo),\n  commands: Schema.Array(CommandInfo)\n})\nexport type SkillsetManifest = typeof SkillsetManifest.Type\n\nexport const emptySkillsetManifest: SkillsetManifest = {\n  version: 1,\n  skills: [],\n  commands: []\n}\n"],"mappings":";;;;AAIA,MAAa,mBAAmB,OAAO,OAAO;CAC5C,SAAS,OAAO,QAAQ,CAAC;CACzB,QAAQ,OAAO,MAAM,SAAS;CAC9B,UAAU,OAAO,MAAM,WAAW;AACpC,CAAC;AAGD,MAAa,wBAA0C;CACrD,SAAS;CACT,QAAQ,CAAC;CACT,UAAU,CAAC;AACb"}

package/dist/markdown.d.mts

@@ -0,0 +1,17 @@
+import { SkillsetError } from "./errors.mjs";
+import { Effect } from "effect";
+
+//#region src/markdown.d.ts
+type MarkdownDocument = {
+  readonly data: Readonly<Record<string, string>>;
+  readonly content: string;
+};
+declare const parseMarkdownDocument: (markdown: string) => Effect.Effect<{
+  data: {
+    [k: string]: string;
+  };
+  content: string;
+}, SkillsetError, never>;
+//#endregion
+export { MarkdownDocument, parseMarkdownDocument };
+//# sourceMappingURL=markdown.d.mts.map

package/dist/markdown.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.mts","names":[],"sources":["../src/markdown.ts"],"mappings":";;;;KAGY,gBAAA;EAAA,SACD,IAAA,EAAM,QAAQ,CAAC,MAAA;EAAA,SACf,OAAA;AAAA;AAAA,cAoBE,qBAAA,GAAyB,QAAA,aAAgB,MAAA,CAAA,MAAA;;;;;GAgDlD,aAAA"}

package/dist/markdown.mjs

@@ -0,0 +1,41 @@
+import { SkillsetError } from "./errors.mjs";
+import { Effect } from "effect";
+//#region src/markdown.ts
+const frontmatterStart = "---\n";
+const frontmatterEndIndex = (markdown) => markdown.indexOf("\n---", 4);
+const parseFrontmatterLine = (line) => {
+	const separatorIndex = line.indexOf(":");
+	if (separatorIndex === -1) return;
+	const key = line.slice(0, separatorIndex).trim();
+	const value = line.slice(separatorIndex + 1).trim();
+	return key.length === 0 ? void 0 : {
+		key,
+		value
+	};
+};
+const parseMarkdownDocument = (markdown) => Effect.gen(function* () {
+	if (!markdown.startsWith(frontmatterStart)) return yield* Effect.fail(new SkillsetError({
+		cause: "frontmatter_missing",
+		message: "Markdown must start with YAML frontmatter"
+	}));
+	const endIndex = frontmatterEndIndex(markdown);
+	if (endIndex === -1) return yield* Effect.fail(new SkillsetError({
+		cause: "frontmatter_invalid",
+		message: "Markdown frontmatter is missing closing delimiter"
+	}));
+	const entries = markdown.slice(4, endIndex).split("\n").filter((line) => line.trim().length > 0).map(parseFrontmatterLine);
+	if (entries.some((entry) => entry === void 0)) return yield* Effect.fail(new SkillsetError({
+		cause: "frontmatter_invalid",
+		message: "Markdown frontmatter only supports simple key: value fields"
+	}));
+	const data = Object.fromEntries(entries.flatMap((entry) => entry === void 0 ? [] : [[entry.key, entry.value]]));
+	const contentStart = markdown.startsWith("\n", endIndex + 4) ? endIndex + 4 + 1 : endIndex + 4;
+	return {
+		data,
+		content: markdown.slice(contentStart).trim()
+	};
+});
+//#endregion
+export { parseMarkdownDocument };
+
+//# sourceMappingURL=markdown.mjs.map

package/dist/markdown.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.mjs","names":[],"sources":["../src/markdown.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport { SkillsetError } from './errors.ts'\n\nexport type MarkdownDocument = {\n  readonly data: Readonly<Record<string, string>>\n  readonly content: string\n}\n\nconst frontmatterStart = '---\\n'\n\nconst frontmatterEndIndex = (markdown: string) => markdown.indexOf('\\n---', frontmatterStart.length)\n\nconst parseFrontmatterLine = (line: string) => {\n  const separatorIndex = line.indexOf(':')\n\n  if (separatorIndex === -1) {\n    return undefined\n  }\n\n  const key = line.slice(0, separatorIndex).trim()\n  const value = line.slice(separatorIndex + 1).trim()\n\n  return key.length === 0 ? undefined : { key, value }\n}\n\nexport const parseMarkdownDocument = (markdown: string) =>\n  Effect.gen(function* () {\n    if (!markdown.startsWith(frontmatterStart)) {\n      return yield* Effect.fail(\n        new SkillsetError({\n          cause: 'frontmatter_missing',\n          message: 'Markdown must start with YAML frontmatter'\n        })\n      )\n    }\n\n    const endIndex = frontmatterEndIndex(markdown)\n\n    if (endIndex === -1) {\n      return yield* Effect.fail(\n        new SkillsetError({\n          cause: 'frontmatter_invalid',\n          message: 'Markdown frontmatter is missing closing delimiter'\n        })\n      )\n    }\n\n    const entries = markdown\n      .slice(frontmatterStart.length, endIndex)\n      .split('\\n')\n      .filter(line => line.trim().length > 0)\n      .map(parseFrontmatterLine)\n\n    if (entries.some(entry => entry === undefined)) {\n      return yield* Effect.fail(\n        new SkillsetError({\n          cause: 'frontmatter_invalid',\n          message: 'Markdown frontmatter only supports simple key: value fields'\n        })\n      )\n    }\n\n    const data = Object.fromEntries(\n      entries.flatMap(entry => (entry === undefined ? [] : [[entry.key, entry.value]]))\n    )\n    const contentStart = markdown.startsWith('\\n', endIndex + frontmatterStart.length)\n      ? endIndex + frontmatterStart.length + 1\n      : endIndex + frontmatterStart.length\n\n    return {\n      data,\n      content: markdown.slice(contentStart).trim()\n    }\n  })\n"],"mappings":";;;AAQA,MAAM,mBAAmB;AAEzB,MAAM,uBAAuB,aAAqB,SAAS,QAAQ,SAAS,CAAuB;AAEnG,MAAM,wBAAwB,SAAiB;CAC7C,MAAM,iBAAiB,KAAK,QAAQ,GAAG;CAEvC,IAAI,mBAAmB,IACrB;CAGF,MAAM,MAAM,KAAK,MAAM,GAAG,cAAc,EAAE,KAAK;CAC/C,MAAM,QAAQ,KAAK,MAAM,iBAAiB,CAAC,EAAE,KAAK;CAElD,OAAO,IAAI,WAAW,IAAI,KAAA,IAAY;EAAE;EAAK;CAAM;AACrD;AAEA,MAAa,yBAAyB,aACpC,OAAO,IAAI,aAAa;CACtB,IAAI,CAAC,SAAS,WAAW,gBAAgB,GACvC,OAAO,OAAO,OAAO,KACnB,IAAI,cAAc;EAChB,OAAO;EACP,SAAS;CACX,CAAC,CACH;CAGF,MAAM,WAAW,oBAAoB,QAAQ;CAE7C,IAAI,aAAa,IACf,OAAO,OAAO,OAAO,KACnB,IAAI,cAAc;EAChB,OAAO;EACP,SAAS;CACX,CAAC,CACH;CAGF,MAAM,UAAU,SACb,MAAM,GAAyB,QAAQ,EACvC,MAAM,IAAI,EACV,QAAO,SAAQ,KAAK,KAAK,EAAE,SAAS,CAAC,EACrC,IAAI,oBAAoB;CAE3B,IAAI,QAAQ,MAAK,UAAS,UAAU,KAAA,CAAS,GAC3C,OAAO,OAAO,OAAO,KACnB,IAAI,cAAc;EAChB,OAAO;EACP,SAAS;CACX,CAAC,CACH;CAGF,MAAM,OAAO,OAAO,YAClB,QAAQ,SAAQ,UAAU,UAAU,KAAA,IAAY,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,KAAK,CAAC,CAAE,CAClF;CACA,MAAM,eAAe,SAAS,WAAW,MAAM,WAAW,CAAuB,IAC7E,WAAW,IAA0B,IACrC,WAAW;CAEf,OAAO;EACL;EACA,SAAS,SAAS,MAAM,YAAY,EAAE,KAAK;CAC7C;AACF,CAAC"}

package/dist/merge.d.mts

@@ -0,0 +1,42 @@
+import { SkillsetError } from "./errors.mjs";
+import { CommandInfo } from "./command.mjs";
+import { SkillInfo } from "./skill.mjs";
+import { SkillsetManifest } from "./manifest.mjs";
+import { Effect } from "effect";
+
+//#region src/merge.d.ts
+type SkillsetSource = {
+  readonly id: string;
+  readonly manifest: SkillsetManifest;
+};
+type MergedSkillset = {
+  readonly skills: ReadonlyArray<SkillInfo>;
+  readonly commands: ReadonlyArray<CommandInfo>;
+};
+declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect.Effect<{
+  skills: {
+    readonly description: string;
+    readonly name: string;
+    readonly location: string;
+    readonly content: string;
+    readonly source?: string | undefined;
+  }[];
+  commands: {
+    readonly name: string;
+    readonly hints: readonly string[];
+    readonly template: string;
+    readonly description?: string | undefined;
+    readonly arguments?: readonly {
+      readonly required: boolean;
+      readonly name: string;
+      readonly description?: string | undefined;
+    }[] | undefined;
+    readonly access?: "read" | "write" | "destructive" | undefined;
+    readonly fileRefs?: boolean | undefined;
+    readonly location?: string | undefined;
+    readonly source?: string | undefined;
+  }[];
+}, SkillsetError, never>;
+//#endregion
+export { MergedSkillset, SkillsetSource, mergeSkillsets };
+//# sourceMappingURL=merge.d.mts.map

package/dist/merge.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.mts","names":[],"sources":["../src/merge.ts"],"mappings":";;;;;;;KAMY,cAAA;EAAA,SACD,EAAA;EAAA,SACA,QAAA,EAAU,gBAAgB;AAAA;AAAA,KAGzB,cAAA;EAAA,SACD,MAAA,EAAQ,aAAA,CAAc,SAAA;EAAA,SACtB,QAAA,EAAU,aAAA,CAAc,WAAA;AAAA;AAAA,cAuCtB,cAAA,GAAkB,OAAA,EAAS,aAAA,CAAc,cAAA,MAAe,MAAA,CAAA,MAAA"}

package/dist/merge.mjs

@@ -0,0 +1,32 @@
+import { SkillsetError } from "./errors.mjs";
+import { Effect } from "effect";
+//#region src/merge.ts
+const mergeByName = (entries) => {
+	const byName = /* @__PURE__ */ new Map();
+	[...entries].reverse().forEach((group) => {
+		group.forEach((entry) => byName.set(entry.name, entry));
+	});
+	return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+};
+const duplicateNames = (entries) => {
+	const names = entries.map((entry) => entry.name);
+	return [...new Set(names.filter((name, index) => names.indexOf(name) !== index))];
+};
+const rejectInternalDuplicates = (source) => {
+	const duplicates = [...duplicateNames(source.manifest.skills).map((name) => `skill:${name}`), ...duplicateNames(source.manifest.commands).map((name) => `command:${name}`)];
+	return duplicates.length === 0 ? Effect.void : Effect.fail(new SkillsetError({
+		cause: "duplicate_entry",
+		message: `Duplicate entries in source ${source.id}: ${duplicates.join(", ")}`
+	}));
+};
+const mergeSkillsets = (sources) => Effect.gen(function* () {
+	yield* Effect.forEach(sources, rejectInternalDuplicates, { discard: true });
+	return {
+		skills: mergeByName(sources.map((source) => source.manifest.skills)),
+		commands: mergeByName(sources.map((source) => source.manifest.commands))
+	};
+});
+//#endregion
+export { mergeSkillsets };
+
+//# sourceMappingURL=merge.mjs.map

package/dist/merge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.mjs","names":[],"sources":["../src/merge.ts"],"sourcesContent":["import { Effect } from 'effect'\nimport { SkillsetError } from './errors.ts'\nimport type { CommandInfo } from './command.ts'\nimport type { SkillInfo } from './skill.ts'\nimport type { SkillsetManifest } from './manifest.ts'\n\nexport type SkillsetSource = {\n  readonly id: string\n  readonly manifest: SkillsetManifest\n}\n\nexport type MergedSkillset = {\n  readonly skills: ReadonlyArray<SkillInfo>\n  readonly commands: ReadonlyArray<CommandInfo>\n}\n\nconst mergeByName = <Entry extends { readonly name: string }>(\n  entries: ReadonlyArray<ReadonlyArray<Entry>>\n) => {\n  const byName = new Map<string, Entry>()\n\n  const reversedEntries = [...entries].reverse()\n\n  reversedEntries.forEach(group => {\n    group.forEach(entry => byName.set(entry.name, entry))\n  })\n\n  return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name))\n}\n\nconst duplicateNames = <Entry extends { readonly name: string }>(entries: ReadonlyArray<Entry>) => {\n  const names = entries.map(entry => entry.name)\n\n  return [...new Set(names.filter((name, index) => names.indexOf(name) !== index))]\n}\n\nconst rejectInternalDuplicates = (source: SkillsetSource) => {\n  const duplicates = [\n    ...duplicateNames(source.manifest.skills).map(name => `skill:${name}`),\n    ...duplicateNames(source.manifest.commands).map(name => `command:${name}`)\n  ]\n\n  return duplicates.length === 0\n    ? Effect.void\n    : Effect.fail(\n        new SkillsetError({\n          cause: 'duplicate_entry',\n          message: `Duplicate entries in source ${source.id}: ${duplicates.join(', ')}`\n        })\n      )\n}\n\nexport const mergeSkillsets = (sources: ReadonlyArray<SkillsetSource>) =>\n  Effect.gen(function* () {\n    yield* Effect.forEach(sources, rejectInternalDuplicates, { discard: true })\n\n    return {\n      skills: mergeByName(sources.map(source => source.manifest.skills)),\n      commands: mergeByName(sources.map(source => source.manifest.commands))\n    }\n  })\n"],"mappings":";;;AAgBA,MAAM,eACJ,YACG;CACH,MAAM,yBAAS,IAAI,IAAmB;CAItC,CAFyB,GAAG,OAAO,EAAE,QAEvB,EAAE,SAAQ,UAAS;EAC/B,MAAM,SAAQ,UAAS,OAAO,IAAI,MAAM,MAAM,KAAK,CAAC;CACtD,CAAC;CAED,OAAO,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AACzE;AAEA,MAAM,kBAA2D,YAAkC;CACjG,MAAM,QAAQ,QAAQ,KAAI,UAAS,MAAM,IAAI;CAE7C,OAAO,CAAC,GAAG,IAAI,IAAI,MAAM,QAAQ,MAAM,UAAU,MAAM,QAAQ,IAAI,MAAM,KAAK,CAAC,CAAC;AAClF;AAEA,MAAM,4BAA4B,WAA2B;CAC3D,MAAM,aAAa,CACjB,GAAG,eAAe,OAAO,SAAS,MAAM,EAAE,KAAI,SAAQ,SAAS,MAAM,GACrE,GAAG,eAAe,OAAO,SAAS,QAAQ,EAAE,KAAI,SAAQ,WAAW,MAAM,CAC3E;CAEA,OAAO,WAAW,WAAW,IACzB,OAAO,OACP,OAAO,KACL,IAAI,cAAc;EAChB,OAAO;EACP,SAAS,+BAA+B,OAAO,GAAG,IAAI,WAAW,KAAK,IAAI;CAC5E,CAAC,CACH;AACN;AAEA,MAAa,kBAAkB,YAC7B,OAAO,IAAI,aAAa;CACtB,OAAO,OAAO,QAAQ,SAAS,0BAA0B,EAAE,SAAS,KAAK,CAAC;CAE1E,OAAO;EACL,QAAQ,YAAY,QAAQ,KAAI,WAAU,OAAO,SAAS,MAAM,CAAC;EACjE,UAAU,YAAY,QAAQ,KAAI,WAAU,OAAO,SAAS,QAAQ,CAAC;CACvE;AACF,CAAC"}

package/dist/name.d.mts

@@ -0,0 +1,10 @@
+import { SkillsetError } from "./errors.mjs";
+import { Effect } from "effect";
+
+//#region src/name.d.ts
+declare const isValidSkillsetName: (name: string) => boolean;
+declare const validateSkillsetName: (name: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
+declare const validateDirectoryName: (expected: string, actual: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
+//#endregion
+export { isValidSkillsetName, validateDirectoryName, validateSkillsetName };
+//# sourceMappingURL=name.d.mts.map

package/dist/name.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.d.mts","names":[],"sources":["../src/name.ts"],"mappings":";;;;cAMa,mBAAA,GAAuB,IAAY;AAAA,cAGnC,oBAAA,GAAwB,IAAA,aAAY,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA;AAAA,cAUpC,qBAAA,GAAyB,QAAA,UAAkB,MAAA,aAAc,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA"}

package/dist/name.mjs

@@ -0,0 +1,18 @@
+import { SkillsetError } from "./errors.mjs";
+import { Effect } from "effect";
+//#region src/name.ts
+const skillsetNamePattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const maxSkillsetNameLength = 64;
+const isValidSkillsetName = (name) => name.length > 0 && name.length <= maxSkillsetNameLength && skillsetNamePattern.test(name);
+const validateSkillsetName = (name) => isValidSkillsetName(name) ? Effect.succeed(name) : Effect.fail(new SkillsetError({
+	cause: "invalid_name",
+	message: `Invalid skillset entry name: ${name}`
+}));
+const validateDirectoryName = (expected, actual) => expected === actual ? Effect.succeed(expected) : Effect.fail(new SkillsetError({
+	cause: "name_mismatch",
+	message: `Skill name must match directory name: expected ${expected}, got ${actual}`
+}));
+//#endregion
+export { isValidSkillsetName, validateDirectoryName, validateSkillsetName };
+
+//# sourceMappingURL=name.mjs.map