How do I install the Surgepix Ppt Translate skill?

Run npx skillmds@latest add surgepix/surgepix-ppt-translate in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Surgepix Ppt Translate safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Surgepix Ppt Translate?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Surgepix Ppt Translate free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Surgepix Ppt Translate?

SurgePix (@surgepix) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Surgepix Ppt Translate by surgepix — Agent Skill

Name: Surgepix Ppt Translate
Author: SurgePix

Surgepix Ppt Translate

Translate a PowerPoint file (PPT/PPTX only) to a target language via SurgePix API and return a download URL. Use when the user says "translate ppt", "翻译PPT", "PPT翻译", "pptx translate", or wants a deck localized. Language: always pass --language as the target (ja / Japanese / 日语 / en / zh, etc.). Do NOT use for pdf/docx — unsupported. Output rule: show ONLY the download URL; NEVER fabricate links.

SurgePix Updated Sep 21, 2026

File contents

SurgePix PPT / PPTX Translate

Translate a .ppt / .pptx deck to a target language and return the translated file download URL. PDF and DOCX are not supported.

Language consistency

--language is the target language for the translated deck, not the agent's reply language. Free-text values are accepted (e.g. ja, Japanese, 日语).

Priority	Rule
1	User names a target ("翻译成日文", "to English") → pass that as `--language`
2	Ambiguous → ask which target language
3	Never silently pick an unrelated default

Reply to the user in the same language they used in their request.

When to use

User says "翻译PPT", "PPT翻译", "translate ppt", "translate pptx", "把幻灯片翻成英文"
User has a local .ppt/.pptx or a URL to one

Prerequisites

Node.js >= 18
SURGEPIX_API_KEY and SURGEPIX_BASE_URL configured (see Step 0)

What the Skill Does

Action	Description
Translate PPT	Upload local file if needed, then call translate API
Reject non-PPT	Fail early on pdf/docx (and other extensions)
Async / sync	Default poll for result; `--nowait true` returns `taskId`
Download	Return `download` URL of the translated pptx

Multi-page decks can take a long time — prefer --nowait true and surgepix-query-task for large files.

Setup

Requirement: Set SURGEPIX_API_KEY and SURGEPIX_BASE_URL via surgepix-setup. Do not ask the user to paste the API key into chat.

Script: <skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs.

Usage Examples

Local file → Japanese (sync):

node "<skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs" \
  ./deck.pptx \
  --language Japanese

URL + async (recommended for long decks):

node "<skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs" \
  --path "https://example.com/files/deck.pptx" \
  --language zh \
  --nowait true
# Then query with surgepix-query-task

Workflow

Step 0: Check environment

node "<skills-dir>/surgepix-setup/scripts/check_env.mjs"

Step 1: Collect inputs

Source: local .ppt/.pptx or HTTPS URL
Target language: required (--language)
If user offers pdf/docx → refuse and ask for ppt/pptx

Step 2: Run

node "<skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs" \
  "<path-or-url>" \
  --language "<target>" \
  [--session-id <id>] \
  [--nowait <true|false>]

Step 3: Present result

Show only API download / taskId
Never invent URLs; never expose tokens

Parameters

Parameter	Required	Default	Description
`<path-or-url>` / `--path`	Yes	—	Local ppt/pptx or URL
`--language`	Yes	—	Target language free text
`--session-id`	No	auto	Session for iteration
`--nowait`	No	`false`	`true` = async `taskId`

Notes

Only .ppt / .pptx. Not pdf/docx.
Local files are uploaded by the script — never pass raw local paths to the API.
Missing env → surgepix-setup.

---name: surgepix-ppt-translatedescription: Translate a PowerPoint file (PPT/PPTX only) to a target language via SurgePix API and return a download URL. Use when the user says "translate ppt", "翻译PPT", "PPT翻译", "pptx translate", or wants a deck localized. Language: always pass --language as the target (ja / Japanese / 日语 / en / zh, etc.). Do NOT use for pdf/docx — unsupported. Output rule: show ONLY the download URL; NEVER fabricate links.---# SurgePix PPT / PPTX TranslateTranslate a **`.ppt` / `.pptx`** deck to a target language and return the translated file download URL. **PDF and DOCX are not supported.**## Language consistency`--language` is the **target language for the translated deck**, not the agent's reply language. Free-text values are accepted (e.g. `ja`, `Japanese`, `日语`).| Priority | Rule ||----------|------|| 1 | User names a target ("翻译成日文", "to English") → pass that as `--language` || 2 | Ambiguous → ask which target language || 3 | Never silently pick an unrelated default |- Reply to the user in the same language they used in their request.## When to use- User says "翻译PPT", "PPT翻译", "translate ppt", "translate pptx", "把幻灯片翻成英文"- User has a local `.ppt`/`.pptx` or a URL to one## Prerequisites- Node.js >= 18- `SURGEPIX_API_KEY` and `SURGEPIX_BASE_URL` configured (see Step 0)---## What the Skill Does| Action | Description ||--------|-------------|| Translate PPT | Upload local file if needed, then call translate API || Reject non-PPT | Fail early on pdf/docx (and other extensions) || Async / sync | Default poll for result; `--nowait true` returns `taskId` || Download | Return `download` URL of the translated pptx |> Multi-page decks can take a long time — prefer `--nowait true` and **surgepix-query-task** for large files.---## Setup**Requirement:** Set `SURGEPIX_API_KEY` and `SURGEPIX_BASE_URL` via **surgepix-setup**. Do **not** ask the user to paste the API key into chat.Script: `<skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs`.---## Usage Examples**Local file → Japanese (sync):**```bashnode "<skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs" \ ./deck.pptx \ --language Japanese```**URL + async (recommended for long decks):**```bashnode "<skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs" \ --path "https://example.com/files/deck.pptx" \ --language zh \ --nowait true# Then query with surgepix-query-task```---## Workflow### Step 0: Check environment```bashnode "<skills-dir>/surgepix-setup/scripts/check_env.mjs"```### Step 1: Collect inputs- Source: local `.ppt`/`.pptx` or HTTPS URL- Target language: required (`--language`)- If user offers pdf/docx → refuse and ask for ppt/pptx### Step 2: Run```bashnode "<skills-dir>/surgepix-ppt-translate/scripts/ppt_translate.mjs" \ "<path-or-url>" \ --language "<target>" \ [--session-id <id>] \ [--nowait <true|false>]```### Step 3: Present result- Show only API `download` / `taskId`- Never invent URLs; never expose tokens---## Parameters| Parameter | Required | Default | Description ||-----------|----------|---------|-------------|| `<path-or-url>` / `--path` | Yes | — | Local ppt/pptx or URL || `--language` | Yes | — | Target language free text || `--session-id` | No | auto | Session for iteration || `--nowait` | No | `false` | `true` = async `taskId` |---## Notes- **Only** `.ppt` / `.pptx`. Not pdf/docx.- Local files are uploaded by the script — never pass raw local paths to the API.- Missing env → **surgepix-setup**.

Frequently asked questions