equalang
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/equalang--equalang-skill)HTML
<a href="/listings/equalang--equalang-skill"><img src="/api/listings/equalang--equalang-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Needs `python3` 3.8 or later, and nothing else: the script uses only the standard library.
The shortest way - paste this to your agent:
> Install the Equalang skill by following the instructions at https://equalang.com/install/skill-install.md
<details open> <summary><b>Claude Code</b> (plugin)</summary>
/plugin marketplace add equalang/equalang-skill /plugin install equalang@equalang
</details>
<details> <summary><b>Claude Code</b> (manual)</summary>
git clone https://github.com/equalang/equalang-skill ~/.claude/skills/equalang
Project-scoped instead? Clone into `.claude/skills/equalang` in the repository. </details>
<details> <summary><b>OpenAI Codex</b></summary>
git clone https://github.com/equalang/equalang-skill ~/.agents/skills/equalang
Codex also reads `.agents/skills/` inside a repository, to scope it to one project. </details>
<details> <summary><b>CodeBuddy / WorkBuddy</b></summary>
git clone https://github.com/equalang/equalang-skill ~/.codebuddy/skills/equalang
Project-scoped: clone into `.codebuddy/skills/equalang` at the project root. </details>
<details> <summary><b>Cursor, Gemini CLI, OpenCode, Copilot, Goose, Amp, Kiro and others</b></summary>
This is a plain [Agent Skill](https://agentskills.io): a folder with a `SKILL.md` in it. Every client that implements the standard loads the same folder - only the directory it scans differs, and each documents its own. Clone the repository into that directory and the skill is installed.
git clone https://github.com/equalang/equalang-skill
</details>
Prefer an MCP server? [equalang-mcp](https://github.com/equalang/equalang-mcp) offers the same operations as tools, and works in Claude Desktop, Cursor, Windsurf, Cline and OpenCode as well.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 7 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "equalang",
- "owner": { "name": "Equalang", "email": "support@equalang.com" },
- "plugins": [
- { "name": "equalang", "description": "Translate whole files with their layout kept, and transcribe recordings.", "version": "0.3.1", "source": "./" }
- ]
- }
README.md · README · 160 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # equalang-skill
- [](LICENSE)
- [](https://agentskills.io)
- [](https://python.org)
- **English** · [简体中文](readme/README.zh-CN.md) · [日本語](readme/README.ja.md) · [한국어](readme/README.ko.md) · [Español](readme/README.es.md) · [Français](readme/README.fr.md) · [Deutsch](readme/README.de.md) · [Português](readme/README.pt.md) · [Italiano](readme/README.it.md) · [Русский](readme/README.ru.md) · [Polski](readme/README.pl.md) · [Türkçe](readme/README.tr.md) · [Tiếng Việt](readme/README.vi.md) · [Bahasa Indonesia](readme/README.id.md) · [ไทย](readme/README.th.md) · [हिन्दी](readme/README.hi.md) · [العربية](readme/README.ar.md)
- [Website](https://equalang.com) · [Pricing](https://equalang.com/pricing) · [Developer docs](https://equalang.com/developers) · [API keys](https://equalang.com/api-keys)
- > **Keywords:** document translation, pdf translator, translate pdf keep layout, docx translation, pptx translation, excel translation, epub translation, subtitle translation, srt translator, image translation, video translation, audio transcription, speech to text, ai translator, agent skill, claude code skill, codex skill, translation api
- **Translate the file, keep the layout.** An [Agent Skill](https://agentskills.io) for [Equalang](https://equalang.com) - an AI translator that works on whole files: a PDF comes back as a PDF, a deck as a deck, with tables, images and formulas where they were. It also translates subtitles and pictures, turns audio and video into translated subtitles or a transcript, and translates short texts in bulk. Works in Claude Code, Codex, Cursor, CodeBuddy and every other agent that loads Agent Skills.
- ## Try asking
- - "Translate ~/Documents/contract.pdf into Chinese, keeping the layout."
- - "Translate pitch-deck.pptx into Japanese and German."
- - "Translate https://example.com/whitepaper.pdf into Spanish and save it in ~/Downloads."
- - "How much would it cost to translate thesis.docx into French?"
- - "Make Korean subtitles for interview.mp4, with the original line above each one."
- - "Transcribe standup.m4a with timestamps."
- - "Make an English version of menu.jpg."
- - "Translate novel.epub into English."
- ## Features
- - **Documents** - PDF, DOCX, PPTX, XLSX, EPUB, HTML and TXT come back in the same format, still editable, with tables, images, formulas and page layout in place
- - **Subtitles and pictures** - SRT and VTT keep their timing, optionally with the source line above the translation; JPG, PNG, WebP and BMP come back with the text in the picture translated
- - **Audio and video** - MP3, M4A, WAV, FLAC, OGG, AAC, Opus, MP4, MOV, WebM and MKV become translated subtitles, or a transcript in the language spoken (SRT, VTT, TXT, JSON)
- - **Text in bulk** - short texts translated in order, or one long text (up to 100,000 characters) that Equalang cuts at sentences itself
- - **Languages** — 152 for text and documents; the live language list reflects the current deployment. Omit the source language to detect it automatically.
- - **PDF formulas** — Formula optimization is optional and off by default. Enable it only for PDF files. `--optimize-math-formula` Adds 10 credits per original PDF page at the default rate. Use the same option when estimating the cost. `estimate --optimize-math-formula`
- ## Get a key
- Sign up at <https://equalang.com> and create a key at <https://equalang.com/api-keys>. New accounts start with free credits, enough to put a document through.
- Save it once in `~/.config/equalang/.env` and it stays in effect: in every agent - Claude Code, Codex, WorkBuddy, Cursor or any other - in every new session, and through reinstalls and updates, with nothing to export. The Equalang MCP server reads the same file.
- ```bash
- # Replace el_your_key with your key
- mkdir -p ~/.config/equalang && echo 'EQUALANG_API_KEY=el_your_key' > ~/.config/equalang/.env && chmod 600 ~/.config/equalang/.env
- ```
- `EQUALANG_API_KEY` in the environment is checked first; the file is read only when the environment has none. That is how one project can use a different key.
- ## Install
- Needs `python3` 3.8 or later, and nothing else: the script uses only the standard library.
- The shortest way - paste this to your agent:
- > Install the Equalang skill by following the instructions at https://equalang.com/install/skill-install.md
- <details open>
- <summary><b>Claude Code</b> (plugin)</summary>
- ```
- /plugin marketplace add equalang/equalang-skill
- /plugin install equalang@equalang
- ```
- </details>
- <details>
- <summary><b>Claude Code</b> (manual)</summary>
- ```bash
- git clone https://github.com/equalang/equalang-skill ~/.claude/skills/equalang
- ```
- Project-scoped instead? Clone into `.claude/skills/equalang` in the repository.
- </details>
- <details>
- <summary><b>OpenAI Codex</b></summary>
- ```bash
- git clone https://github.com/equalang/equalang-skill ~/.agents/skills/equalang
- ```
- Codex also reads `.agents/skills/` inside a repository, to scope it to one project.
- </details>
- <details>
- <summary><b>DeepSeek Harness</b></summary>
- DeepSeek Harness loads skills from `~/.agents/skills/`, the directory Codex uses, so one clone serves both:
- ```bash
- git clone https://github.com/equalang/equalang-skill ~/.agents/skills/equalang
- ```
- The skill runs `python3`. Where there is none on the PATH (often on Windows; the desktop app's own Python is not on it), install the [Equalang plugin for DeepSeek Harness](https://github.com/equalang/equalang-dsh-plugin) instead, which needs no Python.
- </details>
- <details>
- <summary><b>CodeBuddy / WorkBuddy</b></summary>
- ```bash
- git clone https://github.com/equalang/equalang-skill ~/.codebuddy/skills/equalang
- ```
- Project-scoped: clone into `.codebuddy/skills/equalang` at the project root.
- </details>
- <details>
- <summary><b>Cursor, Gemini CLI, OpenCode, Copilot, Goose, Amp, Kiro and others</b></summary>
- This is a plain [Agent Skill](https://agentskills.io): a folder with a `SKILL.md` in it. Every client that implements the standard loads the same folder - only the directory it scans differs, and each documents its own. Clone the repository into that directory and the skill is installed.
- ```bash
- git clone https://github.com/equalang/equalang-skill
- ```
- </details>
- Prefer an MCP server? [equalang-mcp](https://github.com/equalang/equalang-mcp) offers the same operations as tools, and works in Claude Desktop, Cursor, Windsurf, Cline and OpenCode as well.
- ## Commands
- ```bash
- # What would it cost? Free, and nothing starts translating
- python3 scripts/equalang.py estimate report.pdf
- # Translate a file; the result lands beside the source
- python3 scripts/equalang.py translate report.pdf --to zh-CN
- # From a public URL (Equalang fetches it itself), into a folder
- python3 scripts/equalang.py translate https://example.com/deck.pptx --to ja -o ./out
- # What a recording says, as timed text
- python3 scripts/equalang.py transcribe interview.mp3 --format srt --format txt
- # Short texts, in order
- python3 scripts/equalang.py text "Save changes" "Delete project" --to de
- # One long text, cut at sentences by Equalang
- python3 scripts/equalang.py text --file notes.md --to ja -o notes.ja.md
- # A job left running, the balance, and the language codes
- python3 scripts/equalang.py status <job_id>
- python3 scripts/equalang.py cancel <job_id>
- python3 scripts/equalang.py balance
- python3 scripts/equalang.py languages chinese
- ```
- Every command prints JSON: where the files were written and what they cost, or what went wrong. Add `--help` to any command to see its flags. The agent itself reads [SKILL.md](SKILL.md).
- Language codes look like `en`, `zh-CN`, `ja`. Run `languages` to list them, or `languages chinese` to search. A job takes minutes - the command waits for it, and `status <job_id>` picks it up again if you interrupt it.
- ## Links
- - [Equalang](https://equalang.com) · [Pricing](https://equalang.com/pricing) · [Developer docs](https://equalang.com/developers)
- - API for agents: [llms.txt](https://equalang.com/llms.txt) · [llms-full.txt](https://equalang.com/llms-full.txt) · [OpenAPI](https://equalang.com/api/backend/v1/openapi.json)
- - [equalang-mcp](https://github.com/equalang/equalang-mcp) - the same operations as an MCP server
- - Questions: <support@equalang.com>
- ## License
- [Apache-2.0](LICENSE) © Equalang
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.