@xopcai/xopc 0.0.285 → 0.0.291

package/dist/src/workflows/service/workflow-session-bridge.js

@@ -6,7 +6,7 @@ import { renderWorkflowText } from "../../agent/workflow/snapshot.js";
 import { isTerminalWorkflowRunStatus } from "../domain/run.js";
 import "../domain/index.js";
 import { runViewToSnapshot } from "./run-view-to-snapshot.js";
-import { buildWorkflowRunSessionKey } from "./workflow-session-key.js";
+import { buildWorkflowRunConversationId } from "./workflow-session-key.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/service/workflow-session-bridge.ts
 const WORKFLOW_SESSION_TYPE = "workflow-run";
@@ -17,12 +17,12 @@ var WorkflowSessionBridge = class {
 		this.gateway = gateway;
 	}
 	async prepareRunSession(params) {
-		const sessionKey = buildWorkflowRunSessionKey(params.agentId, params.runId);
+		const conversationId = buildWorkflowRunConversationId(params.agentId, params.runId);
 		const goalText = formatWorkflowGoalUserMessage(params.definitionId, params.goal);
 		const sessionName = truncateSessionName(params.goal.trim() || params.definitionTitle || params.definitionId);
 		const store = this.gateway.sessionIndexInstance.getStore();
-		const projectId = params.projectId?.trim() || (params.parentSessionKey?.trim() ? (await store.getMetadata(params.parentSessionKey.trim()))?.projectId : void 0);
-		await store.resolveTranscriptPath(sessionKey, { metadata: {
+		const projectId = params.projectId?.trim() || (params.parentConversationId?.trim() ? (await store.getMetadata(params.parentConversationId.trim()))?.projectId : void 0);
+		await store.resolveTranscriptPath(conversationId, { metadata: {
 			sessionType: WORKFLOW_SESSION_TYPE,
 			projectId,
 			hiddenFromSessionList: true,
@@ -36,7 +36,7 @@ var WorkflowSessionBridge = class {
 				peerId: params.runId
 			}
 		} });
-		await store.updateMetadata(sessionKey, {
+		await store.updateMetadata(conversationId, {
 			sessionType: WORKFLOW_SESSION_TYPE,
 			hiddenFromSessionList: true,
 			workflowRunId: params.runId,
@@ -49,10 +49,10 @@ var WorkflowSessionBridge = class {
 				workflowDefinitionId: params.definitionId,
 				workflowGoal: params.goal,
 				...params.triggerSource ? { triggerSource: params.triggerSource } : {},
-				...params.parentSessionKey ? { parentSessionKey: params.parentSessionKey } : {}
+				...params.parentConversationId ? { parentConversationId: params.parentConversationId } : {}
 			}
 		});
-		await store.appendTranscriptMessage(sessionKey, {
+		await store.appendTranscriptMessage(conversationId, {
 			role: "user",
 			content: [{
 				type: "text",
@@ -60,42 +60,42 @@ var WorkflowSessionBridge = class {
 			}],
 			timestamp: Date.now()
 		});
-		if (params.parentSessionKey?.trim()) await this.writeParentRunLink({
-			parentSessionKey: params.parentSessionKey.trim(),
+		if (params.parentConversationId?.trim()) await this.writeParentRunLink({
+			parentConversationId: params.parentConversationId.trim(),
 			runId: params.runId,
 			ownerAgentId: params.agentId,
-			workflowSessionKey: sessionKey,
+			workflowConversationId: conversationId,
 			definitionId: params.definitionId,
 			goal: params.goal,
 			status: "running"
 		});
 		this.gateway.emit("session.updated", {
-			key: sessionKey,
+			key: conversationId,
 			name: sessionName
 		});
-		return { sessionKey };
+		return { conversationId };
 	}
 	async handleRunViewUpdated(view) {
 		const runId = view.run.id;
-		const sessionKey = view.run.metadata?.sessionKey?.trim();
-		if (!sessionKey || !isTerminalWorkflowRunStatus(view.run.status)) return;
+		const conversationId = view.run.metadata?.conversationId?.trim();
+		if (!conversationId || !isTerminalWorkflowRunStatus(view.run.status)) return;
 		if (this.terminalPersistedRunIds.has(runId)) return;
 		this.terminalPersistedRunIds.add(runId);
-		await this.persistTerminalTranscript(sessionKey, view);
-		const parentSessionKey = readParentSessionKey(view);
-		if (parentSessionKey) await this.writeParentRunLink({
-			parentSessionKey,
+		await this.persistTerminalTranscript(conversationId, view);
+		const parentConversationId = readParentConversationId(view);
+		if (parentConversationId) await this.writeParentRunLink({
+			parentConversationId,
 			runId,
 			ownerAgentId: view.run.metadata?.agentId ?? "",
-			workflowSessionKey: sessionKey,
+			workflowConversationId: conversationId,
 			definitionId: view.run.definitionId,
 			goal: view.run.goal,
 			status: view.run.status
 		});
-		this.recordProjectWorkflowMemory(sessionKey, view);
+		this.recordProjectWorkflowMemory(conversationId, view);
 		new TaskWorkflowCoordinator().handleTerminalRun(view);
 	}
-	async persistTerminalTranscript(sessionKey, view) {
+	async persistTerminalTranscript(conversationId, view) {
 		const store = this.gateway.sessionIndexInstance.getStore();
 		const snapshot = runViewToSnapshot(view);
 		const toolCallId = randomUUID();
@@ -107,7 +107,7 @@ var WorkflowSessionBridge = class {
 			details: snapshot
 		};
 		const isError = view.run.status === "failed" || view.run.status === "timeout";
-		await store.appendTranscriptMessage(sessionKey, {
+		await store.appendTranscriptMessage(conversationId, {
 			role: "assistant",
 			content: [{
 				type: "toolCall",
@@ -117,7 +117,7 @@ var WorkflowSessionBridge = class {
 			}],
 			timestamp: Date.now()
 		});
-		await store.appendTranscriptMessage(sessionKey, {
+		await store.appendTranscriptMessage(conversationId, {
 			role: "toolResult",
 			toolCallId,
 			content: [{
@@ -128,12 +128,12 @@ var WorkflowSessionBridge = class {
 			isError,
 			timestamp: Date.now()
 		});
-		await store.updateMetadata(sessionKey, { status: "active" });
+		await store.updateMetadata(conversationId, { status: "active" });
 	}
 	async writeParentRunLink(params) {
 		const store = this.gateway.sessionIndexInstance.getStore();
 		const text = formatParentRunLinkText(params);
-		await store.appendTranscriptContextEntry(params.parentSessionKey, {
+		await store.appendTranscriptContextEntry(params.parentConversationId, {
 			kind: "context",
 			id: `workflow-run-link:${params.runId}`,
 			text,
@@ -141,7 +141,7 @@ var WorkflowSessionBridge = class {
 				kind: WORKFLOW_RUN_LINK_CONTEXT_KIND,
 				runId: params.runId,
 				...params.ownerAgentId ? { ownerAgentId: params.ownerAgentId } : {},
-				workflowSessionKey: params.workflowSessionKey,
+				workflowConversationId: params.workflowConversationId,
 				definitionId: params.definitionId,
 				goal: params.goal,
 				status: params.status
@@ -149,7 +149,7 @@ var WorkflowSessionBridge = class {
 			createdAt: (/* @__PURE__ */ new Date()).toISOString()
 		});
 	}
-	recordProjectWorkflowMemory(sessionKey, view) {
+	recordProjectWorkflowMemory(conversationId, view) {
 		const projectId = view.run.metadata?.projectId?.trim();
 		const agentId = view.run.metadata?.agentId?.trim();
 		if (!projectId || !agentId) return;
@@ -161,7 +161,7 @@ var WorkflowSessionBridge = class {
 				id: projectId
 			},
 			sourceAgentId: agentId,
-			sourceSessionId: sessionKey,
+			sourceConversationId: conversationId,
 			content: [
 				`Workflow ${view.run.definitionId} finished with status ${view.run.status}.`,
 				view.run.goal ? `Goal: ${view.run.goal}` : void 0,
@@ -192,12 +192,12 @@ function truncateSessionName(name) {
 	if (trimmed.length <= 80) return trimmed;
 	return `${trimmed.slice(0, 77)}…`;
 }
-function readParentSessionKey(view) {
+function readParentConversationId(view) {
 	if (view.run.source.kind === "chat") {
-		const originKey = view.run.source.sessionKey?.trim();
+		const originKey = view.run.source.conversationId?.trim();
 		if (originKey) return originKey;
 	}
-	const customParent = view.run.metadata?.origin?.sessionKey?.trim();
+	const customParent = view.run.metadata?.origin?.conversationId?.trim();
 	if (customParent && view.run.metadata?.triggerSource === "chat") return customParent;
 	return null;
 }

package/dist/src/workflows/service/workflow-session-key.d.ts

@@ -1,3 +1,3 @@
 /** Stable webchat session key for one workflow run (`agent:{id}:webchat:…:direct:wf_{runId}`). */
-export declare function buildWorkflowRunSessionKey(agentId: string, runId: string): string;
+export declare function buildWorkflowRunConversationId(agentId: string, runId: string): string;
 export declare function readWorkflowRunIdFromSessionCustomData(customData: Record<string, unknown> | undefined): string | null;

package/dist/src/workflows/service/workflow-session-key.js

@@ -1,9 +1,9 @@
-import { buildSessionKey, init_session_key } from "../../routing/session-key.js";
+import { init_session_key, resolveConversationId } from "../../routing/session-key.js";
 //#region src/workflows/service/workflow-session-key.ts
 init_session_key();
 /** Stable webchat session key for one workflow run (`agent:{id}:webchat:…:direct:wf_{runId}`). */
-function buildWorkflowRunSessionKey(agentId, runId) {
-	return buildSessionKey({
+function buildWorkflowRunConversationId(agentId, runId) {
+	return resolveConversationId({
 		agentId,
 		source: "webchat",
 		accountId: "default",
@@ -16,4 +16,4 @@ function readWorkflowRunIdFromSessionCustomData(customData) {
 	return typeof raw === "string" && raw.trim() ? raw.trim() : null;
 }
 //#endregion
-export { buildWorkflowRunSessionKey, readWorkflowRunIdFromSessionCustomData };
+export { buildWorkflowRunConversationId, readWorkflowRunIdFromSessionCustomData };

package/dist/src/workflows/service/workflow-writeback-service.js

@@ -1,8 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { TaskRunRepository } from "../../tasks/task-run-repository.js";
+import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
 import { ProjectService } from "../../projects/project-service.js";
 //#region src/workflows/service/workflow-writeback-service.ts
+init_task_run_repository();
 init_logger();
 const log = createLogger("WorkflowWriteback");
 var WorkflowWritebackService = class {

package/dist/src/workflows/store/event-store.js

@@ -1,7 +1,9 @@
-import { requireXopcDatabase } from "../../storage/sqlite/connection.js";
-import { runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { init_connection, requireXopcDatabase } from "../../storage/sqlite/connection.js";
+import { init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/store/event-store.ts
+init_connection();
+init_transaction();
 var WorkflowEventStore = class {
 	constructor(_config, agentId) {
 		this.agentId = agentId;

package/dist/src/workflows/store/run-index-store.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 //#region src/workflows/store/run-index-store.ts
+init_transaction();
 function rowToSummary(row) {
 	const source = JSON.parse(row.source_json);
 	const metadata = row.metadata_json ? JSON.parse(row.metadata_json) : void 0;
@@ -21,24 +22,24 @@ function resultPreview(view) {
 	if (result == null) return null;
 	return result.summary.slice(0, 500);
 }
-function parentSessionKey(view) {
-	if (view.run.source.kind === "chat") return view.run.source.sessionKey;
-	return (view.run.metadata?.origin?.sessionKey)?.trim() || null;
+function parentConversationId(view) {
+	if (view.run.source.kind === "chat") return view.run.source.conversationId;
+	return (view.run.metadata?.origin?.conversationId)?.trim() || null;
 }
 var WorkflowRunIndexStore = class {
 	upsert(agentId, view) {
 		const run = view.run;
 		const metadata = run.metadata;
-		const sessionKey = metadata?.sessionKey;
-		if (!sessionKey) return;
+		const conversationId = metadata?.conversationId;
+		if (!conversationId) return;
 		runSqliteWriteTransaction((db) => {
 			db.prepare(`INSERT OR REPLACE INTO workflow_runs (
           run_id, agent_id, definition_id, definition_version, task_run_id,
-          project_id, session_key, parent_session_key, status, source_kind, source_json,
+          project_id, conversation_id, parent_conversation_id, status, source_kind, source_json,
           metadata_json, title,
           created_at_ms, started_at_ms, completed_at_ms, metrics_json,
           result_preview, error_message
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(run.id, agentId, run.definitionId, run.definitionVersion, metadata?.taskRunId ?? null, metadata?.projectId ?? null, sessionKey, parentSessionKey(view), run.status, run.source.kind, JSON.stringify(run.source), metadata ? JSON.stringify(metadata) : null, run.title, run.createdAtMs, run.startedAtMs ?? null, run.completedAtMs ?? null, JSON.stringify(run.metrics), resultPreview(view), run.error?.message ?? null);
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(run.id, agentId, run.definitionId, run.definitionVersion, metadata?.taskRunId ?? null, metadata?.projectId ?? null, conversationId, parentConversationId(view), run.status, run.source.kind, JSON.stringify(run.source), metadata ? JSON.stringify(metadata) : null, run.title, run.createdAtMs, run.startedAtMs ?? null, run.completedAtMs ?? null, JSON.stringify(run.metrics), resultPreview(view), run.error?.message ?? null);
 		});
 	}
 	list(agentId, options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.285",
+  "version": "0.0.291",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -167,9 +167,11 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/browser-control-contract": "0.1.0",
+    "@xopcai/computer-control-contract": "0.1.0",
+    "@xopcai/endpoint-tools-client": "0.0.0",
+    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/gateway-contract": "0.0.0",
     "@xopcai/realtime-client": "0.0.0",
-    "@xopcai/endpoint-tools-protocol": "0.0.0",
     "@xopcai/realtime-protocol": "0.0.0"
   },
   "scripts": {
@@ -236,7 +238,8 @@
     "build:extensions-ui": "node scripts/build-extensions-ui.mjs",
     "pack:browser-ext": "pnpm -C packages/browser-ext run pack",
     "sync:browser-ext-version": "node scripts/sync-browser-ext-version.mjs",
-    "electron:native:build": "node scripts/build-voice-hotkey-helper.mjs",
+    "computer:driver:setup": "node scripts/setup-computer-driver.mjs",
+    "electron:native:build": "node scripts/build-voice-hotkey-helper.mjs && node scripts/setup-computer-driver.mjs",
     "electron:dev": "pnpm run electron:native:build && cross-env ELECTRON_ENTRY=out/main/index.js electron-vite dev",
     "electron:vite:build": "cross-env ELECTRON_ENTRY=out/main/index.js electron-vite build",
     "electron:vite:build:package": "cross-env ELECTRON_ENTRY=out/main/index.js ELECTRON_VITE_SKIP_RENDERER=1 electron-vite build",

package/skills/creative/algorithmic-art/SKILL.md

@@ -2,6 +2,13 @@
 name: algorithmic-art
 description: Design reproducible, interactive generative-art studies as self-contained browser artifacts or workspace assets.
 metadata:
+  i18n:
+    en:
+      name: "Algorithmic Art"
+      description: "Design reproducible, interactive generative-art studies as self-contained browser artifacts or workspace assets."
+    zh-CN:
+      name: "算法艺术"
+      description: "设计可复现、可交互的生成艺术作品，并输出为独立浏览器作品或工作区资产。"
   xopc:
     emoji: "✨"
     requires_tools:

package/skills/creative/frontend-design/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: frontend-design
 description: Create distinctive, production-grade frontend interfaces, pages, components, dashboards, and HTML/CSS layouts.
+metadata:
+  i18n:
+    en:
+      name: "Frontend Design"
+      description: "Create distinctive, production-grade frontend interfaces, pages, components, dashboards, and HTML/CSS layouts."
+    zh-CN:
+      name: "前端设计"
+      description: "创建风格鲜明、可用于生产的前端界面、页面、组件、仪表盘及 HTML/CSS 布局。"
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/creative/hatch-pet/SKILL.md

@@ -2,6 +2,13 @@
 name: hatch-pet
 description: Create and install a custom animated xopc desktop pet from a user description.
 metadata:
+  i18n:
+    en:
+      name: "Hatch Pet"
+      description: "Create and install a custom animated XOPC desktop pet from a user description."
+    zh-CN:
+      name: "孵化桌面宠物"
+      description: "根据用户描述创建并安装自定义的 XOPC 动画桌面宠物。"
   xopc:
     activates_capabilities:
       - desktop-pet-authoring

package/skills/creative/theme-factory/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: theme-factory
 description: Apply or generate cohesive color and font themes for artifacts, slides, documents, reports, and landing pages.
+metadata:
+  i18n:
+    en:
+      name: "Theme Factory"
+      description: "Apply or generate cohesive color and font themes for artifacts, slides, documents, reports, and landing pages."
+    zh-CN:
+      name: "主题工厂"
+      description: "为作品、幻灯片、文档、报告和落地页应用或生成协调统一的配色与字体主题。"
 license: Complete terms in LICENSE.txt
 ---
 

package/skills/documents/doc-coauthoring/SKILL.md

@@ -2,6 +2,13 @@
 name: doc-coauthoring
 description: Co-author substantial proposals, specifications, RFCs, and decision documents through context, structure, and reader-focused review.
 metadata:
+  i18n:
+    en:
+      name: "Document Co-authoring"
+      description: "Co-author substantial proposals, specifications, RFCs, and decision documents through context, structure, and reader-focused review."
+    zh-CN:
+      name: "文档协作撰写"
+      description: "通过梳理背景、搭建结构和面向读者的审阅，共同撰写提案、规范、RFC 与决策文档。"
   xopc:
     emoji: "🤝"
     requires_tools:

package/skills/documents/docx/SKILL.md

@@ -2,6 +2,13 @@
 name: docx
 description: Create, inspect, edit, render, and validate Word DOCX artifacts while preserving templates and tracked content.
 metadata:
+  i18n:
+    en:
+      name: "Word Documents"
+      description: "Create, inspect, edit, render, and validate Word DOCX artifacts while preserving templates and tracked content."
+    zh-CN:
+      name: "Word 文档"
+      description: "在保留模板和修订内容的同时，创建、检查、编辑、渲染并验证 Word DOCX 文档。"
   xopc:
     emoji: "📝"
     requires_tools:

package/skills/documents/pdf/SKILL.md

@@ -2,6 +2,13 @@
 name: pdf
 description: Read, create, inspect, combine, split, rotate, and validate PDF artifacts in the current workspace.
 metadata:
+  i18n:
+    en:
+      name: "PDF Documents"
+      description: "Read, create, inspect, combine, split, rotate, and validate PDF artifacts in the current workspace."
+    zh-CN:
+      name: "PDF 文档"
+      description: "在当前工作区中读取、创建、检查、合并、拆分、旋转并验证 PDF 文档。"
   xopc:
     emoji: "📄"
     requires_tools:

package/skills/documents/pptx/SKILL.md

@@ -2,6 +2,13 @@
 name: pptx
 description: Create, inspect, edit, render, and validate PowerPoint PPTX presentations with deliberate visual hierarchy.
 metadata:
+  i18n:
+    en:
+      name: "PowerPoint Presentations"
+      description: "Create, inspect, edit, render, and validate PowerPoint PPTX presentations with deliberate visual hierarchy."
+    zh-CN:
+      name: "PowerPoint 演示文稿"
+      description: "创建、检查、编辑、渲染并验证具有清晰视觉层级的 PowerPoint PPTX 演示文稿。"
   xopc:
     emoji: "📊"
     requires_tools:

package/skills/documents/xlsx/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: xlsx
 description: "Create, read, edit, clean, format, chart, or convert spreadsheet files such as .xlsx, .xlsm, .csv, and .tsv."
+metadata:
+  i18n:
+    en:
+      name: "Spreadsheets"
+      description: "Create, read, edit, clean, format, chart, or convert spreadsheet files such as .xlsx, .xlsm, .csv, and .tsv."
+    zh-CN:
+      name: "电子表格"
+      description: "创建、读取、编辑、清理、格式化、绘图或转换 .xlsx、.xlsm、.csv 和 .tsv 等电子表格文件。"
 license: Proprietary. LICENSE.txt has complete terms
 ---
 
@@ -289,4 +297,4 @@ The script returns JSON with error details:
 **For Excel files themselves**:
 - Add comments to cells with complex formulas or important assumptions
 - Document data sources for hardcoded values
-- Include notes for key calculations and model sections
+- Include notes for key calculations and model sections

package/skills/engineering/build-xopc-local-app/SKILL.md

@@ -2,6 +2,13 @@
 name: build-xopc-local-app
 description: Build and iteratively improve a user-owned local XOPC app while preserving its stable extension identity, UI sandbox, and Phase 1 capability boundary.
 metadata:
+  i18n:
+    en:
+      name: "Build XOPC Local App"
+      description: "Build and iteratively improve a user-owned local XOPC app while preserving its stable extension identity, UI sandbox, and Phase 1 capability boundary."
+    zh-CN:
+      name: "构建 XOPC 本地应用"
+      description: "构建并迭代改进用户拥有的 XOPC 本地应用，同时保持稳定的扩展身份、UI 沙箱和第一阶段能力边界。"
   xopc:
     emoji: "🧩"
     requires_tools:

package/skills/engineering/define-task/SKILL.md

@@ -2,6 +2,13 @@
 name: define-task
 description: Define, create, or refine an explicitly requested persistent xopc Task with a verifiable Task Contract; do not use for ordinary one-off work.
 metadata:
+  i18n:
+    en:
+      name: "Define Task"
+      description: "Define, create, or refine an explicitly requested persistent XOPC Task with a verifiable Task Contract; do not use for ordinary one-off work."
+    zh-CN:
+      name: "定义任务"
+      description: "为用户明确要求的持久 XOPC 任务定义、创建或完善可验证的任务契约；不用于普通的一次性工作。"
   xopc:
     emoji: "🎯"
     requires_tools:

package/skills/engineering/diagnose/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: diagnose
 description: Disciplined reproduce → minimise → hypothesise → instrument → fix loop for hard bugs and performance regressions.
+metadata:
+  i18n:
+    en:
+      name: "Diagnose"
+      description: "A disciplined reproduce, minimize, hypothesize, instrument, and fix loop for difficult bugs and performance regressions."
+    zh-CN:
+      name: "问题诊断"
+      description: "以复现、最小化、提出假设、插桩验证和修复为闭环，诊断疑难缺陷与性能回退。"
 ---
 
 # Diagnose

package/skills/engineering/tdd/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: tdd
 description: Test-driven development using a red-green-refactor loop for features, bug fixes, and integration tests.
+metadata:
+  i18n:
+    en:
+      name: "Test-Driven Development"
+      description: "Test-driven development using a red-green-refactor loop for features, bug fixes, and integration tests."
+    zh-CN:
+      name: "测试驱动开发"
+      description: "使用红灯、绿灯、重构循环完成新功能、缺陷修复和集成测试。"
 ---
 
 # Test-Driven Development

package/skills/tools/find-skills/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: find-skills
 description: Find and evaluate installable agent skills across the XOPC Store, ClawHub, and skills.sh. Use when a user asks whether a skill exists, wants capability recommendations, or wants help choosing a high-value skill.
+metadata:
+  i18n:
+    en:
+      name: "Find Skills"
+      description: "Find and evaluate installable agent skills across the XOPC Store, ClawHub, and skills.sh."
+    zh-CN:
+      name: "查找技能"
+      description: "在 XOPC Store、ClawHub 和 skills.sh 中查找并评估可安装的智能体技能。"
 ---
 
 # Find Skills

package/skills/tools/github/SKILL.md

@@ -3,6 +3,13 @@ name: github
 description: "Interact with GitHub using the `gh` CLI for issues, PRs, CI runs, and advanced API queries."
 license: MIT
 metadata:
+  i18n:
+    en:
+      name: "GitHub"
+      description: "Interact with GitHub using the gh CLI for issues, pull requests, CI runs, and advanced API queries."
+    zh-CN:
+      name: "GitHub"
+      description: "使用 gh CLI 操作 GitHub 的 Issue、拉取请求、CI 任务和高级 API 查询。"
   xopc:
     requires_toolsets: [terminal]
     requires:

package/skills/tools/summarize/SKILL.md

@@ -1,6 +1,14 @@
 ---
 name: summarize
 description: Summarize URLs, files, and YouTube videos.
+metadata:
+  i18n:
+    en:
+      name: "Summarize"
+      description: "Summarize URLs, files, and YouTube videos."
+    zh-CN:
+      name: "内容摘要"
+      description: "总结网页链接、文件和 YouTube 视频内容。"
 license: MIT
 ---
 

package/skills/tools/webapp-testing/SKILL.md

@@ -3,6 +3,13 @@ name: webapp-testing
 description: Test local web applications with Playwright scripts, screenshots, browser logs, and UI behavior checks.
 license: Complete terms in LICENSE.txt
 metadata:
+  i18n:
+    en:
+      name: "Web App Testing"
+      description: "Test local web applications with Playwright scripts, screenshots, browser logs, and UI behavior checks."
+    zh-CN:
+      name: "Web 应用测试"
+      description: "使用 Playwright 脚本、截图、浏览器日志和界面行为检查来测试本地 Web 应用。"
   xopc:
     requires_toolsets: [terminal]
 ---
@@ -96,4 +103,4 @@ with sync_playwright() as p:
 - **examples/** - Examples showing common patterns:
   - `element_discovery.py` - Discovering buttons, links, and inputs on a page
   - `static_html_automation.py` - Using file:// URLs for local HTML
-  - `console_logging.py` - Capturing console logs during automation
+  - `console_logging.py` - Capturing console logs during automation