name: ppt-creator description: "Create professional PowerPoint (.pptx) presentations from scratch. This skill should be used when the user asks to create, make, generate, or build a PPT, PowerPoint, 簡報, 幻燈片, or PPT. It generates native .pptx files using python-pptx with support for multiple themes, slide types, Chinese text, and 16:9/4:3 aspect ratios. Triggers include phrases like 幫我做一個PPT, 建立簡報, 生成幻燈片, make a presentation, create slides, etc." agent_created: true

PPT Creator

Overview

Generate professional PowerPoint (.pptx) presentations from scratch using python-pptx. The skill accepts a topic or outline from the user, plans the slide structure, writes a JSON content definition, and runs the generation script to produce a ready-to-use .pptx file.

Supports 5 color themes, 7 slide types, Chinese text, speaker notes, and both 16:9 and 4:3 aspect ratios.

When to Use

Trigger this skill when the user requests creating a presentation, including but not limited to: - "幫我做一個PPT" / "建立一個簡報" / "生成幻燈片" - "make a presentation" / "create slides" / "build a PowerPoint" - "幫我做一個關於XX的PPT" - Any request to produce a .pptx file from a topic, outline, or existing content

Workflow

Step 1: Understand the Requirement

Gather key information from the user (ask only what is not already clear): - Topic: What is the presentation about? - Audience: Who will see it? (affects tone and depth) - Approximate length: How many slides? (default: 8-12 if unspecified) - Theme preference: Any color preference? (default: default if unspecified) - Aspect ratio: 16:9 or 4:3? (default: 16:9)

If the user provides a topic without other details, make reasonable assumptions and proceed — do not over-interrogate.

Step 2: Plan the Slide Structure

Based on the topic, plan the slide-by-slide structure. Reference references/design_guidelines.md for: - Structure templates for different scenarios (business report, product intro, academic, training) - Slide count recommendations based on presentation duration - Content density and design principles

Common structure pattern: 1. Title page 2. Section divider 3-6. Content pages (mix of content, table, two_column, quote as appropriate) 7. Section divider (if long enough) 8-10. More content pages 11. Summary 12. Closing page

Step 3: Write the JSON Content Definition

Create a JSON file defining all slides. Write it to a temporary location (e.g., the system temp directory). The JSON format:

{
    "theme": "default",
    "aspect_ratio": "16:9",
    "slides": [
        {"type": "title", "title": "...", "subtitle": "..."},
        {"type": "section", "title": "..."},
        {"type": "content", "title": "...", "bullets": ["...", {"text": "...", "level": 1}]},
        {"type": "two_column", "title": "...", "left_title": "...", "left_bullets": [...], "right_title": "...", "right_bullets": [...]},
        {"type": "quote", "quote": "...", "author": "..."},
        {"type": "table", "title": "...", "headers": [...], "rows": [[...], ...]},
        {"type": "closing", "title": "...", "subtitle": "..."}
    ]
}

For detailed JSON schema of each slide type, refer to references/slide_types.md.

Key content writing rules: - Each bullet point should be concise (under 20 characters when possible) - Use level: 1 for sub-points under a main bullet - Use bold: true to emphasize key data - Add notes field to content slides for speaker notes - Keep tables to 5-8 rows, max 5 columns - Insert section dividers every 4-6 content slides

Step 4: Generate the PPTX File

Run the generation script:

/Users/a123456/.workbuddy/binaries/python/envs/default/bin/python3 <skill_dir>/scripts/create_pptx.py <content_json_path> <output_pptx_path>

Where: - <skill_dir> is the directory containing this SKILL.md - <content_json_path> is the JSON file created in Step 3 - <output_pptx_path> is the desired output .pptx path (save to the user's working directory)

Prerequisite: python-pptx must be installed. If not already available, install it:

更多技能請訪問小蔥技能站7w4.net。

/Users/a123456/.workbuddy/binaries/python/versions/3.13.12/bin/python3 -m venv /Users/a123456/.workbuddy/binaries/python/envs/default
/Users/a123456/.workbuddy/binaries/python/envs/default/bin/pip install python-pptx

Step 5: Present the Result

After the .pptx file is generated: 1. Present the file to the user using present_files 2. Briefly summarize the presentation structure (theme, slide count, key sections) 3. Offer to adjust content, theme, or structure if needed

Available Themes

Available Slide Types

Resources

scripts/

• create_pptx.py — Main generation script. Reads a JSON content definition and produces a .pptx file. Execute directly with two arguments: content JSON path and output PPTX path.

references/

• design_guidelines.md — PPT design best practices: theme selection, slide count recommendations, structure templates, content density, font hierarchy, and visualization tips. Load when planning slide structure.
• slide_types.md — Detailed JSON schema for each slide type with field descriptions and complete examples. Load when writing the JSON content definition.

Tips

• Always generate the JSON content definition first, then run the script — this separates content planning from rendering
• If the user provides an existing outline or document, map it to the JSON structure rather than generating content from scratch
• For Chinese-language presentations, the script uses "微軟雅黑" font by default for full compatibility
• The script adds slide numbers automatically (except on title and closing slides)
• If the user wants to modify the generated PPT, edit the JSON and re-run the script rather than manually editing the .pptx

這個 PPT 生成 Skill 整體質量較好，功能豐富（多種主題和佈局），文件詳細易懂，能滿足常見的簡報製作需求。主要問題是生成的程式碼包含固定路徑資訊，在不同環境下可能無法直接執行；此外某些細節處理不夠完善（如名稱拼寫有誤）。對於日常使用足夠，但跨環境部署時可能需要額外調整。