skywork-ppt

name	Skywork-ppt
description	Skywork PPT (skywork) - Use when the user wants to work with PowerPoint presentations. Triggers: (1) Generate a new PPT from a topic — 'generate a PPT', 'create a presentation about X', 'make slides', '帮我做个PPT', '生成演示文稿', 'PPTを作って', 'スライドを作って', 'PPT 만들어줘', '슬라이드 만들어줘'; (2) Imitate an existing .pptx style/template — 'use this template', 'imitate this PPT/style', '用这个模板', '仿照这个PPT', 'このテンプレートを使って', '이 템플릿 써줘'; (3) Edit existing PPT via natural language — 'modify slide N', 'change background', 'add a slide', 'make it more beautiful', '修改第N页', '更换背景', '新增一页', '美化一下', 'N枚目を修正', '背景を変えて', 'きれいにして', 'N번 슬라이드 수정', '배경 바꿔줘'; (4) Convert NotebookLM-exported pptx/pdf into editable pptx — 'make this notebooklm ppt editable', 'convert notebooklm export to editable pptx', '把这个notebooklm导出的pptx改成可编辑pptx', '把这个pdf转成可编辑pptx'; (5) Local .pptx file ops — 'delete slide N', 'reorder slides', 'merge pptx', 'extract slides', 'how many slides', '删除第N页', '调整顺序', '合并PPT', '提取幻灯片', 'スライドを削除/並べ替え/結合/抽出', '슬라이드 삭제/순서 변경/합치기/추출'.
metadata	{"openclaw":{"requires":{"bins":"[Truncated]","env":"[Truncated]"},"primaryEnv":"SKYWORK_API_KEY"}}

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 intent	Which path
Generate a new PPT from a topic, set of requirements or reference files	Layer 1 — Generate
Use an existing .pptx as a layout/style template to create a new presentation	Layer 2 — Imitate
Edit an existing PPT: modify slides, add slides, change style, split/merge	Layer 4 — Edit
Convert a NotebookLM-exported .pptx or .pdf into an editable .pptx	Layer 5 — Convert to editable PPTX
Delete / 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.

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

0. REQUIRED FIRST STEP — Read workflow_generate.md NOW, before taking any other action. After reading, output exactly: ✅ workflow_generate.md loaded. — then proceed.
1. Environment check — run the check above to get $PYTHON_CMD.
2. 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.
3. 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.
4. Run the script:

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

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

---

Layer 2 — Imitate PPT (template-based generation)

Steps

0. REQUIRED FIRST STEP - Read workflow_imitate.md immidiately before any action you do!!!
1. Environment check — run the check above to get $PYTHON_CMD.
2. Locate the template — extract the absolute path of the local .pptx from the user's message; ask the user if it's unclear.
3. Upload the template — upload it and extract TEMPLATE_URL from the output.
4. 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
5. 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.
6. Run the script:

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

7. 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

0. Detailed workflow - Read workflow_edit.md immediately before any action you do!!!
1. Environment check — run the check above to get $PYTHON_CMD.
2. Get PPTX URL — from the user's message or upload a local file first.
3. Run the script with --pptx-url:

   $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).

4. 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

0. Detailed workflow - Read workflow_convert_editable.md immediately before any action you do!!!
1. Environment check — run the check above to get $PYTHON_CMD.
2. Locate the source file — extract the absolute path of the local .pptx or .pdf; ask the user if the path is unclear.
3. Upload the source file — upload it and extract SOURCE_URL from the output.
4. Run the script:

   $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).

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

---

Layer 3 — PPT File operations

# 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?

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