@0xmaxma/claude-gateway 1.0.0

package/dist/skills/loader.d.ts

@@ -0,0 +1,23 @@
+import { type SkillDefinition } from './parser';
+export interface SkillRegistry {
+    skills: Map<string, SkillDefinition>;
+}
+export interface LoadSkillsOptions {
+    workspaceDir: string;
+    mcpToolsDir?: string;
+    sharedSkillsDir?: string;
+    logger?: {
+        warn: (msg: string) => void;
+    };
+}
+/**
+ * Load all skills from workspace, module, and shared directories.
+ * Priority: workspace > module > shared (workspace overrides same-name skills).
+ */
+export declare function loadSkills(opts: LoadSkillsOptions): SkillRegistry;
+/**
+ * Render the AVAILABLE SKILLS section for the system prompt.
+ * Groups skills by source: workspace, module, shared.
+ */
+export declare function renderSkillsSection(registry: SkillRegistry): string;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/skills/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,eAAe,EAA0B,MAAM,UAAU,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CAC1C;AAiGD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAuCjE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAwCnE"}

package/dist/skills/loader.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSkills = loadSkills;
+exports.renderSkillsSection = renderSkillsSection;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const parser_1 = require("./parser");
+/**
+ * Scan a directory for skill subdirectories containing SKILL.md.
+ * Each subdirectory name is the skill name used for directory-based discovery.
+ */
+function scanSkillDir(dir, source, modulePrefix) {
+    if (!fs_1.default.existsSync(dir))
+        return [];
+    const skills = [];
+    let entries;
+    try {
+        entries = fs_1.default.readdirSync(dir).sort();
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (entry.startsWith('.') || entry === 'node_modules')
+            continue;
+        const skillDir = path_1.default.join(dir, entry);
+        const skillFile = path_1.default.join(skillDir, 'SKILL.md');
+        try {
+            const stat = fs_1.default.statSync(skillDir);
+            if (!stat.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (!fs_1.default.existsSync(skillFile))
+            continue;
+        try {
+            const raw = fs_1.default.readFileSync(skillFile, 'utf-8');
+            const opts = { filePath: skillFile, source, modulePrefix };
+            const skill = (0, parser_1.parseSkill)(raw, opts);
+            if (skill)
+                skills.push(skill);
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return skills;
+}
+/**
+ * Scan MCP tool module directories for skills.
+ * Structure: mcpToolsDir/{module}/skills/{skill-name}/SKILL.md
+ * Skills are prefixed with {module}: in the registry.
+ */
+function scanModuleSkills(mcpToolsDir) {
+    if (!fs_1.default.existsSync(mcpToolsDir))
+        return [];
+    const skills = [];
+    let modules;
+    try {
+        modules = fs_1.default.readdirSync(mcpToolsDir).sort();
+    }
+    catch {
+        return [];
+    }
+    for (const mod of modules) {
+        if (mod.startsWith('.') || mod === 'node_modules')
+            continue;
+        const skillsDir = path_1.default.join(mcpToolsDir, mod, 'skills');
+        const moduleSkills = scanSkillDir(skillsDir, 'module', mod);
+        skills.push(...moduleSkills);
+    }
+    return skills;
+}
+/**
+ * Check if required binaries are available in PATH.
+ */
+function checkBinAvailability(bins) {
+    const missing = [];
+    const pathDirs = (process.env.PATH || '').split(path_1.default.delimiter);
+    for (const bin of bins) {
+        const found = pathDirs.some((dir) => {
+            try {
+                const binPath = path_1.default.join(dir, bin);
+                fs_1.default.accessSync(binPath, fs_1.default.constants.X_OK);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        });
+        if (!found)
+            missing.push(bin);
+    }
+    return missing;
+}
+/**
+ * Load all skills from workspace, module, and shared directories.
+ * Priority: workspace > module > shared (workspace overrides same-name skills).
+ */
+function loadSkills(opts) {
+    const registry = new Map();
+    const log = opts.logger || { warn: () => { } };
+    // 1. Shared skills (lowest priority, loaded first)
+    if (opts.sharedSkillsDir) {
+        const shared = scanSkillDir(opts.sharedSkillsDir, 'shared');
+        for (const skill of shared) {
+            registry.set(skill.name, skill);
+        }
+    }
+    // 2. Module skills (middle priority)
+    if (opts.mcpToolsDir) {
+        const moduleSkills = scanModuleSkills(opts.mcpToolsDir);
+        for (const skill of moduleSkills) {
+            const key = skill.modulePrefix ? `${skill.modulePrefix}:${skill.name}` : skill.name;
+            registry.set(key, skill);
+        }
+    }
+    // 3. Workspace skills (highest priority, overrides shared)
+    const workspaceSkillsDir = path_1.default.join(opts.workspaceDir, 'skills');
+    const workspaceSkills = scanSkillDir(workspaceSkillsDir, 'workspace');
+    for (const skill of workspaceSkills) {
+        registry.set(skill.name, skill);
+    }
+    // Warn about missing binary dependencies
+    for (const [key, skill] of registry) {
+        if (skill.requires?.bins) {
+            const missing = checkBinAvailability(skill.requires.bins);
+            if (missing.length > 0) {
+                log.warn(`Skill "${key}" requires missing binaries: ${missing.join(', ')}`);
+            }
+        }
+    }
+    return { skills: registry };
+}
+/**
+ * Render the AVAILABLE SKILLS section for the system prompt.
+ * Groups skills by source: workspace, module, shared.
+ */
+function renderSkillsSection(registry) {
+    if (registry.skills.size === 0)
+        return '';
+    const workspace = [];
+    const module = [];
+    const shared = [];
+    for (const [key, skill] of registry.skills) {
+        if (!skill.userInvocable)
+            continue;
+        const emoji = skill.emoji ? ` [${skill.emoji}]` : '';
+        const line = `/${key}: ${skill.description}${emoji}`;
+        if (skill.source === 'workspace')
+            workspace.push(line);
+        else if (skill.source === 'module')
+            module.push(line);
+        else
+            shared.push(line);
+    }
+    if (workspace.length === 0 && module.length === 0 && shared.length === 0)
+        return '';
+    const sections = [];
+    sections.push('Use /skill-name [args] to invoke a skill\n');
+    if (workspace.length > 0) {
+        sections.push('**Workspace Skills**');
+        sections.push(...workspace);
+        sections.push('');
+    }
+    if (module.length > 0) {
+        sections.push('**Module Skills**');
+        sections.push(...module);
+        sections.push('');
+    }
+    if (shared.length > 0) {
+        sections.push('**Shared Skills**');
+        sections.push(...shared);
+        sections.push('');
+    }
+    return sections.join('\n').trimEnd();
+}
+//# sourceMappingURL=loader.js.map

package/dist/skills/loader.js.map

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

package/dist/skills/parser.d.ts

@@ -0,0 +1,55 @@
+export interface SkillRequires {
+    bins?: string[];
+    env?: string[];
+    plugins?: string[];
+}
+export interface SkillInstallDescriptor {
+    id: string;
+    kind: 'brew' | 'python' | 'npm' | 'apt';
+    package?: string;
+    formula?: string;
+    bins?: string[];
+    label: string;
+}
+export interface SkillDefinition {
+    name: string;
+    description: string;
+    emoji?: string;
+    userInvocable: boolean;
+    allowedTools?: string[];
+    readWhen?: string[];
+    requires?: SkillRequires;
+    install?: SkillInstallDescriptor[];
+    primaryEnv?: string;
+    homepage?: string;
+    version?: string;
+    author?: string;
+    keywords?: string[];
+    content: string;
+    filePath: string;
+    source: 'workspace' | 'module' | 'shared';
+    modulePrefix?: string;
+}
+interface ParsedFrontmatter {
+    [key: string]: unknown;
+}
+/**
+ * Extract YAML frontmatter from a SKILL.md file.
+ * Frontmatter is the content between the first two `---` lines.
+ */
+export declare function extractFrontmatter(raw: string): {
+    frontmatter: ParsedFrontmatter;
+    body: string;
+} | null;
+export interface ParseSkillOptions {
+    filePath: string;
+    source: SkillDefinition['source'];
+    modulePrefix?: string;
+}
+/**
+ * Parse a SKILL.md file content into a SkillDefinition.
+ * Returns null if the file is invalid (missing name/description, bad frontmatter).
+ */
+export declare function parseSkill(raw: string, opts: ParseSkillOptions): SkillDefinition | null;
+export {};
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/skills/parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,iBAAiB;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBvG;AA0ED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,eAAe,GAAG,IAAI,CAiEvF"}

package/dist/skills/parser.js

@@ -0,0 +1,178 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFrontmatter = extractFrontmatter;
+exports.parseSkill = parseSkill;
+const js_yaml_1 = __importDefault(require("js-yaml"));
+/**
+ * Extract YAML frontmatter from a SKILL.md file.
+ * Frontmatter is the content between the first two `---` lines.
+ */
+function extractFrontmatter(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith('---'))
+        return null;
+    const end = trimmed.indexOf('\n---', 3);
+    if (end === -1)
+        return null;
+    const yamlBlock = trimmed.slice(3, end).trim();
+    const body = trimmed.slice(end + 4).trim();
+    try {
+        const parsed = js_yaml_1.default.load(yamlBlock);
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        return { frontmatter: parsed, body };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve metadata from either `metadata.openclaw` or `metadata.clawdbot` namespace.
+ * Returns the resolved namespace object, or undefined if neither exists.
+ */
+function resolveMetadataNamespace(fm) {
+    const meta = fm.metadata;
+    if (typeof meta !== 'object' || meta === null)
+        return undefined;
+    const obj = meta;
+    // Prefer openclaw, fallback to clawdbot
+    for (const ns of ['openclaw', 'clawdbot']) {
+        const nsObj = obj[ns];
+        if (typeof nsObj === 'object' && nsObj !== null) {
+            return nsObj;
+        }
+    }
+    return undefined;
+}
+function toStringArray(val) {
+    if (!Array.isArray(val))
+        return undefined;
+    const arr = val.filter((v) => typeof v === 'string');
+    return arr.length > 0 ? arr : undefined;
+}
+function parseRequires(nsMeta) {
+    if (!nsMeta)
+        return undefined;
+    const req = nsMeta.requires;
+    if (typeof req !== 'object' || req === null)
+        return undefined;
+    const r = req;
+    const result = {};
+    const bins = toStringArray(r.bins);
+    const env = toStringArray(r.env);
+    const plugins = toStringArray(r.plugins);
+    if (bins)
+        result.bins = bins;
+    if (env)
+        result.env = env;
+    if (plugins)
+        result.plugins = plugins;
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+function parseInstall(nsMeta) {
+    if (!nsMeta)
+        return undefined;
+    const inst = nsMeta.install;
+    if (!Array.isArray(inst))
+        return undefined;
+    const descriptors = [];
+    for (const item of inst) {
+        if (typeof item !== 'object' || item === null)
+            continue;
+        const obj = item;
+        if (typeof obj.id !== 'string' || typeof obj.kind !== 'string' || typeof obj.label !== 'string')
+            continue;
+        const validKinds = ['brew', 'python', 'npm', 'apt'];
+        if (!validKinds.includes(obj.kind))
+            continue;
+        const desc = {
+            id: obj.id,
+            kind: obj.kind,
+            label: obj.label,
+        };
+        if (typeof obj.package === 'string')
+            desc.package = obj.package;
+        if (typeof obj.formula === 'string')
+            desc.formula = obj.formula;
+        const bins = toStringArray(obj.bins);
+        if (bins)
+            desc.bins = bins;
+        descriptors.push(desc);
+    }
+    return descriptors.length > 0 ? descriptors : undefined;
+}
+/**
+ * Parse a SKILL.md file content into a SkillDefinition.
+ * Returns null if the file is invalid (missing name/description, bad frontmatter).
+ */
+function parseSkill(raw, opts) {
+    const extracted = extractFrontmatter(raw);
+    if (!extracted)
+        return null;
+    const { frontmatter: fm, body } = extracted;
+    // Required: name
+    const name = typeof fm.name === 'string' ? fm.name : undefined;
+    if (!name)
+        return null;
+    // Description: from frontmatter or first line of body
+    const description = typeof fm.description === 'string' ? fm.description : undefined;
+    if (!description)
+        return null;
+    const nsMeta = resolveMetadataNamespace(fm);
+    const skill = {
+        name,
+        description,
+        content: raw,
+        filePath: opts.filePath,
+        source: opts.source,
+        userInvocable: fm['user-invocable'] !== false,
+    };
+    // Emoji
+    const emoji = nsMeta?.emoji;
+    if (typeof emoji === 'string')
+        skill.emoji = emoji;
+    // Requires
+    const requires = parseRequires(nsMeta);
+    if (requires)
+        skill.requires = requires;
+    // Install
+    const install = parseInstall(nsMeta);
+    if (install)
+        skill.install = install;
+    // allowed-tools (top-level or from metadata)
+    const allowedTools = fm['allowed-tools'];
+    if (typeof allowedTools === 'string') {
+        skill.allowedTools = [allowedTools];
+    }
+    else {
+        const arr = toStringArray(allowedTools);
+        if (arr)
+            skill.allowedTools = arr;
+    }
+    // read_when
+    const readWhen = toStringArray(fm.read_when);
+    if (readWhen)
+        skill.readWhen = readWhen;
+    // primaryEnv
+    const primaryEnv = nsMeta?.primaryEnv;
+    if (typeof primaryEnv === 'string')
+        skill.primaryEnv = primaryEnv;
+    // Optional display fields
+    if (typeof fm.homepage === 'string')
+        skill.homepage = fm.homepage;
+    if (typeof fm.version === 'string')
+        skill.version = fm.version;
+    if (typeof fm.author === 'string')
+        skill.author = fm.author;
+    const keywords = toStringArray(fm.keywords);
+    if (keywords)
+        skill.keywords = keywords;
+    // Module prefix
+    if (opts.modulePrefix)
+        skill.modulePrefix = opts.modulePrefix;
+    return skill;
+}
+//# sourceMappingURL=parser.js.map

package/dist/skills/parser.js.map

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

package/dist/skills/sync.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Syncs shared skills to the personal Claude skills directory (~/.claude/skills/).
+ * Skills synced from shared are marked with a .shared sentinel file so stale
+ * entries can be cleaned up when they are removed from shared-skills.
+ */
+export declare function syncSharedSkills(sharedSkillsDir: string, personalSkillsDir: string, logger?: {
+    info: (msg: string, meta?: Record<string, unknown>) => void;
+    warn: (msg: string, meta?: Record<string, unknown>) => void;
+}): void;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/skills/sync.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,MAAM,EACzB,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CAAE,GACpI,IAAI,CAoFN"}

package/dist/skills/sync.js

@@ -0,0 +1,130 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncSharedSkills = syncSharedSkills;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Syncs shared skills to the personal Claude skills directory (~/.claude/skills/).
+ * Skills synced from shared are marked with a .shared sentinel file so stale
+ * entries can be cleaned up when they are removed from shared-skills.
+ */
+function syncSharedSkills(sharedSkillsDir, personalSkillsDir, logger) {
+    // Enumerate skills currently in shared-skills/
+    const sharedNames = new Set();
+    if (fs.existsSync(sharedSkillsDir)) {
+        let entries;
+        try {
+            entries = fs.readdirSync(sharedSkillsDir);
+        }
+        catch {
+            entries = [];
+        }
+        for (const entry of entries) {
+            if (entry.startsWith('.') || entry === 'node_modules')
+                continue;
+            const skillMd = path.join(sharedSkillsDir, entry, 'SKILL.md');
+            if (fs.existsSync(skillMd)) {
+                sharedNames.add(entry);
+            }
+        }
+    }
+    // Ensure personal skills directory exists
+    try {
+        fs.mkdirSync(personalSkillsDir, { recursive: true });
+    }
+    catch {
+        logger?.warn('syncSharedSkills: failed to create personalSkillsDir', { personalSkillsDir });
+        return;
+    }
+    // Remove stale synced entries (those with .shared marker no longer in shared-skills)
+    let existingEntries = [];
+    try {
+        existingEntries = fs.readdirSync(personalSkillsDir);
+    }
+    catch {
+        // ignore
+    }
+    for (const entry of existingEntries) {
+        if (entry.startsWith('.'))
+            continue;
+        const markerFile = path.join(personalSkillsDir, entry, '.shared');
+        if (fs.existsSync(markerFile) && !sharedNames.has(entry)) {
+            try {
+                fs.rmSync(path.join(personalSkillsDir, entry), { recursive: true, force: true });
+                logger?.info('syncSharedSkills: removed stale skill', { name: entry });
+            }
+            catch {
+                logger?.warn('syncSharedSkills: failed to remove stale skill', { name: entry });
+            }
+        }
+    }
+    // Copy/update skills from shared-skills to personal skills dir
+    for (const skillName of sharedNames) {
+        const srcFile = path.join(sharedSkillsDir, skillName, 'SKILL.md');
+        const destDir = path.join(personalSkillsDir, skillName);
+        const destFile = path.join(destDir, 'SKILL.md');
+        const markerFile = path.join(destDir, '.shared');
+        try {
+            fs.mkdirSync(destDir, { recursive: true });
+            // Only write if content differs (avoids spurious mtime updates)
+            const newContent = fs.readFileSync(srcFile, 'utf-8');
+            let existing = '';
+            try {
+                existing = fs.readFileSync(destFile, 'utf-8');
+            }
+            catch {
+                // file doesn't exist yet
+            }
+            if (newContent !== existing) {
+                const tmp = destFile + '.tmp';
+                fs.writeFileSync(tmp, newContent, 'utf-8');
+                fs.renameSync(tmp, destFile);
+                logger?.info('syncSharedSkills: synced skill', { name: skillName });
+            }
+            // Ensure .shared marker exists
+            if (!fs.existsSync(markerFile)) {
+                fs.writeFileSync(markerFile, '', 'utf-8');
+            }
+        }
+        catch (err) {
+            logger?.warn('syncSharedSkills: failed to sync skill', {
+                name: skillName,
+                error: err.message,
+            });
+        }
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/skills/sync.js.map

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

package/dist/skills/watcher.d.ts

@@ -0,0 +1,16 @@
+import { WatchHandle } from '../watch/factory';
+export interface SkillWatcherOptions {
+    /** Directories to watch for SKILL.md changes */
+    dirs: string[];
+    /** Callback when skills change */
+    onChange: () => void;
+    /** Debounce interval in ms (default: 250) */
+    debounceMs?: number;
+}
+/**
+ * Watch skill directories for SKILL.md file changes (add/modify/delete).
+ * Debounces rapid changes to avoid excessive rebuilds.
+ * Returns a close() handle to stop watching.
+ */
+export declare function watchSkills(opts: SkillWatcherOptions): WatchHandle;
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/skills/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,CAiBlE"}