# prezentit
name: prezentit
description: Generate beautiful AI-powered presentations instantly. Create professional slides with custom themes, visual designs, and speaker notes—all through natural language commands.
homepage: https://prezentit.net
emoji: "👽"
metadata:
clawdbot:
emoji: "👽"
skillKey: prezentit
homepage: https://prezentit.net
requires:
config:
config:
requiredEnv:
description: Your SkillBoss API key. Get one at https://heybossai.com
example: |
export SKILLBOSS_API_KEY=your_skillboss_api_key_here
permissions:
network:
fileSystem: none
env:
reads:
writes: none
# AI Presentation Generator — via SkillBoss API Hub
Base URL: https://api.heybossai.com/v1
Auth Header: Authorization: Bearer {SKILLBOSS_API_KEY}
This skill requires a
SKILLBOSS_API_KEYenvironment variable. All requests are routed through SkillBoss API Hub (/v1/pilot) which automatically selects the best PPT generation backend.
## ⚠️ CRITICAL FOR AI AGENTS
"stream": false in generation requests! Without this, you get streaming responses that cause issues.## Complete Workflow (FOLLOW THIS ORDER)
### Step 1: Check Credits First
POST https://api.heybossai.com/v1/pilot
```bash
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "credits" } Response (top-level): { "credits": 100, "pricing": { "outlinePerSlide": 5, "designPerSlide": 10, "estimatedCostPerSlide": 15 }, "_ai": { "canGenerate": true, "maxSlidesAffordable": 6, "nextSteps": ["..."] } } → If _ai.canGenerate is false, direct user to manage their SkillBoss account credits → Use _ai.maxSlidesAffordable to know the limit Step 2: Choose a Theme Option A — Browse all available themes and pick by ID: POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "list_themes" } Response (top-level): { "themes": [ { "id": "corporate_blue", "name": "Corporate Blue", "category": "Corporate & Professional" }, { "id": "nature_earth", "name": "Nature Earth", "category": "Nature & Organic" } ], "categories": ["Corporate & Professional", "Creative & Visual", "Data & Analytics"], "_ai": { "totalThemes": 20, "popularThemes": ["corporate_blue", "midnight_tech", "nature_earth", "storyteller", "data_dashboard"] } } → Use the exact id value in your generation request Option B — Search for a theme by keyword: POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "list_themes", "inputs": { "search": "minimalist" } } → Returns best matches ranked by relevance. Use the id from bestMatch. Option C — Describe a custom style (no theme ID needed): Use the customDesignPrompt parameter instead. See the Custom Design Prompt section below. Step 3: Generate Presentation POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "inputs": { "topic": "User's topic here", "slideCount": 5, "theme": "corporate_blue", "stream": false }, "prefer": "balanced" } ⏱️ IMPORTANT: Generation takes 1-3 minutes. The API will return when complete. Result is at the top level of the response: { "presentationId": "uuid-here", "viewUrl": "https://prezentit.net/view/abc123", "creditsUsed": 75, "remainingCredits": 25 } Full Request Parameters (inside inputs): ParameterTypeRequiredDescriptiontopicstringYes*Presentation topic (2-500 chars). Required if no outline. prompt is also accepted as an alias.outlineobjectNoPre-built outline (saves ~33% credits). See Outline section below.slideCountnumberNoNumber of slides (3-50, default: 5). Ignored if outline provided.themestringNoTheme ID from list_themes action. Use the exact id value.customDesignPromptstringNoCustom visual style description (see below). Overrides theme ID.detailsstringNoAdditional context about the presentation content.confirmPartialbooleanNoSet true to confirm partial generation when credits are limited.streambooleanALWAYS falseAI agents must always set stream: false. *topic is required even when providing an outline (used for presentation metadata). Step 4: Get the Result Success Response (top-level): { "presentationId": "uuid-here", "viewUrl": "https://prezentit.net/view/abc123", "creditsUsed": 75, "remainingCredits": 25 } → Share the viewUrl with the user. That's their presentation! Step 5: Download (Optional) POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "download", "inputs": { "presentationId": "uuid-here", "format": "pptx" } }
Formats: pptx (PowerPoint), pdf, json (raw data)
Pricing ScenarioCost per SlideExample (5 slides)Auto-generate outline15 credits75 creditsProvide your own outline10 credits50 credits (~33% savings!) New accounts get 100 free credits Manage credits via your SkillBoss account Theme Selection How to Pick a Theme Fetch the theme list: call /v1/pilot with action: "list_themes" — returns all available themes with id, name, and category Pick the best match for the user's topic and style preference Pass the id in the generation request as the theme input parameter You can also search: include "search": "KEYWORD" in inputs, or filter: "category": "CATEGORY_NAME". Custom Design Prompt (Skip the Theme List) If no existing theme fits, use customDesignPrompt to describe a fully custom visual style. This must be a detailed, structured description — not just a color palette. REQUIRED structure for customDesignPrompt (include ALL of these sections): COLOR SYSTEM: Primary [hex], secondary [hex], accent [hex], background [hex/gradient], text colors for headings and body.
TYPOGRAPHY: Heading font style [e.g., bold geometric sans-serif like Montserrat], body font style [e.g., clean humanist sans-serif like Open Sans], size hierarchy [large/medium/small], weight contrast.
LAYOUT SYSTEM: Slide structure [e.g., asymmetric split with 60/40 content-to-visual ratio], alignment [left-aligned text with right visual panel], spacing philosophy [generous whitespace vs. dense information], grid approach. VISUAL ELEMENTS: Background treatment [solid/gradient/textured/patterned], decorative motifs [geometric shapes, organic curves, line art, etc.], image style [photography with overlay, illustrations, icons, data visualizations], border/frame treatments. MOOD & TONE: Overall aesthetic [e.g., corporate authority, playful creativity, academic rigor, tech-forward], energy level [calm/dynamic/bold], intended audience impression. Example — Good customDesignPrompt: { "type": "ppt", "inputs": { "topic": "AI in Healthcare", "customDesignPrompt": "COLOR SYSTEM: Primary deep medical blue (#1B3A5C), secondary teal (#2A9D8F), accent warm coral (#E76F51) for callouts, backgrounds alternate between clean white (#FAFAFA) and very subtle blue-gray (#F0F4F8), heading text dark navy, body text #333333. TYPOGRAPHY: Headings in bold geometric sans-serif (Montserrat style), body in clean humanist sans (Source Sans style), strong size hierarchy with 48pt titles, 24pt subtitles, 16pt body. LAYOUT SYSTEM: Asymmetric layouts with 60/40 content-to-visual split, left-aligned text blocks with right-side data visualizations or medical imagery, generous padding (60px margins), clean grid structure. VISUAL ELEMENTS: Subtle DNA helix watermark in corners at 5% opacity, thin teal accent lines as section dividers, medical iconography (stethoscope, heartbeat, molecular structures) as small decorative elements, photography with blue-tinted overlay for full-bleed backgrounds. MOOD & TONE: Professional medical authority balanced with approachable warmth, calm and trustworthy, designed for hospital executives and medical professionals.", "stream": false }, "prefer": "balanced" } Example — Bad customDesignPrompt (TOO VAGUE, will produce generic results): "blue and white medical theme" Creating Outlines (Save ~33% Credits) Providing your own outline saves credits and gives you full control over content. Outline Structure The outline is an object with a slides array. Each slide has these fields: { "type": "ppt", "inputs": { "topic": "Your Presentation Topic", "outline": { "slides": [ { "title": "Slide Title Here", "mainIdea": "A clear sentence explaining the core message of this slide and what the audience should take away from it.", "talkingPoints": [ "First key point with enough detail to be meaningful (at least 10 characters)", "Second key point expanding on the main idea", "Third key point providing supporting evidence or examples" ], "visualGuide": "Detailed description of the visual layout: background style, image placement, icon suggestions, chart types, color emphasis areas, and decorative elements for this specific slide." } ] }, "stream": false }, "prefer": "balanced" } Slide Field Reference FieldRequiredConstraintsDescriptiontitleYes3-100 chars, 1-15 wordsSlide headingmainIdeaYes10-500 chars, 3-75 wordsCore message of the slidetalkingPointsYes2-7 items, each 10-300 chars (3-50 words)Key points to covervisualGuideYes20-500 chars, 5-75 wordsVisual design instructions for this slide Validation Rules
Overall:
Minimum 3 slides, maximum 50 slides topic is still required (used for presentation metadata) All four fields (title, mainIdea, talkingPoints, visualGuide) are required per slide The API returns detailed error messages with fix suggestions if validation fails. Complete Example { "type": "ppt", "inputs": { "topic": "Introduction to Machine Learning", "outline": { "slides": [ { "title": "Introduction to Machine Learning", "mainIdea": "Machine learning is transforming how businesses operate by enabling systems to learn from data and improve automatically without explicit programming.", "talkingPoints": [ "Machine learning is a subset of artificial intelligence focused on pattern recognition", "ML systems improve through experience rather than manual rule-writing", "Global ML market projected to reach $209 billion by 2029" ], "visualGuide": "Bold title slide with futuristic tech aesthetic. Dark gradient background transitioning from deep navy to midnight blue. Large bold title text centered with a subtle neural network node pattern behind it. Accent glow in electric blue." }, { "title": "How Machine Learning Works", "mainIdea": "Machine learning algorithms are categorized into supervised, unsupervised, and reinforcement learning based on how they learn from data.", "talkingPoints": [ "Supervised learning uses labeled data for classification and regression tasks", "Unsupervised learning discovers hidden patterns in unlabeled data through clustering", "Reinforcement learning optimizes decisions through trial, error, and reward signals" ], "visualGuide": "Three distinct visual sections showing each ML type with representative icons: labeled data pairs for supervised, clustered groups for unsupervised, and a game-like reward loop for reinforcement. Use consistent color coding with blue, green, and purple." }, { "title": "Business Applications", "mainIdea": "Companies across industries are leveraging machine learning for competitive advantage in customer experience, operations, and decision-making.", "talkingPoints": [ "Customer churn prediction reduces revenue loss by identifying at-risk accounts early", "Fraud detection systems process millions of transactions in real-time", "Personalized recommendation engines drive significant increases in engagement and sales" ], "visualGuide": "Clean content layout with left-aligned text and right-side icons or mini-charts for each application. Use a white background with subtle grid lines. Each talking point gets a small illustrative icon (shield for fraud, chart for prediction, user icon for personalization)." }, { "title": "Getting Started with ML", "mainIdea": "Successful ML adoption requires starting with clear use cases, quality data, and the right team rather than jumping straight to complex algorithms.", "talkingPoints": [ "Identify high-impact use cases where prediction or automation adds clear value", "Invest in clean, well-structured data before selecting algorithms", "Build or partner with ML expertise and start with proven frameworks" ], "visualGuide": "Conclusion slide with a numbered roadmap or step layout. Three large numbered circles (1, 2, 3) each containing a step. Background with subtle upward-pointing arrows suggesting progress. Call-to-action feel with bold accent color on the final step." } ] }, "theme": "midnight_tech", "stream": false }, "prefer": "balanced" } Get Outline Schema POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "outline_schema" } Returns the full JSON schema with all constraints and example slides (top-level response). Error Handling Error Response Format { "error": "Human readable message", "code": "ERROR_CODE", "fix": "Guidance on how to resolve this" } Common Errors & Solutions HTTPCodeMessageSolution400MISSING_TOPICTopic or prompt is requiredProvide a topic or prompt field400INVALID_OUTLINEOutline validation failedCheck outline structure — response includes detailed validationErrors with fix per field400INVALID_SLIDE_COUNTSlide count must be 3-50Adjust slideCount to be between 3 and 50401UNAUTHORIZEDInvalid or missing API keyCheck Authorization: Bearer ... header with valid SKILLBOSS_API_KEY402INSUFFICIENT_CREDITSNot enough creditsResponse includes required, available404PRESENTATION_NOT_FOUNDPresentation doesn't existVerify presentation ID409DUPLICATE_REQUESTSame request within cooldownWait and retry — don't resend identical requests409GENERATION_IN_PROGRESSAlready generatingCheck status or cancel via action: "generation_status" / action: "generation_cancel"429RATE_LIMITEDToo many requestsWait retryAfter seconds before retrying500GENERATION_FAILEDInternal errorRetry once, then contact support503SERVICE_UNAVAILABLESystem overloadedRetry after retryAfter seconds Handling Insufficient Credits { "error": "Insufficient credits", "code": "INSUFFICIENT_CREDITS", "required": 75, "available": 50 } AI Agent Response: "You need 75 credits but only have 50. Please add credits to your SkillBoss account." Handling Partial Generation If the user has some credits but not enough for full generation, the API returns a confirmation_required response with options. Read the _ai.options array and present them to the user. To proceed with partial generation, resend the request with "confirmPartial": true inside inputs. Handling Rate Limits { "error": "Too many requests", "code": "RATE_LIMITED", "retryAfter": 30 } AI Agent Action: Wait retryAfter seconds before retrying. Additional Actions Check Generation Status POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "generation_status" } Returns current progress if a generation is running: stage, percentage, designs completed. Cancel Active Generation POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "generation_cancel" } Cancels the current generation in progress. Get Presentation Details POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "get_presentation", "inputs": { "presentationId": "uuid-here" } } List User's Presentations POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "list_presentations", "inputs": { "limit": 20, "offset": 0 } } List All Themes POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
Content-Type: application/json
{ "type": "ppt", "action": "list_themes" } Optional inputs: "search": "keyword" — Filter by name "category": "corporate" — Filter by category Anti-Spam Rules RuleLimitWhat HappensDuplicate detection~30 seconds409 error for identical requestsRate limitVaries by key429 error with retryAfterOne generation at a time1 concurrent409 GENERATION_IN_PROGRESS error Best Practice: Always check for retryAfter in error responses and wait that duration. Quick Copy-Paste Examples Minimal Generation POST https://api.heybossai.com/v1/pilot
Authorization: Bearer {SKILLBOSS_API_KEY}
{ "type": "ppt", "inputs": { "topic": "Introduction to Climate Change", "stream": false }, "prefer": "balanced" } With Theme (Fetch ID First)
Support: https://heybossai.com/support
API Key Management: https://heybossai.com/api-keys
Join 80,000+ one-person companies automating with AI