@unityclaw/skills 1.0.0

package/unityclaw-document-convert/SKILL.md

@@ -0,0 +1,375 @@
+---
+name: unityclaw-document-convert
+description: Convert documents between formats (PDF, Word, PPT, Excel, Image)
+version: 1.0.0
+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 Document Convert
+
+Convert documents between various formats including PDF, Word, PowerPoint, Excel, and images.
+
+## Installation
+
+```bash
+npm install @unityclaw/sdk
+```
+
+## Configuration
+
+Set your API key as environment variable:
+
+```bash
+export UNITYCLAW_API_KEY=your-api-key
+```
+
+## Quick Start
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+
+// Convert PDF to Word
+const result = await client.document.pdf2Word({
+  attachment: [
+    { tmp_url: 'https://example.com/document.pdf', name: 'document.pdf' }
+  ]
+});
+
+if (result.code === 0) {
+  console.log('Converted document:', result.data);
+}
+```
+
+## Available APIs
+
+### Image Conversions
+
+| Method | Description |
+|--------|-------------|
+| `image2Word()` | Convert image to Word document |
+| `image2Ppt()` | Convert image to PowerPoint |
+| `image2Excel()` | Convert image to Excel |
+| `image2Pdf()` | Convert image to PDF |
+
+### PDF Conversions
+
+| Method | Description |
+|--------|-------------|
+| `pdf2Word()` | Convert PDF to Word document |
+| `pdf2Ppt()` | Convert PDF to PowerPoint |
+| `pdf2Excel()` | Convert PDF to Excel |
+| `pdf2Image()` | Convert PDF to images |
+
+### Generic Conversion
+
+| Method | Description |
+|--------|-------------|
+| `convert()` | Generic conversion with format specification |
+
+## API Reference
+
+### Image to Word
+
+```typescript
+await client.document.image2Word({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### Image to PowerPoint
+
+```typescript
+await client.document.image2Ppt({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### Image to Excel
+
+```typescript
+await client.document.image2Excel({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### Image to PDF
+
+```typescript
+await client.document.image2Pdf({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### PDF to Word
+
+```typescript
+await client.document.pdf2Word({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### PDF to PowerPoint
+
+```typescript
+await client.document.pdf2Ppt({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### PDF to Excel
+
+```typescript
+await client.document.pdf2Excel({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### PDF to Image
+
+```typescript
+await client.document.pdf2Image({
+  attachment: AttachmentFieldItem[]
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+### Generic Convert
+
+```typescript
+await client.document.convert({
+  attachment: AttachmentFieldItem[];
+  input_format?: string;
+  output_format: string;
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+## Examples
+
+### PDF to Word
+
+```typescript
+const client = new UnityClawClient();
+
+const result = await client.document.pdf2Word({
+  attachment: [
+    { tmp_url: 'https://example.com/report.pdf', name: 'report.pdf' }
+  ]
+});
+
+if (result.code === 0 && result.data) {
+  console.log('Word document:', result.data[0].content);
+}
+```
+
+### PDF to PowerPoint
+
+```typescript
+const result = await client.document.pdf2Ppt({
+  attachment: [
+    { tmp_url: 'https://example.com/slides.pdf', name: 'slides.pdf' }
+  ]
+});
+```
+
+### PDF to Excel
+
+```typescript
+const result = await client.document.pdf2Excel({
+  attachment: [
+    { tmp_url: 'https://example.com/data.pdf', name: 'data.pdf' }
+  ]
+});
+```
+
+### PDF to Image
+
+```typescript
+const result = await client.document.pdf2Image({
+  attachment: [
+    { tmp_url: 'https://example.com/document.pdf', name: 'document.pdf' }
+  ]
+});
+
+// Returns array of images (one per page)
+if (result.code === 0 && result.data) {
+  result.data.forEach((img, i) => {
+    console.log(`Page ${i + 1}: ${img.content}`);
+  });
+}
+```
+
+### Image to Word (OCR)
+
+```typescript
+const result = await client.document.image2Word({
+  attachment: [
+    { tmp_url: 'https://example.com/scanned-doc.jpg', name: 'scanned.jpg' }
+  ]
+});
+```
+
+### Image to PowerPoint
+
+```typescript
+const result = await client.document.image2Ppt({
+  attachment: [
+    { tmp_url: 'https://example.com/diagram.png', name: 'diagram.png' }
+  ]
+});
+```
+
+### Image to Excel
+
+```typescript
+const result = await client.document.image2Excel({
+  attachment: [
+    { tmp_url: 'https://example.com/spreadsheet.png', name: 'spreadsheet.png' }
+  ]
+});
+```
+
+### Image to PDF
+
+```typescript
+const result = await client.document.image2Pdf({
+  attachment: [
+    { tmp_url: 'https://example.com/page1.jpg', name: 'page1.jpg' },
+    { tmp_url: 'https://example.com/page2.jpg', name: 'page2.jpg' }
+  ]
+});
+```
+
+### Generic Convert
+
+```typescript
+// Image to PDF
+const result = await client.document.convert({
+  attachment: [{ tmp_url: 'https://...', name: 'image.jpg' }],
+  input_format: 'image',
+  output_format: 'pdf'
+});
+
+// PDF to Word
+const result = await client.document.convert({
+  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
+  input_format: 'pdf',
+  output_format: 'word'
+});
+```
+
+### Batch Conversion
+
+```typescript
+const pdfFiles = [
+  { tmp_url: 'https://example.com/doc1.pdf', name: 'doc1.pdf' },
+  { tmp_url: 'https://example.com/doc2.pdf', name: 'doc2.pdf' },
+  { tmp_url: 'https://example.com/doc3.pdf', name: 'doc3.pdf' }
+];
+
+const results = await Promise.all(
+  pdfFiles.map(file => client.document.pdf2Word({ attachment: [file] }))
+);
+
+results.forEach((result, i) => {
+  if (result.code === 0) {
+    console.log(`File ${i + 1} converted: ${result.data?.[0]?.content}`);
+  }
+});
+```
+
+### Convert Then Translate
+
+```typescript
+// Convert image to Word, then translate
+const converted = await client.document.image2Word({
+  attachment: [{ tmp_url: 'https://...', name: 'image.jpg' }]
+});
+
+if (converted.code === 0 && converted.data) {
+  const translated = await client.document.translate({
+    attachment: converted.data,
+    source_language: 'en',
+    target_language: 'zh'
+  });
+
+  console.log('Translated document:', translated.data);
+}
+```
+
+## Response Format
+
+```typescript
+interface AttachmentResult {
+  name: string;
+  contentType: 'attachment/url';
+  content: string;  // URL to converted document
+}
+```
+
+## Error Handling
+
+```typescript
+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);
+}
+```
+
+## Task Folders
+
+Each execution creates a task folder:
+
+```typescript
+const result = await client.document.pdf2Word({
+  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }]
+});
+
+console.log('Task ID:', result.taskId);
+console.log('Task Folder:', result.taskFolder);
+console.log('Downloaded Files:', result.attachments);
+```
+
+## Conversion Matrix
+
+| From | To | Method |
+|------|-----|--------|
+| PDF | Word | `pdf2Word()` |
+| PDF | PowerPoint | `pdf2Ppt()` |
+| PDF | Excel | `pdf2Excel()` |
+| PDF | Image | `pdf2Image()` |
+| Image | Word | `image2Word()` |
+| Image | PowerPoint | `image2Ppt()` |
+| Image | Excel | `image2Excel()` |
+| Image | PDF | `image2Pdf()` |
+
+## Best Practices
+
+1. **File Size**: Large files may take longer to process
+2. **Format Fidelity**: Complex formatting may have minor differences
+3. **Batch Processing**: Use Promise.all for multiple files
+4. **Error Recovery**: Always check result.code before proceeding
+
+## Related Skills
+
+- [unityclaw-document-translation](../unityclaw-document-translation/SKILL.md) - Translate documents
+- [unityclaw-image-compress](../unityclaw-image-compress/SKILL.md) - Compress images before conversion

package/unityclaw-document-translation/SKILL.md

@@ -0,0 +1,273 @@
+---
+name: unityclaw-document-translation
+description: Translate documents between multiple languages while preserving formatting
+version: 1.0.0
+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 Document Translation
+
+Translate documents between multiple languages while preserving original formatting and structure.
+
+## Installation
+
+```bash
+npm install @unityclaw/sdk
+```
+
+## Configuration
+
+Set your API key as environment variable:
+
+```bash
+export UNITYCLAW_API_KEY=your-api-key
+```
+
+## Quick Start
+
+```typescript
+import { UnityClawClient } from '@unityclaw/sdk';
+
+const client = new UnityClawClient();
+
+const result = await client.document.translate({
+  attachment: [
+    { tmp_url: 'https://example.com/document.pdf', name: 'document.pdf' }
+  ],
+  source_language: { value: 'en', label: 'English' },
+  target_language: { value: 'zh', label: 'Chinese' }
+});
+
+if (result.code === 0) {
+  console.log('Translated document:', result.data);
+}
+```
+
+## API Reference
+
+### translate()
+
+Translate a document from one language to another.
+
+```typescript
+await client.document.translate({
+  attachment: AttachmentFieldItem[];
+  source_language: LabelFieldItem | string;
+  target_language: LabelFieldItem | string;
+}): Promise<APIResponse<AttachmentResult[]>>
+```
+
+## Parameters
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `attachment` | `AttachmentFieldItem[]` | Yes | Document(s) to translate |
+| `source_language` | `LabelFieldItem \| string` | Yes | Source language code |
+| `target_language` | `LabelFieldItem \| string` | Yes | Target language code |
+
+## Supported Languages
+
+| Code | Language |
+|------|----------|
+| `en` | English |
+| `zh` | Chinese (Simplified) |
+| `zh-TW` | Chinese (Traditional) |
+| `ja` | Japanese |
+| `ko` | Korean |
+| `es` | Spanish |
+| `fr` | French |
+| `de` | German |
+| `pt` | Portuguese |
+| `ru` | Russian |
+| `ar` | Arabic |
+| `it` | Italian |
+| `nl` | Dutch |
+| `pl` | Polish |
+| `tr` | Turkish |
+| `vi` | Vietnamese |
+| `th` | Thai |
+| `id` | Indonesian |
+
+## Supported Document Formats
+
+- PDF (.pdf)
+- Word (.doc, .docx)
+- PowerPoint (.ppt, .pptx)
+- Excel (.xls, .xlsx)
+- Text (.txt)
+- RTF (.rtf)
+
+## Examples
+
+### PDF Translation
+
+```typescript
+const client = new UnityClawClient();
+
+const result = await client.document.translate({
+  attachment: [
+    { tmp_url: 'https://example.com/report.pdf', name: 'report.pdf' }
+  ],
+  source_language: { value: 'en', label: 'English' },
+  target_language: { value: 'zh', label: 'Chinese' }
+});
+
+if (result.code === 0 && result.data) {
+  console.log('Translated PDF:', result.data[0].content);
+}
+```
+
+### Word Document Translation
+
+```typescript
+const result = await client.document.translate({
+  attachment: [
+    { tmp_url: 'https://example.com/contract.docx', name: 'contract.docx' }
+  ],
+  source_language: 'en',
+  target_language: 'ja'
+});
+```
+
+### Simple String Parameters
+
+```typescript
+// Use simple strings for language codes
+const result = await client.document.translate({
+  attachment: [
+    { tmp_url: 'https://example.com/doc.pdf', name: 'doc.pdf' }
+  ],
+  source_language: 'en',
+  target_language: 'zh'
+});
+```
+
+### Batch Translation
+
+```typescript
+const documents = [
+  { tmp_url: 'https://example.com/doc1.pdf', name: 'doc1.pdf' },
+  { tmp_url: 'https://example.com/doc2.pdf', name: 'doc2.pdf' },
+  { tmp_url: 'https://example.com/doc3.pdf', name: 'doc3.pdf' }
+];
+
+const result = await client.document.translate({
+  attachment: documents,
+  source_language: { value: 'en', label: 'English' },
+  target_language: { value: 'zh', label: 'Chinese' }
+});
+
+if (result.code === 0 && result.data) {
+  result.data.forEach((doc, i) => {
+    console.log(`Document ${i + 1}: ${doc.content}`);
+  });
+}
+```
+
+### Multi-Language Translation
+
+```typescript
+const translateTo = async (
+  documentUrl: string,
+  targetLanguages: string[]
+) => {
+  const client = new UnityClawClient();
+  const results = await Promise.all(
+    targetLanguages.map(lang =>
+      client.document.translate({
+        attachment: [{ tmp_url: documentUrl, name: 'document.pdf' }],
+        source_language: 'en',
+        target_language: lang
+      })
+    )
+  );
+
+  return results;
+};
+
+// Translate English document to multiple languages
+const translations = await translateTo(
+  'https://example.com/english-doc.pdf',
+  ['zh', 'ja', 'ko', 'es', 'fr']
+);
+```
+
+### Chinese to English
+
+```typescript
+const result = await client.document.translate({
+  attachment: [
+    { tmp_url: 'https://example.com/chinese-doc.pdf', name: 'chinese.pdf' }
+  ],
+  source_language: { value: 'zh', label: 'Chinese' },
+  target_language: { value: 'en', label: 'English' }
+});
+```
+
+## Response Format
+
+```typescript
+interface AttachmentResult {
+  name: string;
+  contentType: 'attachment/url';
+  content: string;  // URL to translated document
+}
+```
+
+## Error Handling
+
+```typescript
+const result = await client.document.translate({
+  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
+  source_language: 'en',
+  target_language: 'zh'
+});
+
+if (result.code !== 0) {
+  console.error('Translation failed:', result.msg);
+} else {
+  console.log('Success:', result.data);
+}
+```
+
+## Task Folders
+
+Each execution creates a task folder:
+
+```typescript
+const result = await client.document.translate({
+  attachment: [{ tmp_url: 'https://...', name: 'doc.pdf' }],
+  source_language: 'en',
+  target_language: 'zh'
+});
+
+console.log('Task ID:', result.taskId);
+console.log('Task Folder:', result.taskFolder);
+console.log('Downloaded Files:', result.attachments);
+```
+
+## Best Practices
+
+1. **Format Preservation**: Original formatting is maintained
+2. **Large Documents**: May take longer for extensive documents
+3. **Language Detection**: Specify source language for accuracy
+4. **Quality Review**: Review translations for context-specific terms
+
+## Related Skills
+
+- [unityclaw-document-convert](../unityclaw-document-convert/SKILL.md) - Convert document formats
+- [unityclaw-media-analysis](../unityclaw-media-analysis/SKILL.md) - Analyze video/audio content