@sweny-ai/core 0.1.89 → 0.1.91

package/dist/cli/skill.d.ts

@@ -14,14 +14,7 @@
  * and `../skills/index.js`; this CLI is a thin authoring shell over them.
  */
 import { Command } from "commander";
-import { type SkillCategory } from "../types.js";
-declare const HARNESS_DIRS: {
-    readonly claude: ".claude/skills";
-    readonly sweny: ".sweny/skills";
-    readonly agents: ".agents/skills";
-    readonly gemini: ".gemini/skills";
-};
-type HarnessKey = keyof typeof HARNESS_DIRS;
+import { type SkillCategory, type SkillHarnessKey } from "../types.js";
 /** Build the SKILL.md body for a fresh scaffold. Exported for tests. */
 export declare function renderSkillTemplate(opts: {
     id: string;
@@ -31,7 +24,7 @@ export declare function renderSkillTemplate(opts: {
 interface NewOptions {
     description?: string;
     category?: string;
-    harness?: HarnessKey;
+    harness?: SkillHarnessKey;
     force?: boolean;
 }
 /**

package/dist/cli/skill.js

@@ -18,15 +18,11 @@ import * as path from "node:path";
 import chalk from "chalk";
 import { builtinSkills } from "../skills/index.js";
 import { configuredSkillsWithDiagnostics, discoverSkillsWithDiagnostics } from "../skills/custom-loader.js";
-import { SKILL_CATEGORIES } from "../types.js";
-// Mirror of the loader's regex so authoring-side validation matches discovery.
-const VALID_SKILL_ID = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
-const HARNESS_DIRS = {
-    claude: ".claude/skills",
-    sweny: ".sweny/skills",
-    agents: ".agents/skills",
-    gemini: ".gemini/skills",
-};
+import { SKILL_CATEGORIES, SKILL_HARNESSES, isValidSkillId, } from "../types.js";
+// Lookup table: harness key -> directory. Built once from SKILL_HARNESSES so
+// the CLI cannot drift from the loader's scan list.
+const HARNESS_DIRS = Object.fromEntries(SKILL_HARNESSES.map((h) => [h.key, h.path]));
+const HARNESS_KEYS = SKILL_HARNESSES.map((h) => h.key);
 /** Build the SKILL.md body for a fresh scaffold. Exported for tests. */
 export function renderSkillTemplate(opts) {
     const { id, description, category } = opts;
@@ -87,7 +83,7 @@ export function renderSkillTemplate(opts) {
  */
 export function runSkillNew(idArg, options, cwd = process.cwd()) {
     const id = idArg.toLowerCase();
-    if (!VALID_SKILL_ID.test(id) || id.includes("--") || id.length > 64) {
+    if (!isValidSkillId(id)) {
         console.error(chalk.red(`  Invalid skill id "${idArg}".\n  Skill ids must be lowercase alphanumeric + hyphens (no consecutive hyphens), max 64 chars.`));
         process.exit(2);
         return;
@@ -102,7 +98,7 @@ export function runSkillNew(idArg, options, cwd = process.cwd()) {
     const harness = options.harness ?? "claude";
     const baseDir = HARNESS_DIRS[harness];
     if (!baseDir) {
-        console.error(chalk.red(`  Unknown harness "${harness}". Allowed: ${Object.keys(HARNESS_DIRS).join(", ")}`));
+        console.error(chalk.red(`  Unknown harness "${harness}". Allowed: ${HARNESS_KEYS.join(", ")}`));
         process.exit(2);
         return;
     }
@@ -197,7 +193,7 @@ export function registerSkillCommand(program) {
         .description("Scaffold a new SKILL.md in .claude/skills/<id>/")
         .option("-d, --description <text>", "One-line description (required field in frontmatter)")
         .option("-c, --category <category>", `Skill category (${SKILL_CATEGORIES.join("|")})`, "general")
-        .option("--harness <harness>", `Where to place the skill (${Object.keys(HARNESS_DIRS).join("|")})`, "claude")
+        .option("--harness <harness>", `Where to place the skill (${HARNESS_KEYS.join("|")})`, "claude")
         .option("--force", "Overwrite an existing SKILL.md")
         .action((id, options) => runSkillNew(id, options));
     skillCmd

package/dist/schema.d.ts

@@ -42,7 +42,7 @@ export declare const toolZ: z.ZodObject<{
     description: string;
     input_schema: Record<string, unknown>;
 }>;
-export declare const skillCategoryZ: z.ZodEnum<["git", "observability", "tasks", "notification", "general"]>;
+export declare const skillCategoryZ: z.ZodEnum<["general", "git", "tasks", "notification", "observability", "data"]>;
 export declare const mcpServerConfigZ: z.ZodEffects<z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<["stdio", "http"]>>;
     command: z.ZodOptional<z.ZodString>;
@@ -172,7 +172,7 @@ export declare const skillZ: z.ZodEffects<z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodString;
-    category: z.ZodEnum<["git", "observability", "tasks", "notification", "general"]>;
+    category: z.ZodEnum<["general", "git", "tasks", "notification", "observability", "data"]>;
     config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodString;
         required: z.ZodOptional<z.ZodBoolean>;
@@ -241,7 +241,7 @@ export declare const skillZ: z.ZodEffects<z.ZodObject<{
     id: string;
     name: string;
     description: string;
-    category: "general" | "git" | "tasks" | "notification" | "observability";
+    category: "general" | "git" | "tasks" | "notification" | "observability" | "data";
     config: Record<string, {
         description: string;
         required?: boolean | undefined;
@@ -266,7 +266,7 @@ export declare const skillZ: z.ZodEffects<z.ZodObject<{
     id: string;
     name: string;
     description: string;
-    category: "general" | "git" | "tasks" | "notification" | "observability";
+    category: "general" | "git" | "tasks" | "notification" | "observability" | "data";
     instruction?: string | undefined;
     mcp?: {
         url?: string | undefined;
@@ -291,7 +291,7 @@ export declare const skillZ: z.ZodEffects<z.ZodObject<{
     id: string;
     name: string;
     description: string;
-    category: "general" | "git" | "tasks" | "notification" | "observability";
+    category: "general" | "git" | "tasks" | "notification" | "observability" | "data";
     config: Record<string, {
         description: string;
         required?: boolean | undefined;
@@ -316,7 +316,7 @@ export declare const skillZ: z.ZodEffects<z.ZodObject<{
     id: string;
     name: string;
     description: string;
-    category: "general" | "git" | "tasks" | "notification" | "observability";
+    category: "general" | "git" | "tasks" | "notification" | "observability" | "data";
     instruction?: string | undefined;
     mcp?: {
         url?: string | undefined;
@@ -1375,10 +1375,25 @@ export declare const edgeZ: z.ZodObject<{
     when?: string | undefined;
     max_iterations?: number | undefined;
 }>;
+/**
+ * Workflow type discriminator. Cloud uses this to route runs to a
+ * type-specific renderer (Caught/Calibration/Missed for `pr_review`, flake
+ * heatmap for `e2e_test`, source coverage delta for `monitor`, etc.).
+ *
+ * The field is optional on the workflow YAML; absence defaults to `generic`,
+ * which gets a baseline renderer. Marketplace templates published in v1+
+ * are required to declare it.
+ *
+ * Adding a new value here is a deliberate spec change: it requires a new
+ * cloud renderer + metric schema. Don't extend casually.
+ */
+export declare const workflowTypeZ: z.ZodEnum<["pr_review", "e2e_test", "content_generation", "monitor", "data_sync", "generic"]>;
+export type WorkflowType = z.infer<typeof workflowTypeZ>;
 export declare const workflowZ: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     description: z.ZodDefault<z.ZodString>;
+    workflow_type: z.ZodOptional<z.ZodEnum<["pr_review", "e2e_test", "content_generation", "monitor", "data_sync", "generic"]>>;
     nodes: z.ZodRecord<z.ZodString, z.ZodObject<{
         name: z.ZodString;
         instruction: z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -2250,6 +2265,7 @@ export declare const workflowZ: z.ZodObject<{
         type?: string | undefined;
     })[] | undefined;
     judge_model?: string | undefined;
+    workflow_type?: "pr_review" | "e2e_test" | "content_generation" | "monitor" | "data_sync" | "generic" | undefined;
     judge_budget?: number | undefined;
 }, {
     id: string;
@@ -2381,6 +2397,7 @@ export declare const workflowZ: z.ZodObject<{
         type?: string | undefined;
     })[] | undefined;
     judge_model?: string | undefined;
+    workflow_type?: "pr_review" | "e2e_test" | "content_generation" | "monitor" | "data_sync" | "generic" | undefined;
     judge_budget?: number | undefined;
 }>;
 /** Parse + validate a raw object as a Workflow. Throws on invalid input. */
@@ -2514,6 +2531,7 @@ export declare function parseWorkflow(raw: unknown): {
         type?: string | undefined;
     })[] | undefined;
     judge_model?: string | undefined;
+    workflow_type?: "pr_review" | "e2e_test" | "content_generation" | "monitor" | "data_sync" | "generic" | undefined;
     judge_budget?: number | undefined;
 };
 export interface WorkflowError {
@@ -2767,6 +2785,11 @@ export declare const workflowJsonSchema: {
             };
             readonly description: "Background knowledge prepended to every node's instruction.";
         };
+        readonly workflow_type: {
+            readonly type: "string";
+            readonly enum: readonly ["pr_review", "e2e_test", "content_generation", "monitor", "data_sync", "generic"];
+            readonly description: "Workflow type discriminator. Cloud uses this to route runs to a type-specific renderer. Optional; absence defaults to 'generic'.";
+        };
         readonly judge_model: {
             readonly type: "string";
             readonly minLength: 1;
@@ -3002,3 +3025,160 @@ export declare const workflowJsonSchema: {
         };
     };
 };
+/**
+ * Skill JSON Schema, generated from runtime constants.
+ *
+ * Companion to {@link workflowJsonSchema}: published at
+ * https://spec.sweny.ai/schemas/skill.json by the
+ * `write-public-schema.mjs` build step. Validates the structural shape
+ * of a Skill (id, name, description, category, config, plus optional
+ * tools/instruction/mcp).
+ *
+ * Every enum and the `id` pattern + maxLength are imported from
+ * `types.ts` so adding a category, harness, transport, or changing the
+ * id rule updates the published schema with no manual sync.
+ */
+export declare const skillJsonSchema: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://spec.sweny.ai/schemas/skill.json";
+    readonly title: "SWEny Skill";
+    readonly description: "A composable tool bundle that provides capabilities to workflow nodes.";
+    readonly type: "object";
+    readonly required: readonly ["id", "name", "description", "category", "config"];
+    readonly anyOf: readonly [{
+        readonly required: readonly ["tools"];
+    }, {
+        readonly required: readonly ["instruction"];
+    }, {
+        readonly required: readonly ["mcp"];
+    }];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly pattern: string;
+            readonly description: "Unique skill identifier. Referenced by nodes' skills arrays. Lowercase kebab-case recommended.";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "Human-readable skill name.";
+        };
+        readonly description: {
+            readonly type: "string";
+            readonly description: "What this skill provides.";
+        };
+        readonly category: {
+            readonly type: "string";
+            readonly enum: readonly ["general", "git", "tasks", "notification", "observability", "data"];
+            readonly description: "Functional category.";
+        };
+        readonly config: {
+            readonly type: "object";
+            readonly description: "Configuration fields required by this skill.";
+            readonly additionalProperties: {
+                readonly $ref: "#/$defs/ConfigField";
+            };
+        };
+        readonly tools: {
+            readonly type: "array";
+            readonly description: "Tools this skill provides to nodes.";
+            readonly items: {
+                readonly $ref: "#/$defs/Tool";
+            };
+        };
+        readonly instruction: {
+            readonly type: "string";
+            readonly description: "Natural language expertise injected into the node prompt when this skill is referenced.";
+        };
+        readonly mcp: {
+            readonly $ref: "#/$defs/McpServerConfig";
+            readonly description: "External MCP server definition wired for nodes referencing this skill.";
+        };
+    };
+    readonly $defs: {
+        readonly ConfigField: {
+            readonly type: "object";
+            readonly required: readonly ["description"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly description: {
+                    readonly type: "string";
+                    readonly description: "Human-readable description of this config field.";
+                };
+                readonly required: {
+                    readonly type: "boolean";
+                    readonly default: false;
+                    readonly description: "Whether this field must be provided for the skill to function.";
+                };
+                readonly env: {
+                    readonly type: "string";
+                    readonly description: "Default environment variable to read this value from.";
+                };
+            };
+        };
+        readonly Tool: {
+            readonly type: "object";
+            readonly required: readonly ["name", "description", "input_schema"];
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly name: {
+                    readonly type: "string";
+                    readonly description: "Tool name. Must be unique within the skill.";
+                };
+                readonly description: {
+                    readonly type: "string";
+                    readonly description: "What this tool does. Provided to the AI model for tool selection.";
+                };
+                readonly input_schema: {
+                    readonly type: "object";
+                    readonly description: "JSON Schema defining the tool's input parameters.";
+                };
+            };
+        };
+        readonly McpServerConfig: {
+            readonly type: "object";
+            readonly description: "External MCP server definition.";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly type: {
+                    readonly type: "string";
+                    readonly enum: readonly ["stdio", "http"];
+                    readonly description: "Transport type. Inferred from presence of command (stdio) or url (http) when omitted.";
+                };
+                readonly command: {
+                    readonly type: "string";
+                    readonly description: "Spawn command (stdio transport).";
+                };
+                readonly args: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Arguments for the command.";
+                };
+                readonly url: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "HTTP endpoint (HTTP transport).";
+                };
+                readonly headers: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                    readonly description: "HTTP headers (HTTP transport only).";
+                };
+                readonly env: {
+                    readonly type: "object";
+                    readonly additionalProperties: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Environment variable names the server needs. Values are descriptions, not secrets.";
+                };
+            };
+        };
+    };
+};

package/dist/schema.js

@@ -7,6 +7,7 @@
  * parsing untrusted input (JSON/YAML import, Studio editor).
  */
 import { z } from "zod";
+import { EVALUATOR_KINDS, EVAL_POLICIES, MCP_TRANSPORTS, REQUIRES_ON_FAIL, SKILL_CATEGORIES, SKILL_ID_MAX_LENGTH, SKILL_ID_PATTERN, } from "./types.js";
 import { sourceZ } from "./sources.js";
 export { sourceZ };
 // ─── Zod Schemas ─────────────────────────────────────────────────
@@ -26,10 +27,10 @@ export const toolZ = z.object({
     description: z.string(),
     input_schema: jsonSchemaZ,
 });
-export const skillCategoryZ = z.enum(["git", "observability", "tasks", "notification", "general"]);
+export const skillCategoryZ = z.enum(SKILL_CATEGORIES);
 export const mcpServerConfigZ = z
     .object({
-    type: z.enum(["stdio", "http"]).optional(),
+    type: z.enum(MCP_TRANSPORTS).optional(),
     command: z.string().optional(),
     args: z.array(z.string()).optional(),
     url: z.string().optional(),
@@ -90,8 +91,8 @@ export const outputMatchZ = z
     const operators = [m.equals !== undefined, m.in !== undefined, m.matches !== undefined];
     return operators.filter(Boolean).length === 1;
 }, { message: "output_matches entry must declare exactly one of: equals, in, matches" });
-export const evaluatorKindZ = z.enum(["value", "function", "judge"]);
-export const evalPolicyZ = z.enum(["all_pass", "any_pass", "weighted"]);
+export const evaluatorKindZ = z.enum(EVALUATOR_KINDS);
+export const evalPolicyZ = z.enum(EVAL_POLICIES);
 export const evaluatorRuleZ = z
     .object({
     any_tool_called: z.array(z.string().min(1)).min(1).optional(),
@@ -170,7 +171,7 @@ export const nodeRequiresZ = z
     .object({
     output_required: z.array(z.string().min(1)).min(1).optional(),
     output_matches: z.array(outputMatchZ).min(1).optional(),
-    on_fail: z.enum(["fail", "skip"]).optional(),
+    on_fail: z.enum(REQUIRES_ON_FAIL).optional(),
 })
     .strict()
     .refine((r) => r.output_required !== undefined || r.output_matches !== undefined, {
@@ -208,6 +209,19 @@ export const edgeZ = z
     max_iterations: z.number().int().min(1).optional(),
 })
     .strict();
+/**
+ * Workflow type discriminator. Cloud uses this to route runs to a
+ * type-specific renderer (Caught/Calibration/Missed for `pr_review`, flake
+ * heatmap for `e2e_test`, source coverage delta for `monitor`, etc.).
+ *
+ * The field is optional on the workflow YAML; absence defaults to `generic`,
+ * which gets a baseline renderer. Marketplace templates published in v1+
+ * are required to declare it.
+ *
+ * Adding a new value here is a deliberate spec change: it requires a new
+ * cloud renderer + metric schema. Don't extend casually.
+ */
+export const workflowTypeZ = z.enum(["pr_review", "e2e_test", "content_generation", "monitor", "data_sync", "generic"]);
 // Fix #4 gap — workflowZ is intentionally NOT .strict(). The published
 // JSON Schema's `additionalProperties: false` only scopes the properties
 // block, but marketplace workflows routinely carry top-level metadata
@@ -218,6 +232,7 @@ export const workflowZ = z.object({
     id: z.string().min(1),
     name: z.string().min(1),
     description: z.string().default(""),
+    workflow_type: workflowTypeZ.optional(),
     nodes: z.record(nodeZ),
     edges: z.array(edgeZ),
     entry: z.string().min(1),
@@ -482,7 +497,7 @@ export const workflowJsonSchema = {
                     minLength: 1,
                     description: "Stable identifier for this evaluator. Used in EvalResult and retry preambles.",
                 },
-                kind: { type: "string", enum: ["value", "function", "judge"] },
+                kind: { type: "string", enum: [...EVALUATOR_KINDS] },
                 rule: {
                     type: "object",
                     description: "Required for value and function kinds. Shape depends on kind.",
@@ -540,6 +555,11 @@ export const workflowJsonSchema = {
             items: { $ref: "#/$defs/Source" },
             description: "Background knowledge prepended to every node's instruction.",
         },
+        workflow_type: {
+            type: "string",
+            enum: ["pr_review", "e2e_test", "content_generation", "monitor", "data_sync", "generic"],
+            description: "Workflow type discriminator. Cloud uses this to route runs to a type-specific renderer. Optional; absence defaults to 'generic'.",
+        },
         judge_model: {
             type: "string",
             minLength: 1,
@@ -591,7 +611,7 @@ export const workflowJsonSchema = {
                     },
                     eval_policy: {
                         type: "string",
-                        enum: ["all_pass", "any_pass", "weighted"],
+                        enum: [...EVAL_POLICIES],
                         default: "all_pass",
                         description: "How evaluator results aggregate. v1 implements all_pass; the others are reserved.",
                     },
@@ -618,7 +638,7 @@ export const workflowJsonSchema = {
                                 items: { $ref: "#/$defs/OutputMatch" },
                                 minItems: 1,
                             },
-                            on_fail: { type: "string", enum: ["fail", "skip"] },
+                            on_fail: { type: "string", enum: [...REQUIRES_ON_FAIL] },
                         },
                     },
                     retry: {
@@ -689,7 +709,7 @@ export const workflowJsonSchema = {
                         // Round 2: reject unknown keys to match Zod mcpServerConfigZ.strict().
                         additionalProperties: false,
                         properties: {
-                            type: { type: "string", enum: ["stdio", "http"] },
+                            type: { type: "string", enum: [...MCP_TRANSPORTS] },
                             command: { type: "string" },
                             args: { type: "array", items: { type: "string" } },
                             url: { type: "string" },
@@ -702,3 +722,144 @@ export const workflowJsonSchema = {
         },
     },
 };
+/**
+ * Skill JSON Schema, generated from runtime constants.
+ *
+ * Companion to {@link workflowJsonSchema}: published at
+ * https://spec.sweny.ai/schemas/skill.json by the
+ * `write-public-schema.mjs` build step. Validates the structural shape
+ * of a Skill (id, name, description, category, config, plus optional
+ * tools/instruction/mcp).
+ *
+ * Every enum and the `id` pattern + maxLength are imported from
+ * `types.ts` so adding a category, harness, transport, or changing the
+ * id rule updates the published schema with no manual sync.
+ */
+export const skillJsonSchema = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://spec.sweny.ai/schemas/skill.json",
+    title: "SWEny Skill",
+    description: "A composable tool bundle that provides capabilities to workflow nodes.",
+    type: "object",
+    required: ["id", "name", "description", "category", "config"],
+    anyOf: [{ required: ["tools"] }, { required: ["instruction"] }, { required: ["mcp"] }],
+    additionalProperties: false,
+    properties: {
+        id: {
+            type: "string",
+            minLength: 1,
+            maxLength: SKILL_ID_MAX_LENGTH,
+            pattern: SKILL_ID_PATTERN.source,
+            description: "Unique skill identifier. Referenced by nodes' skills arrays. Lowercase kebab-case recommended.",
+        },
+        name: {
+            type: "string",
+            minLength: 1,
+            description: "Human-readable skill name.",
+        },
+        description: {
+            type: "string",
+            description: "What this skill provides.",
+        },
+        category: {
+            type: "string",
+            enum: [...SKILL_CATEGORIES],
+            description: "Functional category.",
+        },
+        config: {
+            type: "object",
+            description: "Configuration fields required by this skill.",
+            additionalProperties: { $ref: "#/$defs/ConfigField" },
+        },
+        tools: {
+            type: "array",
+            description: "Tools this skill provides to nodes.",
+            items: { $ref: "#/$defs/Tool" },
+        },
+        instruction: {
+            type: "string",
+            description: "Natural language expertise injected into the node prompt when this skill is referenced.",
+        },
+        mcp: {
+            $ref: "#/$defs/McpServerConfig",
+            description: "External MCP server definition wired for nodes referencing this skill.",
+        },
+    },
+    $defs: {
+        ConfigField: {
+            type: "object",
+            required: ["description"],
+            additionalProperties: false,
+            properties: {
+                description: {
+                    type: "string",
+                    description: "Human-readable description of this config field.",
+                },
+                required: {
+                    type: "boolean",
+                    default: false,
+                    description: "Whether this field must be provided for the skill to function.",
+                },
+                env: {
+                    type: "string",
+                    description: "Default environment variable to read this value from.",
+                },
+            },
+        },
+        Tool: {
+            type: "object",
+            required: ["name", "description", "input_schema"],
+            additionalProperties: false,
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Tool name. Must be unique within the skill.",
+                },
+                description: {
+                    type: "string",
+                    description: "What this tool does. Provided to the AI model for tool selection.",
+                },
+                input_schema: {
+                    type: "object",
+                    description: "JSON Schema defining the tool's input parameters.",
+                },
+            },
+        },
+        McpServerConfig: {
+            type: "object",
+            description: "External MCP server definition.",
+            additionalProperties: false,
+            properties: {
+                type: {
+                    type: "string",
+                    enum: [...MCP_TRANSPORTS],
+                    description: "Transport type. Inferred from presence of command (stdio) or url (http) when omitted.",
+                },
+                command: {
+                    type: "string",
+                    description: "Spawn command (stdio transport).",
+                },
+                args: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Arguments for the command.",
+                },
+                url: {
+                    type: "string",
+                    format: "uri",
+                    description: "HTTP endpoint (HTTP transport).",
+                },
+                headers: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "HTTP headers (HTTP transport only).",
+                },
+                env: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Environment variable names the server needs. Values are descriptions, not secrets.",
+                },
+            },
+        },
+    },
+};

package/dist/skills/custom-loader.js

@@ -11,12 +11,15 @@
 import { readdirSync, readFileSync, existsSync } from "node:fs";
 import { join } from "node:path";
 import YAML from "yaml";
-import { SKILL_CATEGORIES } from "../types.js";
+import { SKILL_CATEGORIES, SKILL_HARNESSES, isValidSkillId } from "../types.js";
 import { builtinSkills, isSkillConfigured } from "./index.js";
-/** Directories to scan, in ascending priority order. Last match wins. */
-const SKILL_DIRS = [".gemini/skills", ".agents/skills", ".claude/skills", ".sweny/skills"];
-/** Valid skill ID: lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens, max 64 chars. */
-const VALID_SKILL_ID = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/;
+/**
+ * Directories to scan, in ascending priority order. Last match wins.
+ *
+ * Derived from {@link SKILL_HARNESSES} so the loader and the CLI authoring
+ * side cannot disagree on what counts as a skill harness directory.
+ */
+const SKILL_DIRS = SKILL_HARNESSES.map((h) => h.path);
 /**
  * Discover custom skills and surface diagnostics for broken ones.
  *
@@ -104,7 +107,7 @@ function parseSkillMd(content, path) {
         ? fm.category
         : "general";
     const id = String(fm.name);
-    if (!VALID_SKILL_ID.test(id) || id.includes("--") || id.length > 64) {
+    if (!isValidSkillId(id)) {
         return {
             kind: "err",
             diagnostic: {