Powerpoint Pptx 1.0.1

When to Use

Use when the main artifact is a Microsoft PowerPoint presentation or .pptx deck, especially when layouts, templates, placeholders, notes, comments, charts, extraction, editing, or final visual quality matter.

Core Rules

1. Choose the workflow before touching the deck

• Reading text, editing an existing deck, rebuilding from a template, and creating from scratch are different jobs with different failure modes.
• For text extraction or inspection, read the deck before editing it.
• Text extraction plus thumbnail-style visual inspection is safer than editing from shape assumptions alone.
• For template-driven work, inventory the deck before replacing content.
• For deep edits, remember a .pptx file is OOXML with separate parts for slides, layouts, masters, media, notes, and comments.
• If a template exists, template fidelity beats generic slide-design instincts.
• Reusing or duplicating a good existing slide is often safer than rebuilding it and hoping the theme still matches.

2. Inventory the deck before replacing content

• Count the reusable layouts, real placeholders, notes, comments, media, and recurring typography or color patterns first.
• Placeholder indexes and layout indexes are not portable assumptions.
• Inspect the actual slide or template before targeting title, body, chart, or image shapes.
• Speaker notes, comments, and linked assets can live outside the visible slide surface.
• A missing or wrong placeholder target can silently land content in the wrong box or wrong layer.
• Master and layout settings can override local slide edits, so the visible problem is not always on the slide you are editing.

3. Match content to the actual placeholders

• Count the actual content pieces before choosing a layout.
• Pick layouts based on the real number of ideas, columns, images, or charts the slide needs.
• Do not force two ideas into a three-column slide or cram dense text under a chart.
• Category counts and data series lengths must match or charts will break in ugly ways.
• Explicit sizing beats wishful thinking: text boxes, images, and charts need real space, not "it should fit".
• Do not choose a layout with more placeholders than the content can meaningfully fill.
• Quote layouts are for real quotes, and image-led layouts are for slides that actually have images.
• For chart-, table-, or image-heavy slides, full-slide or two-column layouts are usually safer than stacking dense text above the visual.

4. Preserve the deck's visual language

• Theme, master, and layout files usually decide fonts, colors, and hierarchy more than any one slide does.
• Start from the deck's actual theme, fonts, spacing, and aspect ratio instead of improvising a new style.
• Reuse the deck's own alignment and spacing system instead of inventing a second visual language.
• Use common fonts for portability and strong contrast for readability.
• Preserve the template's visual logic first; originality matters less than not breaking the deck's existing language.
• Combining slides from multiple sources requires normalizing themes, masters, and alignment afterward.

5. Run content QA and visual QA separately

• Text overflow, bad alignment, clipped shapes, weak contrast, and placeholder leftovers are normal first-pass failures.
• Run both content QA and visual QA; missing text and broken layout are different failure classes.
• Render or inspect the actual deck output before delivery when layout matters.
• Search for leftover template junk, sample labels, and placeholder text before calling the deck finished.
• Check notes, comments, labels, legends, and chart/table semantics separately from the visual pass.
• A deck can pass text extraction and still fail on overlap, clipping, wrong theme inheritance, or broken notes.
• Thumbnail grids and rendered slides usually reveal layout bugs faster than code or text inspection.
• Assume the first render is wrong and do at least one fix-and-verify cycle before calling the deck finished.
• Re-check affected slides after each fix because one spacing change often creates another issue.

6. Keep decks portable and review-safe

• Template masters can override direct edits in surprising ways.
• Complex effects may degrade across PowerPoint, LibreOffice, and conversion pipelines, so keep important content robust without them.
• Image sizing, font substitution, and placeholder mismatch are common reasons a deck looks good in code and bad on screen.
• Notes, comments, linked media, and merged decks can stay broken even when the visible slide looks fine.

Common Traps

• Placeholder text and sample charts often survive template reuse if not explicitly replaced.
• Directly editing one slide can fail if the real issue lives in the master or layout.
• Charts, icons, and text boxes need enough space; near-collisions are usually visible only after rendering.
• Layout indexes vary by template, so built-in assumptions from one deck often break in another.
• A missing placeholder or wrong shape target can silently put content in the wrong place.
• Counting the text ideas after choosing the layout usually leads to empty placeholders, weak hierarchy, or leftover template junk.
• Font substitution can move line breaks and wreck careful spacing.
• Speaker notes, comments, and linked media can stay broken even when the visible slide looks fine.
• A deck can pass text inspection and still fail visually because of overlap, contrast, or edge clipping.
• Editing from one slide alone can miss the real source of truth in the theme, master, or layout definitions.
• Choosing a quote, comparison, or multi-column layout without matching content usually makes the deck look templated rather than intentional.
• Combining or duplicating slides without checking masters and themes can create subtle inconsistency slide by slide.
• Aspect-ratio mismatches like 16:9 versus 4:3 can shift every placement decision even when each slide looks locally reasonable.

Related Skills

Install with `* 安装此Skill请参考SkillHub平台指南

• documents — Document workflows that often feed presentation content.
• design — Visual direction and layout decisions.
• brief — Concise business messaging for slide narratives.

Feedback

• If useful: `
• Stay updated: `

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明

API Key 配置

• 本Skill基于Markdown指令,无需额外API Key(除内容中明确标注的外部API)

可用性分类

• 分类: MD+EXEC(纯Markdown指令,部分功能需要exec命令行执行能力)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent执行任务

核心能力

• Create, inspect, and edit Microsoft PowerPoint presentations and PPTX
  decks with reliable layouts
• 触发关键词: edit, create, microsoft, inspect, 1
• 1, powerpoint, pptx

适用场景

不适用于：需要人工判断的复杂决策场景

使用流程

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

示例

示例1：基础用法

错误处理

常见问题

Q1: 如何开始使用Powerpoint Pptx 1 0？

A: 请先阅读使用流程章节，确认环境满足依赖说明中的要求。

Q2: 遇到错误怎么办？

A: 请参考错误处理章节，按照表格中的处理方式操作。

Q3: Powerpoint Pptx 1 0有什么限制？

A: 请参考已知限制章节了解具体限制。

已知限制

• 需要LLM支持，无LLM环境无法使用
• 复杂场景可能需要人工辅助判断
• 性能取决于底层模型能力

边界条件与限制

输入限制

• 文件格式限制：该技能仅支持Microsoft PowerPoint presentations和.pptx文件格式的处理。
• 文件大小限制：由于性能和资源限制，处理大型或高分辨率的.pptx文件可能需要较长时间，且可能不支持所有功能。
• 内容复杂度限制：对于包含大量复杂图表、动画或特殊效果的.pptx文件，技能可能无法完全正确处理所有细节。

性能边界

• 处理速度：处理速度取决于文件大小和复杂度，以及运行环境的性能。
• 并发处理：该技能不支持同时处理多个.pptx文件，每次只能处理一个文件。

兼容性约束

• 软件兼容性：该技能依赖于支持SKILL.md的AI Agent，因此需要Agent平台和操作系统兼容。
• 格式兼容性：可能无法完美处理来自不同PowerPoint版本或不同软件的.pptx文件，因为格式和功能可能有所不同。
• 字体和媒体文件兼容性：某些字体或媒体文件可能无法在所有环境中正确显示或渲染。