Freev1.0.0

translate

Translate text to another language (e.g. via LibreTranslate). Use when the user says "translate this to [language]", "translate the above to Spanish", "translate to French", "how do you say X in Y".

Published by

Sai Ko

—Sign in to rate

How to install

Point your Sulala Agent at this store, then install this skill.

Set the registry URL (e.g. in .env):

SKILLS_REGISTRY_URL=https://hub.sulala.ai/api/sulalahub/registry

Then run: sulala skill install translate or install from the dashboard Skills page. This installs the latest version (currently v1.0.0); you can pin a specific version in your skill config if needed.

Skill files

README.md

---
name: translate
description: Translate text to another language (e.g. via LibreTranslate). Use when the user says "translate this to [language]", "translate the above to Spanish", "translate to French", "how do you say X in Y".
metadata:
  clawdbot:
    emoji: "🌐"
    requires:
      bins:
        - curl
---

# Translate

Use **curl** to call a translation API. **LibreTranslate** is free and open; public instances exist. No API key for many instances.

## LibreTranslate (POST)

Most instances use the same API. Replace `https://libretranslate.com` with another instance if needed.

**Translate text:**

```bash
curl -s -X POST "https://libretranslate.com/translate" \
  -H "Content-Type: application/json" \
  -d '{"q":"Hello world","source":"en","target":"es"}'
```

Response: `{"translatedText":"Hola mundo"}`. Use **jq** to extract: `... | jq -r '.translatedText'`.

**Parameters:**

- `q` — text to translate
- `source` — source language code (e.g. `en`, `fr`, `auto` for auto-detect)
- `target` — target language code (e.g. `es`, `de`, `ja`)

**Example with jq:**

```bash
curl -s -X POST "https://libretranslate.com/translate" \
  -H "Content-Type: application/json" \
  -d '{"q":"Hello world","source":"en","target":"es"}' | jq -r '.translatedText'
```

## Language codes (common)

`en` English · `es` Spanish · `fr` French · `de` German · `it` Italian · `pt` Portuguese · `ja` Japanese · `zh` Chinese · `ko` Korean · `ar` Arabic · `ru` Russian.

## Tips

- Escape quotes in the JSON body for the shell (e.g. `\"` or use single quotes around the string and escape only inner quotes).
- If the default instance is rate-limited, try another public LibreTranslate instance or document an optional config for API URL/key.
- For "translate this to Spanish", set `target` to `es` and put the user's text in `q`; use `source: "auto"` if the source language is unknown.

Comments

Loading comments…