@unityclaw/skills 1.0.3 → 1.0.5

package/dist/{chunk-FAGVVFFQ.js → chunk-VTGLNHDK.js}

@@ -1,9 +1,11 @@
 // src/index.ts
-import { spawn } from "child_process";
+import { spawn, execSync } from "child_process";
 import { cp, mkdir, readdir, readFile } from "fs/promises";
-import { existsSync, readdirSync } from "fs";
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
+import * as os from "os";
+import * as readline from "readline";
 function getSkillsDir() {
   const hasSkillDirs = (dir) => {
     try {
@@ -108,6 +110,57 @@ function getOpenClawSkillsDir() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
   return process.env.OPENCLAW_SKILLS_DIR || path.join(homeDir, ".openclaw", "skills");
 }
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question("\nEnter your UnityClaw API key (or press Enter to skip): ", (answer) => {
+      rl.close();
+      resolve(answer.trim() || void 0);
+    });
+  });
+}
+function updateOpenClawEnvConfig(apiKey) {
+  const openclawDir = path.join(os.homedir(), ".openclaw");
+  const openclawPath = path.join(openclawDir, "openclaw.json");
+  let config = {};
+  if (existsSync(openclawPath)) {
+    try {
+      config = JSON.parse(readFileSync(openclawPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (!config.env) config.env = {};
+  const env = config.env;
+  if (!env.vars) env.vars = {};
+  env.vars.UNITYCLAW_API_KEY = apiKey;
+  if (!existsSync(openclawDir)) {
+    mkdirSync(openclawDir, { recursive: true });
+  }
+  writeFileSync(openclawPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function hasExistingApiKey() {
+  const sdkConfigPath = path.join(os.homedir(), ".unityclaw", "config.json");
+  if (existsSync(sdkConfigPath)) {
+    try {
+      const config = JSON.parse(readFileSync(sdkConfigPath, "utf-8"));
+      if (config?.apiKey) return true;
+    } catch {
+    }
+  }
+  const openclawPath = path.join(os.homedir(), ".openclaw", "openclaw.json");
+  if (existsSync(openclawPath)) {
+    try {
+      const config = JSON.parse(readFileSync(openclawPath, "utf-8"));
+      if (config?.env?.vars?.UNITYCLAW_API_KEY) return true;
+    } catch {
+    }
+  }
+  return false;
+}
 async function installSkills(target, skills) {
   const targetDir = target === "claude" ? getClaudeSkillsDir() : getOpenClawSkillsDir();
   const skillsDir = getSkillsDir();
@@ -137,6 +190,41 @@ Installing ${skillsToInstall.length} skill(s):
   }
   console.log(`
 \u2728 Done! Skills installed to: ${targetDir}`);
+  console.log("target", target);
+  console.log("hasExistingApiKey", hasExistingApiKey());
+  if (target === "openclaw" && !hasExistingApiKey()) {
+    console.log("\n\u{1F527} Configuration:");
+    console.log("  UnityClaw API key not found.\n");
+    const apiKey = await promptForApiKey();
+    if (apiKey) {
+      try {
+        execSync(`npx @unityclaw/sdk config set apiKey ${apiKey}`, { stdio: "pipe" });
+      } catch {
+        const configDir = path.join(os.homedir(), ".unityclaw");
+        const configPath = path.join(configDir, "config.json");
+        let config = {};
+        if (existsSync(configPath)) {
+          try {
+            config = JSON.parse(readFileSync(configPath, "utf-8"));
+          } catch {
+            config = {};
+          }
+        }
+        config.apiKey = apiKey;
+        if (!existsSync(configDir)) {
+          mkdirSync(configDir, { recursive: true });
+        }
+        writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+      }
+      updateOpenClawEnvConfig(apiKey);
+      console.log("\n  \u2705 API key saved to:");
+      console.log("     - ~/.openclaw/openclaw.json");
+      console.log("\n  Get your API key at: https://unityclaw.com");
+    } else {
+      console.log("\n  \u26A0\uFE0F  Skipped. Configure later with:");
+      console.log("     npx @unityclaw/sdk config set apiKey <your-key>");
+    }
+  }
 }
 async function executeSkill(skillCommand) {
   const args = [

package/dist/cli.cjs

@@ -33,6 +33,8 @@ var import_promises = require("fs/promises");
 var import_fs = require("fs");
 var import_path = __toESM(require("path"), 1);
 var import_url = require("url");
+var os = __toESM(require("os"), 1);
+var readline = __toESM(require("readline"), 1);
 var import_meta = {};
 function getSkillsDir() {
   const hasSkillDirs = (dir) => {
@@ -138,6 +140,57 @@ function getOpenClawSkillsDir() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
   return process.env.OPENCLAW_SKILLS_DIR || import_path.default.join(homeDir, ".openclaw", "skills");
 }
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question("\nEnter your UnityClaw API key (or press Enter to skip): ", (answer) => {
+      rl.close();
+      resolve(answer.trim() || void 0);
+    });
+  });
+}
+function updateOpenClawEnvConfig(apiKey) {
+  const openclawDir = import_path.default.join(os.homedir(), ".openclaw");
+  const openclawPath = import_path.default.join(openclawDir, "openclaw.json");
+  let config = {};
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (!config.env) config.env = {};
+  const env = config.env;
+  if (!env.vars) env.vars = {};
+  env.vars.UNITYCLAW_API_KEY = apiKey;
+  if (!(0, import_fs.existsSync)(openclawDir)) {
+    (0, import_fs.mkdirSync)(openclawDir, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(openclawPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function hasExistingApiKey() {
+  const sdkConfigPath = import_path.default.join(os.homedir(), ".unityclaw", "config.json");
+  if ((0, import_fs.existsSync)(sdkConfigPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(sdkConfigPath, "utf-8"));
+      if (config?.apiKey) return true;
+    } catch {
+    }
+  }
+  const openclawPath = import_path.default.join(os.homedir(), ".openclaw", "openclaw.json");
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+      if (config?.env?.vars?.UNITYCLAW_API_KEY) return true;
+    } catch {
+    }
+  }
+  return false;
+}
 async function installSkills(target, skills) {
   const targetDir = target === "claude" ? getClaudeSkillsDir() : getOpenClawSkillsDir();
   const skillsDir = getSkillsDir();
@@ -167,6 +220,41 @@ Installing ${skillsToInstall.length} skill(s):
   }
   console.log(`
 \u2728 Done! Skills installed to: ${targetDir}`);
+  console.log("target", target);
+  console.log("hasExistingApiKey", hasExistingApiKey());
+  if (target === "openclaw" && !hasExistingApiKey()) {
+    console.log("\n\u{1F527} Configuration:");
+    console.log("  UnityClaw API key not found.\n");
+    const apiKey = await promptForApiKey();
+    if (apiKey) {
+      try {
+        (0, import_child_process.execSync)(`npx @unityclaw/sdk config set apiKey ${apiKey}`, { stdio: "pipe" });
+      } catch {
+        const configDir = import_path.default.join(os.homedir(), ".unityclaw");
+        const configPath = import_path.default.join(configDir, "config.json");
+        let config = {};
+        if ((0, import_fs.existsSync)(configPath)) {
+          try {
+            config = JSON.parse((0, import_fs.readFileSync)(configPath, "utf-8"));
+          } catch {
+            config = {};
+          }
+        }
+        config.apiKey = apiKey;
+        if (!(0, import_fs.existsSync)(configDir)) {
+          (0, import_fs.mkdirSync)(configDir, { recursive: true });
+        }
+        (0, import_fs.writeFileSync)(configPath, JSON.stringify(config, null, 2), "utf-8");
+      }
+      updateOpenClawEnvConfig(apiKey);
+      console.log("\n  \u2705 API key saved to:");
+      console.log("     - ~/.openclaw/openclaw.json");
+      console.log("\n  Get your API key at: https://unityclaw.com");
+    } else {
+      console.log("\n  \u26A0\uFE0F  Skipped. Configure later with:");
+      console.log("     npx @unityclaw/sdk config set apiKey <your-key>");
+    }
+  }
 }
 async function executeSkill(skillCommand) {
   const args2 = [

package/dist/cli.js

@@ -3,7 +3,7 @@ import {
   executeSkill,
   installSkills,
   listSkills
-} from "./chunk-FAGVVFFQ.js";
+} from "./chunk-VTGLNHDK.js";
 
 // src/cli.ts
 import { program } from "commander";

package/dist/index.cjs

@@ -44,6 +44,8 @@ var import_promises = require("fs/promises");
 var import_fs = require("fs");
 var import_path = __toESM(require("path"), 1);
 var import_url = require("url");
+var os = __toESM(require("os"), 1);
+var readline = __toESM(require("readline"), 1);
 var import_meta = {};
 function getSkillsDir() {
   const hasSkillDirs = (dir) => {
@@ -149,6 +151,57 @@ function getOpenClawSkillsDir() {
   const homeDir = process.env.HOME || process.env.USERPROFILE || "";
   return process.env.OPENCLAW_SKILLS_DIR || import_path.default.join(homeDir, ".openclaw", "skills");
 }
+async function promptForApiKey() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question("\nEnter your UnityClaw API key (or press Enter to skip): ", (answer) => {
+      rl.close();
+      resolve(answer.trim() || void 0);
+    });
+  });
+}
+function updateOpenClawEnvConfig(apiKey) {
+  const openclawDir = import_path.default.join(os.homedir(), ".openclaw");
+  const openclawPath = import_path.default.join(openclawDir, "openclaw.json");
+  let config = {};
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+    } catch {
+      config = {};
+    }
+  }
+  if (!config.env) config.env = {};
+  const env = config.env;
+  if (!env.vars) env.vars = {};
+  env.vars.UNITYCLAW_API_KEY = apiKey;
+  if (!(0, import_fs.existsSync)(openclawDir)) {
+    (0, import_fs.mkdirSync)(openclawDir, { recursive: true });
+  }
+  (0, import_fs.writeFileSync)(openclawPath, JSON.stringify(config, null, 2), "utf-8");
+}
+function hasExistingApiKey() {
+  const sdkConfigPath = import_path.default.join(os.homedir(), ".unityclaw", "config.json");
+  if ((0, import_fs.existsSync)(sdkConfigPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(sdkConfigPath, "utf-8"));
+      if (config?.apiKey) return true;
+    } catch {
+    }
+  }
+  const openclawPath = import_path.default.join(os.homedir(), ".openclaw", "openclaw.json");
+  if ((0, import_fs.existsSync)(openclawPath)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(openclawPath, "utf-8"));
+      if (config?.env?.vars?.UNITYCLAW_API_KEY) return true;
+    } catch {
+    }
+  }
+  return false;
+}
 async function installSkills(target, skills) {
   const targetDir = target === "claude" ? getClaudeSkillsDir() : getOpenClawSkillsDir();
   const skillsDir = getSkillsDir();
@@ -178,6 +231,41 @@ Installing ${skillsToInstall.length} skill(s):
   }
   console.log(`
 \u2728 Done! Skills installed to: ${targetDir}`);
+  console.log("target", target);
+  console.log("hasExistingApiKey", hasExistingApiKey());
+  if (target === "openclaw" && !hasExistingApiKey()) {
+    console.log("\n\u{1F527} Configuration:");
+    console.log("  UnityClaw API key not found.\n");
+    const apiKey = await promptForApiKey();
+    if (apiKey) {
+      try {
+        (0, import_child_process.execSync)(`npx @unityclaw/sdk config set apiKey ${apiKey}`, { stdio: "pipe" });
+      } catch {
+        const configDir = import_path.default.join(os.homedir(), ".unityclaw");
+        const configPath = import_path.default.join(configDir, "config.json");
+        let config = {};
+        if ((0, import_fs.existsSync)(configPath)) {
+          try {
+            config = JSON.parse((0, import_fs.readFileSync)(configPath, "utf-8"));
+          } catch {
+            config = {};
+          }
+        }
+        config.apiKey = apiKey;
+        if (!(0, import_fs.existsSync)(configDir)) {
+          (0, import_fs.mkdirSync)(configDir, { recursive: true });
+        }
+        (0, import_fs.writeFileSync)(configPath, JSON.stringify(config, null, 2), "utf-8");
+      }
+      updateOpenClawEnvConfig(apiKey);
+      console.log("\n  \u2705 API key saved to:");
+      console.log("     - ~/.openclaw/openclaw.json");
+      console.log("\n  Get your API key at: https://unityclaw.com");
+    } else {
+      console.log("\n  \u26A0\uFE0F  Skipped. Configure later with:");
+      console.log("     npx @unityclaw/sdk config set apiKey <your-key>");
+    }
+  }
 }
 async function executeSkill(skillCommand) {
   const args = [

package/dist/index.js

@@ -6,7 +6,7 @@ import {
   installSkills,
   listSkills,
   parseSkill
-} from "./chunk-FAGVVFFQ.js";
+} from "./chunk-VTGLNHDK.js";
 export {
   executeSkill,
   getClaudeSkillsDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unityclaw/skills",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "UnityClaw Skills - Claude Code and OpenClaw skill definitions for AI-powered image/video generation, media analysis, and more",
   "type": "module",
   "bin": {

package/unityclaw-document-convert/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-document-convert
 description: Convert documents between formats (PDF, Word, PPT, Excel, Image)
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,29 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Result data here
+      name: string;
+      contentType: string;
+      content: string;     // URL to converted document
+    }> | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -55,8 +78,9 @@ const result = await client.document.pdf2Word({
   ]
 });
 
-if (result.code === 0) {
-  console.log('Converted document:', result.data);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Converted document:', result.response.data);
 }
 ```
 
@@ -175,8 +199,8 @@ const result = await client.document.pdf2Word({
   ]
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Word document:', result.data[0].content);
+if (result.success && result.response?.data) {
+  console.log('Word document:', result.response.data[0].content);
 }
 ```
 
@@ -210,8 +234,8 @@ const result = await client.document.pdf2Image({
 });
 
 // Returns array of images (one per page)
-if (result.code === 0 && result.data) {
-  result.data.forEach((img, i) => {
+if (result.success && result.response?.data) {
+  result.response.data.forEach((img, i) => {
     console.log(`Page ${i + 1}: ${img.content}`);
   });
 }
@@ -290,8 +314,8 @@ const results = await Promise.all(
 );
 
 results.forEach((result, i) => {
-  if (result.code === 0) {
-    console.log(`File ${i + 1} converted: ${result.data?.[0]?.content}`);
+  if (result.success && result.response?.data) {
+    console.log(`File ${i + 1} converted: ${result.response.data?.[0]?.content}`);
   }
 });
 ```
@@ -304,14 +328,14 @@ const converted = await client.document.image2Word({
   attachment: [{ tmp_url: 'https://...', name: 'image.jpg' }]
 });
 
-if (converted.code === 0 && converted.data) {
+if (converted.success && converted.response?.data) {
   const translated = await client.document.translate({
-    attachment: converted.data,
+    attachment: converted.response.data,
     source_language: 'en',
     target_language: 'zh'
   });
 
-  console.log('Translated document:', translated.data);
+  console.log('Translated document:', translated.response?.data);
 }
 ```
 
@@ -332,11 +356,19 @@ const result = await client.document.pdf2Word({
   attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }]
 });
 
-if (result.code !== 0) {
-  console.error('Conversion failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
+}
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
 }
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Task Folders

package/unityclaw-document-translation/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-document-translation
 description: Translate documents between multiple languages while preserving formatting
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,29 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Result data here
+      name: string;
+      contentType: string;
+      content: string;     // URL to translated document
+    }> | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -56,8 +79,9 @@ const result = await client.document.translate({
   target_language: { value: 'zh', label: 'Chinese' }
 });
 
-if (result.code === 0) {
-  console.log('Translated document:', result.data);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Translated document:', result.response.data);
 }
 ```
 
@@ -130,8 +154,8 @@ const result = await client.document.translate({
   target_language: { value: 'zh', label: 'Chinese' }
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Translated PDF:', result.data[0].content);
+if (result.success && result.response?.data) {
+  console.log('Translated PDF:', result.response.data[0].content);
 }
 ```
 
@@ -175,8 +199,8 @@ const result = await client.document.translate({
   target_language: { value: 'zh', label: 'Chinese' }
 });
 
-if (result.code === 0 && result.data) {
-  result.data.forEach((doc, i) => {
+if (result.success && result.response?.data) {
+  result.response.data.forEach((doc, i) => {
     console.log(`Document ${i + 1}: ${doc.content}`);
   });
 }
@@ -241,11 +265,19 @@ const result = await client.document.translate({
   target_language: 'zh'
 });
 
-if (result.code !== 0) {
-  console.error('Translation failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
+}
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
 }
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Task Folders

package/unityclaw-image-compress/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-image-compress
 description: Compress images with quality control to reduce file size
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,29 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Result data here
+      name: string;
+      contentType: string;
+      content: string;     // URL to compressed image
+    }> | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -55,8 +78,9 @@ const result = await client.image.compress({
   quality: 80
 });
 
-if (result.code === 0) {
-  console.log('Compressed images:', result.data);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Compressed images:', result.response.data);
 }
 ```
 
@@ -104,8 +128,8 @@ const result = await client.image.compress({
   quality: 75
 });
 
-if (result.code === 0 && result.data) {
-  const compressedImage = result.data[0];
+if (result.success && result.response?.data) {
+  const compressedImage = result.response.data[0];
   console.log('Compressed URL:', compressedImage.content);
 }
 ```
@@ -124,8 +148,8 @@ const result = await client.image.compress({
   quality: 80
 });
 
-if (result.code === 0 && result.data) {
-  result.data.forEach((img, i) => {
+if (result.success && result.response?.data) {
+  result.response.data.forEach((img, i) => {
     console.log(`Image ${i + 1}: ${img.content}`);
   });
 }
@@ -159,16 +183,16 @@ const generated = await client.image.gemini({
   prompt: 'A beautiful landscape'
 });
 
-if (generated.code === 0 && generated.data) {
+if (generated.success && generated.response?.data) {
   const compressed = await client.image.compress({
-    attachment: generated.data.map(img => ({
+    attachment: generated.response.data.map(img => ({
       tmp_url: img.content,
       name: img.name
     })),
     quality: 75
   });
 
-  console.log('Compressed generated images:', compressed.data);
+  console.log('Compressed generated images:', compressed.response?.data);
 }
 ```
 
@@ -190,11 +214,19 @@ const result = await client.image.compress({
   quality: 80
 });
 
-if (result.code !== 0) {
-  console.error('Compression failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
+}
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
 }
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Quality Guidelines

package/unityclaw-image-generation/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-image-generation
 description: Generate high-quality images using Gemini or JiMeng (Doubao) models
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,33 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access image data via `result.response.data`.
+
+```typescript
+interface ImageGenerationResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier (e.g., "b7b613d1")
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Generated images here
+      name: string;        // File name
+      contentType: string; // "attachment/url"
+      content: string;     // Image URL
+    }> | null;
+  };
+  logs: Array<{            // Execution logs
+    timestamp: string;
+    level: string;
+    message: string;
+  }>;
+  attachments: any[];      // Downloaded attachments
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -54,8 +81,11 @@ const result = await client.image.gemini({
   aspect_ratio: { value: '16:9', label: '16:9' }
 });
 
-if (result.code === 0) {
-  console.log('Generated images:', result.data);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Generated images:', result.response.data);
+} else {
+  console.error('Error:', result.response);
 }
 ```
 
@@ -147,8 +177,8 @@ const result = await client.image.gemini({
   size: { value: '2K', label: '2K' }
 });
 
-if (result.code === 0 && result.data) {
-  result.data.forEach((img, i) => {
+if (result.success && result.response?.data) {
+  result.response.data.forEach((img, i) => {
     console.log(`Image ${i + 1}: ${img.content}`);
   });
 }
@@ -164,6 +194,10 @@ const result = await client.image.gemini({
   ],
   aspect_ratio: { value: '1:1', label: '1:1' }
 });
+
+if (result.success) {
+  console.log('Style transfer complete:', result.response.data);
+}
 ```
 
 ### Batch Generation
@@ -180,7 +214,7 @@ const results = await Promise.all(
 );
 
 results.forEach((result, i) => {
-  if (result.code === 0) {
+  if (result.success) {
     console.log(`Prompt ${i + 1}: Success`);
   }
 });
@@ -188,27 +222,46 @@ results.forEach((result, i) => {
 
 ## Error Handling
 
+> **IMPORTANT:** Always check `result.success` first, then access data via `result.response.data`.
+
 ```typescript
 const result = await client.image.gemini({ prompt: 'test' });
 
-if (result.code !== 0) {
-  console.error('Error:', result.msg);
-  // Handle error
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
+}
+
+// Check API response code
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
 }
+
+// Success - access result.response.data
+console.log('Success:', result.response.data);
+console.log('Task ID:', result.taskId);
 ```
 
 ## Task Folders
 
-Each execution creates a task folder:
+Each execution creates a task folder with detailed logs:
 
 ```typescript
 const result = await client.image.gemini({ prompt: 'test' });
 
-console.log('Task ID:', result.taskId);
-console.log('Task Folder:', result.taskFolder);
-console.log('Attachments:', result.attachments);
+console.log('Task ID:', result.taskId);        // e.g., "609600db"
+console.log('Task Folder:', result.taskFolder); // e.g., "~/Documents/tasks/20260312_202723_609600db/"
+
+// Task folder structure:
+// ├── attachments/     - Generated images
+// │   └── xxx.png
+// └── logs/
+//     ├── execution.log
+//     ├── request.json   - API request payload
+//     ├── response.json  - Raw API response
+//     └── summary.json   - Task summary with success status
 ```
 
 ## Related Skills

package/unityclaw-media-analysis/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-media-analysis
 description: Analyze video and audio content to extract subtitles, summaries, and insights
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,28 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: {                // ✅ Result data here
+      summary: string;     // Content summary
+      subtitle: string;    // Extracted subtitles/transcript
+    } | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -53,9 +75,10 @@ const result = await client.media.analyze({
   url: [{ link: 'https://youtube.com/watch?v=...' }]
 });
 
-if (result.code === 0) {
-  console.log('Summary:', result.data?.summary);
-  console.log('Subtitle:', result.data?.subtitle);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Summary:', result.response.data.summary);
+  console.log('Subtitle:', result.response.data.subtitle);
 }
 ```
 
@@ -136,9 +159,9 @@ const result = await client.media.analyze({
   url: [{ link: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ' }]
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Summary:', result.data.summary);
-  console.log('Transcript:', result.data.subtitle);
+if (result.success && result.response?.data) {
+  console.log('Summary:', result.response.data.summary);
+  console.log('Transcript:', result.response.data.subtitle);
 }
 ```
 
@@ -200,8 +223,8 @@ const results = await Promise.all(
 );
 
 results.forEach((result, i) => {
-  if (result.code === 0) {
-    console.log(`Video ${i + 1}:`, result.data?.summary);
+  if (result.success) {
+    console.log(`Video ${i + 1}:`, result.response?.data?.summary);
   }
 });
 ```
@@ -277,11 +300,19 @@ const result = await client.media.analyze({
   url: [{ link: 'https://youtube.com/watch?v=invalid' }]
 });
 
-if (result.code !== 0) {
-  console.error('Analysis failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
 }
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
+}
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Task Folders

package/unityclaw-video-generation-kling/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-kling
 description: Generate AI videos using Kling model with multi-version support
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,29 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Result data here
+      name: string;
+      contentType: string;
+      content: string;     // URL to generated video
+    }> | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -54,8 +77,9 @@ const result = await client.video.kling({
   duration: { value: '5', label: '5s' }
 });
 
-if (result.code === 0) {
-  console.log('Generated video:', result.data);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Generated video:', result.response.data);
 }
 ```
 
@@ -201,11 +225,19 @@ const result = await client.video.kling({
   aspect_ratio: '16:9'
 });
 
-if (result.code !== 0) {
-  console.error('Video generation failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
+}
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
 }
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Task Folders

package/unityclaw-video-generation-other/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-other
 description: Generate videos using Doubao, Wan (Alibaba), MiniMax, and JiMeng models
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,29 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Result data here
+      name: string;
+      contentType: string;
+      content: string;     // URL to generated video
+    }> | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -54,6 +77,11 @@ const result = await client.video.doubao({
   resolution: { value: '1080p', label: '1080p' },
   ratio: { value: '16:9', label: '16:9' }
 });
+
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Generated video:', result.response.data);
+}
 ```
 
 ## Available APIs
@@ -225,8 +253,8 @@ const results = await Promise.all([
 
 results.forEach((result, i) => {
   const model = ['Doubao', 'Wan', 'MiniMax'][i];
-  if (result.code === 0) {
-    console.log(`${model}: ${result.data?.[0]?.content}`);
+  if (result.success && result.response?.data) {
+    console.log(`${model}: ${result.response.data?.[0]?.content}`);
   }
 });
 ```
@@ -259,11 +287,19 @@ const result = await client.video.doubao({
   ratio: '16:9'
 });
 
-if (result.code !== 0) {
-  console.error('Failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
 }
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
+}
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Task Folders

package/unityclaw-video-generation-sora/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-sora
 description: Generate cinematic videos using OpenAI Sora AI model
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,29 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Result data here
+      name: string;
+      contentType: string;
+      content: string;     // URL to generated video
+    }> | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -53,8 +76,9 @@ const result = await client.video.sora({
   orientation: { value: 'landscape', label: 'Landscape' }
 });
 
-if (result.code === 0) {
-  console.log('Generated video:', result.data);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Generated video:', result.response.data);
 }
 ```
 
@@ -127,8 +151,8 @@ const result = await client.video.sora({
   orientation: { value: 'landscape', label: 'Landscape' }
 });
 
-if (result.code === 0 && result.data) {
-  console.log('Video URL:', result.data[0].content);
+if (result.success && result.response?.data) {
+  console.log('Video URL:', result.response.data[0].content);
 }
 ```
 
@@ -180,8 +204,8 @@ const results = await Promise.all(
 );
 
 results.forEach((result, i) => {
-  if (result.code === 0) {
-    console.log(`Video ${i + 1}: ${result.data?.[0]?.content}`);
+  if (result.success && result.response?.data) {
+    console.log(`Video ${i + 1}: ${result.response.data?.[0]?.content}`);
   }
 });
 ```
@@ -218,11 +242,19 @@ const result = await client.video.sora({
   orientation: { value: 'landscape', label: 'Landscape' }
 });
 
-if (result.code !== 0) {
-  console.error('Video generation failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
+}
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
 }
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Task Folders

package/unityclaw-video-generation-veo/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: unityclaw-video-generation-veo
 description: Generate high-quality videos using Google Veo AI model
-version: 1.0.0
+version: 1.0.1
 metadata:
   openclaw:
     requires:
@@ -41,6 +41,29 @@ npx @unityclaw/sdk config set apiKey your-api-key
 export UNITYCLAW_API_KEY=your-api-key
 ```
 
+## Response Structure
+
+> **IMPORTANT:** The result has a nested structure. Use `result.success` to check overall success, and access data via `result.response.data`.
+
+```typescript
+interface UnityClawResult {
+  success: boolean;        // ✅ Use this to check if SDK call succeeded
+  taskId: string;          // Task identifier
+  taskFolder: string;      // Path to task folder with logs
+  duration: number;        // Request duration in ms
+  response: {              // API response object
+    code: number;          // 0 = success
+    data: Array<{          // ✅ Result data here
+      name: string;
+      contentType: string;
+      content: string;     // URL to generated video
+    }> | null;
+  };
+  logs: Array<{ timestamp; level; message }>;
+  attachments: any[];
+}
+```
+
 ## Quick Start
 
 ```typescript
@@ -54,8 +77,9 @@ const result = await client.video.veo({
   duration: { value: '8', label: '8s' }
 });
 
-if (result.code === 0) {
-  console.log('Generated video:', result.data);
+// ✅ Correct: Check result.success, access data via result.response.data
+if (result.success && result.response?.data) {
+  console.log('Generated video:', result.response.data);
 }
 ```
 
@@ -207,11 +231,19 @@ const result = await client.video.veo({
   aspect_ratio: '16:9'
 });
 
-if (result.code !== 0) {
-  console.error('Video generation failed:', result.msg);
-} else {
-  console.log('Success:', result.data);
+if (!result.success) {
+  console.error('Request failed');
+  console.log('Check logs:', result.logs);
+  return;
+}
+
+if (result.response?.code !== 0) {
+  console.error('API error:', result.response);
+  return;
 }
+
+// Success
+console.log('Success:', result.response.data);
 ```
 
 ## Task Folders