DeckLingo for PPTX
Use this skill for translation tasks on existing .pptx decks when the output must stay editable and visually close to the source.
It is designed to stay tool-agnostic so the same skill package can be used in Codex-style environments, OpenClaw-style environments, and other agent runtimes that can execute local scripts and read SKILL.md.
Install on ClawHub:
clawhub install decklingo-pptx
Best search phrases for this skill:
- translate powerpoint to chinese
- translate pptx to english
- localize presentation deck
- translate speaker notes in powerpoint
- glossary aware ppt translation
What This Skill Covers
- User-selectable translation target language
- User-selectable source language, including English to Chinese workflows
- User-selectable working/output language for the skill itself
- Translation of editable text in slides, speaker notes, layouts, and slide masters
- Terminology control through glossary files
- Verification that requested source-language text no longer remains in editable text objects
- Scan-only and dry-run workflows before writing output
Real Example Prompts
- Translate this PowerPoint from English to Simplified Chinese and keep all speaker notes editable.
- Convert this Chinese lecture deck into fluent English, but keep file names, URLs, and numbers unchanged.
- Localize this PPTX into Japanese using my glossary and tell me if any source-language text remains in layouts or masters.
When To Use It
- Use it when the source deck must remain editable after translation.
- Use it when you need slides, notes, layouts, or masters translated selectively.
- Use it when repeated terminology should stay stable with a glossary.
When Not To Use It
- Do not use it when the deck text is baked into screenshots or flattened images.
- Do not use it when the user wants a full visual redesign rather than translation.
- Do not use it as a generic document translator for PDFs, DOCX, or websites.
Defaults
source language: auto
target language: infer from the request; if not clear, use the most obvious requested language
english -> chinese is a first-class workflow, not a fallback case
working/output language: use the user's current language by default
translation scope: slides on, notes on, layouts off, masters off unless the user requests a full inherited-text cleanup
Keep these separate:
- Target language: the language written into the deck
- Working language: the language used in logs, summaries, and user-facing notes
Workflow
- Determine:
- input PPTX path
- output PPTX path
- source language
- target language
- working language
- whether notes/layouts/masters should be translated
- Run the scan script first when the deck is unfamiliar or large.
- Prefer XML-level translation so the deck remains editable and layout drift stays low.
- Translate paragraph-sized text instead of isolated run fragments whenever possible.
- Preserve numbers, dates, URLs, filenames, code snippets, and product names unless translation is clearly needed.
- Re-scan the result and report:
- output file path
- paragraph counts
- glossary usage
- any remaining source-language text in editable objects
Scripts
Use the bundled scripts:
python .trae/skills/decklingo-pptx/scripts/scan_pptx_text.py \
--input "path/to/input.pptx" \
--source-lang zh \
--include-notes \
--include-layouts \
--include-masters
python .trae/skills/decklingo-pptx/scripts/translate_pptx_text.py \
--input "path/to/input.pptx" \
--output "path/to/output.pptx" \
--source-lang auto \
--target-lang en \
--ui-lang zh \
--include-notes \
--glossary-file ".trae/skills/decklingo-pptx/assets/glossary.sample.json" \
--report-file "translation-report.json"
Common Options
--source-lang: source language code, default auto
--target-lang: target language code such as en, ja, fr, de, zh-CN
--ui-lang: language for logs and summaries, usually zh or en
--include-notes: include speaker notes
--include-layouts: include slide layouts
--include-masters: include slide masters
--glossary-file: JSON glossary mapping source terms to preferred translations
--skip-pattern-file: regex patterns to protect text like URLs, file names, code identifiers, or custom labels
--report-file: write a machine-readable JSON report
--dry-run: inspect and translate in memory without writing a new deck
--backup-suffix: backup suffix used when translating in place, default .bak
When To Load References
Notes
- Reuse or patch a better project-local translator if the repository already contains one.
- If network translation is required, verify connectivity first.
- If the user asks for design cleanup after translation, pair this skill with a slide-layout skill rather than rebuilding the deck here.
- Treat third-party skills and scripts as untrusted code and review them before enabling.
- Minimal runtime requirements: Python 3.10+,
lxml, deep-translator, ZIP read/write access.
- Changelog: see references/changelog.md.
1---2name: decklingo-pptx-23description: "Translate editable PowerPoint decks into Chinese, English, Japanese, and other target languages while preserving layout, glossary consistency, and editability. Use for PPTX localization, English-to-Chinese slides, Chinese-to-English decks, speaker note translation, and glossary-aware presentation workflows."4license: "MIT"5metadata:6 source: https://skillmd.com/skills/bishal-pdmsft/decklingo-pptx-27 short-description: Translate editable PPTX decks with glossary-aware verification.8 openclaw:9 homepage: https://github.com/Neabigmo/DeckLingo-for-PPTX10 emoji: 🌐11 requires:12 anyBins:13 - python14 - python315 bins: []16 env: []17 config: []18 install:19 - id: download-source20 kind: download21 label: Open GitHub repository22 url: https://github.com/Neabigmo/DeckLingo-for-PPTX23 os:24 - darwin25 - linux26 - win3227---2829# DeckLingo for PPTX3031Use this skill for translation tasks on existing `.pptx` decks when the output must stay editable and visually close to the source.3233It is designed to stay tool-agnostic so the same skill package can be used in Codex-style environments, OpenClaw-style environments, and other agent runtimes that can execute local scripts and read `SKILL.md`.3435Install on ClawHub:3637```bash38clawhub install decklingo-pptx39```4041Best search phrases for this skill:4243- translate powerpoint to chinese44- translate pptx to english45- localize presentation deck46- translate speaker notes in powerpoint47- glossary aware ppt translation4849## What This Skill Covers5051- User-selectable translation target language52- User-selectable source language, including English to Chinese workflows53- User-selectable working/output language for the skill itself54- Translation of editable text in slides, speaker notes, layouts, and slide masters55- Terminology control through glossary files56- Verification that requested source-language text no longer remains in editable text objects57- Scan-only and dry-run workflows before writing output5859## Real Example Prompts6061- Translate this PowerPoint from English to Simplified Chinese and keep all speaker notes editable.62- Convert this Chinese lecture deck into fluent English, but keep file names, URLs, and numbers unchanged.63- Localize this PPTX into Japanese using my glossary and tell me if any source-language text remains in layouts or masters.6465## When To Use It6667- Use it when the source deck must remain editable after translation.68- Use it when you need slides, notes, layouts, or masters translated selectively.69- Use it when repeated terminology should stay stable with a glossary.7071## When Not To Use It7273- Do not use it when the deck text is baked into screenshots or flattened images.74- Do not use it when the user wants a full visual redesign rather than translation.75- Do not use it as a generic document translator for PDFs, DOCX, or websites.7677## Defaults7879- `source language`: `auto`80- `target language`: infer from the request; if not clear, use the most obvious requested language81- `english -> chinese` is a first-class workflow, not a fallback case82- `working/output language`: use the user's current language by default83- `translation scope`: slides on, notes on, layouts off, masters off unless the user requests a full inherited-text cleanup8485Keep these separate:8687- **Target language**: the language written into the deck88- **Working language**: the language used in logs, summaries, and user-facing notes8990## Workflow91921. Determine:93 - input PPTX path94 - output PPTX path95 - source language96 - target language97 - working language98 - whether notes/layouts/masters should be translated992. Run the scan script first when the deck is unfamiliar or large.1003. Prefer XML-level translation so the deck remains editable and layout drift stays low.1014. Translate paragraph-sized text instead of isolated run fragments whenever possible.1025. Preserve numbers, dates, URLs, filenames, code snippets, and product names unless translation is clearly needed.1036. Re-scan the result and report:104 - output file path105 - paragraph counts106 - glossary usage107 - any remaining source-language text in editable objects108109## Scripts110111Use the bundled scripts:112113```bash114python .trae/skills/decklingo-pptx/scripts/scan_pptx_text.py \115 --input "path/to/input.pptx" \116 --source-lang zh \117 --include-notes \118 --include-layouts \119 --include-masters120```121122```bash123python .trae/skills/decklingo-pptx/scripts/translate_pptx_text.py \124 --input "path/to/input.pptx" \125 --output "path/to/output.pptx" \126 --source-lang auto \127 --target-lang en \128 --ui-lang zh \129 --include-notes \130 --glossary-file ".trae/skills/decklingo-pptx/assets/glossary.sample.json" \131 --report-file "translation-report.json"132```133134## Common Options135136- `--source-lang`: source language code, default `auto`137- `--target-lang`: target language code such as `en`, `ja`, `fr`, `de`, `zh-CN`138- `--ui-lang`: language for logs and summaries, usually `zh` or `en`139- `--include-notes`: include speaker notes140- `--include-layouts`: include slide layouts141- `--include-masters`: include slide masters142- `--glossary-file`: JSON glossary mapping source terms to preferred translations143- `--skip-pattern-file`: regex patterns to protect text like URLs, file names, code identifiers, or custom labels144- `--report-file`: write a machine-readable JSON report145- `--dry-run`: inspect and translate in memory without writing a new deck146- `--backup-suffix`: backup suffix used when translating in place, default `.bak`147148## When To Load References149150- Read [references/glossary-schema.md](./references/glossary-schema.md) when you need to create or edit a glossary file.151- Read [references/translation-modes.md](./references/translation-modes.md) when choosing whether to include notes, layouts, or masters.152- Read [references/platform-compatibility.md](./references/platform-compatibility.md) when packaging the skill for Codex, OpenClaw, or another agent runtime.153154## Notes155156- Reuse or patch a better project-local translator if the repository already contains one.157- If network translation is required, verify connectivity first.158- If the user asks for design cleanup after translation, pair this skill with a slide-layout skill rather than rebuilding the deck here.159- Treat third-party skills and scripts as untrusted code and review them before enabling.160- Minimal runtime requirements: Python 3.10+, `lxml`, `deep-translator`, ZIP read/write access.161- Changelog: see [references/changelog.md](./references/changelog.md).