The Document Generation Backend for AI Coding Agents

---
name: "trydoku-generation"
description: "Batch document generation using TRYDOKU REST API and Word templates (.docx)."
---

# TRYDOKU Document Generation Skill

Use this skill to automate batch document generation (invoices, contracts, agreements, reports) from Microsoft Word (`.docx`) templates and structured datasets (Excel, CSV, JSON).

## API Specification & Contracts

- **Base URL:** `https://www.trydoku.com/api/v1`
- **Authentication:** Bearer token via `TRYDOKU_API_TOKEN` environment variable.
- **Header:** `Authorization: Bearer <TRYDOKU_API_TOKEN>`
- **Content-Type:** `application/json`
- **Accept:** `application/json`

### 1. Submit Generation Batch
- **Method:** `POST /api/v1/generate`
- **Payload Schema:**
  ```json
  {
    "template_base64": "<base64_encoded_docx_file_string>",
    "data": [
      {
        "client_name": "Acme Corp",
        "invoice_id": "INV-001",
        "amount": "$1,200.00",
        "is_discounted": true,
        "items": [
          { "description": "Consulting Services", "rate": "$800.00" },
          { "description": "System Integration", "rate": "$400.00" }
        ]
      }
    ]
  }
  ```
- **Response Schema (Pending):**
  ```json
  {
    "data": {
      "id": "batch_abc123",
      "status": "pending",
      "setup_status": "ready",
      "total_items": 1,
      "processed_items": 0,
      "failed_items": 0,
      "links": {
        "self": "https://www.trydoku.com/api/v1/batches/batch_abc123",
        "zip": null
      }
    }
  }
  ```

### 2. Poll Batch Status
- **Method:** `GET /api/v1/batches/{id}`
- **Response Schema (Completed):**
  ```json
  {
    "data": {
      "id": "batch_abc123",
      "status": "completed",
      "setup_status": "ready",
      "total_items": 1,
      "processed_items": 1,
      "failed_items": 0,
      "links": {
        "self": "https://www.trydoku.com/api/v1/batches/batch_abc123",
        "zip": "https://www.trydoku.com/api/v1/batches/batch_abc123/zip"
      }
    }
  }
  ```

## Template Placeholder Syntax Rules

1. **Scalars:** `{{ variable_name }}` (Must use letters, numbers, and underscores).
2. **Repeating Table Rows / Loops:**
   - In Word table cell 1: `{> items }}`
   - Inside row columns: `{{ description }}`, `{{ price }}`
   - In Word table last cell: `{< items }}`
3. **Conditional Sections:** `{% if is_discounted %} ... {% else %} ... {% endif %}`

## Agent Execution Best Practices

1. **Verify Variables First:** Before submitting bulk batches, inspect template placeholders or parse variables using TRYDOKU's free client-side tool at `https://www.trydoku.com/tools/word-template-variable-parser`.
2. **Handle Rate Limiting:** Apply exponential backoff (2s → 4s → 8s) when receiving HTTP 429 status codes.
3. **Credit Management:** Generation consumes 1 credit per non-empty row in the `data` array upon batch submission. Polling batch status (`GET /batches/{id}`) is completely free.
4. **Data Privacy & Retention:** Payload rows are encrypted at rest during queue processing, automatically cleared (`input_data = null`) immediately upon successful generation, and subject to an automated 72-hour pruning window for incomplete or failed batches. Encrypt tokens in environment variables and never commit secrets to repositories.