AgentSkillsCN

pptx

演示文稿的创建、编辑与分析。当Claude需要处理演示文稿（.pptx文件）时，可用于：(1) 创建新演示文稿；(2) 修改或编辑内容；(3) 调整版式布局；(4) 添加评论或演讲者备注，或完成其他演示文稿相关任务。

SKILL.md
--- frontmatter
name: pptx
description: "Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks"
license: Proprietary. LICENSE.txt has complete terms

Overview

When creating a new PowerPoint presentation from scratch, use the html2pptx workflow to convert HTML slides to PowerPoint with accurate positioning.

html2pptx Workflow

  1. •Reading and analyzing content.
  2. •MANDATORY - READ ENTIRE FILE: Read html2pptx.md completely from start to finish. NEVER set any range limits when reading this file. Read the full file content for detailed syntax, critical formatting rules, and best practices before proceeding with presentation creation.
  3. •Create an HTML file for each slide with proper dimensions (e.g., 720pt × 405pt for 16:9)
    • •Use <p>, <h1>-<h6>, <ul>, <ol> for all text content
    • •Use class="placeholder" for areas where charts/tables will be added (render with gray background for visibility)
    • •CRITICAL: Rasterize gradients and icons as PNG images FIRST using Sharp, then reference in HTML
    • •LAYOUT: For slides with charts/tables/images, use either full-slide layout or two-column layout for better readability
  4. •Create and run a JavaScript file using the html2pptx.js library to convert HTML slides to PowerPoint and save the presentation
    • •Use the html2pptx() function to process each HTML file
    • •Add charts and tables to placeholder areas using PptxGenJS API
    • •Save the presentation using pptx.writeFile()
  5. •Visual validation: Generate thumbnails and inspect for layout issues
    • •Create thumbnail grid: python scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 --width 1000 --dpi 300
    • •Read and carefully examine the thumbnail image for:
      • •Text cutoff: Text being cut off by header bars, shapes, or slide edges
      • •Text overlap: Text overlapping with other text or shapes
      • •Positioning issues: Content too close to slide boundaries or other elements
      • •Contrast issues: Insufficient contrast between text and backgrounds
    • •If issues found, adjust HTML margins/spacing/colors and regenerate the presentation
    • •Repeat until all slides are visually correct

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:

bash
# 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.

Unpacking a file

python3 {baseDir}/ooxml/scripts/unpack.py <office_file> <output_dir>

Note: Use {baseDir} as the absolute skill root (directory containing SKILL.md). Avoid hard-coded repo-relative paths.

Key file structures

  • •ppt/presentation.xml - Main presentation metadata and slide references
  • •ppt/slides/slide{N}.xml - Individual slide contents (slide1.xml, slide2.xml, etc.)
  • •ppt/notesSlides/notesSlide{N}.xml - Speaker notes for each slide
  • •ppt/comments/modernComment_*.xml - Comments for specific slides
  • •ppt/slideLayouts/ - Layout templates for slides
  • •ppt/slideMasters/ - Master slide templates
  • •ppt/theme/ - Theme and styling information
  • •ppt/media/ - Images and other media files

Typography and color extraction

When given an example design to emulate: Always analyze the presentation's typography and colors first using the methods below:

  1. •Read theme file: Check ppt/theme/theme1.xml for colors (<a:clrScheme>) and fonts (<a:fontScheme>)
  2. •Sample slide content: Examine ppt/slides/slide1.xml for actual font usage (<a:rPr>) and colors
  3. •Search for patterns: Use grep to find color (<a:solidFill>, <a:srgbClr>) and font references across all XML files

Design Principles

CRITICAL: Before creating any presentation, analyze the content and choose appropriate design elements:

  1. •Consider the subject matter: What is this presentation about? What tone, industry, or mood does it suggest?
  2. •Check for branding: If the user mentions a company/organization, consider their brand colors and identity
  3. •Match palette to content: Select colors that reflect the subject
  4. •State your approach: Explain your design choices before writing code

Requirements:

  • •✅ State your content-informed design approach BEFORE writing code
  • •✅ 根据内容语言选择字体:
    • •中文/CJK: Microsoft YaHei（微软雅黑）, Noto Sans SC, Source Han Sans（思源黑体）, PingFang SC, Arial（带CJK回退）
    • •技术/代码: JetBrains Mono, Menlo, Consolas（仅用于数字/代码，非正文）
  • •✅ Create clear visual hierarchy through size, weight, and color
  • •✅ Ensure readability: strong contrast, appropriately sized text, clean alignment
  • •✅ Be consistent: repeat patterns, spacing, and visual language across slides

Color Palette Selection

Choosing colors creatively:

  • •Think beyond defaults: What colors genuinely match this specific topic? Avoid autopilot choices.
  • •Consider multiple angles: Topic, industry, mood, energy level, target audience, brand identity (if mentioned)
  • •Be adventurous: Try unexpected combinations - a healthcare presentation doesn't have to be green, finance doesn't have to be navy
  • •Build your palette: Pick 3-5 colors that work together (dominant colors + supporting tones + accent)
  • •Ensure contrast: Text must be clearly readable on backgrounds

Example color palettes (use these to spark creativity - choose one, adapt it, or create your own):

  1. •Classic Blue: Deep navy (#1C2833), slate gray (#2E4053), silver (#AAB7B8), off-white (#F4F6F6)
  2. •Teal & Coral: Teal (#5EA8A7), deep teal (#277884), coral (#FE4447), white (#FFFFFF)
  3. •Bold Red: Red (#C0392B), bright red (#E74C3C), orange (#F39C12), yellow (#F1C40F), green (#2ECC71)
  4. •Warm Blush: Mauve (#A49393), blush (#EED6D3), rose (#E8B4B8), cream (#FAF7F2)
  5. •Burgundy Luxury: Burgundy (#5D1D2E), crimson (#951233), rust (#C15937), gold (#997929)
  6. •Deep Purple & Emerald: Purple (#B165FB), dark blue (#181B24), emerald (#40695B), white (#FFFFFF)
  7. •Cream & Forest Green: Cream (#FFE1C7), forest green (#40695B), white (#FCFCFC)
  8. •Pink & Purple: Pink (#F8275B), coral (#FF574A), rose (#FF737D), purple (#3D2F68)
  9. •Lime & Plum: Lime (#C5DE82), plum (#7C3A5F), coral (#FD8C6E), blue-gray (#98ACB5)
  10. •Black & Gold: Gold (#BF9A4A), black (#000000), cream (#F4F6F6)
  11. •Sage & Terracotta: Sage (#87A96B), terracotta (#E07A5F), cream (#F4F1DE), charcoal (#2C2C2C)
  12. •Charcoal & Red: Charcoal (#292929), red (#E33737), light gray (#CCCBCB)
  13. •Vibrant Orange: Orange (#F96D00), light gray (#F2F2F2), charcoal (#222831)
  14. •Forest Green: Black (#191A19), green (#4E9F3D), dark green (#1E5128), white (#FFFFFF)
  15. •Retro Rainbow: Purple (#722880), pink (#D72D51), orange (#EB5C18), amber (#F08800), gold (#DEB600)
  16. •Vintage Earthy: Mustard (#E3B448), sage (#CBD18F), forest green (#3A6B35), cream (#F4F1DE)
  17. •Coastal Rose: Old rose (#AD7670), beaver (#B49886), eggshell (#F3ECDC), ash gray (#BFD5BE)
  18. •Orange & Turquoise: Light orange (#FC993E), grayish turquoise (#667C6F), white (#FCFCFC)

Visual Details Options

Geometric Patterns:

  • •Diagonal section dividers instead of horizontal
  • •Asymmetric column widths (30/70, 40/60, 25/75)
  • •Circular/hexagonal frames for images
  • •Triangular accent shapes in corners
  • •Overlapping shapes for depth

Border & Frame Treatments:

  • •Thick single-color borders (10-20pt) on one side only
  • •Double-line borders with contrasting colors
  • •Corner brackets instead of full frames
  • •L-shaped borders (top+left or bottom+right)
  • •Underline accents beneath headers (3-5pt thick)
  • •⚠️ 使用保守的padding: 20-30pt（顶部/侧边），60-90pt（底部）
  • •⚠️ 底部安全区: 0.6-0.7"（考虑到更高的字符框）

Typography Treatments:

  • •极端尺寸对比。保持层级但正文≥16-18pt, 标题28-44pt
  • •Numbered sections in oversized display type
  • •Monospace (Courier New) for data/stats/technical content.仅用于独立数字/代码；中文保持CJK字体，单独调整行高
  • •Outlined text for emphasis

Chart & Data Styling:

  • •Monochrome charts with single accent color for key data
  • •Horizontal bar charts instead of vertical
  • •Dot plots instead of bar charts
  • •Minimal gridlines or none at all
  • •Data labels directly on elements (no legends)
  • •Oversized numbers for key metrics

Layout Innovations:

  • •Full-bleed images with text overlays
  • •Sidebar column (20-30% width) for navigation/context
  • •Modular grid systems (3×3, 4×4 blocks)
  • •Z-pattern or F-pattern content flow
  • •Floating text boxes over colored shapes
  • •Magazine-style multi-column layouts

Background Treatments:

  • •Solid color blocks occupying 40-60% of slide
  • •Gradient fills (vertical or diagonal only)
  • •Split backgrounds (two colors, diagonal or vertical)
  • •Edge-to-edge color bands
  • •Negative space as a design element

Layout Tips

When creating slides with charts or tables:

  • •Two-column layout (PREFERRED): Use a header spanning the full width, then two columns below - text/bullets in one column and the featured content in the other. This provides better balance and makes charts/tables more readable. Use flexbox with unequal column widths (e.g., 40%/60% split) to optimize space for each content type.
  • •Full-slide layout: Let the featured content (chart/table) take up the entire slide for maximum impact and readability
  • •NEVER vertically stack: Do not place charts/tables below text in a single column - this causes poor readability and layout issues

Use Cases

  • •从零创建高保真演示文稿（HTML→PPTX）
  • •批量替换/整理现有 PPT 文本与结构
  • •解析 OOXML 进行注释、备注、样式级编辑
  • •通过缩略图与校验脚本做交付前质检

Run

bash
# 读取与解包
python3 {baseDir}/ooxml/scripts/unpack.py input.pptx ./workspace/unpacked

# 生成与预览（示例）
node {baseDir}/scripts/html2pptx.js
python3 {baseDir}/scripts/thumbnail.py output.pptx workspace/thumbnails --cols 4 --width 1000 --dpi 300

Inputs

  • •源素材（文案、图表数据、品牌规范）
  • •版式约束（页尺寸、页数、信息层级）
  • •质量目标（可读性、对比度、边距安全区）
  • •可选：原始 PPTX 用于增量编辑

Outputs

  • •生成后的 .pptx 文件
  • •质检产物（缩略图、inventory、验证结果）
  • •必要时的 OOXML 解包目录与差异文件

Safety

  • •严禁跳过关键可读性检查（遮挡、溢出、对比度）
  • •涉及模板复用时先确认许可与版权边界
  • •修改 OOXML 前后都进行结构验证，避免损坏文件
  • •保留可回退中间产物（unpack 目录与脚本）

Version

  • •Template-Version: 1.0
  • •Last-Updated: 2026-02-17