技能内容

PPTX creation, editing, and analysis

Overview

A user may ask you to create, edit, or analyze the contents of a .pptx file. A .pptx file is essentially a ZIP archive containing XML files and other resources that you can read or edit. You have different tools and workflows available for different tasks.

Reading and analyzing content

Text extraction

If you just need to read the text contents of a presentation, you should convert the document to markdown:

# Convert document to markdown
python -m markitdown path-to-file.pptx

Raw XML access

You need raw XML access for: comments, speaker notes, slide layouts, animations, design elements, and complex formatting. For any of these features, you'll need to unpack a presentation and read its raw XML contents.

Extract template text AND create visual thumbnail grid:
- Extract text: python -m markitdown template.pptx > template-content.md
- Read template-content.md: Read the entire file to understand the contents of the template presentation. NEVER set any range limits when reading this file.
- Create thumbnail grids: python scripts/thumbnail.py template.pptx
- See Creating Thumbnail Grids section for more details
Analyze template and save inventory to a file:
- Visual Analysis: Review thumbnail grid(s) to understand slide layouts, design patterns, and visual structure
- Create and save a template inventory file at template-inventory.md containing:
```
# Template Inventory Analysis
**Total Slides: [count]**
**IMPORTANT: Slides are 0-indexed (first slide = 0, last slide = count-1)**

## [Category Name]
- Slide 0: [Layout code if available] - Description/purpose
- Slide 1: [Layout code] - Description/purpose
- Slide 2: [Layout code] - Description/purpose
[... EVERY slide must be listed individually with its index ...]
```
- Using the thumbnail grid: Reference the visual thumbnails to identify:
  - Layout patterns (title slides, content layouts, section dividers)
  - Image placeholder locations and counts
  - Design consistency across slide groups
  - Visual hierarchy and structure
- This inventory file is REQUIRED for selecting appropriate templates in the next step
Create presentation outline based on template inventory:
- Review available templates from step 2.
- Choose an intro or title template for the first slide. This should be one of the first templates.
- Choose safe, text-based layouts for the other slides.
- CRITICAL: Match layout structure to actual content:
  - Single-column layouts: Use for unified narrative or single topic
  - Two-column layouts: Use ONLY when you have exactly 2 distinct items/concepts
  - Three-column layouts: Use ONLY when you have exactly 3 distinct items/concepts
  - Image + text layouts: Use ONLY when you have actual images to insert

python scripts/thumbnail.py template.pptx [output_prefix]

# Basic usage
python scripts/thumbnail.py presentation.pptx

# Combine options: custom name, columns
python scripts/thumbnail.py template.pptx analysis --cols 4

Convert PPTX to PDF:

soffice --headless --convert-to pdf template.pptx

Convert PDF pages to JPEG images:
```
pdftoppm -jpeg -r 150 template.pdf slide
```
This creates files like slide-1.jpg, slide-2.jpg, etc.

pdftoppm -jpeg -r 150 -f 2 -l 5 template.pdf slide  # Converts only pages 2-5

Example template mapping:

# Template slides to use (0-based indexing)
# WARNING: Verify indices are within range! Template with 73 slides has indices 0-72
# Mapping: slide numbers from outline -> template slide indices
template_mapping = [
    0,   # Use slide 0 (Title/Cover)
    34,  # Use slide 34 (B1: Title and body)
    34,  # Use slide 34 again (duplicate for second B1)
    50,  # Use slide 50 (E1: Quote)
    54,  # Use slide 54 (F2: Closing + Text)
]

Duplicate, reorder, and delete slides using rearrange.py:

Use the scripts/rearrange.py script to create a new presentation with slides in the desired order:
```
python scripts/rearrange.py template.pptx working.pptx 0,34,34,50,52
```
The script handles duplicating repeated slides, deleting unused slides, and reordering automatically
Slide indices are 0-based (first slide is 0, second is 1, etc.)
The same slide index can appear multiple times to duplicate that slide

Extract ALL text using the inventory.py script:

Run inventory extraction:

python scripts/inventory.py working.pptx text-inventory.json

Read text-inventory.json: Read the entire text-inventory.json file to understand all shapes and their properties. NEVER set any range limits when reading this file.

The inventory JSON structure:

  {
    "slide-0": {
      "shape-0": {
        "placeholder_type": "TITLE",  // or null for non-placeholders
        "left": 1.5,                  // position in inches
        "top": 2.0,
        "width": 7.5,
        "height": 1.2,
        "paragraphs": [
          {
            "text": "Paragraph text",
            // Optional properties (only included when non-default):
            "bullet": true,           // explicit bullet detected
            "level": 0,               // only included when bullet is true
            "alignment": "CENTER",    // CENTER, RIGHT (not LEFT)
            "space_before": 10.0,     // space before paragraph in points
            "space_after": 6.0,       // space after paragraph in points
            "line_spacing": 22.4,     // line spacing in points
            "font_name": "Arial",     // from first run
            "font_size": 14.0,        // in points
            "bold": true,
            "italic": false,
            "underline": false,
            "color": "FF0000"         // RGB color
          }
        ]
      }
    }
  }

Key features:
- Slides: Named as "slide-0", "slide-1", etc.
- Shapes: Ordered by visual position (top-to-bottom, left-to-right) as "shape-0", "shape-1", etc.
- Placeholder types: TITLE, CENTER_TITLE, SUBTITLE, BODY, OBJECT, or null
- Default font size: default_font_size in points extracted from layout placeholders (when available)
- Slide numbers are filtered: Shapes with SLIDE_NUMBER placeholder type are automatically excluded from inventory
- Bullets: When bullet: true, level is always included (even if 0)
- Spacing: space_before, space_after, and in points (only included when set)

Generate replacement text and save the data to a JSON file Based on the text inventory from the previous step:

CRITICAL: First verify which shapes exist in the inventory - only reference shapes that are actually present
VALIDATION: The replace.py script will validate that all shapes in your replacement JSON exist in the inventory
- If you reference a non-existent shape, you'll get an error showing available shapes
- If you reference a non-existent slide, you'll get an error indicating the slide doesn't exist
- All validation errors are shown at once before the script exits
IMPORTANT: The replace.py script uses inventory.py internally to identify ALL text shapes
AUTOMATIC CLEARING: ALL text shapes from the inventory will be cleared unless you provide "paragraphs" for them
Add a "paragraphs" field to shapes that need content (not "replacement_paragraphs")
Shapes without "paragraphs" in the replacement JSON will have their text cleared automatically
Paragraphs with bullets will be automatically left aligned. Don't set the alignment property on when "bullet": true
Generate appropriate replacement content for placeholder text
Use shape size to determine appropriate content length
CRITICAL: Include paragraph properties from the original inventory - don't just provide text
IMPORTANT: When bullet: true, do NOT include bullet symbols (•, -, *) in text - they're added automatically
ESSENTIAL FORMATTING RULES:
- Headers/titles should typically have "bold": true
- List items should have "bullet": true, "level": 0 (level is required when bullet is true)
- Preserve any alignment properties (e.g., "alignment": "CENTER" for centered text)
- Include font properties when different from default (e.g., "font_size": 14.0, "font_name": "Lora")
- Colors: Use "color": "FF0000" for RGB or "theme_color": "DARK_1" for theme colors
- The replacement script expects properly formatted paragraphs, not just text strings
- Overlapping shapes: Prefer shapes with larger default_font_size or more appropriate placeholder_type
Save the updated inventory with replacements to replacement-text.json
: Different template layouts have different shape counts - always check the actual inventory before creating replacements

Apply replacements using the replace.py script

python scripts/replace.py working.pptx replacement-text.json output.pptx

The script will:

First extract the inventory of ALL text shapes using functions from inventory.py
Validate that all shapes in the replacement JSON exist in the inventory
Clear text from ALL shapes identified in the inventory
Apply new text only to shapes with "paragraphs" defined in the replacement JSON
Preserve formatting by applying paragraph properties from the JSON
Handle bullets, alignment, font properties, and colors automatically
Save the updated presentation

Example validation errors:

ERROR: Invalid shapes in replacement JSON:
  - Shape 'shape-99' not found on 'slide-0'. Available shapes: shape-0, shape-1, shape-4
  - Slide 'slide-999' not found in inventory

ERROR: Replacement text made overflow worse in these shapes:
  - slide-0/shape-2: overflow worsened by 1.25" (was 0.00", now 1.25")

line_spacing

"paragraphs": [
  {
    "text": "New presentation title text",
    "alignment": "CENTER",
    "bold": true
  },
  {
    "text": "Section Header",
    "bold": true
  },
  {
    "text": "First bullet point without bullet symbol",
    "bullet": true,
    "level": 0
  },
  {
    "text": "Red colored text",
    "color": "FF0000"
  },
  {
    "text": "Theme colored text",
    "theme_color": "DARK_1"
  },
  {
    "text": "Regular paragraph text without special formatting"
  }
]

{
  "slide-0": {
    "shape-0": {
      "paragraphs": [...] // This shape gets new text
    }
    // shape-1 and shape-2 from inventory will be cleared automatically
  }
}

Pptx Official | Skills Pool

Pptx Official

Pptx Official

PPTX creation, editing, and analysis

Overview

Reading and analyzing content

Text extraction

Raw XML access

Unpacking a file

Key file structures

Typography and color extraction

Creating a new PowerPoint presentation without a template

Design Principles

Color Palette Selection

Visual Details Options

Layout Tips

Workflow

Editing an existing PowerPoint presentation

Workflow

Creating a new PowerPoint presentation using a template

Workflow

Creating Thumbnail Grids

Converting Slides to Images

Code Style Guidelines

Dependencies

When to Use

Limitations

Feishu Doc

Summarize

Nano Pdf

Diffs

Customs Trade Compliance

Nutrient Document Processing