nexus/server/src/skills/content/convert.SKILL.md

927 B

name description
Format Converter Convert files between formats using direct conversion or AI-bridged fallback via the Nexus content job API

Format Converter

Convert an existing asset to a different file format. Supports direct converter paths (ffmpeg, sharp, pandoc) with AI-bridged fallback for all format pairs.

Usage

Submit a content job via POST /api/companies/{companyId}/content-jobs:

{
  "jobType": "convert",
  "input": {
    "sourceAssetId": "asset-uuid-here",
    "targetFormat": "pdf"
  }
}

Fields:

  • sourceAssetId (required): UUID of the source asset already stored in Nexus
  • targetFormat (required): Target format extension — e.g. pdf, png, mp4, docx, svg

Output

The job returns a ConvertBundle with:

  • assetId: ID of the converted output asset
  • targetFormat: Format that was applied
  • method: Conversion path used — direct or ai-bridge