nolo-cli 0.10.0 → 0.11.0

package/{chunk-4SIMLBEU.js → chunk-3NSIQZZ6.js}

@@ -7,7 +7,7 @@ import {
   toTimestampMs,
   upsert,
   write
-} from "./chunk-BE2OOJ5P.js";
+} from "./chunk-O26GI2JP.js";
 import {
   asRecordOrEmpty
 } from "./chunk-KX6YBIHG.js";
@@ -21,7 +21,7 @@ import {
 } from "./chunk-QSJ3HFEF.js";
 import {
   BUILTIN_NOLO_AGENT_KEY
-} from "./chunk-DSZUWUYB.js";
+} from "./chunk-XFOLQLDN.js";
 import {
   asyncThunkCreator,
   buildCreateSlice,
@@ -29,7 +29,7 @@ import {
   createAsyncThunk,
   createSelector,
   selectIdentityUserId
-} from "./chunk-UTLZINAP.js";
+} from "./chunk-OOM6SJNR.js";
 import {
   getAllServers,
   getIsDesktopApp,

package/{chunk-AUQ747NZ.js → chunk-4SOKXIW4.js}

@@ -8,12 +8,12 @@ import {
 import {
   asOptionalFiniteNumber
 } from "./chunk-WWC7I6TA.js";
-import {
-  asOptionalTrimmedString
-} from "./chunk-G3SUCT4W.js";
 import {
   isRecord
 } from "./chunk-KUG52IAP.js";
+import {
+  asOptionalTrimmedString
+} from "./chunk-G3SUCT4W.js";
 
 // packages/agent-runtime/toolNameAliases.ts
 var LEGACY_TOOL_NAME_ALIASES = {
@@ -102,6 +102,7 @@ var DEFAULT_PRIVATE_NOLO_WORKSPACE_TOOLS = [
   "readSpace",
   "readDoc",
   "readSkillDoc",
+  "loadSkill",
   "listTables",
   "queryTableRows",
   "cliWhoami",
@@ -388,6 +389,7 @@ var NOLO_WORKSPACE_TOOL_NAMES = [
   "readSpace",
   "readDoc",
   "readSkillDoc",
+  "loadSkill",
   "listTables",
   "queryTableRows",
   "cliWhoami",
@@ -458,6 +460,10 @@ function buildNoloWorkspaceOpenAiTools(args) {
   add("listAgents", "List the current user's agents in the Nolo workspace.", {
     space: stringToolParam("Optional space id or URL."),
     publicOnly: { type: "boolean", description: "Only show public agents." }
+    // 端间差异（LOW-R2-3）：CLI 命令 `nolo agent list` 无 --limit（parseAgentListArgs
+    // 仅支持 --json/--public-only/--ids-only），本地缓存全量列出；web 端
+    // listAgentsFunc 另有 limit（默认 100，最大 500）。如后续对齐需在
+    // parseAgentListArgs / agentListCommands 增加 --limit 透传。
   });
   add("readAgent", "Read one agent config in the Nolo workspace.", {
     agent: stringToolParam("Agent key, id, alias, or URL.")
@@ -474,6 +480,9 @@ function buildNoloWorkspaceOpenAiTools(args) {
   add("readSkillDoc", "Read one skill doc in the Nolo workspace.", {
     doc: stringToolParam("Skill doc/page key.")
   }, ["doc"]);
+  add("loadSkill", "Load a Skill by name from the workspace skill directories (.agents/skills/<name>/SKILL.md, then docs/skills/<name>.md) and return its full SKILL.md content inline so you can follow its instructions. Use this instead of readFile when you want to activate a skill. On an unknown name the tool returns a plain text list of available skill names rather than failing.", {
+    name: stringToolParam("Skill name (the name advertised in the skill-discovery layer).")
+  }, ["name"]);
   add("listTables", "List tables in the current user scope or an optional space scope.", {
     limit: { type: "integer", description: "Maximum tables to return." },
     space: stringToolParam("Optional space id or URL."),
@@ -791,13 +800,15 @@ function buildNoloWorkspaceCommandArgs(call) {
     case "readDoc": {
       const doc = noloStringArg(args.doc ?? args.docKey ?? args.pageKey ?? args.key);
       if (!doc) throw new Error("readDoc requires doc.");
-      return ["doc", "read", doc];
+      return doc.startsWith("page-") ? ["doc", "read", "--key", doc] : ["doc", "read", "--id", doc];
     }
     case "readSkillDoc": {
       const doc = noloStringArg(args.doc ?? args.docKey ?? args.pageKey ?? args.key);
       if (!doc) throw new Error("readSkillDoc requires doc.");
-      return ["skill-doc", "read", doc];
+      return doc.startsWith("page-") ? ["skill-doc", "read", "--key", doc] : ["skill-doc", "read", "--id", doc];
     }
+    case "loadSkill":
+      throw new Error("loadSkill is a local-fs tool and has no CLI mapping; wire buildLoadSkillExecutor instead.");
     case "listTables": {
       const cliArgs = ["table", "list"];
       const limit = noloPositiveIntegerString(args.limit);
@@ -868,10 +879,62 @@ async function runNoloWorkspaceCliTool(call, args) {
 function buildNoloWorkspaceCliToolExecutors(args) {
   const executors = {};
   for (const toolName of NOLO_WORKSPACE_TOOL_NAMES) {
+    if (toolName === "loadSkill") continue;
     executors[toolName] = (call) => runNoloWorkspaceCliTool(call, args);
   }
   return executors;
 }
+function buildLoadSkillExecutor(args) {
+  return async (call) => {
+    const parsed = parseNoloWorkspaceToolArguments(call.arguments);
+    const name = noloStringArg(parsed.name ?? parsed.skillName ?? parsed.skill);
+    if (!name) {
+      return {
+        content: await formatUnknownSkillMessage(args.cwd, "(no name provided)"),
+        metadata: { loadSkill: true, resolved: false }
+      };
+    }
+    const { resolveSkillByName } = await import("./skillDiscovery-UGSQGX2U.js");
+    const resolved = resolveSkillByName(args.cwd, name);
+    if (!resolved) {
+      return {
+        content: await formatUnknownSkillMessage(args.cwd, name),
+        metadata: { loadSkill: true, resolved: false, name, requestedName: name }
+      };
+    }
+    try {
+      const { readFileSync } = await import("node:fs");
+      const body = readFileSync(resolved, "utf8");
+      return {
+        content: `Skill "${name}" loaded inline. Follow its instructions.
+
+${body}`,
+        metadata: { loadSkill: true, resolved: true, name, requestedName: name, path: resolved }
+      };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      return {
+        content: `Skill "${name}" could not be read: ${message}`,
+        metadata: { loadSkill: true, resolved: true, name, requestedName: name, path: resolved, readError: message }
+      };
+    }
+  };
+}
+async function formatUnknownSkillMessage(cwd, requestedName) {
+  const { discoverSkills } = await import("./skillDiscovery-UGSQGX2U.js");
+  let available = [];
+  try {
+    available = discoverSkills(cwd).map((s) => s.name);
+  } catch {
+  }
+  const header = `Skill "${requestedName}" not found in this workspace's skill directories (.agents/skills/<name>/SKILL.md, docs/skills/<name>.md).`;
+  if (available.length === 0) return `${header}
+
+No skills were discovered in this workspace.`;
+  return `${header}
+
+Available skills: ${available.join(", ")}`;
+}
 var nodeSpawnFallback = (options) => {
   return spawnToWebStreams({ cmd: options.cmd, env: options.env });
 };
@@ -898,5 +961,6 @@ export {
   filterNoloDialogSubjectRefEvidence,
   verifyNoloDialogSubjectRefQuery,
   buildNoloTableQueryRequest,
-  buildNoloWorkspaceCliToolExecutors
+  buildNoloWorkspaceCliToolExecutors,
+  buildLoadSkillExecutor
 };

package/{chunk-PIVFPOW6.js → chunk-5MOUAAMK.js}

@@ -15,10 +15,10 @@ import {
 import {
   deleteServerSyncedCredential,
   runLlm
-} from "./chunk-I5URP43I.js";
+} from "./chunk-Q3UKJVU4.js";
 import {
   cleanupCliSessionForDialog
-} from "./chunk-7KNKFIRO.js";
+} from "./chunk-GBDSZATH.js";
 import {
   getDialogAgentIds,
   getPrimaryDialogAgentId
@@ -26,6 +26,13 @@ import {
 import {
   require_date_fns
 } from "./chunk-M76ECQRD.js";
+import {
+  isSystemAdmin,
+  nolotusId,
+  selectRemoteServer,
+  selectRemoteServers,
+  selectRemoteSyncServers
+} from "./chunk-3NSIQZZ6.js";
 import {
   fetchMessages
 } from "./chunk-SOTZ6RDN.js";
@@ -34,53 +41,11 @@ import {
   addContentAction,
   checkSpaceMembership,
   localSpaceAuthorityPatchStamp
-} from "./chunk-5JGGZCZL.js";
+} from "./chunk-7D3JY6C2.js";
 import {
   createSpaceKey,
   normalizeSpaceId
 } from "./chunk-UAD2WT54.js";
-import {
-  ALL_MODELS
-} from "./chunk-DCOA4QSN.js";
-import {
-  MODEL_LOOKUP_MAP,
-  findModelConfig,
-  getModelConfig
-} from "./chunk-BBYVOSU2.js";
-import {
-  createFileCredentialBroker
-} from "./chunk-5CS33IBL.js";
-import {
-  extractCustomId,
-  extractUserId
-} from "./chunk-DFFIZ25G.js";
-import {
-  abortActiveControllers,
-  addPageReferenceToRuntime,
-  applyClearDialogStateRuntime,
-  applyUpdateTokensFulfilled,
-  clearActiveControllers,
-  clearPendingAttachments,
-  clearPendingUserInputQueue,
-  deleteDialogRuntime,
-  getActiveDialogKey,
-  getDialogRuntimeTokens,
-  require_react,
-  resetDialogRuntimeSessionState,
-  selectCurrentDialogKey,
-  setActiveDialogKey,
-  setDialogConfigError
-} from "./chunk-3ASDTTEI.js";
-import {
-  toErrorMessage
-} from "./chunk-HNMXYYJR.js";
-import {
-  isSystemAdmin,
-  nolotusId,
-  selectRemoteServer,
-  selectRemoteServers,
-  selectRemoteSyncServers
-} from "./chunk-4SIMLBEU.js";
 import {
   patch,
   read,
@@ -93,10 +58,21 @@ import {
   uploadFileAction,
   upsertSSREntity,
   write
-} from "./chunk-BE2OOJ5P.js";
+} from "./chunk-O26GI2JP.js";
 import {
   resolveFileCategory
 } from "./chunk-AZPCASRE.js";
+import {
+  ALL_MODELS
+} from "./chunk-DCOA4QSN.js";
+import {
+  MODEL_LOOKUP_MAP,
+  findModelConfig,
+  getModelConfig
+} from "./chunk-BBYVOSU2.js";
+import {
+  createFileCredentialBroker
+} from "./chunk-5CS33IBL.js";
 import {
   asRecordOrEmpty
 } from "./chunk-KX6YBIHG.js";
@@ -132,12 +108,36 @@ import {
 import {
   asOptionalFiniteNumber
 } from "./chunk-WWC7I6TA.js";
+import {
+  extractCustomId,
+  extractUserId
+} from "./chunk-DFFIZ25G.js";
+import {
+  abortActiveControllers,
+  addPageReferenceToRuntime,
+  applyClearDialogStateRuntime,
+  applyUpdateTokensFulfilled,
+  clearActiveControllers,
+  clearPendingAttachments,
+  clearPendingUserInputQueue,
+  deleteDialogRuntime,
+  getActiveDialogKey,
+  getDialogRuntimeTokens,
+  require_react,
+  resetDialogRuntimeSessionState,
+  selectCurrentDialogKey,
+  setActiveDialogKey,
+  setDialogConfigError
+} from "./chunk-3ASDTTEI.js";
 import {
   asTrimmedLowercaseString
 } from "./chunk-QSJ3HFEF.js";
+import {
+  toErrorMessage
+} from "./chunk-HNMXYYJR.js";
 import {
   readAction
-} from "./chunk-DSZUWUYB.js";
+} from "./chunk-XFOLQLDN.js";
 import {
   DEVICE_LOCAL_OWNER_ID,
   asyncThunkCreator,
@@ -158,7 +158,7 @@ import {
   selectIdentityToken,
   selectIdentityUserId,
   selectRuntimeSnapshot
-} from "./chunk-UTLZINAP.js";
+} from "./chunk-OOM6SJNR.js";
 import {
   createClientLogger,
   fetchFromServer,
@@ -172,25 +172,25 @@ import {
   isTombstoneRecord,
   shouldReplaceWithNextRecord
 } from "./chunk-GBRG75BQ.js";
-import {
-  API_ENDPOINTS,
-  API_VERSION
-} from "./chunk-LCBAMY2M.js";
 import {
   asTrimmedString
 } from "./chunk-3EUW3WEO.js";
 import {
   asOptionalPositiveFiniteNumber
 } from "./chunk-U6VC4MU4.js";
+import {
+  isRecord
+} from "./chunk-KUG52IAP.js";
+import {
+  API_ENDPOINTS,
+  API_VERSION
+} from "./chunk-LCBAMY2M.js";
 import {
   normalizeServerOrigin
 } from "./chunk-CF7PE763.js";
 import {
   asOptionalTrimmedString
 } from "./chunk-G3SUCT4W.js";
-import {
-  isRecord
-} from "./chunk-KUG52IAP.js";
 import {
   __commonJS,
   __require,
@@ -11385,6 +11385,10 @@ function buildFallbackActivity(toolName, args) {
         refs: [{ type: "file", path }]
       };
     }
+    case "loadSkill": {
+      const name = asTrimmedString(args.name);
+      return name ? { title: "\u52A0\u8F7D\u6280\u80FD", detail: name } : void 0;
+    }
     case "execShell": {
       const command = asTrimmedString(
         typeof args.cmd === "string" ? args.cmd : args.command
@@ -11812,7 +11816,7 @@ async function captureUnderstandingFromCompletedUiTurn(input) {
   if (!input.agentKey) return;
   const latestUserInput = getLatestUserInputFromMessages(input.messages);
   if (!latestUserInput) return;
-  const { captureUnderstandingMemoryFromDialog } = await import("./understanding-3CUQQ6SV.js");
+  const { captureUnderstandingMemoryFromDialog } = await import("./understanding-ZOESBLF3.js");
   await captureUnderstandingMemoryFromDialog({
     db: input.db,
     userId: selectIdentityUserId(input.state),
@@ -12737,7 +12741,7 @@ var messageSlice = createSliceWithThunks({
             runtimeOptions: args.runtimeOptions
           });
           if (agentKeyToUse) {
-            const { streamAgentChatTurn } = await import("./agentSlice-LL5TKZEO.js");
+            const { streamAgentChatTurn } = await import("./agentSlice-6EKOBCCS.js");
             await dispatch(
               streamAgentChatTurn({
                 agentKey: agentKeyToUse,
@@ -15371,7 +15375,7 @@ var deleteOwnedDialogAttachments = async (args) => {
     metadataReadFailures
   });
   if (!plan.deleteCandidates.length) return plan;
-  const { deleteFileAction } = await import("./deleteFile-OW53A6BX.js");
+  const { deleteFileAction } = await import("./deleteFile-7XP5BGC7.js");
   for (const candidate of plan.deleteCandidates) {
     if (candidate.fileDbKey) {
       await deleteFileAction(candidate.fileDbKey, args.thunkApi);
@@ -15433,7 +15437,7 @@ var deleteDialogThunk = async (payload, thunkApi) => {
   }
   if (isCurrentDialog) {
     await thunkApi.dispatch(resetMsgs());
-    const { clearPendingAttachments: clearPendingAttachments2 } = await import("./dialogSlice-PT7YBWNE.js");
+    const { clearPendingAttachments: clearPendingAttachments2 } = await import("./dialogSlice-OWROKURJ.js");
     dispatch(clearPendingAttachments2());
     clearWorkflow();
   }
@@ -15442,35 +15446,35 @@ var deleteDialogThunk = async (payload, thunkApi) => {
 
 // packages/chat/dialog/dialogSlice.ts
 var runCreateDialogAction = async (args, thunkApi) => {
-  const { createDialogAction } = await import("./createDialogAction-QTRR4AT7.js");
+  const { createDialogAction } = await import("./createDialogAction-OJJ7L3L3.js");
   return createDialogAction(args, thunkApi);
 };
 var runCreateAgentAutomationAction = async (args, thunkApi) => {
-  const { createAgentAutomationAction } = await import("./createAgentAutomationAction-CCE7CWGQ.js");
+  const { createAgentAutomationAction } = await import("./createAgentAutomationAction-LTI5QU35.js");
   return createAgentAutomationAction(args, thunkApi);
 };
 var runUpdateDialogTitleAction = async (args, thunkApi) => {
-  const { updateDialogTitleAction } = await import("./updateDialogTitleAction-OCETSKCP.js");
+  const { updateDialogTitleAction } = await import("./updateDialogTitleAction-7FYNJOGP.js");
   return updateDialogTitleAction(args, thunkApi);
 };
 var runAddDialogAgentAction = async (args, thunkApi) => {
-  const { addDialogAgentAction } = await import("./addDialogAgentAction-BJ6SB76X.js");
+  const { addDialogAgentAction } = await import("./addDialogAgentAction-WVVKT5WQ.js");
   return addDialogAgentAction(args, thunkApi);
 };
 var runRemoveDialogAgentAction = async (args, thunkApi) => {
-  const { removeDialogAgentAction } = await import("./removeDialogAgentAction-OHMCNSSD.js");
+  const { removeDialogAgentAction } = await import("./removeDialogAgentAction-TCT35SOF.js");
   return removeDialogAgentAction(args, thunkApi);
 };
 var runSetPrimaryDialogAgentAction = async (args, thunkApi) => {
-  const { setPrimaryDialogAgentAction } = await import("./setPrimaryDialogAgentAction-EBAREZDM.js");
+  const { setPrimaryDialogAgentAction } = await import("./setPrimaryDialogAgentAction-F6BFQDJU.js");
   return setPrimaryDialogAgentAction(args, thunkApi);
 };
 var runSetDialogExtraReferencesAction = async (args, thunkApi) => {
-  const { setDialogExtraReferencesAction } = await import("./setDialogExtraReferencesAction-YJUM5BWQ.js");
+  const { setDialogExtraReferencesAction } = await import("./setDialogExtraReferencesAction-CGYLZMFH.js");
   return setDialogExtraReferencesAction(args, thunkApi);
 };
 var runHandleSendMessageAction = async (args, thunkApi) => {
-  const { handleSendMessageAction } = await import("./handleSendMessageAction-5NSYAS53.js");
+  const { handleSendMessageAction } = await import("./handleSendMessageAction-B5PRR7BE.js");
   return handleSendMessageAction(args, thunkApi);
 };
 function clearDialogState() {
@@ -15483,7 +15487,7 @@ var createPageAndAddReference = createAsyncThunk(
   async (payload, { dispatch, getState, rejectWithValue }) => {
     const { slateData, jsonData, title, type, fileId, groupId, dialogKey } = payload;
     try {
-      const { createDocState } = await import("./docStore-QUQZAFZF.js");
+      const { createDocState } = await import("./docStore-3DXRYBMD.js");
       const pageKey = await createDocState(
         { slateData, title },
         { dispatch, getState }
@@ -19440,11 +19444,11 @@ var ENTITY_DELETE_STRATEGIES = {
     await dispatch(deleteTable({ dbKey: key })).unwrap();
   },
   file: async (key, { thunkAPI }) => {
-    const { deleteFileAction } = await import("./deleteFile-OW53A6BX.js");
+    const { deleteFileAction } = await import("./deleteFile-7XP5BGC7.js");
     await deleteFileAction(key, thunkAPI);
   },
   image: async (key, { thunkAPI }) => {
-    const { deleteFileAction } = await import("./deleteFile-OW53A6BX.js");
+    const { deleteFileAction } = await import("./deleteFile-7XP5BGC7.js");
     await deleteFileAction(key, thunkAPI);
   },
   agent: async (key, { dispatch, userId, sourceServerOrigin }) => {
@@ -21612,7 +21616,7 @@ var fetchSpaceAction = async (input, thunkAPI) => {
   const spaceKey = createSpaceKey.space(spaceId);
   const readSpace = async (dbKey) => {
     try {
-      const { read: read2, readAndWait: readAndWait2 } = await import("./dbSlice-WWNV2SGX.js");
+      const { read: read2, readAndWait: readAndWait2 } = await import("./dbSlice-RQFQQVHT.js");
       if (fresh) {
         return await dispatch(readAndWait2(dbKey)).unwrap();
       }

package/{chunk-A67QFHAA.js → chunk-5OIFWVX7.js}

@@ -1,7 +1,7 @@
 import {
   DEFAULT_AGENT_BASE_POLICY,
   DEFAULT_USER_PREFERENCE_PROFILE
-} from "./chunk-4SIMLBEU.js";
+} from "./chunk-3NSIQZZ6.js";
 
 // packages/ai/policy/runtimePolicy.ts
 var clampLevel = (value, fallback) => {

package/{chunk-5JGGZCZL.js → chunk-7D3JY6C2.js}

@@ -4,12 +4,12 @@ import {
 import {
   patch,
   read
-} from "./chunk-BE2OOJ5P.js";
+} from "./chunk-O26GI2JP.js";
 import {
   DEVICE_LOCAL_OWNER_ID,
   isDeviceLocalSpaceBody,
   selectIdentityUserId
-} from "./chunk-UTLZINAP.js";
+} from "./chunk-OOM6SJNR.js";
 
 // packages/create/space/utils/permissions.ts
 var checkSpaceMembership = (spaceData, userId) => {

package/{chunk-OR2XR25C.js → chunk-AEZAORLG.js}

@@ -2,7 +2,7 @@ import {
   buildLocalAgentLookupKeys,
   normalizeAgentHandle,
   shouldReadAgentKeyRemotely
-} from "./chunk-CDTLMEB3.js";
+} from "./chunk-C2MDQQ4O.js";
 import {
   resolveCliAgentKeyInput
 } from "./chunk-VHBWHNVT.js";
@@ -10,6 +10,9 @@ import {
   readPipeText,
   spawnProcess
 } from "./chunk-IDZTNRP2.js";
+import {
+  createAgentKey
+} from "./chunk-O4BU24WZ.js";
 import {
   parseUserIdFromAuthToken,
   readOption,
@@ -20,9 +23,6 @@ import {
 import {
   toErrorMessage
 } from "./chunk-HNMXYYJR.js";
-import {
-  createAgentKey
-} from "./chunk-O4BU24WZ.js";
 
 // packages/cli/agentRecordHelpers.ts
 import { readFileSync } from "node:fs";

package/chunk-AFON4QUU.js

@@ -0,0 +1,112 @@
+import {
+  buildSkillDiscoveryLayer
+} from "./chunk-C4FTUXVF.js";
+import {
+  load
+} from "./chunk-WZSRQNQG.js";
+
+// packages/agent-runtime/skillDiscovery.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+var SKILL_SCAN_DIRS = [".agents/skills", "docs/skills"];
+var MAX_DISCOVERED_SKILLS = 50;
+function parseSkillFrontmatter(filePath) {
+  try {
+    const content = readFileSync(filePath, "utf8").slice(0, 2048);
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch) return {};
+    const fm = load(fmMatch[1]);
+    if (!fm || typeof fm !== "object") return {};
+    const name = typeof fm.name === "string" ? fm.name : void 0;
+    const rawDesc = fm.description;
+    const description = typeof rawDesc === "string" ? rawDesc : rawDesc == null ? void 0 : String(rawDesc);
+    const sanitize = (s) => s?.trim().replace(/^["']|["']$/g, "").replace(/[\n\r]+/g, " ").slice(0, 200);
+    return { name: sanitize(name), description: sanitize(description) };
+  } catch {
+    return {};
+  }
+}
+function discoverSkills(cwd) {
+  const skills = [];
+  for (const dir of SKILL_SCAN_DIRS) {
+    if (skills.length >= MAX_DISCOVERED_SKILLS) break;
+    const absDir = join(cwd, dir);
+    if (!existsSync(absDir) || !statSync(absDir).isDirectory()) continue;
+    try {
+      for (const entry of readdirSync(absDir)) {
+        if (skills.length >= MAX_DISCOVERED_SKILLS) break;
+        const skillMdPath = join(absDir, entry, "SKILL.md");
+        if (existsSync(skillMdPath)) {
+          const { name, description } = parseSkillFrontmatter(skillMdPath);
+          skills.push({ name: name ?? entry, description: description ?? "", relativePath: join(dir, entry, "SKILL.md") });
+          continue;
+        }
+        if (dir === "docs/skills" && entry.endsWith(".md")) {
+          const flatPath = join(absDir, entry);
+          const { name, description } = parseSkillFrontmatter(flatPath);
+          skills.push({ name: name ?? entry.replace(/\.md$/, ""), description: description ?? "", relativePath: join(dir, entry) });
+        }
+      }
+    } catch {
+    }
+  }
+  return skills;
+}
+function resolveSkillByName(cwd, name) {
+  const trimmed = name.trim();
+  if (!trimmed || trimmed.includes("/") || trimmed.includes("\\") || trimmed.includes("..")) {
+    return null;
+  }
+  const agentsDir = join(cwd, ".agents", "skills", trimmed);
+  const agentsSkillMd = join(agentsDir, "SKILL.md");
+  if (existsSync(agentsSkillMd)) return agentsSkillMd;
+  const agentsParent = join(cwd, ".agents", "skills");
+  if (existsSync(agentsParent) && statSync(agentsParent).isDirectory()) {
+    try {
+      for (const entry of readdirSync(agentsParent)) {
+        const candidate = join(agentsParent, entry, "SKILL.md");
+        if (!existsSync(candidate)) continue;
+        try {
+          const { name: fmName } = parseSkillFrontmatter(candidate);
+          if (fmName && fmName === trimmed) return candidate;
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  const docsFlat = join(cwd, "docs", "skills", `${trimmed}.md`);
+  if (existsSync(docsFlat)) return docsFlat;
+  const docsDir = join(cwd, "docs", "skills");
+  if (existsSync(docsDir) && statSync(docsDir).isDirectory()) {
+    try {
+      for (const entry of readdirSync(docsDir)) {
+        if (!entry.endsWith(".md")) continue;
+        const candidate = join(docsDir, entry);
+        try {
+          const { name: fmName } = parseSkillFrontmatter(candidate);
+          if (fmName && fmName === trimmed) return candidate;
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function buildSkillDiscoveryContextBlock(cwd) {
+  try {
+    const discovered = discoverSkills(cwd);
+    const layer = buildSkillDiscoveryLayer(discovered, cwd);
+    return layer?.content ?? null;
+  } catch {
+    return null;
+  }
+}
+
+export {
+  parseSkillFrontmatter,
+  discoverSkills,
+  resolveSkillByName,
+  buildSkillDiscoveryContextBlock
+};