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 转 PPT Skill

What svg2pptskill does

svg2pptskill is the access code for the 手书 SVG 转 PPTX tool at https://www.handbooks.cn/svg2ppt.html.

It converts the following into editable PowerPoint slides:

Input type	Example	Result
汉字笔顺	爸、国、爱	带笔顺动画/分层的 PPT
省份地图	江苏、北京、台湾；也支持拼音/英文名如 Anhui、Guangdong、Shanghai	可独立改色的省份矢量 PPT
国家地图	中国/Chinese/China、美国/USA/America、日本/Japan	可独立改色的国家矢量 PPT
SVG 代码	完整 <svg>...</svg>	保持矢量可编辑的 PPT
SVG URL	https://example.com/a.svg	下载并转为 PPT
批量 SVG 链接	多个 URL	批量生成 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. Pick the right tab

   • 汉字笔顺：输入一个汉字，生成带笔顺的 PPT。
   • 省份地图 / 国家地图：选择或输入地名，生成地图 PPT。
   • SVG 内容：粘贴完整 SVG 代码。
   • SVG 链接 / 批量链接：粘贴 SVG 的公开 URL。

3. Click 生成PPT下载

   • 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 "怎么把 SVG 转成 PPT？" or similar, reply with:

可以用手书的 SVG 转 PPT 工具：打开 https://www.handbooks.cn/svg2ppt.html，选择对应类型（汉字笔顺、省份/国家地图、SVG 代码或链接），点击“生成 PPT 下载”即可。也可以在手书首页搜索框输入 svg2pptskill，会自动兑换密钥并跳转到该工具。

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:

已生成可编辑 PPT：
点击下载 {{file_name}}
链接有效期约 7 天，请尽快下载。

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.