Summon Translator Skill#

Use this skill to translate compliance-critical files — XLIFF exports from Articulate Rise 360, supplier qualification forms, safety data sheets, JSAs, LOTOs, arc flash procedures, and more — into any target language with terminology precision.

Who this is for#

Supply Chain Managers — Onboard global suppliers faster. Translate qualification questionnaires, vendor codes of conduct, and procurement forms without waiting on LSP quotes.

Articulate Rise 360 / L&D Teams — Export your course XLIFF from Rise, translate it here, re-import. No manual copy-paste. Preserves all tags, inline formatting, and segment structure. Ideal for safety inductions, compliance modules, and onboarding courses across multilingual workforces.

Heavy Industry HSE Professionals — Translate JSAs, SDS sheets, arc flash warning labels, LOTO procedures, confined space permits, and toolbox talk scripts into the field languages your workers actually speak. Supports Arabic (RTL), Vietnamese, Tagalog, Hindi, Portuguese, and 130+ more.

---

Prerequisites#

1. Create an account at https://summontranslator.com
2. Add a payment method at https://summontranslator.com/billing
3. Generate an API key at https://summontranslator.com/account
4. Set the environment variable: SUMMON_API_KEY=st_live_<your-key>

Verify your key is working#

bash

curl -s https://summontranslator.com/api/v1/ping \
  -H "Authorization: Bearer $SUMMON_API_KEY"

Expected response: {"ok":true,"version":"1",...}

---

translate_file — Translate a local file#

Use this command when the user wants to translate a file.

Parameters:

• file_path — path to the file on disk (required)
• target_languages — comma-separated BCP-47 codes, e.g. ja-JP,fr-FR,de-DE (required)
• model — AI model to use (optional, default: claude-haiku-4-5-20251001)
• provider — anthropic | openai | gemini | deepseek (optional, inferred from model)
• source_language — source language BCP-47 code (optional, default: en-US)
• output_dir — directory to save translated files (optional, default: same dir as input)

Step 1 — Submit the translation job#

bash

curl -s -X POST https://summontranslator.com/api/v1/jobs \
  -H "Authorization: Bearer $SUMMON_API_KEY" \
  -F "file=@{file_path}" \
  -F "provider={provider}" \
  -F "model={model}" \
  -F "targetLanguages={target_languages}" \
  -F "sourceLanguage={source_language}" \
  -F "name=$(basename {file_path})"

Save the jobId from the response.

Step 2 — Poll for completion#

bash

curl -s https://summontranslator.com/api/v1/jobs/{jobId} \
  -H "Authorization: Bearer $SUMMON_API_KEY"

Repeat every 15 seconds until status is "completed" or "failed". Each task in the tasks array shows per-language progress.

Step 3 — Download each translated file#

For each completed task, use the downloadUrl from the poll response:

bash

curl -s -L -o "{output_dir}/{taskId}.{ext}" \
  -H "Authorization: Bearer $SUMMON_API_KEY" \
  "{downloadUrl}"

Or use the explicit URL:

bash

curl -s -L -o "{output_dir}/{language}.{ext}" \
  -H "Authorization: Bearer $SUMMON_API_KEY" \
  "https://summontranslator.com/api/v1/jobs/{jobId}/tasks/{taskId}/download"

---

check_job — Check translation status#

Use when the user wants to check the status of a previously submitted job.

bash

curl -s https://summontranslator.com/api/v1/jobs/{job_id} \
  -H "Authorization: Bearer $SUMMON_API_KEY"

---

list_jobs — List recent translation jobs#

bash

curl -s "https://summontranslator.com/api/v1/jobs?limit=10" \
  -H "Authorization: Bearer $SUMMON_API_KEY"

---

Supported file formats#

ExtensionFormatTypical Use Case.xliff / .xlfXLIFF 1.2 bilingualArticulate Rise 360 exports, TMS roundtrips.jsonJSON key-valueSupplier portal UI strings, web app content.csvCSV (id, value columns)Qualification forms, audit checklists.mdMarkdownSOPs, safety bulletins, internal wikis.txtPlain textToolbox talk scripts, permit-to-work templates.xmlAndroid string resourcesMobile HSE apps, field inspection tools.poGNU gettextOpen-source EHS platforms.stringsiOS/macOS Localizable.stringsNative mobile safety apps.stringsdictiOS/macOS plural rulesMobile apps with count-based strings.xcstringsXcode String CatalogModern iOS/macOS app localization.arbFlutter ARBCross-platform field inspection apps.propertiesJava resource bundlesEnterprise ERP / WMS localization

---

Articulate Rise 360 Workflow#

Rise 360 exports course content as an XLIFF file ( .xlf). Use Summon Translator to localize it without breaking your course structure:

1. In Rise, go to Export → Translations → Export for Translation → download the .xlf
2. Run translate_file with your .xlf and target languages (e.g., es-ES,pt-BR,vi-VN)
3. Download the translated .xlf files
4. Re-import into Rise: Export → Translations → Import Translation

All inline tags ( <g>, <x/>, <mrk>) are preserved. No broken segments.

Recommended model for eLearning: claude-sonnet-4-6 — best at maintaining instructional tone, safety register, and consistent terminology across modules.

---

HSE Content Tips#

For safety-critical translations, use claude-sonnet-4-6 and add a system prompt or glossary note in your job name to signal the domain:

bash

-F "name=arc-flash-loto-procedure_HSE"

High-stakes content types that benefit most from AI translation review:

• Arc flash boundary labels and PPE category callouts
• SDS Sections 2, 4, 7 (hazard ID, first aid, handling/storage)
• LOTO energy isolation sequences
• Confined space entry permits
• Emergency response and evacuation procedures

⚠️ For regulatory submissions or legally binding safety documents, always have a qualified human reviewer validate the final translation.

---

Common target language codes for industrial workforces#

LanguageCodeCommon regionsSpanish (Latin America)es-419Mexico, Central/South AmericaSpanish (Spain)es-ESSpain, EU supplier basePortuguese (Brazil)pt-BRBrazil manufacturingVietnamesevi-VNSoutheast Asia operationsTagalogtl-PHPhilippines, offshore marineHindihi-INIndia supply chainArabicar-SAGulf region, oilfieldFrenchfr-FRFrance, West Africa, CanadaMandarin (Simplified)zh-CNChina manufacturingMandarin (Traditional)zh-TWTaiwan, HK procurementThaith-THThailand, ASEANIndonesianid-IDIndonesia, miningPolishpl-PLEastern Europe manufacturing

---

Supported models#

Model IDProviderBest forclaude-sonnet-4-6anthropicHSE docs, eLearning, compliance content requiring precisionclaude-haiku-4-5-20251001anthropicHigh-volume supplier forms, UI strings, fast turnaroundgpt-4oopenaiAlternative premium optiongpt-4o-miniopenaiCost-conscious batch jobsgemini-2.0-flashgeminiBulk processing, lower costdeepseek-chatdeepseekBudget option for non-critical content

Recommended default: claude-haiku-4-5-20251001 — fast and affordable for most supply chain and onboarding content.

For safety-critical or Rise 360 eLearning: use claude-sonnet-4-6.

---

Pricing#

• $0.007 per source word (platform fee)
• Plus AI model cost × 5 markup
• $5.00 minimum per job
• Billed monthly to card on file
• First 1,000 words free: add -F "promoCode=1TIME" to your first job

A typical 30-minute Rise 360 safety induction course (~3,000 source words) costs roughly $21–$45 depending on model — vs. $300–$600+ from a traditional LSP.

---

Support#

Email: support@summontranslator.com

API docs: https://summontranslator.com/llms.txt