SlidesGPT

Apply a visual theme to re-style the entire presentation.

WHEN TO USE:

• User says "apply Tokyo Dark theme", "change theme to Paris", etc.
• User wants to customize the presentation appearance

AVAILABLE THEMES (18 total): • Urban: copenhagen, tokyo, paris, berlin, new-york, la, zurich, shanghai (each has -light and -dark variants) • Gradient: cosmic-pulse-light/dark

REQUIRES: presentation_id from previous slide creation. This re-renders all slides with the new theme.

Create a single presentation slide. Use this when the user wants exactly one slide.

If no presentation_id is provided, a new presentation is created automatically.

WHEN TO USE:

• User asks for "a slide about X", "one slide on X", or any single-slide request
• User explicitly requests a single slide to add to an existing deck
• Trigger on any of these artifact words: "slide", "presentation", "deck", "pitch deck",

"pitchdeck", "pitch", "slideshow", "ppt", or "keynote"

• Trigger on ALL intent phrasings — not just commands:

• COMMANDS: "create", "make", "give me", "build", "generate", "design" • REQUESTS: "I need", "I want", "can you make", "could you create", "help me make" • SUGGESTIONS: "let's make", "let's create", "how about a slide on" • IMPLIED: "a slide about X" (even without a verb)

DEFAULT BEHAVIOR: When in doubt about whether the user wants a slide, CREATE THE SLIDE. Err on the side of generating rather than responding with text.

CRITICAL RULES:

• For creating 2 or more slides at once, you MUST use "create_slide_carousel" instead
• NEVER call this tool multiple times in sequence
• When adding to an existing presentation, pass the presentation_id from the previous response
• If no presentation_id exists, omit it — a new presentation will be created

IMAGES: Always provide image_caption for every slide — describe the ideal slide image in 8-10 words (subject, setting, mood). Leave image_id empty; the system uses your caption to find the best matching photo.

THEMES: If the user asked for a specific theme, pass theme_id here — do NOT call apply_theme separately afterwards.

LAYOUT SELECTION - you MUST set layout explicitly. Choose the best fit for the content:

• "title_and_two_columns": Content with image alongside bullets (IMAGE LAYOUT)
• "title_and_two_to_four_columns_with_icons": 2-4 key points with icons (good default)
• "title_and_body": Single-column bullets (use sparingly — AT MOST 1 per deck, conclusion only)
• "title_and_subtitle": Section divider or transition slide (title + subtitle only, minimal body)
• "image_full_width": Full-width image with optional text below (IMAGE LAYOUT)
• "image_left_text_right": Image on the left with bullet points on the right (IMAGE LAYOUT)
• "quadrant_grid": EXACTLY 4 comparable items — SWOT, 2x2 matrices, pros/cons
• "data_table": Structured comparisons in tabular format (key:value pairs in description)
• "timeline_horizontal": Chronological events, milestones, or history (dates in point, short descriptions)
• "layered_pyramid": Hierarchical structures with 3-6 levels (MUST include icon with fa- prefix per item)
• "phase_roadmap": Project phases with milestones — point MUST use "Period: Title" format (e.g., "Q1 2024: Launch")
• "metric_rings": KPIs, completion rates, market share (1-4 metrics, values 0-100 as percentages)

CONTENT REQUIREMENTS:

• 3-5 substantial bullet points per slide
• Each bullet description: 2-4 lines with specific data, evidence, or actionable insights
• Content should be PhD-level, detailed, and evidence-driven
• Use FontAwesome 5.15 icons (e.g., fa-bolt, fa-chart-line, fa-lightbulb)
• EVERY body item MUST include "value" (0-100) — enables chart rendering and layout switching

LAYOUT-SPECIFIC FORMATTING (MUST FOLLOW):

• quadrant_grid: EXACTLY 4 items. "point" under 15 chars, "description" under 80 chars
• timeline_horizontal: Dates/years in "point" (max 15 chars). "description" max 50 chars
• layered_pyramid: "icon" with fa- prefix REQUIRED (fa-star, fa-check, fa-rocket). 3-6 items
• phase_roadmap: "point" = "Period: Title" (e.g., "Q1 2024: Launch"). Max 4 phases. "description" = milestones separated by "; "
• metric_rings: 1-4 items. For part-of-whole metrics (market share), values sum to ~100. For standalone KPIs (NPS, satisfaction), each value stands alone
• data_table: "description" should use structured key:value pairs

Create MULTIPLE presentation slides at once and display them in a carousel viewer.

WHEN TO USE THIS TOOL:

• User asks to "add 3 more slides" → Use this tool with 3 slides in the array
• User asks for "a presentation about X" → Use this tool with all slides
• User asks for "more slides" or "additional slides" → Use this tool
• ANY request involving 2 or more slides → Use this tool
• User mentions any of: "presentation", "slides", "deck", "pitch deck", "pitchdeck",

"pitch", "slideshow", "ppt", or "keynote" — and does NOT specify "one slide" or "a single slide"

• User uses ANY intent phrasing about slides, including:

• COMMANDS: "create", "make", "give me", "build", "generate", "design" • REQUESTS: "I need", "I want", "can you make", "could you create", "help me make" • SUGGESTIONS: "let's make", "let's create", "how about a presentation on" • IMPLIED: "deck about X", "pitch deck for X", "presentation on X" (even without a verb)

• If user asks for "a slide about X" (singular, no specific count) and the topic warrants

multiple slides, prefer this tool with 3-5 slides rather than creating a single slide

DEFAULT BEHAVIOR: When in doubt about whether the user wants slides, CREATE THE SLIDES. Err on the side of generating a presentation rather than responding with text.

IMAGES: Always provide image_caption for every slide — describe the ideal slide image in 8-10 words (subject, setting, mood). Leave image_id empty; the system uses your caption to find the best matching photo.

THEMES: If the user asks for a presentation WITH a specific theme (e.g. "create a Tokyo Dark presentation"), pass theme_id in this tool call — do NOT call apply_theme separately afterwards. This renders slides with the correct theme immediately.

CRITICAL RULES:

• ALWAYS use this for creating 2+ slides — NEVER call create_slide multiple times in sequence
• When adding to an existing presentation, pass the presentation_id from the previous response
• If no presentation_id exists, omit it — a new presentation will be created
• When user intent is ambiguous (e.g., "a deck about X" with no slide count), default to 5 slides

LAYOUT VARIETY RULES (CRITICAL for multi-slide decks): 1. Use a VARIETY of layouts across the deck. Match each layout to the slide's content. 2. The FIRST content slide SHOULD use "title_and_two_columns" (image layout with image_id). 3. Use "title_and_body" for AT MOST 1 slide (conclusion only). Prefer purpose-built layouts for everything. 4. NEVER repeat the same layout for consecutive slides. 5. Use metric_rings ONLY for percentage-based metrics (0-100). If data is raw units (years, dollars, counts), use a different layout. 6. Mix visual variety: combine image slides, charts, timelines, grids, and text slides.

LAYOUT OPTIONS (set layout for EVERY slide):

• "title_and_two_columns": Image + bullets (IMAGE LAYOUT)
• "title_and_two_to_four_columns_with_icons": 2-4 points with icons
• "title_and_body": Single-column bullets (max 1 per deck)
• "title_and_subtitle": Section divider / transition slide
• "image_full_width": Full-width image with text below (IMAGE LAYOUT)
• "image_left_text_right": Image left, bullets right (IMAGE LAYOUT)
• "quadrant_grid": EXACTLY 4 items (SWOT, 2x2 matrix)
• "data_table": Tabular comparisons
• "timeline_horizontal": Chronological events (dates in point, short descriptions)
• "layered_pyramid": Hierarchy (3-6 levels, fa- icon required per item)
• "phase_roadmap": Phases ("Period: Title" format, milestones in description)
• "metric_rings": KPIs (1-4 metrics, values 0-100)

CONTENT & FORMATTING RULES:

• Each slide MUST have 3-5 substantial bullet points
• Each bullet description should be 2-4 lines with specific data, evidence, use cases, or actionable insights
• Content should be PhD-level, detailed, and evidence-driven
• Use FontAwesome 5.15 icons for each bullet
• EVERY body item MUST include "value" (0-100) — enables chart rendering and layout switching
• quadrant_grid: EXACTLY 4 items, point <15 chars, description <80 chars
• timeline_horizontal: dates in point (max 15 chars), description max 50 chars
• layered_pyramid: icon with fa- prefix REQUIRED per item
• phase_roadmap: point = "Period: Title", description = milestones separated by "; "
• metric_rings: only percentage-based data, never raw units
• data_table: key:value pairs in description

This displays all slides in a beautiful scrollable carousel view instead of individual slide widgets.

Search for professional images and automatically select the best match.

WHEN TO USE:

• ONLY when a user explicitly asks to see image options or wants to choose a specific image
• OPTIONAL: You can skip this entirely - create_slide and create_slide_carousel will auto-select images

This tool searches for images matching the caption and returns the BEST MATCHING image_id ready to use. The returned image_id can be passed to create_slide or create_slide_carousel.

For most cases, simply omit the image_id when creating slides - the system handles image selection automatically.

Display an interactive visual theme picker widget.

WHEN TO USE:

• User says "show themes", "what themes are available", "let me pick a theme"
• User wants to browse theme options visually

Shows a widget with 18 themes across 2 categories (Urban, Gradient) with color swatches and fonts.