PPT Write Skill#

Five capabilities: generate, template imitation, edit existing PPT, convert NotebookLM export to editable PPTX, and local file operations.

---

Prerequisites#

API Key Configuration (Required First)#

This skill requires a SKYWORK_API_KEY to be configured before use.

If you don't have an API key yet, please visit: https://skywork.ai

For detailed setup instructions, see: references/apikey-fetch.md

---

Privacy & Remote Calls (Read Before Use)#

• Remote upload & processing: Layers 1/2/4/5 upload local files and send the full, verbatim user query to the Skywork service. Avoid sensitive or confidential content unless you trust the remote service and its data handling policies.
• Polling behavior: The generation/edit workflows include periodic status polling (about every 5 seconds) while waiting for backend jobs. This is expected.

---

Routing — Identify the user's intent first#

User intentWhich pathGenerate a new PPT from a topic, set of requirements or reference filesLayer 1 — GenerateUse an existing .pptx as a layout/style template to create a new presentationLayer 2 — ImitateEdit an existing PPT: modify slides, add slides, change style, split/mergeLayer 4 — EditConvert a NotebookLM-exported .pptx or .pdf into an editable .pptxLayer 5 — Convert to editable PPTXDelete / reorder / extract / merge slides in a local file (no backend)Layer 3 — Local ops

---

Environment check (always run this first)#

This skill requires Python 3 (>=3.8). Run the following before any script to locate a valid Python binary and install dependencies.

bash

PYTHON_CMD=""
for cmd in python3 python python3.13 python3.12 python3.11 python3.10 python3.9 python3.8; do
  if command -v "$cmd" &>/dev/null && "$cmd" -c "import sys; exit(0 if sys.version_info >= (3,8) else 1)" 2>/dev/null; then
    PYTHON_CMD="$cmd"
    break
  fi
done

if [ -z "$PYTHON_CMD" ]; then
  echo "ERROR: Python 3.8+ not found."
  echo "Install on macOS: brew install python3  or visit https://www.python.org/downloads/"
  exit 1
fi

echo "Found Python: $PYTHON_CMD ($($PYTHON_CMD --version))"

$PYTHON_CMD -m pip install -q --break-system-packages python-pptx
echo "Dependencies ready."

After this check, replace python with the discovered $PYTHON_CMD (e.g. python3) in all subsequent commands.

---

Layer 1 — Generate PPT#

Steps#

1. REQUIRED FIRST STEP — Read workflow_generate.md NOW, before taking any other action. After reading, output exactly: ✅ workflow_generate.md loaded. — then proceed.

2. Environment check — run the check above to get $PYTHON_CMD.

3. Upload reference files (if the user provides local files as content source) — parse the file using tool in script/parse_file.py and pass the result to --files. See the --files note below.

4. Web search (required if no relevant content is already in the conversation) — call web_search tool in script to search the topic and distill results into a reference-file file of ≤ 2000 words.

5. Run the script:

   Important: set exec tool yieldMs to 600000 (10 minutes).

6. Deliver — provide the absolute .pptx path and the download URL.

---

Layer 2 — Imitate PPT (template-based generation)#

Steps#

1. REQUIRED FIRST STEP - Read workflow_imitate.md immidiately before any action you do!!!

2. Environment check — run the check above to get $PYTHON_CMD.

3. Locate the template — extract the absolute path of the local .pptx from the user's message; ask the user if it's unclear.

4. Upload the template — upload it and extract TEMPLATE_URL from the output.

5. Upload reference files (if the user provides additional local files as content source) — parse the file using tool in script/parse_file.py and pass the result to --files. See the --files

6. Web search (required if no relevant content is already in the conversation) — call web_search tool in script to search the new topic and distill results into a reference-file file of ≤ 2000 words.

7. Run the script:

   Important: set exec tool yieldMs to 600000 (10 minutes).

8. Deliver — provide the absolute .pptx path, the download URL, and the template filename used.

---

Layer 4 — Edit PPT (AI-powered modification)#

Use this layer when the user wants to modify an existing PPT using natural language. Requires an OSS/CDN URL of the PPTX (from a previous generation or upload).

Steps#

1. Detailed workflow - Read workflow_edit.md immediately before any action you do!!!

2. Environment check — run the check above to get $PYTHON_CMD.

3. Get PPTX URL — from the user's message or upload a local file first.

4. Run the script with --pptx-url: bash

   $PYTHON_CMD scripts/run_ppt_write.py "edit instruction" \
     --language Chinese \
     --pptx-url "https://cdn.example.com/file.pptx" \
     -o /absolute/path/output.pptx
   
   

   Important: set exec tool yieldMs to 600000 (10 minutes).

5. Deliver — provide download link, local path, and summary of changes.

---

Layer 5 — Convert NotebookLM Export to Editable PPTX#

Use this layer when the user provides a local .pptx or .pdf exported from NotebookLM and wants an editable .pptx.

Steps#

1. Detailed workflow - Read workflow_convert_editable.md immediately before any action you do!!!

2. Environment check — run the check above to get $PYTHON_CMD.

3. Locate the source file — extract the absolute path of the local .pptx or .pdf; ask the user if the path is unclear.

4. Upload the source file — upload it and extract SOURCE_URL from the output.

5. Run the script: bash

   $PYTHON_CMD scripts/run_editable_convert.py \
     --file-url "https://cdn.example.com/source.pptx" \
     --file-type "pptx" \
     -o /absolute/path/output_editable.pptx
   
   

   Important: set exec tool yieldMs to 600000 (10 minutes).

6. Deliver — provide download link, local path, and the original filename used as the source.

---

Layer 3 — PPT File operations#

bash

# Inspect slide count and titles
$PYTHON_CMD scripts/local_pptx_ops.py info --file my.pptx

# Delete slides (1-based index; supports ranges like 3,5,7-9; omit -o to overwrite in place)
$PYTHON_CMD scripts/local_pptx_ops.py delete --file my.pptx --slides 3,5,7-9 -o trimmed.pptx

# Reorder slides (must list every slide, no omissions)
$PYTHON_CMD scripts/local_pptx_ops.py reorder --file my.pptx --order 2,1,4,3,5

# Extract a subset of slides into a new file
$PYTHON_CMD scripts/local_pptx_ops.py extract --file my.pptx --slides 1-3 -o subset.pptx

# Merge multiple files
$PYTHON_CMD scripts/local_pptx_ops.py merge --files a.pptx b.pptx -o merged.pptx

Read workflow_local.md immidiately before any action you do!!!

---

Error Handling#

• Insufficient benefit: When calling scripts (generate, imitate, edit, or convert to editable), the script or log may show a message like Insufficient benefit. Please upgrade your account at {url}, meaning the user's benefit level does not meet the requirement for this skill.

How to reply when benefit is insufficient#

When you detect the above, reply in the user's current language — do not echo the English message. Use this pattern:

• Convey: "Sorry, PPT generation failed. This skill requires upgrading your Skywork membership to use." then a single call-to-action link.
• Format: One short sentence in the user's language + a link like [Upgrade now →](url) or the equivalent in their language .
• URL: Extract the upgrade URL from the log/script output (e.g. the at https://... part).

Note: Only suggest upgrading when the error is Insufficient benefit. For auth errors like NO_TOKEN / INVALID_TOKEN / 401 / “invalid API key”, keep the error code / raw message and guide users to update SKYWORK_API_KEY. Do not suggest upgrading membership.

---

Dependencies#

• Python 3.8+ (required) — python3 / python must be on PATH
• Layer 3 local ops: pip install python-pptx --break-system-packages

(The environment check step installs all required dependencies automatically.)

---

Which layer to trigger?#

ScenarioUseGenerate a PPT from a topic or existing reference filesLayer 1Imitate the layout/style of an existing .pptxLayer 2Edit/modify an existing PPT via natural languageLayer 4Convert NotebookLM-exported .pptx / .pdf into editable .pptxLayer 5Delete / reorder / extract / merge local .pptx files (no backend)Layer 3