Create ZIP

Overview

You provide files as inline UTF-8 text, base64 bytes, or managed file references and we build a deterministic ZIP archive. Entry paths are validated against zip-slip (absolute paths, .., drive letters, backslashes, over-long names). Duplicate paths are rejected unless you allow overwrites. We return a file reference when storage is available, or archiveBase64 as a fallback, plus size and SHA-256. Do not use this to extract archives or create password-protected zips. Archive members cost 1 execution credit per 10 members, rounded up, minimum 1, capped at 1000 members (100 credits).

Agents cannot produce binary archives reliably. We build deterministic, zip-slip-safe ZIPs from content you already have.

When to use it

Scope

Non-goals

• Does not extract archives
• Does not encrypt or password-protect
• Does not fetch external URLs

Properties

Capabilities

Cost & billing

1 execution credit per 10 archive members, rounded up, reserved from the request and capped at 1000 members (100 credits).

File handling

File limits

Constraints this skill applies to your input and generated files. The “Limited by” column shows the static source of each cap; none of these can be raised by upgrading your plan.

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"file.create_zip","input":{"files":[{"path":"one.txt","content":"Hello"}]}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("file.create_zip", {"files":[{"content":"Hello","path":"readme.txt"},{"content":"More","path":"data/info.txt"}]});

Errors

Other limits

Limitations

• Does not extract archives
• Does not encrypt or password-protect
• Does not fetch external URLs
• Archive extraction (use file.safe_extract_archive)
• Password-protected or encrypted archives

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "file.create_zip",
  "input": {
    "files": [
      {
        "content": "Hello",
        "path": "readme.txt"
      },
      {
        "content": "More",
        "path": "data/info.txt"
      }
    ]
  }
}

Examples

{
  "files": [
    {
      "content": "Hello",
      "path": "readme.txt"
    },
    {
      "content": "More",
      "path": "data/info.txt"
    }
  ]
}

{
  "fileRef": "squillify://files/f-generated-archive",
  "expiresAt": "2026-08-13T12:00:00Z",
  "sizeBytes": 301,
  "downloadUrl": "https://files.squillify.example/generated-archive",
  "ok": true,
  "entryCount": 2,
  "metadata": {
    "compressionLevel": 6,
    "outputFilename": "archive.zip"
  },
  "sha256": "3d14b5b2236cc79e3b1f533361055f829dcf02e98974579dc78e948fa234ad2c"
}

{
  "compressionLevel": 9,
  "files": [
    {
      "content": "ok",
      "path": "note.txt"
    }
  ]
}

{
  "fileRef": "squillify://files/f-generated-archive",
  "expiresAt": "2026-08-13T12:00:00Z",
  "sizeBytes": 152,
  "downloadUrl": "https://files.squillify.example/generated-archive",
  "ok": true,
  "entryCount": 1,
  "metadata": {
    "compressionLevel": 9,
    "outputFilename": "archive.zip"
  },
  "sha256": "4fd10e5c2b4a4a77242d3668a3c6198805c1e3ef90d1d35505f64a305a959652"
}

Recommended use cases

• Bundle agent outputs for download
• Package multiple managed files into one handoff artifact

Avoid for

• Archive extraction (use file.safe_extract_archive)
• Password-protected or encrypted archives

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags