@unityclaw/skills 1.1.2 → 1.1.4

package/unityclaw-image-compress/SKILL.md

@@ -1,275 +0,0 @@
----
-name: unityclaw-image-compress
-description: Compress images with quality control to reduce file size
-version: 1.1.2
-metadata:
-  openclaw:
-    requires:
-      env:
-        - UNITYCLAW_API_KEY
-      bins:
-        - node
-        - npm
-    primaryEnv: UNITYCLAW_API_KEY
-    emoji: "🗜️"
-    homepage: https://unityclaw.com
-    install:
-      - kind: node
-        package: "@unityclaw/sdk"
-        bins: []
----
-
-# UnityClaw Image Compress
-
-Compress images to reduce file size while maintaining visual quality.
-
-## Installation
-
-```bash
-npm install @unityclaw/sdk
-```
-
-## Configuration
-
-Set your API key using one of these methods:
-
-```bash
-# Method 1: Use SDK CLI (recommended - persists across sessions)
-npx @unityclaw/sdk config set apiKey your-api-key
-
-# Method 2: Environment variable
-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
-import { UnityClawClient } from '@unityclaw/sdk';
-
-const client = new UnityClawClient();
-
-const result = await client.image.compress({
-  attachment: [
-    { tmp_url: 'https://example.com/large-image.jpg', name: 'image.jpg' }
-  ],
-  quality: 80
-});
-
-// ✅ Correct: Check result.success, access data via result.response.data
-if (result.success && result.response?.data) {
-  console.log('Compressed images:', result.response.data);
-}
-```
-
-## API Reference
-
-### compress()
-
-Compress one or more images with customizable quality.
-
-```typescript
-await client.image.compress({
-  attachment: AttachmentFieldItem[],
-  quality?: number
-}): Promise<APIResponse<AttachmentResult[]>>
-```
-
-## Parameters
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `attachment` | `AttachmentFieldItem[]` | Yes | Array of images to compress |
-| `quality` | `number` | No | Compression quality (0-100, default: 80) |
-
-### AttachmentFieldItem
-
-```typescript
-interface AttachmentFieldItem {
-  tmp_url: string;    // URL of the image to compress
-  name?: string;      // File name
-  type?: string;      // MIME type (e.g., 'image/jpeg')
-}
-```
-
-## Examples
-
-### Single Image Compression
-
-```typescript
-const client = new UnityClawClient();
-
-const result = await client.image.compress({
-  attachment: [
-    { tmp_url: 'https://example.com/photo.jpg', name: 'photo.jpg', type: 'image/jpeg' }
-  ],
-  quality: 75
-});
-
-if (result.success && result.response?.data) {
-  const compressedImage = result.response.data[0];
-  console.log('Compressed URL:', compressedImage.content);
-}
-```
-
-### Batch Compression
-
-```typescript
-const images = [
-  { tmp_url: 'https://example.com/img1.jpg', name: 'img1.jpg' },
-  { tmp_url: 'https://example.com/img2.png', name: 'img2.png' },
-  { tmp_url: 'https://example.com/img3.webp', name: 'img3.webp' }
-];
-
-const result = await client.image.compress({
-  attachment: images,
-  quality: 80
-});
-
-if (result.success && result.response?.data) {
-  result.response.data.forEach((img, i) => {
-    console.log(`Image ${i + 1}: ${img.content}`);
-  });
-}
-```
-
-### High Quality Compression
-
-```typescript
-// Preserve more detail (larger file size)
-const result = await client.image.compress({
-  attachment: [{ tmp_url: 'https://...', name: 'photo.jpg' }],
-  quality: 90
-});
-```
-
-### Aggressive Compression
-
-```typescript
-// Smaller file size (more quality loss)
-const result = await client.image.compress({
-  attachment: [{ tmp_url: 'https://...', name: 'photo.jpg' }],
-  quality: 50
-});
-```
-
-### With Generated Images
-
-```typescript
-// Generate then compress
-const generated = await client.image.jimeng({
-  prompt: 'A beautiful landscape',
-  size: '2048x2048'
-});
-
-if (generated.success && generated.response?.data) {
-  const compressed = await client.image.compress({
-    attachment: generated.response.data.map(img => ({
-      tmp_url: img.content,
-      name: img.name
-    })),
-    quality: 75
-  });
-
-  console.log('Compressed generated images:', compressed.response?.data);
-}
-```
-
-## Response Format
-
-```typescript
-interface AttachmentResult {
-  name: string;
-  contentType: string;
-  content: string;  // URL to compressed image
-}
-```
-
-## Error Handling
-
-```typescript
-const result = await client.image.compress({
-  attachment: [{ tmp_url: 'invalid-url', name: 'test.jpg' }],
-  quality: 80
-});
-
-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
-
-| Quality | Use Case | File Size Reduction |
-|---------|----------|---------------------|
-| 90-100 | Print, professional photography | Minimal |
-| 75-89 | Web display, social media | Moderate |
-| 50-74 | Thumbnails, previews | Significant |
-| 0-49 | Aggressive optimization | Maximum |
-
-## Supported Formats
-
-- JPEG/JPG
-- PNG
-- WebP
-- GIF (static)
-
-## Task Folders
-
-Each execution creates a task folder with logs and downloaded attachments:
-
-```typescript
-const result = await client.image.compress({
-  attachment: [{ tmp_url: 'https://...', name: 'image.jpg' }],
-  quality: 80
-});
-
-console.log('Task ID:', result.taskId);
-console.log('Task Folder:', result.taskFolder);
-console.log('Local Attachments:', result.attachments);
-```
-
-## Related Skills
-
-- [unityclaw-image-generation](../unityclaw-image-generation/SKILL.md) - Generate images before compression
-
-<!-- SDK_VERSION_RULE_START -->
-## SDK Version Check Rule
-
-- Before invoking this skill, check local `@unityclaw/sdk` version.
-- Required minimum SDK version: `1.1.2`
-- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
-- Suggested command: `npm i @unityclaw/sdk@latest`
-<!-- SDK_VERSION_RULE_END -->

package/unityclaw-video-frame-extract/SKILL.md

@@ -1,50 +0,0 @@
----
-name: unityclaw-video-frame-extract
-description: Extract first/last/specified-time frame from video attachments
-version: 1.1.2
-metadata:
-  openclaw:
-    requires:
-      env:
-        - UNITYCLAW_API_KEY
-      bins:
-        - node
-        - npm
-    primaryEnv: UNITYCLAW_API_KEY
-    emoji: "🖼️"
-    homepage: https://unityclaw.com
-    install:
-      - kind: node
-        package: "@unityclaw/sdk"
-        bins: []
----
-
-# UnityClaw Video Frame Extract
-
-Extract one frame from video at first frame, last frame, or specific `mm:ss`.
-
-```typescript
-import { UnityClawClient } from '@unityclaw/sdk';
-
-const client = new UnityClawClient();
-const result = await client.media.extractFrame({
-  attachment: [{ path: './files/demo.mp4' }],
-  frame_option: 'first',
-});
-
-if (result.success && result.response?.data?.[0]) {
-  console.log(result.response.data[0].content);
-}
-```
-
-- API: `/api/video/frame`
-- field-feishu: `video/frame`
-
-<!-- SDK_VERSION_RULE_START -->
-## SDK Version Check Rule
-
-- Before invoking this skill, check local `@unityclaw/sdk` version.
-- Required minimum SDK version: `1.1.2`
-- If local SDK version is lower than this skill version, stop and prompt user to upgrade SDK first.
-- Suggested command: `npm i @unityclaw/sdk@latest`
-<!-- SDK_VERSION_RULE_END -->