跳转到使用指南
pptx-slide-specification作者 Seth Hobson

PPTX Slide Specification Skill.

一个 Claude Code 和 Codex skill,用于 PPT 和幻灯片:为可编辑的 PPTX 文件编写明确坐标的 JSON 规范。

  • Presentations
  • PPTX
wshobson/agents · plugins/pptx-deck-creation/skills/pptx-slide-specification/SKILL.mdSKILL.md
--- name: pptx-slide-specification description: Use when authoring or repairing a coordinate-explicit JSON specification for an editable PPTX deck. --- ## Required contract ## Authoring rules ## Build contract
前置信息和章节标题读取自上游文件,时间为 2026-09-14 · 完整内容 1,954 字符

01 功能说明

pptx-slide-specification Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

该 skill 为可编辑的 PowerPoint 幻灯片编写坐标明确的 JSON 规范,其中每个元素都有以英寸为单位的最终边界框、稳定 ID、样式、z-index 和分类。规范一旦确定,任何渲染器都不得决定布局或在事后缩小文字。根 JSON 包含 summary 和 slides;每个 slide 都有稳定 ID、以信息为导向的标题、无障碍阅读顺序,以及完整的 layout_tree。

生产版摘要包含明确的 layout_policy,涵盖安全边距、内容底部、页脚顶部和最小间距。原生对象(文本、形状、线条、表格、图像)取代任何辅助性视觉元素。正文文字须为 9pt 或更大。构建器从空白布局开始,用 Inches() 映射所有边界框,并显式设置换行、自动调整大小、内边距、锚点、对齐、字体、颜色和线条设置。

它产出什么

  • 包含 summary 和 slides 的 JSON 规范,其中含坐标明确的布局树
查看示例提示词 ↗

工作方式

  1. 01
    在 Layout_tree 中编写最终坐标

    将以英寸为单位的绝对边界框直接写入布局树。审校完成后,任何渲染器都不得决定布局、缩小文字,或事后推断布局。

  2. 02
    为每个 Slide 声明完整结构

    每个 slide 都必须有稳定 ID、以信息为导向的标题、无障碍阅读顺序,以及声明幻灯片尺寸、根组和所有对象的完整 layout_tree。

  3. 03
    显式指定所有对象属性

    每个有意义的对象都必须声明 id、kind、role、classification、content、style、bbox 和 z_index,且 bbox 与 style 均为最终值。

  4. 04
    构建器映射到空白 Slide 布局

    任务本地构建器从空白幻灯片布局开始,并使用 Inches() 映射所有 bbox。

02 找到适合场景

何时使用 pptx-slide-specification Skill

当工作是此类 PPT 和幻灯片时,在 Claude Code 或 Codex 中使用 pptx-slide-specification skill。下方的适用范围和限制取自 skill 自身的文件。

适合场景

  • 为可编辑的 PPTX 演示文稿编写坐标明确的 JSON 规范

    03 Skill 内部

    pptx-slide-specification Skill 赋予 Claude Code 和 Codex 的规则

    SKILL.md 为 Agent 设定的 7 条具体指令、默认值与限制——正是文件中真正改变结果的部分。

    1. 使用稳定可读的 ID 和正数尺寸

      所有 ID 必须稳定且可读。在整个规范中使用绝对分组和正数英寸尺寸。

    2. 将内容保持在安全边距内并高于页脚

      普通内容必须保持在安全边距内并位于页脚栏上方。只有背景的 layout_design 对象可以出血到全幅。

    3. 内容文字最小尺寸为 9pt

      内容文字保持 9 pt 或以上。先缩短、调整尺寸或拆分密集内容,再考虑缩小字号。

    4. 为所有内容使用原生对象

      使用原生文本、形状、线条、表格和图像对象。将支持性视觉素材中的标签和数值重建为原生对象,而不是留在图像中。

    5. 提供无障碍与来源元数据

      为有意义的图像提供替代文字。为有来源出处的内容记录 source_ref。制作摘要中必须包含无障碍元数据。

    6. 在摘要中明确包含 layout_policy

      制作摘要中必须包含明确的 layout_policy,指定安全边距、内容底部、页脚顶部和最小间距。

    7. 构建器会拒绝无效的几何形状

      在将对象加入之前,构建器必须拒绝零或负数的几何形状,以确保所有形状具有有效尺寸。

    04 投入使用

    在 Claude Code 或 Codex 中安装 pptx-slide-specification

    一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

    将 pptx-slide-specification 添加到 Claude Code、Codex 或你的 Agent

    在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

    Terminal
    npx skills add https://github.com/wshobson/agents --skill pptx-slide-specification

    通用 skills CLI 形式用于 plugins/pptx-deck-creation/skills/pptx-slide-specification/SKILL.md;仓库可能会记录其自身路径。

    为 Skill 提供首个 PPT 和幻灯片任务

    按 skill 自身的术语撰写;把括号中的部分换成你的内容。

    Starter prompt
    Create a PPTX specification for a [quarterly performance review] deck with [5 slides]. Include a title slide, three data slides showing [revenue trends, customer acquisition, and operational metrics], and a closing slide with next steps. Use a [corporate] layout with consistent spacing and ensure all chart labels are native text objects at minimum 9pt.

    来源:依据 SKILL.md,按 skill 自身的术语撰写。

    检查首次结果

    在接受输出之前,在记录和文件中查找以下内容:

    • 使用稳定的可读 ID、绝对组和正英寸尺寸。
    • 将正常内容保留在安全边距内且位于页脚栏上方。只有背景 layout_design 对象可以满版出血。
    • 使用原生文本、形状、线条、表格和图像对象。将任何辅助视觉元素中的标签和值重新创建为原生对象。
    • 为有意义的图像提供 alt 文本。为来源声明记录 source_ref。
    • 将内容文本保持在 9 磅或更大;在缩小字体之前缩短、调整大小或拆分密集内容。
    • 使用共享网格、一致的间距、明确的颜色、明确的字号和有意的 z-order。

    在 OpenDesign 中通过其 SKILL.md 链接导入 pptx-slide-specification:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

    05 开源、可追溯

    来源、许可与验证

    本页面事实的来源,以及最后检查时间。

    Repository
    github.com/wshobson/agents 分支 main
    Skill 文件
    plugins/pptx-deck-creation/skills/pptx-slide-specification/SKILL.md 验证时记录的内容校验和;提交 4236bb9
    License
    MIT 来自 LICENSE。
    仓库星标数
    39,635 GitHub 快照拍摄于 2026-09-14,针对整个 wshobson/agents 仓库,该仓库在此目录中包含 18 个 skills。不是 pptx-slide-specification 的评分或使用次数。
    已由 OpenDesign 验证
    2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

    SKILL.md 内部

    1. 必需契约定义根 JSON 结构、幻灯片要求、布局树内容以及必需的对象字段
    2. 编写规则规定 ID 约定、边距规则、原生对象使用方式、无障碍要求、字号最小值以及一致性标准
    3. 构建契约说明构建器如何从空白布局、明确的属性设置和几何验证处理规范
    Skill 自身的描述
    "在编写或修复可编辑 PPTX 文档的坐标明确 JSON 规范时使用。"

    来自 SKILL.md 的前言描述。完整文件约 1,954 个字符。在 GitHub 上阅读完整文件。

    PPTX Slide Specification

    在真实的 PPT 和幻灯片任务中运行 pptx-slide-specification。

    下载 OpenDesign,从其 SKILL.md 链接导入 pptx-slide-specification,粘贴上方的提示,在结果前阅读计划。

    终端
    npx skills add https://github.com/wshobson/agents --skill pptx-slide-specification

    OpenDesign 桌面客户端

    一套设计系统,让每一次创作都保持品牌一致

    在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

    • 覆盖网页、PPT、原型、数据看板、图像与视频
    • 140+ 设计系统,以及完整模板与技能库
    • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
    免费下载

    支持 macOS 与 Windows