@pentoshi/clai 4.6.2 → 4.8.0

package/dist/skills/frontmatter.js

@@ -0,0 +1,151 @@
+const KEY_LINE = /^([A-Za-z][A-Za-z0-9_.-]*):[ \t]*(.*)$/;
+const LIST_ITEM = /^[ \t]*-[ \t]*(.*)$/;
+const EMPTY_FRONTMATTER = {
+    fields: {},
+    lists: {},
+    body: "",
+    present: false,
+};
+function unquote(value) {
+    const trimmed = value.trim();
+    if (trimmed.length < 2)
+        return trimmed;
+    const first = trimmed[0];
+    const last = trimmed[trimmed.length - 1];
+    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+        return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\'/g, "'");
+    }
+    return trimmed;
+}
+function indentOf(line) {
+    let count = 0;
+    for (const char of line) {
+        if (char === " ")
+            count += 1;
+        else if (char === "\t")
+            count += 2;
+        else
+            break;
+    }
+    return count;
+}
+function splitFlowList(value) {
+    return value
+        .slice(1, -1)
+        .split(",")
+        .map((part) => unquote(part))
+        .filter((part) => part.length > 0);
+}
+export function parseFrontmatter(raw) {
+    const text = raw.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n");
+    const lines = text.split("\n");
+    let cursor = 0;
+    while (cursor < lines.length && lines[cursor].trim().length === 0)
+        cursor += 1;
+    if (lines[cursor]?.trim() !== "---") {
+        return { ...EMPTY_FRONTMATTER, body: text.trim() };
+    }
+    let end = -1;
+    for (let index = cursor + 1; index < lines.length; index += 1) {
+        const candidate = lines[index].trim();
+        if (candidate === "---" || candidate === "...") {
+            end = index;
+            break;
+        }
+    }
+    if (end < 0)
+        return { ...EMPTY_FRONTMATTER, body: text.trim() };
+    const fields = {};
+    const lists = {};
+    const region = lines.slice(cursor + 1, end);
+    for (let index = 0; index < region.length; index += 1) {
+        const line = region[index];
+        if (line.trim().length === 0 || line.trimStart().startsWith("#"))
+            continue;
+        if (indentOf(line) > 0)
+            continue;
+        const match = KEY_LINE.exec(line);
+        if (!match)
+            continue;
+        const key = match[1].toLowerCase();
+        const rawValue = match[2] ?? "";
+        const scalar = rawValue.trim();
+        if (scalar === "|" || scalar === "|-" || scalar === ">" || scalar === ">-") {
+            const folded = scalar.startsWith(">");
+            const collected = [];
+            let look = index + 1;
+            while (look < region.length) {
+                const next = region[look];
+                if (next.trim().length > 0 && indentOf(next) === 0)
+                    break;
+                collected.push(next.trim());
+                look += 1;
+            }
+            index = look - 1;
+            const joined = folded
+                ? collected.join(" ").replace(/\s+/g, " ").trim()
+                : collected.join("\n").trim();
+            fields[key] = joined;
+            continue;
+        }
+        if (scalar.startsWith("[") && scalar.endsWith("]")) {
+            const items = splitFlowList(scalar);
+            lists[key] = items;
+            fields[key] = items.join(" ");
+            continue;
+        }
+        if (scalar.length === 0) {
+            const items = [];
+            const nested = [];
+            let look = index + 1;
+            while (look < region.length) {
+                const next = region[look];
+                if (next.trim().length === 0) {
+                    look += 1;
+                    continue;
+                }
+                if (indentOf(next) === 0)
+                    break;
+                const item = LIST_ITEM.exec(next);
+                if (item)
+                    items.push(unquote(item[1] ?? ""));
+                else {
+                    const child = KEY_LINE.exec(next.trim());
+                    if (child)
+                        nested.push(`${child[1]}=${unquote(child[2] ?? "")}`);
+                }
+                look += 1;
+            }
+            index = look - 1;
+            if (items.length > 0) {
+                lists[key] = items.filter((item) => item.length > 0);
+                fields[key] = lists[key].join(" ");
+            }
+            else if (nested.length > 0) {
+                fields[key] = nested.join(" ");
+            }
+            continue;
+        }
+        fields[key] = unquote(scalar);
+    }
+    return {
+        fields,
+        lists,
+        body: lines.slice(end + 1).join("\n").trim(),
+        present: true,
+    };
+}
+export function frontmatterList(parsed, key) {
+    const direct = parsed.lists[key];
+    if (direct && direct.length > 0)
+        return [...direct];
+    const scalar = parsed.fields[key];
+    if (!scalar)
+        return undefined;
+    const items = scalar
+        .split(/[,\s]+/)
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+    return items.length > 0 ? items : undefined;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/skills/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/skills/frontmatter.ts"],"names":[],"mappings":"AAOA,MAAM,QAAQ,GAAG,wCAAwC,CAAC;AAC1D,MAAM,SAAS,GAAG,qBAAqB,CAAC;AACxC,MAAM,iBAAiB,GAAgB;IACrC,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,KAAK;CACf,CAAC;AAEF,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACvE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;aACxB,IAAI,IAAI,KAAK,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;;YAC9B,MAAM;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK;SACT,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SACZ,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC5B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QACpC,OAAO,EAAE,GAAG,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YAC/C,GAAG,GAAG,KAAK,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;IAEhE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,KAAK,GAA6B,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAE5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3E,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QACjC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE/B,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,IAAI,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;YACrB,OAAO,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAE,CAAC;gBAC3B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,MAAM;gBAC1D,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC5B,IAAI,IAAI,CAAC,CAAC;YACZ,CAAC;YACD,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM;gBACnB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;gBACjD,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACrB,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACpC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,IAAI,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;YACrB,OAAO,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAE,CAAC;gBAC3B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC7B,IAAI,IAAI,CAAC,CAAC;oBACV,SAAS;gBACX,CAAC;gBACD,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;oBAAE,MAAM;gBAChC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;qBACxC,CAAC;oBACJ,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;oBACzC,IAAI,KAAK;wBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;gBACnE,CAAC;gBACD,IAAI,IAAI,CAAC,CAAC;YACZ,CAAC;YACD,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;YACjB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACrD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtC,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,OAAO;QACL,MAAM;QACN,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAC5C,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAmB,EACnB,GAAW;IAEX,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM;SACjB,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/dist/skills/locations.d.ts

@@ -0,0 +1,10 @@
+import type { SkillRoot } from "./types.js";
+export declare function projectSearchDirs(input: {
+    readonly cwd: string;
+    readonly projectRoot?: string | undefined;
+}): string[];
+export declare function skillSearchRoots(input: {
+    readonly cwd: string;
+    readonly projectRoot?: string | undefined;
+}): SkillRoot[];
+export declare function skillSearchLocationHints(): string[];

package/dist/skills/locations.js

@@ -0,0 +1,174 @@
+import { existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, dirname, join, resolve } from "node:path";
+import { getDataDir } from "../store/paths.js";
+const PROJECT_SUFFIXES = [
+    [".clai/skills", "clai"],
+    [".claude/skills", "claude"],
+    [".agents/skills", "agents"],
+    [".agent/skills", "agent"],
+    ["agents/skills", "agents"],
+    [".github/skills", "copilot"],
+    [".opencode/skills", "opencode"],
+    [".opencode/skill", "opencode"],
+    [".codex/skills", "codex"],
+    [".antigravity/skills", "antigravity"],
+    [".gemini/skills", "gemini"],
+    [".cursor/skills", "cursor"],
+    [".windsurf/skills", "windsurf"],
+    ["skills", "workspace"],
+];
+const PROJECT_MARKER_FILES = [
+    ".git",
+    "package.json",
+    "pyproject.toml",
+    "go.mod",
+    "Cargo.toml",
+    "pom.xml",
+    "build.gradle",
+    "composer.json",
+    "Gemfile",
+    "requirements.txt",
+    "CMakeLists.txt",
+    "AGENTS.md",
+    ".clai",
+];
+const MAX_ANCESTOR_LEVELS = 4;
+function xdgConfigHome() {
+    const configured = process.env.XDG_CONFIG_HOME?.trim();
+    if (configured)
+        return resolve(configured);
+    return join(homedir(), ".config");
+}
+function userRootSpecs() {
+    const home = homedir();
+    const xdg = xdgConfigHome();
+    const appData = process.env.APPDATA?.trim();
+    const localAppData = process.env.LOCALAPPDATA?.trim();
+    const specs = [
+        [join(getDataDir(), "skills"), "clai"],
+        [join(home, ".clai", "skills"), "clai"],
+        [join(home, ".claude", "skills"), "claude"],
+        [join(home, ".codex", "skills"), "codex"],
+        [join(home, ".agents", "skills"), "agents"],
+        [join(home, ".agent", "skills"), "agent"],
+        [join(home, ".antigravity", "skills"), "antigravity"],
+        [join(home, ".gemini", "antigravity", "skills"), "antigravity"],
+        [join(home, ".gemini", "skills"), "gemini"],
+        [join(home, ".cursor", "skills"), "cursor"],
+        [join(home, ".opencode", "skills"), "opencode"],
+        [join(home, ".opencode", "skill"), "opencode"],
+        [join(xdg, "opencode", "skills"), "opencode"],
+        [join(xdg, "opencode", "skill"), "opencode"],
+        [join(xdg, "claude", "skills"), "claude"],
+        [join(xdg, "codex", "skills"), "codex"],
+        [join(xdg, "agents", "skills"), "agents"],
+        [join(xdg, "clai", "skills"), "clai"],
+    ];
+    if (appData) {
+        specs.push([join(appData, "opencode", "skills"), "opencode"], [join(appData, "Claude", "skills"), "claude"], [join(appData, "codex", "skills"), "codex"], [join(appData, "clai", "skills"), "clai"]);
+    }
+    if (localAppData) {
+        specs.push([join(localAppData, "antigravity", "skills"), "antigravity"], [join(localAppData, "opencode", "skills"), "opencode"]);
+    }
+    return specs;
+}
+function extraRootSpecs() {
+    const configured = process.env.CLAI_SKILLS_PATH?.trim();
+    if (!configured)
+        return [];
+    return configured
+        .split(delimiter)
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0)
+        .map((part) => [resolve(part), "custom"]);
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function hasProjectMarker(dir) {
+    return PROJECT_MARKER_FILES.some((marker) => existsSync(join(dir, marker)));
+}
+function isBoundary(dir) {
+    const home = resolve(homedir());
+    const current = resolve(dir);
+    return current === home || dirname(current) === current;
+}
+export function projectSearchDirs(input) {
+    const seeds = [input.projectRoot, input.cwd]
+        .filter((value) => Boolean(value?.trim()))
+        .map((value) => resolve(value));
+    const out = [];
+    const seen = new Set();
+    const push = (dir) => {
+        const key = process.platform === "win32" ? dir.toLowerCase() : dir;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        out.push(dir);
+    };
+    for (const seed of seeds) {
+        push(seed);
+        let current = seed;
+        for (let level = 0; level < MAX_ANCESTOR_LEVELS; level += 1) {
+            if (isBoundary(current))
+                break;
+            const parent = dirname(current);
+            if (parent === current)
+                break;
+            current = parent;
+            if (isBoundary(current))
+                break;
+            push(current);
+            if (hasProjectMarker(current))
+                break;
+        }
+    }
+    return out;
+}
+export function skillSearchRoots(input) {
+    const collected = [];
+    const seen = new Set();
+    const add = (path, tool, scope) => {
+        const key = process.platform === "win32" ? path.toLowerCase() : path;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        if (!isDirectory(path))
+            return;
+        collected.push({ path, tool, scope });
+    };
+    for (const [path, tool] of extraRootSpecs())
+        add(path, tool, "extra");
+    for (const dir of projectSearchDirs(input)) {
+        for (const [suffix, tool] of PROJECT_SUFFIXES) {
+            add(join(dir, ...suffix.split("/")), tool, "project");
+        }
+    }
+    for (const [path, tool] of userRootSpecs())
+        add(path, tool, "user");
+    return collected;
+}
+export function skillSearchLocationHints() {
+    return [
+        ".clai/skills",
+        ".claude/skills",
+        ".agents/skills",
+        ".github/skills",
+        ".opencode/skills",
+        ".codex/skills",
+        ".antigravity/skills",
+        ".cursor/skills",
+        "~/.clai/skills",
+        "~/.claude/skills",
+        "~/.codex/skills",
+        "~/.config/opencode/skills",
+        "$CLAI_SKILLS_PATH",
+    ];
+}
+//# sourceMappingURL=locations.js.map

package/dist/skills/locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.js","sourceRoot":"","sources":["../../src/skills/locations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,gBAAgB,GAA6C;IACjE,CAAC,cAAc,EAAE,MAAM,CAAC;IACxB,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IAC5B,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IAC5B,CAAC,eAAe,EAAE,OAAO,CAAC;IAC1B,CAAC,eAAe,EAAE,QAAQ,CAAC;IAC3B,CAAC,gBAAgB,EAAE,SAAS,CAAC;IAC7B,CAAC,kBAAkB,EAAE,UAAU,CAAC;IAChC,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAC/B,CAAC,eAAe,EAAE,OAAO,CAAC;IAC1B,CAAC,qBAAqB,EAAE,aAAa,CAAC;IACtC,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IAC5B,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IAC5B,CAAC,kBAAkB,EAAE,UAAU,CAAC;IAChC,CAAC,QAAQ,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF,MAAM,oBAAoB,GAAsB;IAC9C,MAAM;IACN,cAAc;IACd,gBAAgB;IAChB,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,cAAc;IACd,eAAe;IACf,SAAS;IACT,kBAAkB;IAClB,gBAAgB;IAChB,WAAW;IACX,OAAO;CACR,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,SAAS,aAAa;IACpB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,UAAU;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IACtD,MAAM,KAAK,GAAqC;QAC9C,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QACtC,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QACvC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAC3C,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QACzC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAC3C,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QACzC,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC;QACrD,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC;QAC/D,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAC3C,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAC3C,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC;QAC/C,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC;QAC9C,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC;QAC7C,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC;QAC5C,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACzC,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QACvC,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACzC,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CACR,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,EACjD,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAC7C,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,EAC3C,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CACR,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,EAC5D,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CACvD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,UAAU;SACd,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAU,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAGjC;IACC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC;SACzC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SAC1D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAClC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACnE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,CAAC;QACX,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,mBAAmB,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC5D,IAAI,UAAU,CAAC,OAAO,CAAC;gBAAE,MAAM;YAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,MAAM,KAAK,OAAO;gBAAE,MAAM;YAC9B,OAAO,GAAG,MAAM,CAAC;YACjB,IAAI,UAAU,CAAC,OAAO,CAAC;gBAAE,MAAM;YAC/B,IAAI,CAAC,OAAO,CAAC,CAAC;YACd,IAAI,gBAAgB,CAAC,OAAO,CAAC;gBAAE,MAAM;QACvC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAGhC;IACC,MAAM,SAAS,GAAgB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,KAAiB,EAAQ,EAAE;QAClE,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACrE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAAE,OAAO;QAC/B,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,cAAc,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACtE,KAAK,MAAM,GAAG,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,gBAAgB,EAAE,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,aAAa,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,cAAc;QACd,gBAAgB;QAChB,gBAAgB;QAChB,gBAAgB;QAChB,kBAAkB;QAClB,eAAe;QACf,qBAAqB;QACrB,gBAAgB;QAChB,gBAAgB;QAChB,kBAAkB;QAClB,iBAAiB;QACjB,2BAA2B;QAC3B,mBAAmB;KACpB,CAAC;AACJ,CAAC"}

package/dist/skills/mentions.d.ts

@@ -0,0 +1,9 @@
+export interface SkillMentionRange {
+    readonly start: number;
+    readonly end: number;
+    readonly name: string;
+}
+export declare function formatSkillToken(name: string): string;
+export declare function findSkillMentions(text: string, known: ReadonlySet<string>): SkillMentionRange[];
+export declare function skillMentionNames(text: string, known: ReadonlySet<string>): string[];
+export declare function hasSkillMention(text: string, known: ReadonlySet<string>): boolean;

package/dist/skills/mentions.js

@@ -0,0 +1,31 @@
+const TOKEN_RE = /(^|[^\w:/\\.-])skill:([A-Za-z0-9][A-Za-z0-9_-]*)/g;
+export function formatSkillToken(name) {
+    return `skill:${name}`;
+}
+export function findSkillMentions(text, known) {
+    if (!text || known.size === 0 || !text.includes("skill:"))
+        return [];
+    const out = [];
+    const pattern = new RegExp(TOKEN_RE.source, TOKEN_RE.flags);
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+        const lead = match[1] ?? "";
+        const raw = match[2] ?? "";
+        const name = raw.toLowerCase().replace(/_/g, "-");
+        if (!known.has(name))
+            continue;
+        const start = match.index + lead.length;
+        out.push({ start, end: start + `skill:${raw}`.length, name });
+    }
+    return out;
+}
+export function skillMentionNames(text, known) {
+    const seen = new Set();
+    for (const mention of findSkillMentions(text, known))
+        seen.add(mention.name);
+    return [...seen];
+}
+export function hasSkillMention(text, known) {
+    return findSkillMentions(text, known).length > 0;
+}
+//# sourceMappingURL=mentions.js.map

package/dist/skills/mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mentions.js","sourceRoot":"","sources":["../../src/skills/mentions.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GAAG,mDAAmD,CAAC;AAErE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,SAAS,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAA0B;IAE1B,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IACrE,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,SAAS,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,KAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,KAA0B;IAE1B,OAAO,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACnD,CAAC"}

package/dist/skills/registry.d.ts

@@ -0,0 +1,12 @@
+import { type LoadedSkill, type SkillIndex, type SkillMeta } from "./types.js";
+export interface SkillScanInput {
+    readonly cwd?: string | undefined;
+    readonly projectRoot?: string | undefined;
+}
+export declare function getSkillIndex(input?: SkillScanInput): Promise<SkillIndex>;
+export declare function skillIndexSnapshot(): SkillIndex;
+export declare function skillNamesSnapshot(): ReadonlySet<string>;
+export declare function findSkillInSnapshot(name: string): SkillMeta | undefined;
+export declare function invalidateSkillIndex(): void;
+export declare function loadSkill(name: string, input?: SkillScanInput): Promise<LoadedSkill | undefined>;
+export declare function skillFileSignature(meta: SkillMeta): Promise<string | undefined>;

package/dist/skills/registry.js

@@ -0,0 +1,141 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+import { safeCwd } from "../os/cwd.js";
+import { dedupeSkills, discoverSkills, normalizeSkillName } from "./discover.js";
+import { skillSearchRoots } from "./locations.js";
+import { parseFrontmatter } from "./frontmatter.js";
+import { EMPTY_SKILL_INDEX, } from "./types.js";
+const INDEX_TTL_MS = 10_000;
+const MAX_BODY_CHARS = 48 * 1024;
+const MAX_RESOURCES = 40;
+const RESOURCE_DEPTH = 2;
+let cache;
+let inflight;
+function scanKey(input) {
+    return `${input.projectRoot ?? ""}\u0000${input.cwd ?? safeCwd()}`;
+}
+function buildIndex(skills, roots, truncated) {
+    return {
+        skills,
+        roots,
+        names: new Set(skills.map((skill) => skill.name)),
+        scannedAt: Date.now(),
+        truncated,
+    };
+}
+async function scan(input) {
+    const cwd = input.cwd ?? safeCwd();
+    const roots = skillSearchRoots({
+        cwd,
+        ...(input.projectRoot ? { projectRoot: input.projectRoot } : {}),
+    });
+    if (roots.length === 0)
+        return buildIndex([], roots, false);
+    const { skills, truncated } = await discoverSkills(roots);
+    return buildIndex(dedupeSkills(skills), roots, truncated);
+}
+export async function getSkillIndex(input = {}) {
+    const key = scanKey(input);
+    const fresh = cache?.key === key && Date.now() - cache.index.scannedAt < INDEX_TTL_MS;
+    if (fresh)
+        return cache.index;
+    if (inflight)
+        return inflight;
+    inflight = scan(input)
+        .then((index) => {
+        cache = { key, index };
+        return index;
+    })
+        .catch(() => {
+        const fallback = buildIndex([], [], false);
+        cache = { key, index: fallback };
+        return fallback;
+    })
+        .finally(() => {
+        inflight = undefined;
+    });
+    return inflight;
+}
+export function skillIndexSnapshot() {
+    return cache?.index ?? EMPTY_SKILL_INDEX;
+}
+export function skillNamesSnapshot() {
+    return skillIndexSnapshot().names;
+}
+export function findSkillInSnapshot(name) {
+    const normalized = normalizeSkillName(name);
+    if (!normalized)
+        return undefined;
+    return skillIndexSnapshot().skills.find((skill) => skill.name === normalized);
+}
+export function invalidateSkillIndex() {
+    cache = undefined;
+}
+async function listResources(dir) {
+    const out = [];
+    const walk = async (current, depth) => {
+        if (depth > RESOURCE_DEPTH || out.length >= MAX_RESOURCES)
+            return;
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (out.length >= MAX_RESOURCES)
+                return;
+            const child = join(current, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === "node_modules" || entry.name.startsWith("."))
+                    continue;
+                await walk(child, depth + 1);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (/^skill\.md$/i.test(entry.name))
+                continue;
+            out.push(relative(dir, child).split(sep).join("/"));
+        }
+    };
+    await walk(dir, 1);
+    return out.sort();
+}
+export async function loadSkill(name, input = {}) {
+    const index = await getSkillIndex(input);
+    const normalized = normalizeSkillName(name);
+    const meta = normalized
+        ? index.skills.find((skill) => skill.name === normalized)
+        : undefined;
+    if (!meta)
+        return undefined;
+    let raw;
+    try {
+        raw = await readFile(meta.file, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    const parsed = parseFrontmatter(raw);
+    const source = parsed.present ? parsed.body : raw.trim();
+    const truncated = source.length > MAX_BODY_CHARS;
+    const body = truncated ? source.slice(0, MAX_BODY_CHARS) : source;
+    return {
+        meta,
+        body,
+        resources: await listResources(meta.dir),
+        truncated,
+    };
+}
+export async function skillFileSignature(meta) {
+    try {
+        const info = await stat(meta.file);
+        return `${meta.file}:${info.mtimeMs}:${info.size}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/skills/registry.js.map

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

package/dist/skills/types.d.ts

@@ -0,0 +1,33 @@
+export type SkillScope = "project" | "user" | "extra";
+export interface SkillRoot {
+    readonly path: string;
+    readonly tool: string;
+    readonly scope: SkillScope;
+}
+export interface SkillMeta {
+    readonly name: string;
+    readonly description: string;
+    readonly dir: string;
+    readonly file: string;
+    readonly scope: SkillScope;
+    readonly tool: string;
+    readonly root: string;
+    readonly compatibility?: string | undefined;
+    readonly license?: string | undefined;
+    readonly allowedTools?: readonly string[] | undefined;
+    readonly shadowed?: readonly string[] | undefined;
+}
+export interface SkillIndex {
+    readonly skills: readonly SkillMeta[];
+    readonly roots: readonly SkillRoot[];
+    readonly names: ReadonlySet<string>;
+    readonly scannedAt: number;
+    readonly truncated: boolean;
+}
+export interface LoadedSkill {
+    readonly meta: SkillMeta;
+    readonly body: string;
+    readonly resources: readonly string[];
+    readonly truncated: boolean;
+}
+export declare const EMPTY_SKILL_INDEX: SkillIndex;

package/dist/skills/types.js

@@ -0,0 +1,8 @@
+export const EMPTY_SKILL_INDEX = {
+    skills: [],
+    roots: [],
+    names: new Set(),
+    scannedAt: 0,
+    truncated: false,
+};
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":"AAqCA,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,IAAI,GAAG,EAAU;IACxB,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,KAAK;CACjB,CAAC"}