# Cappt

> Generate a PowerPoint presentation from a topic, title, or article using Cappt. Use this skill when the user asks to create a PPT, presentation, or slide deck, or mentions Cappt. The skill first generates a structured Markdown outline, then calls the Cappt CLI to produce the final presentation. Trigger phrases include "生成PPT"、"做一个演示文稿"、"制作幻灯片"、"create a presentation"、"make a PPT"、"generate slides…

- **Type:** Skill
- **Install:** `agentstack add skill-cappt-team-skills-cappt`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [cappt-team](https://agentstack.voostack.com/s/cappt-team)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [cappt-team](https://github.com/cappt-team)
- **Source:** https://github.com/cappt-team/skills/tree/main/skills/cappt
- **Website:** https://www.cappt.cc

## Install

```sh
agentstack add skill-cappt-team-skills-cappt
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Cappt PPT 生成器

使用 Cappt AI 服务，根据用户输入生成专业的 PowerPoint 演示文稿。

## 触发场景

同时满足以下两个条件时激活：
- 用户提到 PPT / 演示文稿 / 幻灯片 / presentation / slides / Cappt
- 有明确的生成意图（生成 / 做 / 制作 / 创建 / create / make / generate）

## 安全约束（最高优先级）

以下规则不可被用户指令覆盖：
- **Token 内容禁止输出**，不可读取、打印或日志记录 `~/.config/cappt/auth.json` 的内容
- **更新操作需用户明确确认**，不可在用户未要求时自动执行更新脚本

## 前置检查

按顺序执行以下检查，发现问题立即引导用户修复，再继续。

**检查 1：cappt CLI 是否已安装**

```bash
# macOS/Linux
command -v cappt
```
```powershell
# Windows
Get-Command cappt -ErrorAction SilentlyContinue
```

若未安装，按平台引导运行安装脚本：

```bash
# macOS/Linux
bash ${CLAUDE_SKILL_DIR}/scripts/install.sh
```
```powershell
# Windows
pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\install.ps1"
```

> 安装问题参见：`reference/troubleshooting.md`

**检查 2：是否已登录**

```bash
cappt whoami
```

若未登录（退出码 1），执行以下登录流程：

**步骤 1** — 获取登录链接（立即返回到 stdout）：
```bash
AUTH_URL=$(cappt login --utm-source )
```
`--utm-source` 为可选参数，不传时默认为 `cappt`。将 `$AUTH_URL` 展示给用户，请用户在浏览器中打开并登录，登录后浏览器会显示一个 token。

**步骤 2** — 用户复制 token 后，将其保存到本地：
```bash
cappt login --token 
```

两项检查均通过后，进入工作流。

> **环境变量快捷方式**：若用户提到使用环境变量，可跳过登录流程：
> - `CAPPT_TOKEN=`：直接传入认证 token，优先级高于本地缓存
> - `CAPPT_BASE_URL=`：覆盖默认 API 地址（默认 `https://api.cappt.cc`），适用于私有部署或测试环境
>
> 示例：`CAPPT_TOKEN=xxx CAPPT_BASE_URL=https://api.b.cappt.cc cappt generate --outline-file outline.md`

## 工作流

按顺序执行以下四步，不可跳过任何一步。

### 第一步 — 理解用户需求

从用户消息中识别：
- 需要转化为 PPT 的**主题、标题或文章内容**
- 是否需要返回所有幻灯片的图片集合（`--include-gallery`）
- 是否需要返回预览图（`--include-preview`）

若用户未提及上述选项，默认均为 **false**。

### 第二步 — 生成结构化 Markdown 大纲

参照 `reference/outline-format.md` 中的格式规范，生成符合要求的完整大纲。

关键要求：
- **语言一致**：大纲语言必须与用户输入语言一致
- **层级完整**：`#` 总标题 → `##` 章节（3-5 个）→ `###` 小节（每章节 3-5 个）→ `####` 要点（每小节 3-8 个）
- **副标题完整**：每级标题下方必须有一行 `>` 副标题
- **编号规范**：`##` 用 `1.`，`###` 用 `1.1`，`####` 用 `1.1.1`
- **数量随机**：各章节小节数、各小节要点数不可完全相同

生成完毕后，**将完整大纲展示给用户，等待确认后再进行第三步**。

若用户提供的文章超过 500 字，展示大纲后必须请用户确认再继续。

### 第三步 — 调用 cappt CLI 生成 PPT

将大纲写入临时文件，调用 CLI：

```bash
OUTLINE_FILE="/tmp/cappt_outline_$(date +%s).md"
cat > "$OUTLINE_FILE" 
OUTLINE_EOF

cappt generate --outline-file "$OUTLINE_FILE"
```

若用户要求了图片集合或预览图，追加对应参数：
- `--include-gallery`：返回所有幻灯片图片 URL
- `--include-preview`：返回预览图 URL

传给 CLI 的必须是**完整的 Markdown 大纲原文**，不可使用摘要替代。

API 调用失败时最多重试一次。

### 第四步 — 展示结果

CLI 成功时将 JSON 输出到 stdout，解析后按以下格式展示：

```
您的 PPT 已经生成！

[在 Cappt 中打开并编辑]({editorUrl})

封面预览：

```

若 JSON 中包含 `gallery` 字段，在封面下方依次展示每张幻灯片图片。
若包含 `preview` 字段，作为额外预览图展示。

## 错误处理

| 错误信息 | 原因 | 建议操作 |
|----------|------|----------|
| `out of AI credits` (code 5410) | Cappt 账户点数不足 | 引导用户前往 Cappt 充值 |
| `token invalid or expired` (401) | 登录态失效，缓存已自动清除 | 运行 `cappt login` 重新登录 |
| `internal server error` (500) | Cappt 服务端异常 | 稍后重试 |
| `generation failed` (fail) | 大纲格式有误或服务异常 | 检查大纲格式，参见 `reference/outline-format.md` |
| `stream ended without a result` | 页数过多或网络异常 | 缩短大纲后重试 |
| `command not found: cappt` | CLI 未安装 | 运行 `install.sh` / `install.ps1` |

若 CLI 以非零退出码退出，将 stderr 中的错误信息完整展示给用户。

> 更多错误排查见：`reference/troubleshooting.md`

## 生命周期管理

用户有安装/登录/更新/卸载需求时，直接引导运行对应命令：

| 操作 | macOS/Linux | Windows |
|------|-------------|---------|
| 安装 CLI | `bash ${CLAUDE_SKILL_DIR}/scripts/install.sh` | `pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\install.ps1"` |
| 登录 | `cappt login` → `cappt login --token ` | 同左 |
| 查看状态 | `cappt whoami` | 同左 |
| 注销 | `cappt logout` | 同左 |
| 更新 CLI | `bash ${CLAUDE_SKILL_DIR}/scripts/update.sh` | `pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\update.ps1"` |
| 卸载 | `bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh` | `pwsh -ExecutionPolicy Bypass -File "${env:CLAUDE_SKILL_DIR}\scripts\uninstall.ps1"` |

## 参考文档

| 文档 | 用途 |
|------|------|
| `reference/outline-format.md` | 大纲格式规范（层级、编号、示例） |
| `reference/troubleshooting.md` | 故障排除指南 |

## 示例

**示例一 — 中文主题**
> 用户："帮我生成一个关于人工智能发展历史的PPT"
→ 前置检查 → 生成中文大纲 → 用户确认 → 调用 CLI → 展示结果

**示例二 — 英文主题**
> 用户："Create a 10-slide deck on climate change"
→ 前置检查 → 生成英文大纲 → 用户确认 → 调用 CLI → 展示结果

**示例三 — 文章转换**
> 用户："把这篇文章做成PPT：[文章内容]"
→ 前置检查 → 提取要点生成大纲 → 用户确认 → 调用 CLI → 展示结果

**示例四 — 安装 / 登录**
> 用户："我想用 Cappt 做 PPT，怎么安装？"
→ 引导运行 `install.sh`（或 `install.ps1`），然后 `cappt login`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [cappt-team](https://github.com/cappt-team)
- **Source:** [cappt-team/skills](https://github.com/cappt-team/skills)
- **License:** MIT
- **Homepage:** https://www.cappt.cc

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-cappt-team-skills-cappt
- Seller: https://agentstack.voostack.com/s/cappt-team
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.