feedmob-presentations

name	feedmob-presentations
description	Create, edit, and analyze PowerPoint presentations with professional styling, themes, and layouts. Supports python-pptx for creation and OOXML manipulation for advanced editing.
allowed-tools	Read, Write, Bash

PPT Generator

This skill enables comprehensive PowerPoint presentation management through multiple approaches:

1. Python-based Creation: Use python-pptx library for programmatic generation with professional styling
2. Direct OOXML Editing: Unpack, modify XML content, and repack PPTX files for advanced control
3. 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:

1. Understand Requirements: Analyze what presentation operation is needed
2. Select Approach: Choose creation, editing, or analysis workflow
3. Apply Design Principles: Use content-informed design with proper hierarchy
4. Execute Operations: Run appropriate tools (python-pptx, XML manipulation, etc.)
5. 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 IDs
• ppt/slides/slide*.xml - Individual slide content
• ppt/slideLayouts/ - Layout templates
• ppt/media/ - Embedded images
• [Content_Types].xml - File type declarations
• ppt/_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.