svg2pptskill

SKILL.md

---
name: svg2pptskill
version: 1.0.0
description: "Convert SVG content, Chinese character stroke order, province/country maps, or SVG URLs into editable PowerPoint (.pptx) via the handbooks.cn SVG-to-PPT service. Requires an API key obtained from the handbooks homepage."
author: handbooks
homepage: https://www.handbooks.cn/svg2ppt.html
license: Proprietary
---

# 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 |
| 省份地图 | 江苏、北京、台湾 | 可独立改色的省份矢量 PPT |
| 国家地图 | 中国、美国、日本 | 可独立改色的国家矢量 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:江苏`, `map:台湾` |
| Country map | `map:中国`, `map:美国`, `map:日本` |
| 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}}]({{download_url}})  
> 链接有效期约 7 天，请尽快下载。

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.