Claude Skill

pptx

Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download eigent-ai-eigent-resources_example-skills_pptx-5aa1c64.zip · 162 KB

Install

skills CLI npx skills add https://github.com/eigent-ai/eigent/tree/main/resources/example-skills/pptx
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install eigent-ai-eigent@llmmart
Git git clone https://github.com/eigent-ai/eigent.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole eigent-ai/eigent collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

PPTX Skill

Quick Reference

Task Guide
Read/analyze content python -m markitdown presentation.pptx
Edit or create from template Read editing.md
Create from scratch Read pptxgenjs.md

Reading Content

# Text extraction
python -m markitdown presentation.pptx

# Visual overview
python scripts/thumbnail.py presentation.pptx

# Raw XML
python scripts/office/unpack.py presentation.pptx unpacked/

Editing Workflow

Read editing.md for full details.

  1. Analyze template with thumbnail.py
  2. Unpack → manipulate slides → edit content → clean → pack

Creating from Scratch

Read pptxgenjs.md for full details.

Use when no template or reference presentation is available.


Design Ideas

Don't create boring slides. Plain bullets on a white background won't impress anyone. Consider ideas from this list for each slide.

Before Starting

  • Pick a bold, content-informed color palette: The palette should feel designed for THIS topic. If swapping your colors into a completely different presentation would still "work," you haven't made specific enough choices.
  • Dominance over equality: One color should dominate (60-70% visual weight), with 1-2 supporting tones and one sharp accent. Never give all colors equal weight.
  • Dark/light contrast: Dark backgrounds for title + conclusion slides, light for content ("sandwich" structure). Or commit to dark throughout for a premium feel.
  • Commit to a visual motif: Pick ONE distinctive element and repeat it — rounded image frames, icons in colored circles, thick single-side borders. Carry it across every slide.

Color Palettes

Choose colors that match your topic — don't default to generic blue. Use these palettes as inspiration:

Theme Primary Secondary Accent
Midnight Executive 1E2761 (navy) CADCFC (ice blue) FFFFFF (white)
Forest & Moss 2C5F2D (forest) 97BC62 (moss) F5F5F5 (cream)
Coral Energy F96167 (coral) F9E795 (gold) 2F3C7E (navy)
Warm Terracotta B85042 (terracotta) E7E8D1 (sand) A7BEAE (sage)
Ocean Gradient 065A82 (deep blue) 1C7293 (teal) 21295C (midnight)
Charcoal Minimal 36454F (charcoal) F2F2F2 (off-white) 212121 (black)
Teal Trust 028090 (teal) 00A896 (seafoam) 02C39A (mint)
Berry & Cream 6D2E46 (berry) A26769 (dusty rose) ECE2D0 (cream)
Sage Calm 84B59F (sage) 69A297 (eucalyptus) 50808E (slate)
Cherry Bold 990011 (cherry) FCF6F5 (off-white) 2F3C7E (navy)

For Each Slide

Every slide needs a visual element — image, chart, icon, or shape. Text-only slides are forgettable.

Layout options:

  • Two-column (text left, illustration on right)
  • Icon + text rows (icon in colored circle, bold header, description below)
  • 2x2 or 2x3 grid (image on one side, grid of content blocks on other)
  • Half-bleed image (full left or right side) with content overlay

Data display:

  • Large stat callouts (big numbers 60-72pt with small labels below)
  • Comparison columns (before/after, pros/cons, side-by-side options)
  • Timeline or process flow (numbered steps, arrows)

Visual polish:

  • Icons in small colored circles next to section headers
  • Italic accent text for key stats or taglines

Typography

Choose an interesting font pairing — don't default to Arial. Pick a header font with personality and pair it with a clean body font.

Header Font Body Font
Georgia Calibri
Arial Black Arial
Calibri Calibri Light
Cambria Calibri
Trebuchet MS Calibri
Impact Arial
Palatino Garamond
Consolas Calibri
Element Size
Slide title 36-44pt bold
Section header 20-24pt bold
Body text 14-16pt
Captions 10-12pt muted

Spacing

  • 0.5" minimum margins
  • 0.3-0.5" between content blocks
  • Leave breathing room—don't fill every inch

Avoid (Common Mistakes)

  • Don't repeat the same layout — vary columns, cards, and callouts across slides
  • Don't center body text — left-align paragraphs and lists; center only titles
  • Don't skimp on size contrast — titles need 36pt+ to stand out from 14-16pt body
  • Don't default to blue — pick colors that reflect the specific topic
  • Don't mix spacing randomly — choose 0.3" or 0.5" gaps and use consistently
  • Don't style one slide and leave the rest plain — commit fully or keep it simple throughout
  • Don't create text-only slides — add images, icons, charts, or visual elements; avoid plain title + bullets
  • Don't forget text box padding — when aligning lines or shapes with text edges, set margin: 0 on the text box or offset the shape to account for padding
  • Don't use low-contrast elements — icons AND text need strong contrast against the background; avoid light text on light backgrounds or dark text on dark backgrounds
  • NEVER use accent lines under titles — these are a hallmark of AI-generated slides; use whitespace or background color instead

QA (Required)

Assume there are problems. Your job is to find them.

Your first render is almost never correct. Approach QA as a bug hunt, not a confirmation step. If you found zero issues on first inspection, you weren't looking hard enough.

Content QA

python -m markitdown output.pptx

Check for missing content, typos, wrong order.

When using templates, check for leftover placeholder text:

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

If grep returns results, fix them before declaring success.

Visual QA

Verification Loop

  1. Generate slides → Convert to images → Inspect
  2. List issues found (if none found, look again more critically)
  3. Fix issues
  4. Re-verify affected slides — one fix often creates another problem
  5. Repeat until a full pass reveals no new issues

Do not declare success until you've completed at least one fix-and-verify cycle.


Converting to Images

Convert presentations to individual slide images for visual inspection:

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

This creates slide-01.jpg, slide-02.jpg, etc.

To re-render specific slides after fixes:

pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed

Dependencies

  • pip install "markitdown[pptx]" - text extraction
  • pip install Pillow - thumbnail grids
  • npm install -g pptxgenjs - creating from scratch
  • LibreOffice (soffice) - PDF conversion (auto-configured for sandboxed environments via scripts/office/soffice.py)
  • Poppler (pdftoppm) - PDF to images
Files (eigent)
  • scripts
    • office
      • helpers
        • merge_runs.py 6.1 KB
          Loading…
        • simplify_redlines.py 6.3 KB
          Loading…
        • __init__.py 695 B
          Loading…
      • schemas
        • ecma
          • fouth-edition
            • opc-contentTypes.xsd 1.9 KB · in bundle
            • opc-coreProperties.xsd 2.5 KB · in bundle
            • opc-digSig.xsd 2.8 KB · in bundle
            • opc-relationships.xsd 1.3 KB · in bundle
        • ISO-IEC29500-4_2016
          • dml-chart.xsd 73.2 KB · in bundle
          • dml-chartDrawing.xsd 6.8 KB · in bundle
          • dml-diagram.xsd 50.1 KB · in bundle
          • dml-lockedCanvas.xsd 624 B · in bundle
          • dml-main.xsd 148.5 KB · in bundle
          • dml-picture.xsd 1.2 KB · in bundle
          • dml-spreadsheetDrawing.xsd 8.7 KB · in bundle
          • dml-wordprocessingDrawing.xsd 14.4 KB · in bundle
          • pml.xsd 81.7 KB · in bundle
          • shared-additionalCharacteristics.xsd 1.2 KB · in bundle
          • shared-bibliography.xsd 7.2 KB · in bundle
          • shared-commonSimpleTypes.xsd 6.2 KB · in bundle
          • shared-customXmlDataProperties.xsd 1.2 KB · in bundle
          • shared-customXmlSchemaProperties.xsd 880 B · in bundle
          • shared-documentPropertiesCustom.xsd 2.5 KB · in bundle
          • shared-documentPropertiesExtended.xsd 3.4 KB · in bundle
          • shared-documentPropertiesVariantTypes.xsd 7.3 KB · in bundle
          • shared-math.xsd 22.8 KB · in bundle
          • shared-relationshipReference.xsd 1.3 KB · in bundle
          • sml.xsd 236.6 KB · in bundle
          • vml-main.xsd 25.5 KB · in bundle
          • vml-officeDrawing.xsd 24.7 KB · in bundle
          • vml-presentationDrawing.xsd 535 B · in bundle
          • vml-spreadsheetDrawing.xsd 5.6 KB · in bundle
          • vml-wordprocessingDrawing.xsd 3.9 KB · in bundle
          • wml.xsd 167.4 KB · in bundle
          • xml.xsd 4.5 KB · in bundle
        • mce
          • mc.xsd 3.1 KB · in bundle
        • microsoft
          • wml-2010.xsd 25.9 KB · in bundle
          • wml-2012.xsd 3.7 KB · in bundle
          • wml-2018.xsd 901 B · in bundle
          • wml-cex-2018.xsd 1.7 KB · in bundle
          • wml-cid-2016.xsd 1002 B · in bundle
          • wml-sdtdatahash-2020.xsd 600 B · in bundle
          • wml-symex-2015.xsd 745 B · in bundle
      • validators
        • base.py 32.6 KB
          Loading…
        • docx.py 16.7 KB
          Loading…
        • pptx.py 10.3 KB
          Loading…
        • redlining.py 9.4 KB
          Loading…
        • __init__.py 1 KB
          Loading…
      • pack.py 5.6 KB
        Loading…
      • soffice.py 5.9 KB
        Loading…
      • unpack.py 4.6 KB
        Loading…
      • validate.py 4.3 KB
        Loading…
    • add_slide.py 7.4 KB
      Loading…
    • clean.py 10 KB
      Loading…
    • thumbnail.py 9.3 KB
      Loading…
    • __init__.py 695 B
      Loading…
  • editing.md 6.2 KB
    Loading…
  • LICENSE.txt 1.4 KB
    Loading…
  • pptxgenjs.md 12.5 KB
    Loading…
  • SKILL.md 7.6 KB
    ---
    name: pptx
    description: "Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill."
    license: Proprietary. LICENSE.txt has complete terms
    ---
    
    # PPTX Skill
    
    ## Quick Reference
    
    | Task | Guide |
    |------|-------|
    | Read/analyze content | `python -m markitdown presentation.pptx` |
    | Edit or create from template | Read [editing.md](editing.md) |
    | Create from scratch | Read [pptxgenjs.md](pptxgenjs.md) |
    
    ---
    
    ## Reading Content
    
    ```bash
    # Text extraction
    python -m markitdown presentation.pptx
    
    # Visual overview
    python scripts/thumbnail.py presentation.pptx
    
    # Raw XML
    python scripts/office/unpack.py presentation.pptx unpacked/
    ```
    
    ---
    
    ## Editing Workflow
    
    **Read [editing.md](editing.md) for full details.**
    
    1. Analyze template with `thumbnail.py`
    2. Unpack → manipulate slides → edit content → clean → pack
    
    ---
    
    ## Creating from Scratch
    
    **Read [pptxgenjs.md](pptxgenjs.md) for full details.**
    
    Use when no template or reference presentation is available.
    
    ---
    
    ## Design Ideas
    
    **Don't create boring slides.** Plain bullets on a white background won't impress anyone. Consider ideas from this list for each slide.
    
    ### Before Starting
    
    - **Pick a bold, content-informed color palette**: The palette should feel designed for THIS topic. If swapping your colors into a completely different presentation would still "work," you haven't made specific enough choices.
    - **Dominance over equality**: One color should dominate (60-70% visual weight), with 1-2 supporting tones and one sharp accent. Never give all colors equal weight.
    - **Dark/light contrast**: Dark backgrounds for title + conclusion slides, light for content ("sandwich" structure). Or commit to dark throughout for a premium feel.
    - **Commit to a visual motif**: Pick ONE distinctive element and repeat it — rounded image frames, icons in colored circles, thick single-side borders. Carry it across every slide.
    
    ### Color Palettes
    
    Choose colors that match your topic — don't default to generic blue. Use these palettes as inspiration:
    
    | Theme | Primary | Secondary | Accent |
    |-------|---------|-----------|--------|
    | **Midnight Executive** | `1E2761` (navy) | `CADCFC` (ice blue) | `FFFFFF` (white) |
    | **Forest & Moss** | `2C5F2D` (forest) | `97BC62` (moss) | `F5F5F5` (cream) |
    | **Coral Energy** | `F96167` (coral) | `F9E795` (gold) | `2F3C7E` (navy) |
    | **Warm Terracotta** | `B85042` (terracotta) | `E7E8D1` (sand) | `A7BEAE` (sage) |
    | **Ocean Gradient** | `065A82` (deep blue) | `1C7293` (teal) | `21295C` (midnight) |
    | **Charcoal Minimal** | `36454F` (charcoal) | `F2F2F2` (off-white) | `212121` (black) |
    | **Teal Trust** | `028090` (teal) | `00A896` (seafoam) | `02C39A` (mint) |
    | **Berry & Cream** | `6D2E46` (berry) | `A26769` (dusty rose) | `ECE2D0` (cream) |
    | **Sage Calm** | `84B59F` (sage) | `69A297` (eucalyptus) | `50808E` (slate) |
    | **Cherry Bold** | `990011` (cherry) | `FCF6F5` (off-white) | `2F3C7E` (navy) |
    
    ### For Each Slide
    
    **Every slide needs a visual element** — image, chart, icon, or shape. Text-only slides are forgettable.
    
    **Layout options:**
    - Two-column (text left, illustration on right)
    - Icon + text rows (icon in colored circle, bold header, description below)
    - 2x2 or 2x3 grid (image on one side, grid of content blocks on other)
    - Half-bleed image (full left or right side) with content overlay
    
    **Data display:**
    - Large stat callouts (big numbers 60-72pt with small labels below)
    - Comparison columns (before/after, pros/cons, side-by-side options)
    - Timeline or process flow (numbered steps, arrows)
    
    **Visual polish:**
    - Icons in small colored circles next to section headers
    - Italic accent text for key stats or taglines
    
    ### Typography
    
    **Choose an interesting font pairing** — don't default to Arial. Pick a header font with personality and pair it with a clean body font.
    
    | Header Font | Body Font |
    |-------------|-----------|
    | Georgia | Calibri |
    | Arial Black | Arial |
    | Calibri | Calibri Light |
    | Cambria | Calibri |
    | Trebuchet MS | Calibri |
    | Impact | Arial |
    | Palatino | Garamond |
    | Consolas | Calibri |
    
    | Element | Size |
    |---------|------|
    | Slide title | 36-44pt bold |
    | Section header | 20-24pt bold |
    | Body text | 14-16pt |
    | Captions | 10-12pt muted |
    
    ### Spacing
    
    - 0.5" minimum margins
    - 0.3-0.5" between content blocks
    - Leave breathing room—don't fill every inch
    
    ### Avoid (Common Mistakes)
    
    - **Don't repeat the same layout** — vary columns, cards, and callouts across slides
    - **Don't center body text** — left-align paragraphs and lists; center only titles
    - **Don't skimp on size contrast** — titles need 36pt+ to stand out from 14-16pt body
    - **Don't default to blue** — pick colors that reflect the specific topic
    - **Don't mix spacing randomly** — choose 0.3" or 0.5" gaps and use consistently
    - **Don't style one slide and leave the rest plain** — commit fully or keep it simple throughout
    - **Don't create text-only slides** — add images, icons, charts, or visual elements; avoid plain title + bullets
    - **Don't forget text box padding** — when aligning lines or shapes with text edges, set `margin: 0` on the text box or offset the shape to account for padding
    - **Don't use low-contrast elements** — icons AND text need strong contrast against the background; avoid light text on light backgrounds or dark text on dark backgrounds
    - **NEVER use accent lines under titles** — these are a hallmark of AI-generated slides; use whitespace or background color instead
    
    ---
    
    ## QA (Required)
    
    **Assume there are problems. Your job is to find them.**
    
    Your first render is almost never correct. Approach QA as a bug hunt, not a confirmation step. If you found zero issues on first inspection, you weren't looking hard enough.
    
    ### Content QA
    
    ```bash
    python -m markitdown output.pptx
    ```
    
    Check for missing content, typos, wrong order.
    
    **When using templates, check for leftover placeholder text:**
    
    ```bash
    python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"
    ```
    
    If grep returns results, fix them before declaring success.
    
    ### Visual QA
    
    ### Verification Loop
    
    1. Generate slides → Convert to images → Inspect
    2. **List issues found** (if none found, look again more critically)
    3. Fix issues
    4. **Re-verify affected slides** — one fix often creates another problem
    5. Repeat until a full pass reveals no new issues
    
    **Do not declare success until you've completed at least one fix-and-verify cycle.**
    
    ---
    
    ## Converting to Images
    
    Convert presentations to individual slide images for visual inspection:
    
    ```bash
    python scripts/office/soffice.py --headless --convert-to pdf output.pptx
    pdftoppm -jpeg -r 150 output.pdf slide
    ```
    
    This creates `slide-01.jpg`, `slide-02.jpg`, etc.
    
    To re-render specific slides after fixes:
    
    ```bash
    pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed
    ```
    
    ---
    
    ## Dependencies
    
    - `pip install "markitdown[pptx]"` - text extraction
    - `pip install Pillow` - thumbnail grids
    - `npm install -g pptxgenjs` - creating from scratch
    - LibreOffice (`soffice`) - PDF conversion (auto-configured for sandboxed environments via `scripts/office/soffice.py`)
    - Poppler (`pdftoppm`) - PDF to images
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.