← Back to Skills Marketplace
litousteven

Translate TXT

by litousteven · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
85
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install smart-translate-txt
Description
Translate text files using OpenAI-compatible APIs (e.g. SiliconFlow, DeepSeek, OpenAI). Use when the user wants to: translate a txt file, translate text to C...
Usage Guidance
This skill appears to do exactly what it says: it will send the contents of the input .txt file to whichever OpenAI‑compatible API you configure, so only provide an API key for a provider you trust and avoid translating sensitive or confidential documents with third‑party services. Note the registry metadata omits the required TRANSLATE_API_KEY even though SKILL.md and the scripts expect it — check the skill source before use (source/homepage are unknown). If you prefer to keep data local, run translations through a private endpoint (use --base-url) or avoid installing the skill. Finally, confirm where the .env file will be stored (~/.comate/skills/translate-txt/.env) and consider its filesystem permissions or removing the key after use.
Capability Analysis
Type: OpenClaw Skill Name: smart-translate-txt Version: 1.0.1 The skill bundle is a legitimate tool for translating text files using OpenAI-compatible APIs. The code in `scripts/translate.py` implements a sophisticated translation strategy involving keyword extraction and sliding-window context without any signs of malicious intent, data exfiltration, or unauthorized execution. The `setup.sh` script safely manages local configuration in a `.env` file, and the `SKILL.md` instructions are consistent with the tool's stated purpose.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The name/description match the implemented behavior: a Python translator that sends text to an OpenAI‑compatible chat endpoint. The only required secret (an API key) is appropriate for this purpose. Minor inconsistency: the registry metadata reports "Required env vars: none" while SKILL.md and the code require TRANSLATE_API_KEY (and allow other optional env vars); this is likely a metadata omission rather than malicious.
Instruction Scope
SKILL.md instructs the agent to configure the API key (setup.sh) and run scripts/translate.py on an input file. The runtime instructions and code only read the local .env and the input file(s), chunk text, call the configured API endpoint, and write the translated output. There are no instructions to read unrelated files or exfiltrate environment/config beyond sending the input to the configured remote API (which is expected for a translation skill). Note: a provided sample (test.txt) contains copyrighted text — not a security issue for the code, but something to be aware of when testing.
Install Mechanism
No install spec or external downloads are used. The skill is instruction + included scripts (setup.sh and translate.py). setup.sh writes a .env in the skill directory; no remote installers, no archived downloads, and no unusual filesystem locations are created.
Credentials
The code requires a single service credential (TRANSLATE_API_KEY) and optionally accepts TRANSLATE_BASE_URL, TRANSLATE_MODEL, etc. That is proportionate to translating via an external API. Important: translating a file necessarily transmits its contents to the configured remote service — if the data is sensitive, the user should only use trusted providers or an internal endpoint.
Persistence & Privilege
The skill does not request system-wide privileges, does not set always:true, and does not modify other skills' configs. It persists configuration only to its own .env file under the skill directory (normal behavior).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install smart-translate-txt
  3. After installation, invoke the skill by name or use /smart-translate-txt
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
No visible changes in this version (1.0.1); the skill content and configuration remain the same.
v1.0.0
init. name: translate-txt description: | Translate text files using OpenAI-compatible APIs (e.g. SiliconFlow, DeepSeek, OpenAI). Use when the user wants to: translate a txt file, translate text to Chinese or other languages, batch translate documents, or convert foreign language txt files to Chinese. Triggers: 翻译txt文件, 翻译文本, translate txt, translate file, 文件翻译, txt翻译.
Metadata
Slug smart-translate-txt
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Translate TXT?

Translate text files using OpenAI-compatible APIs (e.g. SiliconFlow, DeepSeek, OpenAI). Use when the user wants to: translate a txt file, translate text to C... It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.

How do I install Translate TXT?

Run "/install smart-translate-txt" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Translate TXT free?

Yes, Translate TXT is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Translate TXT support?

Translate TXT is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Translate TXT?

It is built and maintained by litousteven (@litousteven); the current version is v1.0.1.

💬 Comments