SVG to PPT Skill

What svg2pptskill does

svg2pptskill is the access code for the Handbooks SVG to PPTX tool at https://www.handbooks.cn/svg2ppt.html.

It converts the following into editable PowerPoint slides:

Default response: guide the user to the web UI

For general questions or when the user has not provided an API key, guide them to the web UI:

1. Open the tool
   - Direct URL: https://www.handbooks.cn/svg2ppt.html
   - Or go to https://www.handbooks.cn/, type svg2pptskill in the home search box, and click search. This will redeem an API key and auto-open the tool.

2. Select the appropriate tab
   - Chinese Stroke Order: Enter a Chinese character to generate a PPT with stroke order.
   - Province Map / Country Map: Select or enter a place name to generate a map PPT.
   - SVG Content: Paste the full SVG code.
   - SVG URL / Batch URLs: Paste the public URL of the SVG.

3. Click Generate PPT Download
   - The browser downloads a .pptx file.
   - Open it in PowerPoint or WPS; shapes remain vector-editable and colors can be changed independently.

Quick response template

If a user asks "How do I convert SVG to PPT?" or similar, reply with:

> Use the Handbooks SVG to PPT tool: open https://www.handbooks.cn/svg2ppt.html, select the matching type (Chinese stroke order, province/country map, SVG code or URL), and click "Generate PPT Download". You can also enter svg2pptskill in the Handbooks homepage search box; it will redeem a key and jump to the tool.

Active API invocation (only when the user provides a key)

If the user explicitly asks you to perform the conversion and has already provided a valid API key, you may call the conversion API directly.

Important restriction

NEVER call /api/skill/key directly. The user must obtain the API key from the handbooks homepage by typing svg2pptskill in the search box. Only after the user pastes the key to you can you call the conversion API.

Conversion API

POST https://www.handbooks.cn/api/skill/convert
Content-Type: application/json

Request body:

{
  "skill": "svg2pptskill",
  "key": "<key provided by user>",
  "svg": "<value>"
}

Supported svg values:

Response handling

On success:

{
  "success": true,
  "download_url": "https://www.handbooks.cn/downloads/svg2ppt-1783264040021-5e3b271e.pptx",
  "file_name": "svg2ppt-1783264040021-5e3b271e.pptx",
  "expires_in": 604800
}

Reply to the user with:

> Editable PPT generated:
> Click to download {{file_name}}
> The link is valid for about 7 days; please download soon.

Calling via the bundled script (recommended)

When invoking the bundled scripts/convert.cjs tool, pass the API key as the first argument and the svg value as the second argument.

OpenClaw invokes this tool via command-line arguments. Node.js on Windows preserves Unicode argv, so Chinese characters, full SVG code, and URLs can be passed directly without base64 encoding. The script also accepts input via stdin for manual piping.

Examples:

# Pass the svg value as the second argument (recommended for OpenClaw and CJK input)
node scripts/convert.cjs SVG2PPTSKILL-xxx map:安徽
node scripts/convert.cjs SVG2PPTSKILL-xxx char:中

# For manual CLI piping, stdin is also accepted
echo "map:安徽" | node scripts/convert.cjs SVG2PPTSKILL-xxx -
echo "char:中" | node scripts/convert.cjs SVG2PPTSKILL-xxx -

On error:
- 400: Parameter error or SVG conversion failed. Read the error field and ask the user to check their input.
- 403: API key invalid or quota used up. Ask the user to get a new key from the handbooks homepage and try again. If it still fails, guide them to the web UI at https://www.handbooks.cn/svg2ppt.html.

When NOT to use this skill

• If the user only wants to read or summarize an existing .pptx file, use the pptx skill instead.
• If the user wants programmatic/server-side batch conversion, they should use the web UI or implement their own server-side key exchange. Never expose or call /api/skill/key on behalf of the user.