# deepl

> Übersetzt Texte, Dokumente und XLIFF-Dateien via DeepL API. Verwende für Übersetzungen mit /deepl translate, /deepl file oder /deepl xliff.

- Author: Olivier Dobberkau
- Repository: dkd-dobberkau/deepl-claude-skill
- Version: 20260126125031
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/dkd-dobberkau/deepl-claude-skill
- Web: https://mule.run/skillshub/@@dkd-dobberkau/deepl-claude-skill~deepl:20260126125031

---

# DeepL Claude Code Skill

Translates texts, documents, and XLIFF files via the DeepL API directly in Claude Code.

## Installation

1. **Link the skill directory:**

```bash
ln -s /path/to/deepl-claude-skill ~/.claude/skills/deepl
```

2. **Configure API key:**

```bash
# In ~/.zshrc or ~/.bashrc
export DEEPL_API_KEY="your-api-key-here"

# Optional: Default target language
export DEEPL_TARGET_LANG="DE"
```

API key available at: https://www.deepl.com/pro-api

## Usage

### Translate text

```
/deepl translate "Hello, how are you?"
/deepl translate "Guten Morgen" --to EN
```

### Translate document

```
/deepl file README.txt --to EN
/deepl file document.docx --to FR
```

Supported formats: `.docx`, `.pptx`, `.pdf`, `.html`, `.txt`

### Translate XLIFF

```
/deepl xliff locallang.xlf --to DE
/deepl xliff locallang.xlf --force      # Retranslate everything
/deepl xliff locallang.xlf --dry-run    # Preview only
```

## Options

| Option | Description |
|--------|-------------|
| `--to <LANG>` | Target language (e.g. EN, DE, FR) |
| `--from <LANG>` | Source language (otherwise auto-detect) |
| `--force` | XLIFF: Retranslate everything |
| `--dry-run` | XLIFF: Preview only |
| `--output <path>` | Output file |

## Language codes

DE, EN, EN-GB, EN-US, FR, ES, IT, NL, PL, PT, PT-BR, RU, JA, ZH, ...

Full list: https://developers.deepl.com/docs/resources/supported-languages

## Troubleshooting

**"DEEPL_API_KEY not set"**
→ Set environment variable (see Installation)

**"API key invalid"**
→ Check key at https://www.deepl.com/pro-account

**"Quota exceeded"**
→ Upgrade your DeepL account or wait for reset

## License

MIT

## Trademark Notice

[DeepL](https://www.deepl.com) is a registered trademark of DeepL SE.

[Claude](https://claude.ai) and [Claude Code](https://claude.ai/claude-code) are trademarks of Anthropic PBC.

This project is not affiliated with or authorized by DeepL SE or Anthropic PBC.