@evalops/maestro 0.10.50 → 0.10.53

package/dist/skills/index.js

@@ -1,40 +0,0 @@
-/**
- * Skills System - Dynamic skill discovery and loading.
- *
- * Skills are domain-specific instruction sets that can be loaded
- * dynamically by the agent when it recognizes a matching task.
- *
- * ## Progressive Skill Disclosure (#857)
- *
- * Skills use a two-phase loading system for context efficiency:
- *
- * 1. **System Prompt**: Only inject metadata (name + description) using
- *    `formatSkillsForSystemPrompt()` - ~10 tokens per skill
- * 2. **On-Demand**: Agent uses `read` tool to load full SKILL.md when needed
- *    - ~500+ tokens per skill, only when relevant
- *
- * This scales to 20+ skills without degrading conversation quality.
- *
- * @example
- * ```typescript
- * import { loadSkills, formatSkillsForSystemPrompt } from "./skills";
- *
- * // Load all available skills
- * const { skills } = loadSkills(process.cwd());
- *
- * // Get lightweight metadata for system prompt (progressive disclosure)
- * const systemPromptSkills = formatSkillsForSystemPrompt(skills);
- *
- * // Or use legacy full-content approach (not recommended)
- * const summary = getSkillsSummary(skills);
- * ```
- */
-export { findSkill, findSkillMd, formatSkillForInjection, formatSkillListItem, formatSkillMetadataOnly, formatSkillsForSystemPrompt, getSkillsSummary, loadSkills, parseFrontmatter, searchSkills, skillToDict, skillToJson, skillsToPrompt, stringArrayValue, } from "./loader.js";
-export { composeSkill } from "./composer.js";
-export { scaffoldSkillWithBody, } from "./scaffolder.js";
-export { createSkillTool, invalidateSkillCache } from "./tool.js";
-export { buildSkillRuntimeActivation, } from "./runtime-activation.js";
-export { SKILL_BODY_MAX_CHARS, SKILL_BODY_MAX_LINES, formatSkillLintText, hasSkillLintErrors, isWindowsRunnableToolboxEntry, lintSkillDirectory, lintSkillPaths, scaffoldSkill, shouldUseShellForToolboxDescribe, toolboxDescribeSpawnCommand, } from "./linter.js";
-export { evaluateSkillPackages, formatSkillEvalText, hasSkillEvalFailures, } from "./eval-harness.js";
-export { MAESTRO_PACKAGE_KEYWORD, MAESTRO_SKILL_PACKAGE_KEYWORD, SKILL_PACKAGE_CONTRACT_SCHEMA, buildSkillPackagePublishContract, formatSkillPackageInstallSource, formatSkillPackagePublishContract, } from "./package-contract.js";
-//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAIN,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAGN,qBAAqB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EASN,2BAA2B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIN,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gCAAgC,EAChC,2BAA2B,GAC3B,MAAM,aAAa,CAAC;AAErB,OAAO,EAMN,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAK7B,gCAAgC,EAChC,+BAA+B,EAC/B,iCAAiC,GACjC,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * Skills System - Dynamic skill discovery and loading.\n *\n * Skills are domain-specific instruction sets that can be loaded\n * dynamically by the agent when it recognizes a matching task.\n *\n * ## Progressive Skill Disclosure (#857)\n *\n * Skills use a two-phase loading system for context efficiency:\n *\n * 1. **System Prompt**: Only inject metadata (name + description) using\n *    `formatSkillsForSystemPrompt()` - ~10 tokens per skill\n * 2. **On-Demand**: Agent uses `read` tool to load full SKILL.md when needed\n *    - ~500+ tokens per skill, only when relevant\n *\n * This scales to 20+ skills without degrading conversation quality.\n *\n * @example\n * ```typescript\n * import { loadSkills, formatSkillsForSystemPrompt } from \"./skills\";\n *\n * // Load all available skills\n * const { skills } = loadSkills(process.cwd());\n *\n * // Get lightweight metadata for system prompt (progressive disclosure)\n * const systemPromptSkills = formatSkillsForSystemPrompt(skills);\n *\n * // Or use legacy full-content approach (not recommended)\n * const summary = getSkillsSummary(skills);\n * ```\n */\n\nexport {\n\ttype LoadedSkill,\n\ttype SkillDefinition,\n\ttype SkillResource,\n\tfindSkill,\n\tfindSkillMd,\n\tformatSkillForInjection,\n\tformatSkillListItem,\n\tformatSkillMetadataOnly,\n\tformatSkillsForSystemPrompt,\n\tgetSkillsSummary,\n\tloadSkills,\n\tparseFrontmatter,\n\tsearchSkills,\n\tskillToDict,\n\tskillToJson,\n\tskillsToPrompt,\n\tstringArrayValue,\n} from \"./loader.js\";\n\nexport { composeSkill } from \"./composer.js\";\nexport {\n\ttype ScaffoldSkillOptions,\n\ttype ScaffoldSkillResult,\n\tscaffoldSkillWithBody,\n} from \"./scaffolder.js\";\nexport { createSkillTool, invalidateSkillCache } from \"./tool.js\";\nexport {\n\ttype SkillRuntimeActivation,\n\ttype SkillRuntimeActivationOptions,\n\ttype SkillRuntimeMcpActivation,\n\ttype SkillRuntimeMcpServer,\n\ttype SkillRuntimeResource,\n\ttype SkillRuntimeResourceDirectories,\n\ttype SkillRuntimeToolboxActivation,\n\ttype SkillRuntimeToolboxEntry,\n\tbuildSkillRuntimeActivation,\n} from \"./runtime-activation.js\";\nexport {\n\ttype SkillLintIssue,\n\ttype SkillLintResult,\n\ttype SkillScaffoldOptions,\n\tSKILL_BODY_MAX_CHARS,\n\tSKILL_BODY_MAX_LINES,\n\tformatSkillLintText,\n\thasSkillLintErrors,\n\tisWindowsRunnableToolboxEntry,\n\tlintSkillDirectory,\n\tlintSkillPaths,\n\tscaffoldSkill,\n\tshouldUseShellForToolboxDescribe,\n\ttoolboxDescribeSpawnCommand,\n} from \"./linter.js\";\n\nexport {\n\ttype SkillEvalAssertion,\n\ttype SkillEvalCase,\n\ttype SkillEvalOutcome,\n\ttype SkillEvalReport,\n\ttype SkillEvalResult,\n\tevaluateSkillPackages,\n\tformatSkillEvalText,\n\thasSkillEvalFailures,\n} from \"./eval-harness.js\";\nexport {\n\tMAESTRO_PACKAGE_KEYWORD,\n\tMAESTRO_SKILL_PACKAGE_KEYWORD,\n\tSKILL_PACKAGE_CONTRACT_SCHEMA,\n\ttype BuildSkillPackagePublishContractOptions,\n\ttype SkillPackageContractIssue,\n\ttype SkillPackageInstallCommandSet,\n\ttype SkillPackagePublishContract,\n\tbuildSkillPackagePublishContract,\n\tformatSkillPackageInstallSource,\n\tformatSkillPackagePublishContract,\n} from \"./package-contract.js\";\n"]}

package/dist/skills/linter.d.ts

@@ -1,36 +0,0 @@
-export type SkillLintSeverity = "error" | "warning";
-export interface SkillLintIssue {
-    code: string;
-    severity: SkillLintSeverity;
-    message: string;
-    path: string;
-}
-export interface SkillLintResult {
-    path: string;
-    issues: SkillLintIssue[];
-}
-export interface SkillScaffoldOptions {
-    description?: string;
-    force?: boolean;
-}
-export interface SkillScaffoldResult {
-    name: string;
-    directory: string;
-    files: string[];
-}
-type SkillLintOptions = {
-    describeToolbox?: boolean;
-    platform?: NodeJS.Platform;
-};
-export declare const SKILL_BODY_MAX_LINES = 500;
-export declare const SKILL_BODY_MAX_CHARS = 20000;
-export declare function isWindowsRunnableToolboxEntry(path: string, pathExt?: string | undefined): boolean;
-export declare function shouldUseShellForToolboxDescribe(platform?: NodeJS.Platform): boolean;
-export declare function toolboxDescribeSpawnCommand(path: string, platform?: NodeJS.Platform): string;
-export declare function lintSkillDirectory(skillDir: string, options?: SkillLintOptions): Promise<SkillLintResult>;
-export declare function lintSkillPaths(paths: string[], options?: SkillLintOptions): Promise<SkillLintResult[]>;
-export declare function formatSkillLintText(results: SkillLintResult[]): string;
-export declare function hasSkillLintErrors(results: SkillLintResult[]): boolean;
-export declare function scaffoldSkill(baseDir: string, name: string, options?: SkillScaffoldOptions): SkillScaffoldResult;
-export {};
-//# sourceMappingURL=linter.d.ts.map

package/dist/skills/linter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"linter.d.ts","sourceRoot":"","sources":["../../src/skills/linter.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,KAAK,gBAAgB,GAAG;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AA6S3C,wBAAgB,6BAA6B,CAC5C,IAAI,EAAE,MAAM,EACZ,OAAO,qBAAsB,GAC3B,OAAO,CAKT;AAsBD,wBAAgB,gCAAgC,CAC/C,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC1C,OAAO,CAET;AAED,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC1C,MAAM,CAER;AA4FD,wBAAsB,kBAAkB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,eAAe,CAAC,CA+F1B;AAED,wBAAsB,cAAc,CACnC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,gBAAqB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC,CA6C5B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CA6BtE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAItE;AAED,wBAAgB,aAAa,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GAChC,mBAAmB,CAgFrB"}

package/dist/skills/linter.js

@@ -1,399 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, } from "node:fs";
-import { constants, access } from "node:fs/promises";
-import { basename, extname, join, resolve } from "node:path";
-import { writeTextFileAtomic } from "../utils/fs.js";
-import { SKILL_FRONTMATTER_FIELDS, findSkillMd, parseFrontmatter, stringArrayValue, } from "./loader.js";
-export const SKILL_BODY_MAX_LINES = 500;
-export const SKILL_BODY_MAX_CHARS = 20_000;
-const FIELD_SET = new Set(SKILL_FRONTMATTER_FIELDS);
-const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-function issue(code, severity, path, message) {
-    return { code, severity, path, message };
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function validateSkillName(value, dirName, path) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        return [
-            issue("missing_name", "error", path, "Skill frontmatter requires name."),
-        ];
-    }
-    const issues = [];
-    if (value.length > 64) {
-        issues.push(issue("name_too_long", "error", path, "Skill name must be <= 64 chars."));
-    }
-    if (!SKILL_NAME_PATTERN.test(value)) {
-        issues.push(issue("invalid_name", "error", path, "Skill name must use lowercase letters, numbers, and single hyphens."));
-    }
-    if (dirName !== "skills" && value !== dirName) {
-        issues.push(issue("name_mismatch", "error", path, `Skill name '${value}' must match directory '${dirName}'.`));
-    }
-    return issues;
-}
-function validateDescription(value, path) {
-    if (typeof value !== "string" || value.trim().length === 0) {
-        return [
-            issue("missing_description", "error", path, "Skill frontmatter requires description."),
-        ];
-    }
-    const issues = [];
-    if (value.length > 1024) {
-        issues.push(issue("description_too_long", "error", path, "Skill description must be <= 1024 chars."));
-    }
-    if (!/\b(use|when)\b/i.test(value)) {
-        issues.push(issue("description_missing_when", "warning", path, 'Description should include when to use the skill, for example "Use when ...".'));
-    }
-    return issues;
-}
-function validateStringArrayField(frontmatter, field, path) {
-    const value = frontmatter[field];
-    if (value === undefined)
-        return [];
-    if (Array.isArray(value)) {
-        if (value.length === 0 ||
-            value.some((entry) => typeof entry !== "string" || entry.trim() === "")) {
-            return [
-                issue("invalid_string_list", "error", path, `${field} entries must all be non-empty strings.`),
-            ];
-        }
-        return [];
-    }
-    const normalized = stringArrayValue(value);
-    if (!normalized || normalized.length === 0) {
-        return [
-            issue("invalid_string_list", "error", path, `${field} must be a non-empty string or list of strings.`),
-        ];
-    }
-    return [];
-}
-function isBooleanFrontmatterValue(value) {
-    if (typeof value === "boolean")
-        return true;
-    if (typeof value === "string") {
-        const normalized = value.toLowerCase();
-        return normalized === "true" || normalized === "false";
-    }
-    return false;
-}
-function validateBody(body, path) {
-    const issues = [];
-    const lines = body.split("\n").length;
-    if (lines > SKILL_BODY_MAX_LINES) {
-        issues.push(issue("skill_oversize", "error", path, `SKILL.md body has ${lines} lines; maximum is ${SKILL_BODY_MAX_LINES}.`));
-    }
-    if (body.length > SKILL_BODY_MAX_CHARS) {
-        issues.push(issue("skill_oversize", "error", path, `SKILL.md body has ${body.length} chars; maximum is ${SKILL_BODY_MAX_CHARS}.`));
-    }
-    return issues;
-}
-function validateMcpJson(skillDir) {
-    const path = join(skillDir, "mcp.json");
-    if (!existsSync(path))
-        return [];
-    let parsed;
-    try {
-        parsed = JSON.parse(readFileSync(path, "utf8"));
-    }
-    catch (error) {
-        return [
-            issue("invalid_mcp_json", "error", path, `mcp.json must be valid JSON: ${error instanceof Error ? error.message : String(error)}`),
-        ];
-    }
-    if (!isRecord(parsed)) {
-        return [
-            issue("invalid_mcp_json", "error", path, "mcp.json must be an object keyed by server name."),
-        ];
-    }
-    const issues = [];
-    for (const [serverName, server] of Object.entries(parsed)) {
-        const serverPath = `${path}#${serverName}`;
-        if (!isRecord(server)) {
-            issues.push(issue("invalid_mcp_server", "error", serverPath, "MCP server config must be an object."));
-            continue;
-        }
-        if (typeof server.command !== "string" || server.command.trim() === "") {
-            issues.push(issue("invalid_mcp_command", "error", serverPath, "MCP server requires a non-empty command."));
-        }
-        if (!Array.isArray(server.includeTools) ||
-            server.includeTools.length === 0) {
-            issues.push(issue("mcp_tools_unfiltered", "error", serverPath, "MCP server must declare includeTools with at least one tool."));
-        }
-        else if (server.includeTools.some((tool) => typeof tool !== "string" || tool.trim() === "")) {
-            issues.push(issue("invalid_mcp_include_tools", "error", serverPath, "includeTools entries must be non-empty strings."));
-        }
-        if (server.args !== undefined &&
-            (!Array.isArray(server.args) ||
-                server.args.some((arg) => typeof arg !== "string"))) {
-            issues.push(issue("invalid_mcp_args", "error", serverPath, "MCP args must be a list of strings."));
-        }
-        if (server.env !== undefined && !isRecord(server.env)) {
-            issues.push(issue("invalid_mcp_env", "error", serverPath, "MCP env must be an object of string values."));
-        }
-        if (isRecord(server.env) &&
-            Object.values(server.env).some((value) => typeof value !== "string")) {
-            issues.push(issue("invalid_mcp_env", "error", serverPath, "MCP env values must be strings."));
-        }
-    }
-    return issues;
-}
-const DEFAULT_WINDOWS_EXECUTABLE_EXTENSIONS = ".COM;.EXE;.BAT;.CMD;.PS1";
-function windowsExecutableExtensions(pathExt = process.env.PATHEXT) {
-    return new Set((pathExt || DEFAULT_WINDOWS_EXECUTABLE_EXTENSIONS)
-        .split(";")
-        .map((entry) => entry.trim().toUpperCase())
-        .filter(Boolean));
-}
-export function isWindowsRunnableToolboxEntry(path, pathExt = process.env.PATHEXT) {
-    const extension = extname(path).toUpperCase();
-    return Boolean(extension && windowsExecutableExtensions(pathExt).has(extension));
-}
-function hasWindowsRunnableToolboxCompanion(entry, directoryEntries, pathExt = process.env.PATHEXT) {
-    if (isWindowsRunnableToolboxEntry(entry, pathExt)) {
-        return false;
-    }
-    const entryStem = basename(entry, extname(entry)).toLowerCase();
-    return directoryEntries.some((candidate) => {
-        if (candidate === entry) {
-            return false;
-        }
-        if (!isWindowsRunnableToolboxEntry(candidate, pathExt)) {
-            return false;
-        }
-        return basename(candidate, extname(candidate)).toLowerCase() === entryStem;
-    });
-}
-export function shouldUseShellForToolboxDescribe(platform = process.platform) {
-    return platform === "win32";
-}
-export function toolboxDescribeSpawnCommand(path, platform = process.platform) {
-    return platform === "win32" ? `"${path}"` : path;
-}
-async function isExecutable(path, platform = process.platform) {
-    if (platform === "win32") {
-        return isWindowsRunnableToolboxEntry(path);
-    }
-    try {
-        await access(path, constants.X_OK);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function validateToolbox(skillDir, options = {}) {
-    const toolboxDir = join(skillDir, "toolbox");
-    if (!existsSync(toolboxDir) || !statSync(toolboxDir).isDirectory())
-        return [];
-    const issues = [];
-    const directoryEntries = readdirSync(toolboxDir);
-    const platform = options.platform ?? process.platform;
-    let toolboxEntryCount = 0;
-    let runnableEntryCount = 0;
-    for (const entry of directoryEntries) {
-        if (entry.startsWith(".") || entry.toLowerCase() === "readme.md")
-            continue;
-        const path = join(toolboxDir, entry);
-        if (!statSync(path).isFile())
-            continue;
-        toolboxEntryCount += 1;
-        if (platform !== "win32" && isWindowsRunnableToolboxEntry(path)) {
-            continue;
-        }
-        if (platform === "win32" &&
-            !isWindowsRunnableToolboxEntry(path) &&
-            hasWindowsRunnableToolboxCompanion(entry, directoryEntries)) {
-            continue;
-        }
-        if (!(await isExecutable(path, platform))) {
-            issues.push(issue("toolbox_not_executable", "error", path, "Toolbox entries must be executable files."));
-            continue;
-        }
-        runnableEntryCount += 1;
-        if (options.describeToolbox) {
-            const result = spawnSync(toolboxDescribeSpawnCommand(path, platform), {
-                env: { ...process.env, MAESTRO_TOOLBOX_ACTION: "describe" },
-                encoding: "utf8",
-                shell: shouldUseShellForToolboxDescribe(platform),
-                timeout: 5000,
-            });
-            if (result.status !== 0) {
-                issues.push(issue("toolbox_describe_failed", "error", path, `Toolbox describe failed: ${result.stderr || result.stdout || "non-zero exit"}`));
-            }
-        }
-    }
-    if (toolboxEntryCount > 0 &&
-        runnableEntryCount === 0 &&
-        issues.length === 0) {
-        issues.push(issue("toolbox_no_runnable_entries", "error", toolboxDir, "Toolbox must include at least one executable entry runnable on the target platform."));
-    }
-    return issues;
-}
-export async function lintSkillDirectory(skillDir, options = {}) {
-    const resolvedDir = resolve(skillDir);
-    const skillFile = findSkillMd(resolvedDir);
-    const issues = [];
-    if (!skillFile) {
-        return {
-            path: resolvedDir,
-            issues: [
-                issue("missing_skill_md", "error", resolvedDir, "Skill package requires SKILL.md."),
-            ],
-        };
-    }
-    try {
-        const { frontmatter, body } = parseFrontmatter(readFileSync(skillFile, "utf8"));
-        for (const key of Object.keys(frontmatter)) {
-            if (!FIELD_SET.has(key)) {
-                issues.push(issue("unexpected_field", "error", skillFile, `Unexpected frontmatter field '${key}'.`));
-            }
-        }
-        issues.push(...validateSkillName(frontmatter.name, basename(resolvedDir), skillFile));
-        issues.push(...validateDescription(frontmatter.description, skillFile));
-        for (const field of ["allowed-tools", "builtin-tools"]) {
-            issues.push(...validateStringArrayField(frontmatter, field, skillFile));
-        }
-        if (frontmatter.compatibility !== undefined &&
-            typeof frontmatter.compatibility !== "string") {
-            issues.push(issue("invalid_compatibility", "error", skillFile, "compatibility must be a string."));
-        }
-        if (frontmatter.isolatedContext !== undefined &&
-            !isBooleanFrontmatterValue(frontmatter.isolatedContext)) {
-            issues.push(issue("invalid_isolated_context", "error", skillFile, "isolatedContext must be a boolean."));
-        }
-        issues.push(...validateBody(body, skillFile));
-    }
-    catch (error) {
-        issues.push(issue("invalid_skill_md", "error", skillFile, error instanceof Error ? error.message : String(error)));
-    }
-    if (existsSync(join(resolvedDir, "reference")) &&
-        existsSync(join(resolvedDir, "references"))) {
-        issues.push(issue("duplicate_reference_dirs", "warning", resolvedDir, "Use either reference/ or references/; reference/ is preferred."));
-    }
-    issues.push(...validateMcpJson(resolvedDir));
-    issues.push(...(await validateToolbox(resolvedDir, options)));
-    return { path: resolvedDir, issues };
-}
-export async function lintSkillPaths(paths, options = {}) {
-    const results = [];
-    for (const path of paths) {
-        const resolved = resolve(path);
-        if (!existsSync(resolved)) {
-            results.push({
-                path: resolved,
-                issues: [
-                    issue("missing_path", "error", resolved, "Skill path does not exist."),
-                ],
-            });
-            continue;
-        }
-        const stat = statSync(resolved);
-        if (!stat.isDirectory()) {
-            results.push({
-                path: resolved,
-                issues: [
-                    issue("invalid_path", "error", resolved, "Skill path must be a directory."),
-                ],
-            });
-            continue;
-        }
-        if (findSkillMd(resolved)) {
-            results.push(await lintSkillDirectory(resolved, options));
-            continue;
-        }
-        for (const entry of readdirSync(resolved)) {
-            const child = join(resolved, entry);
-            if (statSync(child).isDirectory()) {
-                results.push(await lintSkillDirectory(child, options));
-            }
-        }
-    }
-    return results;
-}
-export function formatSkillLintText(results) {
-    const lines = [];
-    let errorCount = 0;
-    let warningCount = 0;
-    for (const result of results) {
-        const issues = result.issues;
-        if (issues.length === 0) {
-            lines.push(`OK ${result.path}`);
-            continue;
-        }
-        lines.push(result.path);
-        for (const item of issues) {
-            if (item.severity === "error")
-                errorCount++;
-            if (item.severity === "warning")
-                warningCount++;
-            lines.push(`  ${item.severity.toUpperCase()} ${item.code}: ${item.message}`);
-            if (item.path !== result.path) {
-                lines.push(`    ${item.path}`);
-            }
-        }
-    }
-    lines.push("");
-    lines.push(`${errorCount} error${errorCount === 1 ? "" : "s"}, ${warningCount} warning${warningCount === 1 ? "" : "s"}`);
-    return lines.join("\n");
-}
-export function hasSkillLintErrors(results) {
-    return results.some((result) => result.issues.some((item) => item.severity === "error"));
-}
-export function scaffoldSkill(baseDir, name, options = {}) {
-    if (!SKILL_NAME_PATTERN.test(name) || name.length > 64) {
-        throw new Error("Skill name must use lowercase letters, numbers, and single hyphens.");
-    }
-    const directory = resolve(baseDir, name);
-    if (existsSync(directory) && !options.force) {
-        throw new Error(`Skill already exists at ${directory}`);
-    }
-    const description = options.description ??
-        `${name.replace(/-/g, " ")}. Use when a task needs this packaged workflow.`;
-    const files = [];
-    mkdirSync(join(directory, "reference"), { recursive: true });
-    mkdirSync(join(directory, "scripts"), { recursive: true });
-    mkdirSync(join(directory, "toolbox"), { recursive: true });
-    const skillMd = join(directory, "SKILL.md");
-    const escapedDescription = description
-        .replace(/\\/g, "\\\\")
-        .replace(/"/g, '\\"');
-    writeTextFileAtomic(skillMd, [
-        "---",
-        `name: ${name}`,
-        `description: "${escapedDescription}"`,
-        "allowed-tools:",
-        "  - read",
-        "builtin-tools:",
-        "  - read",
-        "---",
-        "",
-        `# ${name}`,
-        "",
-        "## Workflow",
-        "",
-        "1. State the task-specific outcome.",
-        "2. Load only the reference files needed for the request.",
-        "3. Use bundled scripts or toolbox executables when they are more reliable than retyping long commands.",
-        "",
-        "## References",
-        "",
-        "- Read `reference/overview.md` when the user asks for implementation detail.",
-        "",
-    ].join("\n"));
-    files.push(skillMd);
-    const reference = join(directory, "reference", "overview.md");
-    writeTextFileAtomic(reference, `# ${name} Reference\n\nAdd deeper examples, protocol notes, and troubleshooting details here. Keep this out of SKILL.md until needed.\n`);
-    files.push(reference);
-    const scriptsReadme = join(directory, "scripts", "README.md");
-    writeTextFileAtomic(scriptsReadme, "# Scripts\n\nPut deterministic helper scripts here. Agents should run these instead of retyping long workflows.\n");
-    files.push(scriptsReadme);
-    const toolboxReadme = join(directory, "toolbox", "README.md");
-    writeTextFileAtomic(toolboxReadme, "# Toolbox\n\nPut executable Toolbox protocol commands here. Each executable should support `MAESTRO_TOOLBOX_ACTION=describe`.\n");
-    files.push(toolboxReadme);
-    const mcpJson = join(directory, "mcp.json.example");
-    writeTextFileAtomic(mcpJson, '{\n  "example-server": {\n    "command": "npx",\n    "args": ["-y", "example-mcp-server"],\n    "includeTools": ["example_tool"]\n  }\n}\n');
-    files.push(mcpJson);
-    return { name, directory, files };
-}
-//# sourceMappingURL=linter.js.map

package/dist/skills/linter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"linter.js","sourceRoot":"","sources":["../../src/skills/linter.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport {\n\texistsSync,\n\tmkdirSync,\n\treadFileSync,\n\treaddirSync,\n\tstatSync,\n} from \"node:fs\";\nimport { constants, access } from \"node:fs/promises\";\nimport { basename, extname, join, resolve } from \"node:path\";\nimport { writeTextFileAtomic } from \"../utils/fs.js\";\nimport {\n\tSKILL_FRONTMATTER_FIELDS,\n\tfindSkillMd,\n\tparseFrontmatter,\n\tstringArrayValue,\n} from \"./loader.js\";\n\nexport type SkillLintSeverity = \"error\" | \"warning\";\n\nexport interface SkillLintIssue {\n\tcode: string;\n\tseverity: SkillLintSeverity;\n\tmessage: string;\n\tpath: string;\n}\n\nexport interface SkillLintResult {\n\tpath: string;\n\tissues: SkillLintIssue[];\n}\n\nexport interface SkillScaffoldOptions {\n\tdescription?: string;\n\tforce?: boolean;\n}\n\nexport interface SkillScaffoldResult {\n\tname: string;\n\tdirectory: string;\n\tfiles: string[];\n}\n\ntype SkillLintOptions = {\n\tdescribeToolbox?: boolean;\n\tplatform?: NodeJS.Platform;\n};\n\nexport const SKILL_BODY_MAX_LINES = 500;\nexport const SKILL_BODY_MAX_CHARS = 20_000;\n\nconst FIELD_SET = new Set<string>(SKILL_FRONTMATTER_FIELDS);\nconst SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\n\nfunction issue(\n\tcode: string,\n\tseverity: SkillLintSeverity,\n\tpath: string,\n\tmessage: string,\n): SkillLintIssue {\n\treturn { code, severity, path, message };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction validateSkillName(\n\tvalue: unknown,\n\tdirName: string,\n\tpath: string,\n): SkillLintIssue[] {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\treturn [\n\t\t\tissue(\"missing_name\", \"error\", path, \"Skill frontmatter requires name.\"),\n\t\t];\n\t}\n\n\tconst issues: SkillLintIssue[] = [];\n\tif (value.length > 64) {\n\t\tissues.push(\n\t\t\tissue(\"name_too_long\", \"error\", path, \"Skill name must be <= 64 chars.\"),\n\t\t);\n\t}\n\tif (!SKILL_NAME_PATTERN.test(value)) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"invalid_name\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t\"Skill name must use lowercase letters, numbers, and single hyphens.\",\n\t\t\t),\n\t\t);\n\t}\n\tif (dirName !== \"skills\" && value !== dirName) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"name_mismatch\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t`Skill name '${value}' must match directory '${dirName}'.`,\n\t\t\t),\n\t\t);\n\t}\n\treturn issues;\n}\n\nfunction validateDescription(value: unknown, path: string): SkillLintIssue[] {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\treturn [\n\t\t\tissue(\n\t\t\t\t\"missing_description\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t\"Skill frontmatter requires description.\",\n\t\t\t),\n\t\t];\n\t}\n\n\tconst issues: SkillLintIssue[] = [];\n\tif (value.length > 1024) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"description_too_long\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t\"Skill description must be <= 1024 chars.\",\n\t\t\t),\n\t\t);\n\t}\n\tif (!/\\b(use|when)\\b/i.test(value)) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"description_missing_when\",\n\t\t\t\t\"warning\",\n\t\t\t\tpath,\n\t\t\t\t'Description should include when to use the skill, for example \"Use when ...\".',\n\t\t\t),\n\t\t);\n\t}\n\treturn issues;\n}\n\nfunction validateStringArrayField(\n\tfrontmatter: Record<string, unknown>,\n\tfield: string,\n\tpath: string,\n): SkillLintIssue[] {\n\tconst value = frontmatter[field];\n\tif (value === undefined) return [];\n\tif (Array.isArray(value)) {\n\t\tif (\n\t\t\tvalue.length === 0 ||\n\t\t\tvalue.some((entry) => typeof entry !== \"string\" || entry.trim() === \"\")\n\t\t) {\n\t\t\treturn [\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_string_list\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tpath,\n\t\t\t\t\t`${field} entries must all be non-empty strings.`,\n\t\t\t\t),\n\t\t\t];\n\t\t}\n\t\treturn [];\n\t}\n\tconst normalized = stringArrayValue(value);\n\tif (!normalized || normalized.length === 0) {\n\t\treturn [\n\t\t\tissue(\n\t\t\t\t\"invalid_string_list\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t`${field} must be a non-empty string or list of strings.`,\n\t\t\t),\n\t\t];\n\t}\n\treturn [];\n}\n\nfunction isBooleanFrontmatterValue(value: unknown): boolean {\n\tif (typeof value === \"boolean\") return true;\n\tif (typeof value === \"string\") {\n\t\tconst normalized = value.toLowerCase();\n\t\treturn normalized === \"true\" || normalized === \"false\";\n\t}\n\treturn false;\n}\n\nfunction validateBody(body: string, path: string): SkillLintIssue[] {\n\tconst issues: SkillLintIssue[] = [];\n\tconst lines = body.split(\"\\n\").length;\n\tif (lines > SKILL_BODY_MAX_LINES) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"skill_oversize\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t`SKILL.md body has ${lines} lines; maximum is ${SKILL_BODY_MAX_LINES}.`,\n\t\t\t),\n\t\t);\n\t}\n\tif (body.length > SKILL_BODY_MAX_CHARS) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"skill_oversize\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t`SKILL.md body has ${body.length} chars; maximum is ${SKILL_BODY_MAX_CHARS}.`,\n\t\t\t),\n\t\t);\n\t}\n\treturn issues;\n}\n\nfunction validateMcpJson(skillDir: string): SkillLintIssue[] {\n\tconst path = join(skillDir, \"mcp.json\");\n\tif (!existsSync(path)) return [];\n\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(readFileSync(path, \"utf8\"));\n\t} catch (error) {\n\t\treturn [\n\t\t\tissue(\n\t\t\t\t\"invalid_mcp_json\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t`mcp.json must be valid JSON: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t}`,\n\t\t\t),\n\t\t];\n\t}\n\n\tif (!isRecord(parsed)) {\n\t\treturn [\n\t\t\tissue(\n\t\t\t\t\"invalid_mcp_json\",\n\t\t\t\t\"error\",\n\t\t\t\tpath,\n\t\t\t\t\"mcp.json must be an object keyed by server name.\",\n\t\t\t),\n\t\t];\n\t}\n\n\tconst issues: SkillLintIssue[] = [];\n\tfor (const [serverName, server] of Object.entries(parsed)) {\n\t\tconst serverPath = `${path}#${serverName}`;\n\t\tif (!isRecord(server)) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_mcp_server\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tserverPath,\n\t\t\t\t\t\"MCP server config must be an object.\",\n\t\t\t\t),\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (typeof server.command !== \"string\" || server.command.trim() === \"\") {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_mcp_command\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tserverPath,\n\t\t\t\t\t\"MCP server requires a non-empty command.\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tif (\n\t\t\t!Array.isArray(server.includeTools) ||\n\t\t\tserver.includeTools.length === 0\n\t\t) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"mcp_tools_unfiltered\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tserverPath,\n\t\t\t\t\t\"MCP server must declare includeTools with at least one tool.\",\n\t\t\t\t),\n\t\t\t);\n\t\t} else if (\n\t\t\tserver.includeTools.some(\n\t\t\t\t(tool) => typeof tool !== \"string\" || tool.trim() === \"\",\n\t\t\t)\n\t\t) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_mcp_include_tools\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tserverPath,\n\t\t\t\t\t\"includeTools entries must be non-empty strings.\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tif (\n\t\t\tserver.args !== undefined &&\n\t\t\t(!Array.isArray(server.args) ||\n\t\t\t\tserver.args.some((arg) => typeof arg !== \"string\"))\n\t\t) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_mcp_args\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tserverPath,\n\t\t\t\t\t\"MCP args must be a list of strings.\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tif (server.env !== undefined && !isRecord(server.env)) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_mcp_env\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tserverPath,\n\t\t\t\t\t\"MCP env must be an object of string values.\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tif (\n\t\t\tisRecord(server.env) &&\n\t\t\tObject.values(server.env).some((value) => typeof value !== \"string\")\n\t\t) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_mcp_env\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tserverPath,\n\t\t\t\t\t\"MCP env values must be strings.\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t}\n\treturn issues;\n}\n\nconst DEFAULT_WINDOWS_EXECUTABLE_EXTENSIONS = \".COM;.EXE;.BAT;.CMD;.PS1\";\n\nfunction windowsExecutableExtensions(\n\tpathExt = process.env.PATHEXT,\n): Set<string> {\n\treturn new Set(\n\t\t(pathExt || DEFAULT_WINDOWS_EXECUTABLE_EXTENSIONS)\n\t\t\t.split(\";\")\n\t\t\t.map((entry) => entry.trim().toUpperCase())\n\t\t\t.filter(Boolean),\n\t);\n}\n\nexport function isWindowsRunnableToolboxEntry(\n\tpath: string,\n\tpathExt = process.env.PATHEXT,\n): boolean {\n\tconst extension = extname(path).toUpperCase();\n\treturn Boolean(\n\t\textension && windowsExecutableExtensions(pathExt).has(extension),\n\t);\n}\n\nfunction hasWindowsRunnableToolboxCompanion(\n\tentry: string,\n\tdirectoryEntries: string[],\n\tpathExt = process.env.PATHEXT,\n): boolean {\n\tif (isWindowsRunnableToolboxEntry(entry, pathExt)) {\n\t\treturn false;\n\t}\n\tconst entryStem = basename(entry, extname(entry)).toLowerCase();\n\treturn directoryEntries.some((candidate) => {\n\t\tif (candidate === entry) {\n\t\t\treturn false;\n\t\t}\n\t\tif (!isWindowsRunnableToolboxEntry(candidate, pathExt)) {\n\t\t\treturn false;\n\t\t}\n\t\treturn basename(candidate, extname(candidate)).toLowerCase() === entryStem;\n\t});\n}\n\nexport function shouldUseShellForToolboxDescribe(\n\tplatform: NodeJS.Platform = process.platform,\n): boolean {\n\treturn platform === \"win32\";\n}\n\nexport function toolboxDescribeSpawnCommand(\n\tpath: string,\n\tplatform: NodeJS.Platform = process.platform,\n): string {\n\treturn platform === \"win32\" ? `\"${path}\"` : path;\n}\n\nasync function isExecutable(\n\tpath: string,\n\tplatform: NodeJS.Platform = process.platform,\n): Promise<boolean> {\n\tif (platform === \"win32\") {\n\t\treturn isWindowsRunnableToolboxEntry(path);\n\t}\n\ttry {\n\t\tawait access(path, constants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nasync function validateToolbox(\n\tskillDir: string,\n\toptions: SkillLintOptions = {},\n): Promise<SkillLintIssue[]> {\n\tconst toolboxDir = join(skillDir, \"toolbox\");\n\tif (!existsSync(toolboxDir) || !statSync(toolboxDir).isDirectory()) return [];\n\n\tconst issues: SkillLintIssue[] = [];\n\tconst directoryEntries = readdirSync(toolboxDir);\n\tconst platform = options.platform ?? process.platform;\n\tlet toolboxEntryCount = 0;\n\tlet runnableEntryCount = 0;\n\tfor (const entry of directoryEntries) {\n\t\tif (entry.startsWith(\".\") || entry.toLowerCase() === \"readme.md\") continue;\n\t\tconst path = join(toolboxDir, entry);\n\t\tif (!statSync(path).isFile()) continue;\n\t\ttoolboxEntryCount += 1;\n\t\tif (platform !== \"win32\" && isWindowsRunnableToolboxEntry(path)) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (\n\t\t\tplatform === \"win32\" &&\n\t\t\t!isWindowsRunnableToolboxEntry(path) &&\n\t\t\thasWindowsRunnableToolboxCompanion(entry, directoryEntries)\n\t\t) {\n\t\t\tcontinue;\n\t\t}\n\t\tif (!(await isExecutable(path, platform))) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"toolbox_not_executable\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tpath,\n\t\t\t\t\t\"Toolbox entries must be executable files.\",\n\t\t\t\t),\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\trunnableEntryCount += 1;\n\t\tif (options.describeToolbox) {\n\t\t\tconst result = spawnSync(toolboxDescribeSpawnCommand(path, platform), {\n\t\t\t\tenv: { ...process.env, MAESTRO_TOOLBOX_ACTION: \"describe\" },\n\t\t\t\tencoding: \"utf8\",\n\t\t\t\tshell: shouldUseShellForToolboxDescribe(platform),\n\t\t\t\ttimeout: 5000,\n\t\t\t});\n\t\t\tif (result.status !== 0) {\n\t\t\t\tissues.push(\n\t\t\t\t\tissue(\n\t\t\t\t\t\t\"toolbox_describe_failed\",\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t\tpath,\n\t\t\t\t\t\t`Toolbox describe failed: ${result.stderr || result.stdout || \"non-zero exit\"}`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n\tif (\n\t\ttoolboxEntryCount > 0 &&\n\t\trunnableEntryCount === 0 &&\n\t\tissues.length === 0\n\t) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"toolbox_no_runnable_entries\",\n\t\t\t\t\"error\",\n\t\t\t\ttoolboxDir,\n\t\t\t\t\"Toolbox must include at least one executable entry runnable on the target platform.\",\n\t\t\t),\n\t\t);\n\t}\n\treturn issues;\n}\n\nexport async function lintSkillDirectory(\n\tskillDir: string,\n\toptions: SkillLintOptions = {},\n): Promise<SkillLintResult> {\n\tconst resolvedDir = resolve(skillDir);\n\tconst skillFile = findSkillMd(resolvedDir);\n\tconst issues: SkillLintIssue[] = [];\n\tif (!skillFile) {\n\t\treturn {\n\t\t\tpath: resolvedDir,\n\t\t\tissues: [\n\t\t\t\tissue(\n\t\t\t\t\t\"missing_skill_md\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tresolvedDir,\n\t\t\t\t\t\"Skill package requires SKILL.md.\",\n\t\t\t\t),\n\t\t\t],\n\t\t};\n\t}\n\n\ttry {\n\t\tconst { frontmatter, body } = parseFrontmatter(\n\t\t\treadFileSync(skillFile, \"utf8\"),\n\t\t);\n\t\tfor (const key of Object.keys(frontmatter)) {\n\t\t\tif (!FIELD_SET.has(key)) {\n\t\t\t\tissues.push(\n\t\t\t\t\tissue(\n\t\t\t\t\t\t\"unexpected_field\",\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t\tskillFile,\n\t\t\t\t\t\t`Unexpected frontmatter field '${key}'.`,\n\t\t\t\t\t),\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tissues.push(\n\t\t\t...validateSkillName(frontmatter.name, basename(resolvedDir), skillFile),\n\t\t);\n\t\tissues.push(...validateDescription(frontmatter.description, skillFile));\n\t\tfor (const field of [\"allowed-tools\", \"builtin-tools\"]) {\n\t\t\tissues.push(...validateStringArrayField(frontmatter, field, skillFile));\n\t\t}\n\t\tif (\n\t\t\tfrontmatter.compatibility !== undefined &&\n\t\t\ttypeof frontmatter.compatibility !== \"string\"\n\t\t) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_compatibility\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tskillFile,\n\t\t\t\t\t\"compatibility must be a string.\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tif (\n\t\t\tfrontmatter.isolatedContext !== undefined &&\n\t\t\t!isBooleanFrontmatterValue(frontmatter.isolatedContext)\n\t\t) {\n\t\t\tissues.push(\n\t\t\t\tissue(\n\t\t\t\t\t\"invalid_isolated_context\",\n\t\t\t\t\t\"error\",\n\t\t\t\t\tskillFile,\n\t\t\t\t\t\"isolatedContext must be a boolean.\",\n\t\t\t\t),\n\t\t\t);\n\t\t}\n\t\tissues.push(...validateBody(body, skillFile));\n\t} catch (error) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"invalid_skill_md\",\n\t\t\t\t\"error\",\n\t\t\t\tskillFile,\n\t\t\t\terror instanceof Error ? error.message : String(error),\n\t\t\t),\n\t\t);\n\t}\n\n\tif (\n\t\texistsSync(join(resolvedDir, \"reference\")) &&\n\t\texistsSync(join(resolvedDir, \"references\"))\n\t) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\t\"duplicate_reference_dirs\",\n\t\t\t\t\"warning\",\n\t\t\t\tresolvedDir,\n\t\t\t\t\"Use either reference/ or references/; reference/ is preferred.\",\n\t\t\t),\n\t\t);\n\t}\n\tissues.push(...validateMcpJson(resolvedDir));\n\tissues.push(...(await validateToolbox(resolvedDir, options)));\n\treturn { path: resolvedDir, issues };\n}\n\nexport async function lintSkillPaths(\n\tpaths: string[],\n\toptions: SkillLintOptions = {},\n): Promise<SkillLintResult[]> {\n\tconst results: SkillLintResult[] = [];\n\tfor (const path of paths) {\n\t\tconst resolved = resolve(path);\n\t\tif (!existsSync(resolved)) {\n\t\t\tresults.push({\n\t\t\t\tpath: resolved,\n\t\t\t\tissues: [\n\t\t\t\t\tissue(\n\t\t\t\t\t\t\"missing_path\",\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t\tresolved,\n\t\t\t\t\t\t\"Skill path does not exist.\",\n\t\t\t\t\t),\n\t\t\t\t],\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tconst stat = statSync(resolved);\n\t\tif (!stat.isDirectory()) {\n\t\t\tresults.push({\n\t\t\t\tpath: resolved,\n\t\t\t\tissues: [\n\t\t\t\t\tissue(\n\t\t\t\t\t\t\"invalid_path\",\n\t\t\t\t\t\t\"error\",\n\t\t\t\t\t\tresolved,\n\t\t\t\t\t\t\"Skill path must be a directory.\",\n\t\t\t\t\t),\n\t\t\t\t],\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tif (findSkillMd(resolved)) {\n\t\t\tresults.push(await lintSkillDirectory(resolved, options));\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const entry of readdirSync(resolved)) {\n\t\t\tconst child = join(resolved, entry);\n\t\t\tif (statSync(child).isDirectory()) {\n\t\t\t\tresults.push(await lintSkillDirectory(child, options));\n\t\t\t}\n\t\t}\n\t}\n\treturn results;\n}\n\nexport function formatSkillLintText(results: SkillLintResult[]): string {\n\tconst lines: string[] = [];\n\tlet errorCount = 0;\n\tlet warningCount = 0;\n\tfor (const result of results) {\n\t\tconst issues = result.issues;\n\t\tif (issues.length === 0) {\n\t\t\tlines.push(`OK ${result.path}`);\n\t\t\tcontinue;\n\t\t}\n\t\tlines.push(result.path);\n\t\tfor (const item of issues) {\n\t\t\tif (item.severity === \"error\") errorCount++;\n\t\t\tif (item.severity === \"warning\") warningCount++;\n\t\t\tlines.push(\n\t\t\t\t`  ${item.severity.toUpperCase()} ${item.code}: ${item.message}`,\n\t\t\t);\n\t\t\tif (item.path !== result.path) {\n\t\t\t\tlines.push(`    ${item.path}`);\n\t\t\t}\n\t\t}\n\t}\n\tlines.push(\"\");\n\tlines.push(\n\t\t`${errorCount} error${errorCount === 1 ? \"\" : \"s\"}, ${warningCount} warning${\n\t\t\twarningCount === 1 ? \"\" : \"s\"\n\t\t}`,\n\t);\n\treturn lines.join(\"\\n\");\n}\n\nexport function hasSkillLintErrors(results: SkillLintResult[]): boolean {\n\treturn results.some((result) =>\n\t\tresult.issues.some((item) => item.severity === \"error\"),\n\t);\n}\n\nexport function scaffoldSkill(\n\tbaseDir: string,\n\tname: string,\n\toptions: SkillScaffoldOptions = {},\n): SkillScaffoldResult {\n\tif (!SKILL_NAME_PATTERN.test(name) || name.length > 64) {\n\t\tthrow new Error(\n\t\t\t\"Skill name must use lowercase letters, numbers, and single hyphens.\",\n\t\t);\n\t}\n\tconst directory = resolve(baseDir, name);\n\tif (existsSync(directory) && !options.force) {\n\t\tthrow new Error(`Skill already exists at ${directory}`);\n\t}\n\n\tconst description =\n\t\toptions.description ??\n\t\t`${name.replace(/-/g, \" \")}. Use when a task needs this packaged workflow.`;\n\tconst files: string[] = [];\n\tmkdirSync(join(directory, \"reference\"), { recursive: true });\n\tmkdirSync(join(directory, \"scripts\"), { recursive: true });\n\tmkdirSync(join(directory, \"toolbox\"), { recursive: true });\n\n\tconst skillMd = join(directory, \"SKILL.md\");\n\tconst escapedDescription = description\n\t\t.replace(/\\\\/g, \"\\\\\\\\\")\n\t\t.replace(/\"/g, '\\\\\"');\n\twriteTextFileAtomic(\n\t\tskillMd,\n\t\t[\n\t\t\t\"---\",\n\t\t\t`name: ${name}`,\n\t\t\t`description: \"${escapedDescription}\"`,\n\t\t\t\"allowed-tools:\",\n\t\t\t\"  - read\",\n\t\t\t\"builtin-tools:\",\n\t\t\t\"  - read\",\n\t\t\t\"---\",\n\t\t\t\"\",\n\t\t\t`# ${name}`,\n\t\t\t\"\",\n\t\t\t\"## Workflow\",\n\t\t\t\"\",\n\t\t\t\"1. State the task-specific outcome.\",\n\t\t\t\"2. Load only the reference files needed for the request.\",\n\t\t\t\"3. Use bundled scripts or toolbox executables when they are more reliable than retyping long commands.\",\n\t\t\t\"\",\n\t\t\t\"## References\",\n\t\t\t\"\",\n\t\t\t\"- Read `reference/overview.md` when the user asks for implementation detail.\",\n\t\t\t\"\",\n\t\t].join(\"\\n\"),\n\t);\n\tfiles.push(skillMd);\n\n\tconst reference = join(directory, \"reference\", \"overview.md\");\n\twriteTextFileAtomic(\n\t\treference,\n\t\t`# ${name} Reference\\n\\nAdd deeper examples, protocol notes, and troubleshooting details here. Keep this out of SKILL.md until needed.\\n`,\n\t);\n\tfiles.push(reference);\n\n\tconst scriptsReadme = join(directory, \"scripts\", \"README.md\");\n\twriteTextFileAtomic(\n\t\tscriptsReadme,\n\t\t\"# Scripts\\n\\nPut deterministic helper scripts here. Agents should run these instead of retyping long workflows.\\n\",\n\t);\n\tfiles.push(scriptsReadme);\n\n\tconst toolboxReadme = join(directory, \"toolbox\", \"README.md\");\n\twriteTextFileAtomic(\n\t\ttoolboxReadme,\n\t\t\"# Toolbox\\n\\nPut executable Toolbox protocol commands here. Each executable should support `MAESTRO_TOOLBOX_ACTION=describe`.\\n\",\n\t);\n\tfiles.push(toolboxReadme);\n\n\tconst mcpJson = join(directory, \"mcp.json.example\");\n\twriteTextFileAtomic(\n\t\tmcpJson,\n\t\t'{\\n  \"example-server\": {\\n    \"command\": \"npx\",\\n    \"args\": [\"-y\", \"example-mcp-server\"],\\n    \"includeTools\": [\"example_tool\"]\\n  }\\n}\\n',\n\t);\n\tfiles.push(mcpJson);\n\n\treturn { name, directory, files };\n}\n"]}