ppt-generation
Use this skill when the user requests to generate, create, or make presentations (PPT/PPTX). Has TWO workflows: (1) Primary — AI-generated full-slide images composed via `scripts/generate.py`; (2) Fallback — `python-pptx` programmatic slides (all text editable, better for reports/project management). The fallback auto-activates when image-generation or the compose script is missing. Final PPTX always goes to `./outputs/`.
peintune · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add peintune/runjam --skill ppt-generation技能说明
name: ppt-generation
description: Use this skill when the user requests to generate, create, or make presentations (PPT/PPTX). Has TWO workflows: (1) Primary — AI-generated full-slide images composed via scripts/generate.py; (2) Fallback — python-pptx programmatic slides (all text editable, better for reports/project management). The fallback auto-activates when image-generation or the compose script is missing. Final PPTX always goes to ./outputs/.
⚠️ This skill has TWO workflows. Always run the Dependency Check first and pick the right one — do NOT assume the image-based path works.
- Primary (image-based): Requires
image-generationskill +scripts/generate.py. Generates full-slide images and composes them into PPTX.- Fallback (python-pptx): Use when image-generation or the compose script is missing. Creates slides programmatically with
python-pptx— all text is editable, copyable, searchable. This is the BETTER choice for project management, reports, and data-heavy presentations.Output path rule (from
runjam-defaults): The final.pptxfile MUST be placed in./outputs/. Before starting:mkdir -p ./outputs. Never output to arbitrary directories.
PPT Generation Skill
Overview
This skill generates professional PowerPoint presentations. The primary workflow uses AI-generated images for each slide (composed via scripts/generate.py). When those dependencies are unavailable, the fallback workflow builds slides natively with python-pptx — all text remains editable, which is usually the preferred delivery for project-management decks, reports, and any content the user's team needs to modify.
Core Capabilities
- Plan and structure multi-slide presentations with unified visual style
- Support multiple presentation styles: Business, Academic, Minimal, Apple Keynote, Creative
- Generate unique AI images for each slide using image-generation skill
- Maintain visual consistency by using previous slide as reference image
- Compose images into a professional PPTX file
Presentation Styles
Choose one of the following styles when creating the presentation plan:
| Style | Description | Best For |
|---|---|---|
| glassmorphism | Frosted glass panels with blur effects, floating translucent cards, vibrant gradient backgrounds, depth through layering | Tech products, AI/SaaS demos, futuristic pitches |
| dark-premium | Rich black backgrounds (#0a0a0a), luminous accent colors, subtle glow effects, luxury brand aesthetic | Premium products, executive presentations, high-end brands |
| gradient-modern | Bold mesh gradients, fluid color transitions, contemporary typography, vibrant yet sophisticated | Startups, creative agencies, brand launches |
| neo-brutalist | Raw bold typography, high contrast, intentional "ugly" aesthetic, anti-design as design, Memphis-inspired | Edgy brands, Gen-Z targeting, disruptive startups |
| 3d-isometric | Clean isometric illustrations, floating 3D elements, soft shadows, tech-forward aesthetic | Tech explainers, product features, SaaS presentations |
| editorial | Magazine-quality layouts, sophisticated typography hierarchy, dramatic photography, Vogue/Bloomberg aesthetic | Annual reports, luxury brands, thought leadership |
| minimal-swiss | Grid-based precision, Helvetica-inspired typography, bold use of negative space, timeless modernism | Architecture, design firms, premium consulting |
| keynote | Apple-inspired aesthetic with bold typography, dramatic imagery, high contrast, cinematic feel | Keynotes, product reveals, inspirational talks |
Dependency Check (MUST RUN FIRST)
Before starting any workflow, check what's actually available:
- Check if
../image-generation/SKILL.mdexists → image-based primary workflow possible? - Check if
./scripts/generate.pyexists → compose script available? - Check
python-pptx:python -c "import pptx" 2>&1(needed for both compose and fallback)
Decision matrix:
| image-generation skill | scripts/generate.py | python-pptx | Workflow |
|---|---|---|---|
| ✅ present | ✅ present | ✅ installed | Primary (image-based) |
| ❌ missing | ❌ missing | ✅ installed | Fallback (python-pptx) — tell the user you switched and why |
| ❌ missing | ❌ missing | ❌ missing | Install python-pptx first: pip install python-pptx, then use Fallback |
| ⚠️ any mix | ⚠️ any mix | ✅ installed | Use Fallback — avoid partial image workflow; the compose chain breaks without ALL pieces |
Note: In most RunJam installations today, neither image-generation nor scripts/generate.py ship with the app. Assume Fallback unless you explicitly see both present.
Workflow
Step 1: Understand Requirements
When a user requests presentation generation, identify:
- Topic/subject: What is the presentation about
- Number of slides: How many slides are needed (default: 5-10)
- Style: business / academic / minimal / keynote / creative
- Aspect ratio: Standard (16:9) or classic (4:3)
- Content outline: Key points for each slide
- You don't need to check the folder under
.
Step 2: Create Presentation Plan
Create a JSON file in ./workspace/ with the presentation structure. Important: Include the style field to define the overall visual consistency.
{
"title": "Presentation Title",
"style": "keynote",
"style_guidelines": {
"color_palette": "Deep black backgrounds, white text, single accent color (blue or orange)",
"typography": "Bold sans-serif headlines, clean body text, dramatic size contrast",
"imagery": "High-quality photography, full-bleed images, cinematic composition",
"layout": "Generous whitespace, centered focus, minimal elements per slide"
},
"aspect_ratio": "16:9",
"slides": [
{
"slide_number": 1,
"type": "title",
"title": "Main Title",
"subtitle": "Subtitle or tagline",
"visual_description": "Detailed description for image
阅读完整来源 ↗