tomevault-io PPT Generator
This skill enables comprehensive PowerPoint presentation management through multiple approaches:
- Python-based Creation: Use python-pptx library for programmatic generation with professional styling
- Direct OOXML Editing: Unpack, modify XML content, and repack PPTX files for advanced control
- Template-based Workflow: Leverage existing templates with content replacement
PPTX files are ZIP archives containing XML files and resources. This architecture enables both high-level creation and low-level manipulation.
Core Capabilities
Creating Presentations
- Generate from scratch with python-pptx
- Multiple color schemes (FeedMob, Binance, Professional, Modern, Corporate)
- Automatic background selection based on content
- Smart logo insertion for brand consistency
- Professional typography and layouts
Editing Presentations
- Unpack PPTX to access raw XML
- Modify slide content, layouts, and structure
- Rearrange, duplicate, or delete slides
- Replace text and images programmatically
- Repack into valid PPTX format
Analyzing Presentations
- Extract text content as markdown
- Access raw XML for comments and notes
- Examine slide layouts and structure
- Validate presentation integrity
Instructions
When invoked, this skill will:
- Understand Requirements: Analyze what presentation operation is needed
- Select Approach: Choose creation, editing, or analysis workflow
- Apply Design Principles: Use content-informed design with proper hierarchy
- Execute Operations: Run appropriate tools (python-pptx, XML manipulation, etc.)
- Validate Output: Ensure generated PPTX is valid and properly formatted
Features
Core Capabilities
- Create new presentations: Generate fresh PowerPoint files with professional styling
- Multiple color schemes: Choose from FeedMob, Binance (default), professional, modern, or corporate themes
- FeedMob branding: Native support for FeedMob color scheme with custom slide layouts
- Footer logo: Automatic FeedMob logo placement in footer (bottom-right) on every slide
- Advanced layouts: Create section headers, comparison slides, two-column layouts, metrics dashboards
- Typography: Professional fonts (Arial) with consistent sizing and colors
- Image effects: Add shadows, proper sizing, and positioning for images
- Background styling: Gradient backgrounds and image support for title slides
- Professional templates: Corporate-quality slide designs with company-specific styling
NEW: Professional Design Principles Integration
Intelligent Background & Logo System
- Automatic background selection: Choose appropriate background images based on slide content keywords
- Smart logo insertion: Automatically add logos to slides without backgrounds for brand consistency
- Content-aware matching: Backgrounds selected by analyzing slide titles and content for context
- Flexible control: Enable/disable automatic backgrounds and logos via command line or JSON
- Professional positioning: Logos placed strategically (bottom-right by default) with transparency
- Theme consistency: Backgrounds and logos complement the chosen color scheme
Design Principles Implementation
- 6x6 Rule: Automatically optimize content to maximum 6 lines per slide, 6 words per line
- Typography Standards: Title ≥28pt, Body ≥18pt with Arial sans-serif font
- 60-30-10 Color Rule: 60% primary color, 30% secondary, 10% accent for visual harmony
- Visual Hierarchy: Automatic emphasis for first items, action words, and metrics with colors
- Grid Alignment System: 12x8 grid for precise element positioning and balance
- White Space Optimization: 20% minimum margins for improved readability
- Content Simplification: Automatic truncation of long text with ellipsis for clarity
Background Selection Logic
The system intelligently selects backgrounds based on content:
- Business/Professional: Uses corporate-style backgrounds (bg4.jpg, bg5.jpg)
- Technology/Digital: Uses tech-themed backgrounds (bg2.png, bg3.png)
- Analytics/Data: Uses data-visualization backgrounds (bg3.png)
- Marketing/Growth: Uses marketing-focused backgrounds (bg1.jpg)
- General Content: Uses appropriate backgrounds for overviews, introductions, features, benefits
Logo Features
Important: All FeedMob logo assets should be obtained from the feedmob-brand-guidelines skill, which contains official FeedMob logo files in its assets/logos/ directory:
feedmob-logo-black-teal.svg- Black text + teal plus (for white backgrounds)feedmob-logo-white-teal.svg- White text + teal plus (for dark backgrounds)feedmob-plus-icon-teal.svg- Standalone teal plus icon (design element)
Footer Logo (Always Present):
- Automatically added to ALL slides in the footer area
- Position: Bottom-right corner (0.8x0.8 inches)
- Logo: Use FeedMob brand logo from feedmob-brand-guidelines skill
- Purpose: Consistent branding across entire presentation
Content Logo (Optional):
- Added to: Content slides, comparison slides, visual content, two-column layouts
- Not added to: Title slides, section headers, metrics dashboards, slides with existing backgrounds
- Positioning: Bottom-right corner with subtle transparency
- Selection: Use appropriate logo from feedmob-brand-guidelines skill based on background color (when auto_logos enabled)
Enhanced Slide Types
- FeedMob title slides: Gradient backgrounds with orange accent bars and 52pt white titles
- FeedMob content slides: Blue accent bar with gray title background and green bullet points
- Professional title slides: Solid color background with large 54pt titles (Binance style)
- Visual content slides: Bullet points with image support and colored accent bars
- Metrics dashboard slides: Grid layout with colorful KPI boxes (up to 4 metrics)
- Content slides: Professional bullet points with consistent styling
- Section headers: Eye-catching gradient backgrounds
- Comparison slides: Side-by-side content with colored backgrounds
- Two-column slides: Balanced content layout
- Blank slides: Canvas for custom layouts with shapes and text
Supported Operations
- Apply professional color schemes (FeedMob, Binance, Professional, Modern, Corporate)
- Create FeedMob-branded title slides with gradient backgrounds
- Create FeedMob content slides with custom styling
- Create professional title slides with solid color backgrounds
- Create metrics dashboards with colorful KPI boxes
- Create visual content slides with images and accent bars
- Add section headers with gradient backgrounds
- Generate comparison and two-column layouts
- Style text with professional Arial fonts and colors
- Add images with shadow effects
- Create custom shapes with text
- Format text with consistent typography
JSON Configuration (Enhanced)
The JSON format now supports automatic background and logo control:
{
"color_scheme": "feedmob",
"auto_backgrounds": true,
"auto_logos": true,
"slides": [
{
"type": "title",
"title": "Company Overview"
},
{
"type": "content",
"title": "Technology Features",
"content": ["Cloud platform", "Real-time analytics", "Mobile support"]
}
]
}
JSON Options
- auto_backgrounds (boolean): Enable automatic background selection (default: true)
- auto_logos (boolean): Enable automatic logo insertion (default: true)
Implementation
The skill uses Python with the python-pptx library to process PowerPoint files. Run the processing script:
python scripts/create_ppt.py [options]
Script Usage
The script supports multiple ways to create presentations:
1. Simple command-line creation:
python scripts/create_ppt.py --output presentation.pptx --title "My Presentation"
2. JSON-based content definition:
python scripts/create_ppt.py --output presentation.pptx --json slides.json
3. Enhanced command-line creation with color scheme:
python scripts/create_ppt.py --output presentation.pptx --title "My Presentation" --color-scheme feedmob
4. Presentation with background image:
python scripts/create_ppt.py --output presentation.pptx --title "My Presentation" --background-image "bg.jpg"
5. Presentation with automatic backgrounds and logos (NEW):
python scripts/create_ppt.py --output presentation.pptx --title "My Presentation" --color-scheme feedmob
6. Disable automatic backgrounds or logos:
python scripts/create_ppt.py --output presentation.pptx --title "My Presentation" --no-auto-backgrounds
python scripts/create_ppt.py --output presentation.pptx --title "My Presentation" --no-auto-logos
The script will:
- Create a new PowerPoint presentation with professional styling
- Apply FeedMob or Binance color scheme by default (or selected alternative theme)
- NEW: Automatically select background images based on slide content (enabled by default)
- NEW: Automatically add logos to slides without backgrounds (enabled by default)
- Add slides with enhanced typography and layout
- Insert text and images with proper formatting
- Save the final .pptx file
- Handle errors gracefully with clear messages
Usage Examples
Create a FeedMob-branded presentation:
Create a PowerPoint presentation about FeedMob platform using FeedMob color scheme
Create a professional presentation:
Create a PowerPoint presentation about project status (uses Binance style by default)
Add slides with enhanced styling:
Generate a PPT with title slide and 3 content slides about quarterly results (uses FeedMob styling)
Create presentation with section headers:
Make a PowerPoint from this outline: Introduction, Features, Benefits, Conclusion with section headers (uses FeedMob theme)
Create comparison slides:
Create a presentation comparing our product vs competitors using FeedMob colors
Add images with effects:
Create a FeedMob presentation and add the logo image to the title slide with shadow effects
Requirements
- Python 3.6 or higher
- python-pptx library (>=0.6.21)
- Image files must exist at specified paths (for image insertion)
Output
- A .pptx file saved to the specified location
- Standard PowerPoint format compatible with Microsoft PowerPoint, LibreOffice, and Google Slides
- Preserves all formatting and layout settings
OOXML Direct Manipulation
For advanced editing beyond python-pptx capabilities, directly manipulate the OOXML structure:
Unpacking PPTX
# PPTX files are ZIP archives
unzip presentation.pptx -d unpacked/
Key OOXML Files
ppt/presentation.xml- Slide order and IDsppt/slides/slide*.xml- Individual slide contentppt/slideLayouts/- Layout templatesppt/media/- Embedded images[Content_Types].xml- File type declarationsppt/_rels/presentation.xml.rels- Slide relationships
Common Operations
Rearrange Slides: Modify <p:sldId> sequence in presentation.xml
Replace Text: Edit text within <a:t> tags in slide XML files
Duplicate Slides: Copy slide XML and update IDs in relationships
Delete Slides: Remove references from presentation.xml, relationships, and Content_Types
Repacking PPTX
cd unpacked/
zip -r ../modified.pptx * -x "*.DS_Store"
Critical: Validate OOXML structure before repacking. Incorrect XML causes corrupted files.
Design Principles
Follow these principles for professional presentations:
Content-Informed Design
- Design should serve content, not overshadow it
- Use strong visual hierarchy
- Maintain readable contrast (WCAG AA minimum)
- Use web-safe fonts (Arial, Helvetica, Times New Roman, Georgia)
Typography Standards
- Title: ≥28pt for readability
- Body: ≥18pt minimum
- Consistent font family throughout
- Limited font variations (2-3 weights max)
Color Guidelines
- 60-30-10 Rule: 60% primary, 30% secondary, 10% accent
- Maximum 4 colors per chart
- Consistent color mapping across visualizations
- Test contrast ratios for accessibility
Layout Optimization
- 6x6 Rule: Max 6 lines per slide, 6 words per line
- 20% Margins: Minimum white space for readability
- Grid Alignment: Use 12x8 grid for element positioning
- Visual Balance: Distribute weight evenly across slide
Recommended Color Palettes
Choose palettes that match presentation tone:
Professional Business: Navy (#1a3a5c), Gray (#6b7280), Blue (#3b82f6) Technology: Teal (#00B5AD), Purple (#8b5cf6), Cyan (#06b6d4) Corporate: Charcoal (#374151), Gold (#f59e0b), White (#ffffff) Modern: Black (#000000), Coral (#EE6969), Mint (#10b981)
Best Practices
Planning
- Define Structure First: Outline slide flow before detailed content
- Content-Informed Design: Let content guide design choices
- Consistent Theme: Maintain visual consistency throughout
Implementation
- Use Appropriate Tools: python-pptx for creation, OOXML for complex edits
- Validate Early: Check output after each major change
- Keep Text Concise: Follow 6x6 rule for readability
- Optimize Assets: Compress images before insertion
Quality Assurance
- Test Compatibility: Open in PowerPoint, LibreOffice, Google Slides
- Check Accessibility: Verify contrast ratios and font sizes
- Validate OOXML: Ensure no corrupted relationships or missing files
- Review on Device: Test on actual presentation display
Requirements
Python Environment:
- Python 3.6+
- python-pptx >= 0.6.21
Optional Tools:
- markitdown (text extraction)
- unzip/zip (OOXML manipulation)
- LibreOffice (validation and conversion)
For OOXML manipulation details, see REFERENCE.md.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.