Skip to content
Back to search

equalang

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/equalang--equalang-skill/badge.svg)](/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

i

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.

  1. {
  2. "name": "equalang",
  3. "owner": { "name": "Equalang", "email": "support@equalang.com" },
  4. "plugins": [
  5. { "name": "equalang", "description": "Translate whole files with their layout kept, and transcribe recordings.", "version": "0.3.1", "source": "./" }
  6. ]
  7. }
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.

  1. # equalang-skill
  2. [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
  3. [![Agent Skill](https://img.shields.io/badge/Agent_Skills-open_standard-6E56CF.svg)](https://agentskills.io)
  4. [![Python](https://img.shields.io/badge/python-%3E%3D3.8-3776AB.svg)](https://python.org)
  5. **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)
  6. [Website](https://equalang.com) · [Pricing](https://equalang.com/pricing) · [Developer docs](https://equalang.com/developers) · [API keys](https://equalang.com/api-keys)
  7. > **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
  8. **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.
  9. ## Try asking
  10. - "Translate ~/Documents/contract.pdf into Chinese, keeping the layout."
  11. - "Translate pitch-deck.pptx into Japanese and German."
  12. - "Translate https://example.com/whitepaper.pdf into Spanish and save it in ~/Downloads."
  13. - "How much would it cost to translate thesis.docx into French?"
  14. - "Make Korean subtitles for interview.mp4, with the original line above each one."
  15. - "Transcribe standup.m4a with timestamps."
  16. - "Make an English version of menu.jpg."
  17. - "Translate novel.epub into English."
  18. ## Features
  19. - **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
  20. - **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
  21. - **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)
  22. - **Text in bulk** - short texts translated in order, or one long text (up to 100,000 characters) that Equalang cuts at sentences itself
  23. - **Languages** — 152 for text and documents; the live language list reflects the current deployment. Omit the source language to detect it automatically.
  24. - **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`
  25. ## Get a key
  26. 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.
  27. 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.
  28. ```bash
  29. # Replace el_your_key with your key
  30. mkdir -p ~/.config/equalang && echo 'EQUALANG_API_KEY=el_your_key' > ~/.config/equalang/.env && chmod 600 ~/.config/equalang/.env
  31. ```
  32. `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.
  33. ## Install
  34. Needs `python3` 3.8 or later, and nothing else: the script uses only the standard library.
  35. The shortest way - paste this to your agent:
  36. > Install the Equalang skill by following the instructions at https://equalang.com/install/skill-install.md
  37. <details open>
  38. <summary><b>Claude Code</b> (plugin)</summary>
  39. ```
  40. /plugin marketplace add equalang/equalang-skill
  41. /plugin install equalang@equalang
  42. ```
  43. </details>
  44. <details>
  45. <summary><b>Claude Code</b> (manual)</summary>
  46. ```bash
  47. git clone https://github.com/equalang/equalang-skill ~/.claude/skills/equalang
  48. ```
  49. Project-scoped instead? Clone into `.claude/skills/equalang` in the repository.
  50. </details>
  51. <details>
  52. <summary><b>OpenAI Codex</b></summary>
  53. ```bash
  54. git clone https://github.com/equalang/equalang-skill ~/.agents/skills/equalang
  55. ```
  56. Codex also reads `.agents/skills/` inside a repository, to scope it to one project.
  57. </details>
  58. <details>
  59. <summary><b>DeepSeek Harness</b></summary>
  60. DeepSeek Harness loads skills from `~/.agents/skills/`, the directory Codex uses, so one clone serves both:
  61. ```bash
  62. git clone https://github.com/equalang/equalang-skill ~/.agents/skills/equalang
  63. ```
  64. 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.
  65. </details>
  66. <details>
  67. <summary><b>CodeBuddy / WorkBuddy</b></summary>
  68. ```bash
  69. git clone https://github.com/equalang/equalang-skill ~/.codebuddy/skills/equalang
  70. ```
  71. Project-scoped: clone into `.codebuddy/skills/equalang` at the project root.
  72. </details>
  73. <details>
  74. <summary><b>Cursor, Gemini CLI, OpenCode, Copilot, Goose, Amp, Kiro and others</b></summary>
  75. 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.
  76. ```bash
  77. git clone https://github.com/equalang/equalang-skill
  78. ```
  79. </details>
  80. 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.
  81. ## Commands
  82. ```bash
  83. # What would it cost? Free, and nothing starts translating
  84. python3 scripts/equalang.py estimate report.pdf
  85. # Translate a file; the result lands beside the source
  86. python3 scripts/equalang.py translate report.pdf --to zh-CN
  87. # From a public URL (Equalang fetches it itself), into a folder
  88. python3 scripts/equalang.py translate https://example.com/deck.pptx --to ja -o ./out
  89. # What a recording says, as timed text
  90. python3 scripts/equalang.py transcribe interview.mp3 --format srt --format txt
  91. # Short texts, in order
  92. python3 scripts/equalang.py text "Save changes" "Delete project" --to de
  93. # One long text, cut at sentences by Equalang
  94. python3 scripts/equalang.py text --file notes.md --to ja -o notes.ja.md
  95. # A job left running, the balance, and the language codes
  96. python3 scripts/equalang.py status <job_id>
  97. python3 scripts/equalang.py cancel <job_id>
  98. python3 scripts/equalang.py balance
  99. python3 scripts/equalang.py languages chinese
  100. ```
  101. 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).
  102. 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.
  103. ## Links
  104. - [Equalang](https://equalang.com) · [Pricing](https://equalang.com/pricing) · [Developer docs](https://equalang.com/developers)
  105. - 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)
  106. - [equalang-mcp](https://github.com/equalang/equalang-mcp) - the same operations as an MCP server
  107. - Questions: <support@equalang.com>
  108. ## License
  109. [Apache-2.0](LICENSE) © Equalang

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.