office-pptx SKILL.md skillA
office-pptx from knowflow-ai/knowwork is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add knowflow-ai/knowwork/office-pptx@git:20261021.536ea09Pins git:20261021.536ea09 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- knowflow-ai/knowwork
- Path
runtime-host/plugins/dsh-host/skills/office-pptx/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261021.536ea09, committed Oct 21, 2026
- Size
- 20,189 bytes
- Repository stars
- 109
- License
- Apache-2.0
只要涉及 .pptx / .potx 文件就用——不论它是输入、输出还是两者。包括：做演示稿、汇报 PPT、路演材料、幻灯片；读取、解析或提取任何 .pptx 里的文字（哪怕提取出来是为了写邮件或摘要）；修改、更新已有的演示稿；合并或拆分幻灯片；套用模板、版式，处理演讲者备注或批注。用户说"PPT""幻灯片""演示稿""deck""汇报材料"，或提到某个 .pptx 文件名时，无论之后要拿内容做什么，都加载它。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# PPTX：生成、修改与读取
`.pptx` 是一个装着 XML 的压缩包。按任务选做法：
| 任务 | 做法 |
|---|---|
| **生成**新演示稿 | 写一个 `pptxgenjs` 脚本——坑点见下 |
| **修改**已有演示稿，或基于模板制作 | 解压 → 改 `ppt/slides/slideN.xml` → 打包 |
| **读取**内容 | `markitdown 文件.pptx`（每页一段，以 `<!-- Slide number: N -->` 分隔）；看版式：`python3 /opt/knowwork/office/thumbnail.py 文件.pptx 前缀` |
> 用户给的原文件在 `/workspace/input`（只读），中间文件放 `/workspace/tmp`，要交给用户的
> 放 `/workspace/output`，写好后调用 `present` 交付（例如 `present({"files":[{"path":"/workspace/output/演示稿.pptx"}]})`）。
## 脚本
都在 `/opt/knowwork/office/`，其余都是普通的 Python、`node` 或 shell。
| 脚本 | 作用 |
|---|---|
| `thumbnail.py 文件.pptx 前缀` | 把每页渲染成带页码的缩略图网格，用来挑模板版式。只接受 `.pptx`。**一定要传前缀**，用文件名命名它——两份演示稿用同一个前缀，后一份的网格会覆盖前一份 |
| `add_slide.py 目录/ slide2.xml [--after slideN.xml]` | 复制一页（或从 `slideLayoutN.xml` 新建一页），把包里要登记的地方都登记好。也能直接对文件：`-o 输出.pptx` |
| `clean.py 目录/` | 删掉已经没人引用的幻灯片、图片、关系。**`<p:sldIdLst>` 定稿之后**再跑 |
| `validate.py 文件.pptx [--render]` | 检查 XML、关系、内容类型、幻灯片列表；`--render` 再让 LibreOffice 打开一次。每个问题都附修法 |
| `soffice.py --headless --convert-to pdf 文件.pptx` | LibreOffice 的封装——沙箱里直接跑 `soffice` 会卡住 |
## 用 pptxgenjs 生成——坑点
`pptxgenjs` 已经装好，直接 `require('pptxgenjs')`，不要 `npm install`——沙箱没有网络。
API 你是知道的，要当心的是这些：
…Read the whole file at its exact version.
How to install
mdr add knowflow-ai/knowwork/office-pptx@sha256:3a1af03869d3f69bThe line at the top of this page pins the label git:20261021.536ea09, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_fmylktesztr2evup)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 21, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (20189 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
knowflow-ai/knowwork · 109 stars · license Apache-2.0 · pushed 2026-11-07 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_fmylktesztr2evup GET https://markdownregistry.com/api/v1/resolve?ref=knowflow-ai/knowwork/office-pptx GET https://markdownregistry.com/api/v1/blob/3a1af03869d3f69b2f3a35263e949b0c9c49ea8b3df02c05d859d2bf9271d8bb
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.