@geminilight/mindos 0.5.70 → 0.6.1

package/app/lib/i18n-zh.ts

@@ -53,6 +53,11 @@ export const zh = {
     aiInit: 'AI 初始化内容',
     aiInitHint: 'AI 将为此空间生成 README 和 INSTRUCTION',
     aiInitNoKey: '在 设置 → AI 中配置 API 密钥以启用',
+    aiInitGenerating: (name: string) => `正在为「${name}」生成内容`,
+    aiInitReady: (name: string) => `「${name}」已就绪`,
+    aiInitReview: '查看',
+    aiInitDiscard: '撤销',
+    aiInitReverted: (name: string) => `「${name}」已恢复为模板`,
     createSpace: '创建',
     cancelCreate: '取消',
     continueEditing: '继续编辑',
@@ -78,6 +83,9 @@ export const zh = {
       hoursAgo: (n: number) => `${n} 小时前`,
       daysAgo: (n: number) => `${n} 天前`,
     },
+    cleanupExamples: (n: number) => `有 ${n} 个模板示例文件可以清理`,
+    cleanupExamplesButton: '一键清理',
+    cleanupExamplesDone: '示例文件已清理',
   },
   sidebar: {
     files: '空间',
@@ -122,7 +130,7 @@ export const zh = {
   },
   ask: {
     title: 'MindOS Agent',
-    placeholder: '输入问题，或输入 @ 添加附件文件',
+    placeholder: '输入问题… @ 附加文件，/ 技能',
     emptyPrompt: '可以问任何关于知识库的问题',
     send: '发送',
     newlineHint: '换行',
@@ -130,7 +138,9 @@ export const zh = {
     panelComposerFooter: '拉高输入区',
     panelComposerResetHint: '双击恢复默认高度',
     panelComposerKeyboard: '方向键调节高度；Home/End 最小或最大',
-    attachFile: '附加文件',
+    attachFile: '上下文',
+    uploadedFiles: '已上传',
+    skillsHint: '技能',
     attachCurrent: '附加当前文件',
     stopTitle: '停止',
     connecting: '正在与你的心智一起思考...',
@@ -375,6 +385,9 @@ export const zh = {
       enabledUnit: (n: number) => `${n} 已启用`,
       agentCount: (n: number) => `${n} 个 Agent`,
       runtimeActive: '活跃',
+      riskMcpStopped: 'MCP 服务未运行。',
+      riskDetected: (n: number) => `${n} 个已检测 Agent 待配置。`,
+      riskSkillsDisabled: '所有技能已禁用。',
     },
     mcp: {
       title: 'MCP 连接',
@@ -408,6 +421,7 @@ export const zh = {
       riskMcpStopped: 'MCP 服务未运行。',
       riskDetected: (n: number) => `${n} 个已检测 Agent 待配置。`,
       riskNotFound: (n: number) => `${n} 个 Agent 未在本机检测到。`,
+      riskSkillsDisabled: '所有技能已禁用。',
       bulkReconnectFiltered: '全部重连',
       bulkRunning: '正在批量重连...',
       bulkSummary: (ok: number, failed: number) => `重连成功 ${ok} 个，失败 ${failed} 个。`,
@@ -816,6 +830,15 @@ export const zh = {
       authTokenResetConfirm: '重新生成令牌？所有 MCP 客户端配置都需要更新。',
       authTokenMcpPort: 'MCP 端口',
       restartWalkthrough: '重新开始引导',
+      showHiddenFiles: '显示隐藏文件',
+      showHiddenFilesHint: '在文件树中显示以 . 开头的文件夹（.agents、.claude、.mindos 等）。',
+      cleanupExamples: '清理示例文件',
+      cleanupExamplesHint: '移除知识库中所有模板示例文件（🧪_example_*）。',
+      cleanupExamplesButton: '清理',
+      cleanupExamplesNone: '没有找到示例文件',
+      cleanupExamplesConfirm: (n: number) => `删除 ${n} 个示例文件？此操作不可撤销。`,
+      cleanupExamplesDone: (n: number) => `已移除 ${n} 个示例文件`,
+      cleanupExamplesScanning: '扫描中...',
     },
     sync: {
       emptyTitle: '跨设备同步',
@@ -1167,50 +1190,36 @@ export const zh = {
     welcomeLinkMCP: 'MCP 设置',
   },
   guide: {
-    title: '开始使用 MindOS',
+    title: '快速上手',
     showGuide: '显示新手引导',
     close: '关闭',
     skip: '跳过',
-    kb: {
-      title: '探索你的知识库',
-      cta: '开始',
-      fullDesc: '你的知识库有 6 个区域，试试点开看看：',
-      dirs: {
-        profile: '你是谁、偏好、目标',
-        notes: '日常捕捉：想法、会议、待办',
-        connections: '你的人脉关系网',
-        workflows: '可复用的工作流程 SOP',
-        resources: '结构化数据：产品库、工具库',
-        projects: '项目计划和进展',
-      },
-      instructionHint: '点击 INSTRUCTION.md 看看 AI 的行为规则。',
-      emptyDesc: '你的知识库有 3 个核心文件：',
-      emptyFiles: {
-        instruction: 'INSTRUCTION.md — 所有 AI Agent 遵循的规则',
-        readme: 'README.md — 目录索引和导航',
-        config: 'CONFIG.json — 机器可读的配置偏好',
-      },
-      emptyHint: '你可以随时创建自己的目录结构。',
-      progress: (n: number) => `已浏览 ${n}/1 个文件`,
-      done: '完成',
+    import: {
+      title: '导入你的文件',
+      cta: '导入',
+      desc: '上传简历、项目文档、笔记——任何你想让 AI Agent 了解的内容。',
+      button: '导入文件',
     },
     ai: {
-      title: '和 AI 对话',
-      cta: '开始',
-      prompt: '读一下我的知识库，帮我把自我介绍写进 Profile。',
+      title: '感受 AI 读取内容',
+      cta: '试试',
+      desc: '你的文件已在知识库中。问问 MindOS Agent 它了解了什么：',
+      prompt: '根据我的知识库介绍一下我——我是谁、在做什么？',
       promptEmpty: '帮我设计一个适合我的知识库目录结构',
     },
-    sync: {
-      title: '同步笔记',
-      optional: '可选',
-      cta: '设置',
+    agent: {
+      title: '在其他 Agent 验证',
+      cta: '复制提示词',
+      desc: '打开 Cursor、Claude Code 或任意连接了 MCP 的 Agent，粘贴以下提示词：',
+      copyPrompt: '读取我的 MindOS 知识库，概括我的背景，然后建议我接下来该做什么。',
+      copy: '复制',
+      copied: '已复制！',
     },
     done: {
       title: '你已准备好使用 MindOS',
       titleFinal: '你已掌握 MindOS 核心用法',
       steps: [
         { hint: '下一步：试试把一篇文章存进来 →', prompt: '帮我把这篇文章的要点整理到 MindOS 里。' },
-        { hint: '下一步：试试在另一个 Agent 里调用知识库 →', prompt: '帮我按 MindOS 里的方案开始写代码。' },
         { hint: '下一步：试试把经验沉淀为 SOP →', prompt: '帮我把这次对话的经验沉淀到 MindOS，形成可复用的工作流。' },
       ],
     },
@@ -1291,24 +1300,20 @@ prompt: '这是我的简历，读一下，把我的信息整理到 MindOS 里。
     exploreCta: '探索更多用法 →',
     steps: [
       {
-        title: '导航栏',
-        body: '这是你的 Activity Bar — 在这里切换文件、搜索、插件和 Agent。',
-      },
-      {
-        title: '你的知识库',
-        body: '在文件面板中浏览和管理你的笔记、画像和项目。',
+        title: '你的项目记忆',
+        body: '用 Space 管理项目、SOP 和偏好规则。数据存在本地，完全由你掌控。',
       },
       {
-        title: 'AI 对话',
-        body: '和了解你整个知识库的 AI 对话。随时按 ⌘/ 启动。',
+        title: '不用重讲背景的 AI',
+        body: 'MindOS Agent 自动读取整个知识库。问它项目相关的事，不需要重复交代背景。',
       },
       {
-        title: '快速搜索',
-        body: '按 ⌘K 即可搜索所有笔记，瞬间找到任何文件。',
+        title: '多 Agent 共享记忆',
+        body: '通过 MCP 连接 Cursor、Claude Code、Windsurf，它们共享同一份项目记忆。',
       },
       {
-        title: '设置',
-        body: '在这里配置 AI 服务商、MCP 连接、同步和外观。',
+        title: '回响 — 认知在积累',
+        body: '关于你、每日回顾、成长轨迹——MindOS 帮你沉淀判断与偏好，让经验不断复利。',
       },
     ],
   },

package/app/lib/mcp-agents.ts

@@ -41,6 +41,14 @@ export interface SkillAgentRegistration {
 }
 
 export const MCP_AGENTS: Record<string, AgentDef> = {
+  'mindos': {
+    name: 'MindOS',
+    project: null,
+    global: '~/.mindos/mcp.json',
+    key: 'mcpServers',
+    preferredTransport: 'stdio',
+    presenceDirs: ['~/.mindos/'],
+  },
   'claude-code': {
     name: 'Claude Code',
     project: '.mcp.json',

package/app/lib/pdf-extract.ts

@@ -0,0 +1,33 @@
+function uint8ToBase64(bytes: Uint8Array): string {
+  let binary = '';
+  const chunkSize = 0x8000;
+  for (let i = 0; i < bytes.length; i += chunkSize) {
+    const chunk = bytes.subarray(i, i + chunkSize);
+    binary += String.fromCharCode(...chunk);
+  }
+  return btoa(binary);
+}
+
+export async function extractPdfText(file: File): Promise<string> {
+  const buffer = await file.arrayBuffer();
+  const dataBase64 = uint8ToBase64(new Uint8Array(buffer));
+
+  const res = await fetch('/api/extract-pdf', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ name: file.name, dataBase64 }),
+  });
+
+  let payload: { text?: string; extracted?: boolean; error?: string } = {};
+  try {
+    payload = await res.json();
+  } catch {
+    // ignore JSON parse error
+  }
+
+  if (!res.ok) {
+    throw new Error(payload.error || `PDF extraction failed (${res.status})`);
+  }
+
+  return payload.extracted ? (payload.text || '') : '';
+}

package/app/lib/pi-integration/extensions.ts

@@ -0,0 +1,68 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { DefaultResourceLoader, SettingsManager } from '@mariozechner/pi-coding-agent';
+
+export function getMindosExtensionsDir(): string {
+  return path.join(os.homedir(), '.mindos', 'extensions');
+}
+
+/** Scan ~/.mindos/extensions/ for .ts files and index.ts in subdirs */
+export function scanExtensionPaths(): string[] {
+  const dir = getMindosExtensionsDir();
+  if (!fs.existsSync(dir)) return [];
+  const paths: string[] = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isFile() && entry.name.endsWith('.ts')) {
+      paths.push(path.join(dir, entry.name));
+    } else if (entry.isDirectory()) {
+      const indexPath = path.join(dir, entry.name, 'index.ts');
+      if (fs.existsSync(indexPath)) paths.push(indexPath);
+    }
+  }
+  return paths;
+}
+
+export interface ExtensionSummary {
+  name: string;
+  path: string;
+  enabled: boolean;
+  tools: string[];
+  commands: string[];
+}
+
+export async function getExtensionsList(
+  projectRoot: string,
+  _mindRoot: string,
+  disabledExtensions: string[] = [],
+): Promise<ExtensionSummary[]> {
+  const settingsManager = SettingsManager.inMemory();
+
+  const loader = new DefaultResourceLoader({
+    cwd: projectRoot,
+    settingsManager,
+    systemPromptOverride: () => '',
+    appendSystemPromptOverride: () => [],
+    additionalSkillPaths: [],
+    additionalExtensionPaths: scanExtensionPaths(),
+  });
+
+  try {
+    await loader.reload();
+    const result = loader.getExtensions();
+
+    return result.extensions.map((ext) => {
+      const name = path.basename(ext.path, path.extname(ext.path));
+      return {
+        name,
+        path: ext.resolvedPath || ext.path,
+        enabled: !disabledExtensions.includes(name),
+        tools: [...ext.tools.keys()],
+        commands: [...ext.commands.keys()],
+      };
+    });
+  } catch (error) {
+    console.error('[getExtensionsList] Failed to load extensions:', error);
+    return [];
+  }
+}

package/app/lib/pi-integration/mcporter.ts

@@ -0,0 +1,219 @@
+import os from 'os';
+import path from 'path';
+import { Type } from '@sinclair/typebox';
+import type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';
+import {
+  createRuntime,
+  createCallResult,
+  type Runtime,
+  type ServerToolInfo,
+} from 'mcporter';
+
+export interface McporterServerSummary {
+  name: string;
+  status: string;
+  durationMs?: number;
+  transport?: string;
+  error?: string;
+  issue?: { kind?: string; rawMessage?: string };
+  source?: { kind?: string; path?: string; importKind?: string };
+  tools?: McporterToolSummary[];
+}
+
+export interface McporterToolSummary {
+  name: string;
+  description?: string;
+  inputSchema?: Record<string, unknown>;
+  options?: Array<Record<string, unknown>>;
+}
+
+export interface McporterServerList {
+  mode?: string;
+  counts?: Record<string, number>;
+  servers: McporterServerSummary[];
+}
+
+function textResult(text: string): AgentToolResult<Record<string, never>> {
+  return { content: [{ type: 'text', text }], details: {} };
+}
+
+function normalizeNameSegment(value: string): string {
+  const normalized = value.toLowerCase().replace(/[^a-z0-9]+/g, '_').replace(/^_+|_+$/g, '');
+  return normalized || 'tool';
+}
+
+function toToolSchema(inputSchema?: Record<string, unknown>) {
+  if (!inputSchema || Object.keys(inputSchema).length === 0) {
+    return Type.Object({}, { additionalProperties: true });
+  }
+  return Type.Unsafe(inputSchema as any);
+}
+
+export function extractJsonObject(text: string): string {
+  const first = text.indexOf('{');
+  const last = text.lastIndexOf('}');
+  if (first === -1 || last === -1 || last < first) {
+    throw new Error('Failed to parse mcporter output as JSON');
+  }
+  return text.slice(first, last + 1);
+}
+
+// ─── Singleton mcporter Runtime ──────────────────────────────────────────────
+
+const MCP_CONFIG_PATH = path.join(os.homedir(), '.mindos', 'mcp.json');
+const TOOL_TIMEOUT_MS = 30_000;
+
+let _runtime: Runtime | null = null;
+let _runtimePromise: Promise<Runtime | null> | null = null;
+
+async function getRuntime(): Promise<Runtime | null> {
+  if (_runtime) return _runtime;
+  if (_runtimePromise) return _runtimePromise;
+
+  _runtimePromise = (async () => {
+    try {
+      const rt = await createRuntime({
+        configPath: MCP_CONFIG_PATH,
+        clientInfo: { name: 'mindos', version: '1.0.0' },
+      });
+      _runtime = rt;
+      return rt;
+    } catch (err) {
+      console.warn('[mcporter] Failed to create runtime:', err instanceof Error ? err.message : err);
+      _runtimePromise = null;
+      return null;
+    }
+  })();
+  return _runtimePromise;
+}
+
+if (typeof process !== 'undefined') {
+  const cleanup = () => {
+    if (_runtime) {
+      _runtime.close().catch(() => {});
+      _runtime = null;
+      _runtimePromise = null;
+    }
+  };
+  process.on('exit', cleanup);
+  process.on('SIGINT', cleanup);
+  process.on('SIGTERM', cleanup);
+}
+
+export async function listMcporterServers(): Promise<McporterServerList> {
+  const rt = await getRuntime();
+  if (!rt) return { servers: [] };
+
+  try {
+    const names = rt.listServers();
+    if (names.length === 0) return { servers: [] };
+
+    const servers: McporterServerSummary[] = await Promise.all(
+      names.map(async (name) => {
+        try {
+          const def = rt.getDefinition(name);
+          const transport = def.command.kind;
+          const tools = await rt.listTools(name, { includeSchema: false });
+          return {
+            name,
+            status: 'ok',
+            transport,
+            tools: tools.map(toToolSummary),
+          };
+        } catch (err) {
+          return {
+            name,
+            status: 'error',
+            error: err instanceof Error ? err.message : String(err),
+          };
+        }
+      }),
+    );
+
+    return { servers };
+  } catch (err) {
+    console.warn('[mcporter] listServers failed:', err instanceof Error ? err.message : err);
+    return { servers: [] };
+  }
+}
+
+function toToolSummary(tool: ServerToolInfo): McporterToolSummary {
+  return {
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema as Record<string, unknown> | undefined,
+  };
+}
+
+export async function listMcporterTools(serverName: string): Promise<McporterServerSummary> {
+  const rt = await getRuntime();
+  if (!rt) return { name: serverName, status: 'not_configured', tools: [] };
+
+  try {
+    const tools = await rt.listTools(serverName, { includeSchema: true });
+    return {
+      name: serverName,
+      status: 'ok',
+      tools: tools.map(toToolSummary),
+    };
+  } catch (err) {
+    return {
+      name: serverName,
+      status: 'error',
+      error: err instanceof Error ? err.message : String(err),
+      tools: [],
+    };
+  }
+}
+
+export async function callMcporterTool(
+  serverName: string,
+  toolName: string,
+  args: Record<string, unknown>,
+): Promise<string> {
+  const rt = await getRuntime();
+  if (!rt) throw new Error(`MCP runtime not available. Ensure ~/.mindos/mcp.json is configured.`);
+
+  const raw = await rt.callTool(serverName, toolName, {
+    args,
+    timeoutMs: TOOL_TIMEOUT_MS,
+  });
+  const result = createCallResult(raw);
+  return result.text('\n') ?? JSON.stringify(raw);
+}
+
+export function createMcporterAgentTools(servers: McporterServerSummary[]): AgentTool<any>[] {
+  const seenNames = new Set<string>();
+  const tools: AgentTool<any>[] = [];
+
+  for (const server of servers) {
+    if (server.status !== 'ok' || !server.tools?.length) continue;
+
+    for (const tool of server.tools) {
+      const baseName = `mcp__${normalizeNameSegment(server.name)}__${normalizeNameSegment(tool.name)}`;
+      let name = baseName;
+      let suffix = 2;
+      while (seenNames.has(name)) {
+        name = `${baseName}_${suffix++}`;
+      }
+      seenNames.add(name);
+
+      tools.push({
+        name,
+        label: `MCP ${server.name}: ${tool.name}`,
+        description: `MCP tool "${tool.name}" from server "${server.name}".${tool.description ? ` ${tool.description}` : ''}`,
+        parameters: toToolSchema(tool.inputSchema),
+        execute: async (_toolCallId, params) => {
+          try {
+            const output = await callMcporterTool(server.name, tool.name, (params ?? {}) as Record<string, unknown>);
+            return textResult(output || '(empty MCP response)');
+          } catch (error) {
+            return textResult(`Error: ${error instanceof Error ? error.message : String(error)}`);
+          }
+        },
+      });
+    }
+  }
+
+  return tools;
+}

package/app/lib/pi-integration/session-store.ts

@@ -0,0 +1,62 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { SessionManager } from '@mariozechner/pi-coding-agent';
+
+function getSessionsRoot(): string {
+  return path.join(os.homedir(), '.mindos', 'sessions');
+}
+
+export function getSessionDir(sessionId: string): string {
+  const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+  return path.join(getSessionsRoot(), safe);
+}
+
+export function sessionDirExists(sessionId: string): boolean {
+  const sessionDir = getSessionDir(sessionId);
+  if (!fs.existsSync(sessionDir)) return false;
+  // Check if there's at least one .jsonl file
+  try {
+    return fs.readdirSync(sessionDir).some((f) => f.endsWith('.jsonl'));
+  } catch {
+    return false;
+  }
+}
+
+export function getOrCreateSessionManager(
+  sessionId: string | undefined,
+  cwd: string,
+): SessionManager {
+  if (!sessionId) {
+    return SessionManager.inMemory(cwd);
+  }
+
+  const sessionDir = getSessionDir(sessionId);
+
+  try {
+    fs.mkdirSync(sessionDir, { recursive: true });
+
+    if (sessionDirExists(sessionId)) {
+      // Reuse the most recent session in this directory
+      return SessionManager.continueRecent(cwd, sessionDir);
+    }
+
+    // Brand new — create fresh session file
+    return SessionManager.create(cwd, sessionDir);
+  } catch (error) {
+    console.error(`[session-store] Failed to open/create session ${sessionId}, falling back to inMemory:`, error);
+    return SessionManager.inMemory(cwd);
+  }
+}
+
+export function deleteSessionDir(sessionId: string): boolean {
+  const sessionDir = getSessionDir(sessionId);
+  if (!fs.existsSync(sessionDir)) return false;
+  try {
+    fs.rmSync(sessionDir, { recursive: true, force: true });
+    return true;
+  } catch (error) {
+    console.error(`[session-store] Failed to delete session dir ${sessionDir}:`, error);
+    return false;
+  }
+}

package/app/lib/pi-integration/skills.ts

@@ -0,0 +1,116 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+export interface PiSkillInfo {
+  name: string;
+  description: string;
+  path: string;
+  source: 'builtin' | 'user';
+  enabled: boolean;
+  editable: boolean;
+  origin: 'app-builtin' | 'project-builtin' | 'mindos-user' | 'mindos-global';
+}
+
+export interface ScanSkillOptions {
+  projectRoot: string;
+  mindRoot: string;
+  disabledSkills?: string[];
+}
+
+export function parseSkillMd(content: string): { name: string; description: string } {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return { name: '', description: '' };
+  const yaml = match[1];
+  const nameMatch = yaml.match(/^name:\s*(.+)/m);
+  const descMatch = yaml.match(/^description:\s*>?\s*\n?([\s\S]*?)(?=\n\w|\n---)/m);
+  const name = nameMatch ? nameMatch[1].trim() : '';
+  let description = '';
+  if (descMatch) {
+    description = descMatch[1].trim().split('\n').map((l) => l.trim()).join(' ').slice(0, 200);
+  } else {
+    const simpleDesc = yaml.match(/^description:\s*(.+)/m);
+    if (simpleDesc) description = simpleDesc[1].trim().slice(0, 200);
+  }
+  return { name, description };
+}
+
+export function getPiSkillSearchDirs(projectRoot: string, mindRoot: string) {
+  return [
+    {
+      origin: 'app-builtin' as const,
+      dir: path.join(projectRoot, 'app', 'data', 'skills'),
+      pathLabel: 'app/data/skills',
+      source: 'builtin' as const,
+      editable: false,
+    },
+    {
+      origin: 'project-builtin' as const,
+      dir: path.join(projectRoot, 'skills'),
+      pathLabel: 'skills',
+      source: 'builtin' as const,
+      editable: false,
+    },
+    {
+      origin: 'mindos-user' as const,
+      dir: path.join(mindRoot, '.skills'),
+      pathLabel: '{mindRoot}/.skills',
+      source: 'user' as const,
+      editable: true,
+    },
+    {
+      origin: 'mindos-global' as const,
+      dir: path.join(os.homedir(), '.mindos', 'skills'),
+      pathLabel: '~/.mindos/skills',
+      source: 'user' as const,
+      editable: true,
+    },
+  ];
+}
+
+export function scanSkillDirs(options: ScanSkillOptions): PiSkillInfo[] {
+  const { projectRoot, mindRoot, disabledSkills = [] } = options;
+  const skills: PiSkillInfo[] = [];
+  const seen = new Set<string>();
+
+  for (const sourceDef of getPiSkillSearchDirs(projectRoot, mindRoot)) {
+    if (!fs.existsSync(sourceDef.dir)) continue;
+
+    for (const entry of fs.readdirSync(sourceDef.dir, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const skillFile = path.join(sourceDef.dir, entry.name, 'SKILL.md');
+      if (!fs.existsSync(skillFile)) continue;
+
+      const content = fs.readFileSync(skillFile, 'utf-8');
+      const { name, description } = parseSkillMd(content);
+      const skillName = name || entry.name;
+      if (!skillName || seen.has(skillName)) continue;
+
+      seen.add(skillName);
+      skills.push({
+        name: skillName,
+        description,
+        path: `${sourceDef.pathLabel}/${entry.name}/SKILL.md`,
+        source: sourceDef.source,
+        enabled: !disabledSkills.includes(skillName),
+        editable: sourceDef.editable,
+        origin: sourceDef.origin,
+      });
+    }
+  }
+
+  return skills;
+}
+
+export function readSkillContentByName(name: string, options: Omit<ScanSkillOptions, 'disabledSkills'>): string | null {
+  const { projectRoot, mindRoot } = options;
+
+  for (const sourceDef of getPiSkillSearchDirs(projectRoot, mindRoot)) {
+    const file = path.join(sourceDef.dir, name, 'SKILL.md');
+    if (fs.existsSync(file)) {
+      return fs.readFileSync(file, 'utf-8');
+    }
+  }
+
+  return null;
+}