Source profileQuality 58/100

bojieli/ai-agent-book/chapter2/agent-skills-ppt/skills/pptx/SKILL.md

pptx

Useful for office productivity workflows; the detail page covers purpose, installation, and practical steps.

Source repository stars
23,540
Declared platforms
0
Static risk flags
0
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

从论文、大纲或结构化文本生成 PowerPoint (.

Best for

  • pptx) 演示文稿。Use when 用户需要把一篇论文/文章/大纲做成幻灯片、slides、演示文稿、PPT、deck。Don't use when 只需纯文本总结、生成 Word/PDF、或修改已有 pptx 的单个像素级样式。

Not for

  • pptx) 演示文稿。Use when 用户需要把一篇论文/文章/大纲做成幻灯片、slides、演示文稿、PPT、deck。Don't use when 只需纯文本总结、生成 Word/PDF、或修改已有 pptx 的单个像素级样式。

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/bojieli/ai-agent-book --skill "chapter2/agent-skills-ppt/skills/pptx"
Safe inspection promptEditorial

Inspect the Agent Skill "pptx" from https://github.com/bojieli/ai-agent-book/blob/761352efdcf938c8d47c5c134045088a1db7fd84/chapter2/agent-skills-ppt/skills/pptx/SKILL.md at commit 761352efdcf938c8d47c5c134045088a1db7fd84. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    核心流程(第二层)

    把一份来源文本(论文 / 大纲)转成 8-12 页的演示文稿,按以下步骤:

    通读来源:理解论文的标题、作者、问题背景、方法、关键结果、结论。规划页序:一份合格的演示文稿总页数应为 8-12 页,至少覆盖——标题页(论文标题 + 作者/来源作为副标题)
  2. 02

    捆绑脚本调用约定

    工具:runskillscript(name="pptx", script="generatepptx.py", payload=)

    slides 至少 8 项(加上自动生成的标题页,总页数落在 8-12 页区间)。第一项通常是「目录 / 大纲」,最后一项应为「小结 / 结论」。每页 bullets 建议 3-5 条。
  3. 03

    更详细的样式与实现细则(第三层)

    如需了解版式、配色、python-pptx 的实现细节,或排查生成问题, 再用 readskillfile 读取本 Skill 内的: - reference.md —— 版式、配色与 python-pptx 技术细节 - scripts/generatepptx.py —— 生成器源码本身

    reference.md —— 版式、配色与 python-pptx 技术细节scripts/generatepptx.py —— 生成器源码本身如需了解版式、配色、python-pptx 的实现细节,或排查生成问题, 再用 readskillfile 读取本 Skill 内的: - reference.md —— 版式、配色与 python-pptx 技术细节 - scripts/generatepptx.py —— 生成器源码本身

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score58/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars23,540SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guidecatalog recordEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
bojieli/ai-agent-book
Skill path
chapter2/agent-skills-ppt/skills/pptx/SKILL.md
Commit
761352efdcf938c8d47c5c134045088a1db7fd84
License
Apache-2.0
Collected
2026-07-28
Default branch
main
View the original SKILL.md

pptx Skill —— 从论文生成演示文稿

核心流程(第二层)

把一份来源文本(论文 / 大纲)转成 8-12 页的演示文稿,按以下步骤:

  1. 通读来源:理解论文的标题、作者、问题背景、方法、关键结果、结论。
  2. 规划页序:一份合格的演示文稿总页数应为 8-12 页,至少覆盖——
    • 标题页(论文标题 + 作者/来源作为副标题)
    • 目录 / 大纲页
    • 研究背景 / 问题动机
    • 方法概述(必须拆成 2 页,例如「总体思路」与「关键机制」)
    • 关键结果 / 实验发现(必须拆成 2 页,例如「效率指标」与「效果对比」)
    • 局限性 / 讨论
    • 小结 / 结论页(要点式总结全篇)
  3. 提炼要点:每页 3-5 条 bullet,每条一句话,避免整段照搬原文。
  4. 生成文件:调用本 Skill 捆绑的脚本 scripts/generate_pptx.py (通过 run_skill_script 工具),传入下面约定的 JSON payload。

捆绑脚本调用约定

工具:run_skill_script(name="pptx", script="generate_pptx.py", payload=<JSON字符串>)

payload 的 JSON schema:

{
  "title": "演示文稿主标题(通常等于论文标题)",
  "subtitle": "副标题,通常是作者或来源,可留空",
  "slides": [
    {"title": "页标题", "bullets": ["要点1", "要点2", "要点3"]}
  ]
}

约束:

  • slides 至少 8 项(加上自动生成的标题页,总页数落在 8-12 页区间)。
  • 第一项通常是「目录 / 大纲」,最后一项应为「小结 / 结论」。
  • 每页 bullets 建议 3-5 条。

更详细的样式与实现细则(第三层)

如需了解版式、配色、python-pptx 的实现细节,或排查生成问题, 再用 read_skill_file 读取本 Skill 内的:

  • reference.md —— 版式、配色与 python-pptx 技术细节
  • scripts/generate_pptx.py —— 生成器源码本身

Alternatives

Compare before choosing