vskill 1.0.13 → 1.0.14

package/dist/core/skill-generator.d.ts

@@ -1,7 +1,29 @@
-import { type GenerateSkillRequest, type GenerateSkillResult } from "../eval-server/skill-create-routes.js";
-export type { GenerateSkillRequest, GenerateSkillResult };
+import { type GenerateSkillRequest as BaseGenerateSkillRequest, type GenerateSkillResult as BaseGenerateSkillResult } from "../eval-server/skill-create-routes.js";
+export interface GenerateSkillRequest extends BaseGenerateSkillRequest {
+    multiFile?: boolean;
+}
+export interface GenerateSkillResult extends BaseGenerateSkillResult {
+    /** Auxiliary files produced by the multi-file pipeline (relative path → contents). */
+    files?: Record<string, string>;
+    /** Env-var names declared by the test-agent. */
+    secrets?: string[];
+    /** Runtime requirements declared by the script-agent. */
+    runtime?: {
+        python?: string;
+        pip?: string[];
+        node?: string;
+    };
+    /** Integration-test contract declared by the test-agent. */
+    integrationTests?: {
+        runner: "vitest" | "pytest" | "none";
+        file?: string;
+        requires?: string[];
+    };
+    /** Per-agent error messages from the parallel fan-out (informational). */
+    multiFileWarnings?: string[];
+}
 export interface GenerateSkillProgressEvent {
-    phase: "preparing" | "generating-body" | "generating-evals" | "parsing" | "done";
+    phase: "preparing" | "generating-body" | "generating-evals" | "generating-scripts" | "generating-graders" | "generating-tests" | "generating-references" | "parsing" | "done";
     message: string;
 }
 export interface GenerateSkillOptions {

package/dist/core/skill-generator.js

@@ -25,6 +25,7 @@
 // eslint-disable-next-line no-restricted-imports -- see module header TODO
 import { BODY_SYSTEM_PROMPT, EVAL_SYSTEM_PROMPT, buildAgentAwareSystemPrompt, detectProjectLayout, mergeGenerateResults, parseBodyResponse, parseEvalsResponse, } from "../eval-server/skill-create-routes.js";
 import { createLlmClient } from "../eval/llm.js";
+import { SCRIPT_SYSTEM_PROMPT, GRADER_SYSTEM_PROMPT, TEST_SYSTEM_PROMPT, REFERENCE_SYSTEM_PROMPT, parseScriptResponse, parseGraderResponse, parseTestResponse, parseReferenceResponse, } from "./agent-prompts.js";
 /**
  * Resolve provider + model defaults consistent with the pre-extraction
  * handler behavior: when both are absent we use { claude-cli, sonnet }.
@@ -76,6 +77,18 @@ export async function generateSkill(request, options) {
     const evalPrompt = `Generate eval test cases for this skill:\n\n${trimmedPrompt}\n\nReturn only the JSON object with an "evals" array.`;
     // Agent-aware prompt augmentation: append constraints for non-Claude agents
     const effectiveSystemPrompt = buildAgentAwareSystemPrompt(BODY_SYSTEM_PROMPT, request.targetAgents);
+    if (request.multiFile === true) {
+        return await generateMultiFileSkill({
+            trimmedPrompt,
+            effectiveSystemPrompt,
+            provider,
+            model,
+            evalModel,
+            pluginContext,
+            abortSignal,
+            emit,
+        });
+    }
     emit({ phase: "generating-body", message: "Generating skill body..." });
     emit({ phase: "generating-evals", message: "Generating evals..." });
     const bodyCall = bodyClient
@@ -97,4 +110,122 @@ export async function generateSkill(request, options) {
     emit({ phase: "done", message: "Generation complete" });
     return merged;
 }
+async function generateMultiFileSkill(ctx) {
+    const { trimmedPrompt, effectiveSystemPrompt, provider, model, evalModel, pluginContext, abortSignal, emit, } = ctx;
+    // Capable model for code-producing agents; cheap model for reference + eval.
+    const capableClient = createLlmClient({ provider, model });
+    const cheapClient = createLlmClient({ provider, model: evalModel });
+    // Each agent gets the same skill description; the system prompt does the
+    // role-shaping. buildAgentAwareSystemPrompt() is intentionally NOT applied
+    // here — the per-role prompts are concrete enough that target-agent
+    // constraints are encoded by the body-agent's SKILL.md output, not the
+    // auxiliary code files.
+    const userPrompt = `Generate the role-specific output for this skill:\n\n${trimmedPrompt}`;
+    emit({ phase: "generating-scripts", message: "Generating helper scripts..." });
+    emit({ phase: "generating-graders", message: "Generating grader..." });
+    emit({ phase: "generating-tests", message: "Generating integration test..." });
+    emit({ phase: "generating-references", message: "Generating references..." });
+    emit({ phase: "generating-evals", message: "Generating evals..." });
+    const scriptCall = capableClient
+        .generate(SCRIPT_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseScriptResponse(r.text));
+    const graderCall = capableClient
+        .generate(GRADER_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseGraderResponse(r.text));
+    const testCall = capableClient
+        .generate(TEST_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseTestResponse(r.text));
+    const referenceCall = cheapClient
+        .generate(REFERENCE_SYSTEM_PROMPT, userPrompt)
+        .then((r) => parseReferenceResponse(r.text));
+    const evalCall = cheapClient
+        .generate(EVAL_SYSTEM_PROMPT, `Generate eval test cases for this skill:\n\n${trimmedPrompt}\n\nReturn only the JSON object with an "evals" array.`)
+        .then((r) => parseEvalsResponse(r.text));
+    const settled = await Promise.allSettled([
+        scriptCall,
+        graderCall,
+        testCall,
+        referenceCall,
+        evalCall,
+    ]);
+    if (abortSignal?.aborted) {
+        const reason = abortSignal.reason ??
+            new Error("Skill generation aborted");
+        throw reason instanceof Error ? reason : new Error(String(reason));
+    }
+    // Collect produced files + warnings.
+    const files = {};
+    const warnings = [];
+    let secrets;
+    let runtime;
+    let integrationTests;
+    const [scriptR, graderR, testR, referenceR, evalsR] = settled;
+    if (scriptR.status === "fulfilled") {
+        for (const f of scriptR.value.files)
+            files[f.path] = f.content;
+        if (scriptR.value.runtime)
+            runtime = scriptR.value.runtime;
+    }
+    else {
+        warnings.push(`script-agent failed: ${stringifyReason(scriptR.reason)}`);
+    }
+    if (graderR.status === "fulfilled") {
+        for (const f of graderR.value.files)
+            files[f.path] = f.content;
+    }
+    else {
+        warnings.push(`grader-agent failed: ${stringifyReason(graderR.reason)}`);
+    }
+    if (testR.status === "fulfilled") {
+        for (const f of testR.value.files)
+            files[f.path] = f.content;
+        if (testR.value.secrets)
+            secrets = testR.value.secrets;
+        if (testR.value.integrationTests)
+            integrationTests = testR.value.integrationTests;
+    }
+    else {
+        warnings.push(`test-agent failed: ${stringifyReason(testR.reason)}`);
+    }
+    if (referenceR.status === "fulfilled") {
+        for (const f of referenceR.value.files)
+            files[f.path] = f.content;
+    }
+    else {
+        warnings.push(`reference-agent failed: ${stringifyReason(referenceR.reason)}`);
+    }
+    emit({ phase: "generating-body", message: "Generating SKILL.md..." });
+    // Body-agent runs LAST with the produced filename list so SKILL.md can
+    // reference the actual files. Missing files become generic prose in the
+    // SKILL.md body — never broken links.
+    const filenameList = Object.keys(files).sort().join("\n  - ");
+    const bodyPrompt = `Generate a skill definition (body and metadata only, NO evals) for:\n\n${trimmedPrompt}\n\nThe skill is multi-file. The following auxiliary files have been produced and live in the skill directory:\n  - ${filenameList || "(no auxiliary files produced)"}\n\nReference them in the SKILL.md body using relative paths (e.g. \`scripts/audit.py\`). If a referenced category is missing from the list above, omit references rather than inventing filenames.\n\nApply Skill Studio best practices. Return the JSON object followed by ---REASONING--- and your explanation.${pluginContext}`;
+    const bodyClient = createLlmClient({ provider, model });
+    const bodySettled = await Promise.allSettled([
+        bodyClient.generate(effectiveSystemPrompt, bodyPrompt).then((r) => parseBodyResponse(r.text)),
+    ]);
+    emit({ phase: "parsing", message: "Merging multi-file results..." });
+    const merged = mergeGenerateResults(bodySettled[0], evalsR);
+    emit({ phase: "done", message: "Multi-file generation complete" });
+    return {
+        ...merged,
+        files,
+        ...(secrets ? { secrets } : {}),
+        ...(runtime ? { runtime } : {}),
+        ...(integrationTests ? { integrationTests } : {}),
+        ...(warnings.length > 0 ? { multiFileWarnings: warnings } : {}),
+    };
+}
+function stringifyReason(reason) {
+    if (reason instanceof Error)
+        return reason.message;
+    if (typeof reason === "string")
+        return reason;
+    try {
+        return JSON.stringify(reason);
+    }
+    catch {
+        return String(reason);
+    }
+}
 //# sourceMappingURL=skill-generator.js.map

package/dist/core/skill-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/core/skill-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-generator.js","sourceRoot":"","sources":["../../src/core/skill-generator.ts"],"names":[],"mappings":"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"}

package/dist/eval-server/api-routes.d.ts

@@ -107,6 +107,20 @@ export interface SkillMetadataFields {
      *  "skills/foo/SKILL.md"). Defaults to "SKILL.md" for flat-layout
      *  installs derived from a legacy `github:` source string. */
     skillPath: string | null;
+    /** Env-var names this skill expects (purposes/hints live in `.env.example` comments). */
+    secrets: string[] | null;
+    /** Language runtime declaration (Python and/or Node.js). */
+    runtime: {
+        python: string | null;
+        pip: string[] | null;
+        node: string | null;
+    } | null;
+    /** Integration-test contract verified by `vskill check`. */
+    integrationTests: {
+        runner: "vitest" | "pytest" | "none";
+        file: string | null;
+        requires: string[] | null;
+    } | null;
 }
 /**
  * Minimal YAML frontmatter parser — handles scalars and arrays (inline [a, b]

package/dist/eval-server/api-routes.js

@@ -375,6 +375,9 @@ const EMPTY_METADATA = {
     sourceAgent: null,
     repoUrl: null,
     skillPath: null,
+    secrets: null,
+    runtime: null,
+    integrationTests: null,
 };
 /**
  * Allow-list of metadata children that may be surfaced at the top level
@@ -407,6 +410,20 @@ const SURFACED_METADATA_KEYS = new Set([
     // Path / file metadata
     "entryPoint",
     "entry-point",
+    // 0815: multi-file manifest fields (kebab-case canonical, camelCase tolerated).
+    "secrets",
+    "runtime-python",
+    "runtimePython",
+    "runtime-pip",
+    "runtimePip",
+    "runtime-node",
+    "runtimeNode",
+    "integration-runner",
+    "integrationRunner",
+    "integration-file",
+    "integrationFile",
+    "integration-requires",
+    "integrationRequires",
 ]);
 /**
  * Minimal YAML frontmatter parser — handles scalars and arrays (inline [a, b]
@@ -716,6 +733,24 @@ export function buildSkillMetadata(skillDir, origin, root) {
     const deps = toStringArrayOrNull(fm["skill-deps"] ?? fm.skillDeps ?? fm.deps);
     const mcpDeps = toStringArrayOrNull(fm["mcp-deps"] ?? fm.mcpDeps ?? fm.mcpDependencies);
     const tags = toStringArrayOrNull(fm.tags);
+    // 0815: assemble runtime + integrationTests from flat fields. Secrets stays
+    // a string[] (env-var names); purposes live in the skill's `.env.example`.
+    const secrets = toStringArrayOrNull(fm.secrets);
+    const runtimePython = toStringOrNull(fm["runtime-python"] ?? fm.runtimePython);
+    const runtimePip = toStringArrayOrNull(fm["runtime-pip"] ?? fm.runtimePip);
+    const runtimeNode = toStringOrNull(fm["runtime-node"] ?? fm.runtimeNode);
+    const runtime = runtimePython || runtimePip || runtimeNode
+        ? { python: runtimePython, pip: runtimePip, node: runtimeNode }
+        : null;
+    const rawRunner = toStringOrNull(fm["integration-runner"] ?? fm.integrationRunner);
+    const integrationRunner = rawRunner === "vitest" || rawRunner === "pytest" || rawRunner === "none"
+        ? rawRunner
+        : null;
+    const integrationFile = toStringOrNull(fm["integration-file"] ?? fm.integrationFile);
+    const integrationRequires = toStringArrayOrNull(fm["integration-requires"] ?? fm.integrationRequires);
+    const integrationTests = integrationRunner
+        ? { runner: integrationRunner, file: integrationFile, requires: integrationRequires }
+        : null;
     return {
         description: toStringOrNull(fm.description),
         version: toStringOrNull(fm.version),
@@ -732,6 +767,9 @@ export function buildSkillMetadata(skillDir, origin, root) {
         sourceAgent: deriveSourceAgent(skillDir, root, origin),
         repoUrl: sourceLink.repoUrl,
         skillPath: sourceLink.skillPath,
+        secrets,
+        runtime,
+        integrationTests,
     };
 }
 // ---------------------------------------------------------------------------