deepl

Translates text, documents, and XLIFF files via the DeepL API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/chhpt/skills --skill deepl-chhpt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deepl
Source: https://github.com/chhpt/skills/tree/main/skills/deepl
Command: npx skills add https://github.com/chhpt/skills --skill deepl-chhpt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Translating text snippets, office documents, and localization files manually is slow and error-prone, especially when maintaining multilingual projects. This Skill automates translation through the DeepL API directly from the command line. ## Core Features & Use Cases - Text Translation: Translate free text with automatic source language detection and configurable target languages via /deepl translate. - Document Translation: Upload and translate DOCX, PPTX, PDF, HTML, and TXT files while preserving formatting via /deepl file. - XLIFF Localization: Fill in missing translations in XLIFF files (TYPO3, Symfony) with batch translation, dry-run preview, and force re-translation via /deepl xliff. - Use Case: A developer maintaining a TYPO3 extension runs /deepl xliff locallang.xlf --to DE to automatically fill all empty target elements with German translations. ## Quick Start Set your DEEPL_API_KEY environment variable and ask the assistant to translate a text, document, or XLIFF file into your desired target language.

Frequently Asked Questions about deepl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate text with the DeepL API from the command line?

Use the /deepl translate command with your text in quotes, optionally adding --to and --from flags for target and source languages. The skill sends a POST request to the DeepL API with your DEEPL_API_KEY and returns the translated text with the detected source language.

How to translate XLIFF files for TYPO3 or Symfony automatically?

Run /deepl xliff with the file path to fill empty target elements via DeepL batch translation. Use --dry-run to preview translations, --force to re-translate everything, and --output to write to a new file.

What file formats does DeepL document translation support?

DeepL document translation supports DOCX, PPTX, PDF (Pro accounts only), HTML, and TXT files. Markdown files are treated as plain text. The document is uploaded, polled for completion, and downloaded with formatting preserved.

Does the DeepL free API key work differently than the pro key?

Yes, free API keys end in ':fx' and must use the api-free.deepl.com endpoint instead of api.deepl.com. The skill detects this automatically from the key format and routes requests to the correct endpoint.

Why does my DeepL translation fail with error 456 or 429?

Error 456 means your DeepL character quota is exceeded and you need to check your account usage. Error 429 indicates rate limiting, which the skill handles by waiting and retrying up to three times with exponential backoff.