Svg2pptskill

Convert SVG content, Chinese character stroke order, province/country maps (Chinese, English or pinyin names like Anhui/China/USA/Japan), or SVG URLs into editable PowerPoint (.pptx) via the handbooks.cn SVG-to-PPT service. Requires an API key obtained from the handbooks homepage.

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:

Input type	Example	Result
Chinese character stroke order	爸、国、爱	PPT with stroke-order animations/layers
Province map	江苏、北京、台湾；also supports pinyin/English names like Anhui、Guangdong、Shanghai	Vector province PPT with independently editable colors
Country map	中国/Chinese/China、美国/USA/America、日本/Japan	Vector country PPT with independently editable colors
SVG code	full <svg>...</svg>	Vector-editable PPT
SVG URL	https://example.com/a.svg	Download and convert to PPT
Batch SVG URLs	multiple URLs	Batch generate PPT

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

http

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

Request body:

json

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

Supported svg values:

Type	Example
Chinese character	char:中, char:爸, char:爱
Province map	map:北京/map:Beijing, map:江苏/map:Jiangsu, map:台湾/map:Taiwan, map:安徽/map:Anhui
Country map	map:中国/map:Chinese/map:China, map:美国/map:USA/map:America, map:日本/map:Japan
SVG code	<svg xmlns="http://www.w3.org/2000/svg">...</svg>
SVG URL	https://example.com/image.svg

Response handling

On success:

json

{
  "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:

bash

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