AgriciDaniel/canvas-present

canvas-present: Presentation Canvas Builder

Read ../canvas/references/presentation-spec.md for slide dimensions, navigation edges, layout patterns, and color coding. Read ../canvas/references/performance-guide.md for node limits.

---

Operations

Build Presentation (/canvas present [topic])

Create a complete presentation canvas from a topic description.

Workflow:

1. Gather context: Ask the user for:

   • Topic/title (required)
   • Number of slides (default: 6, recommend 6-10)
   • Style: deck (1200×675 clean) or storyboard (1920×1080 with script column)
   • Whether to generate images for slides (requires /banana)

2. Generate slide structure: Claude writes the content for each slide:

   • Slide 1: Title slide (title, subtitle, date)
   • Slide 2: Agenda/overview
   • Slides 3-N-2: Content slides (key points, data, findings)
   • Slide N-1: Key takeaway / summary
   • Slide N: Next steps / closing

3. Create the canvas:

   a. Start from the presentation template:

   python3 scripts/canvas_template.py presentation [output_path] \
     --param title="[topic]" --param slide_count=[N]
   

   b. Edit each slide's text node with the generated content using the Edit tool.

   c. If images requested: generate via /banana and add as file nodes inside slide groups.

   d. If storyboard style: add script annotation text nodes (width=500) to the right of each slide group.

4. Color-code slides per the spec:

   • Title/close: "6" (purple)
   • Content: "4" (green)
   • Key insight: "5" (cyan)
   • Action items: "2" (orange)

5. Validate:

   python3 scripts/canvas_validate.py [output_path]
   

6. Report: "Created [N]-slide presentation at [path]. Open in Obsidian with Advanced Canvas to navigate with arrow keys."

---

Build from Notes (/canvas present from [notes])

Create a presentation from existing markdown files or wiki pages.

Workflow:

1. Find source notes: Search for the specified files. If in a claude-obsidian vault, use wiki/ paths. Otherwise search the current directory.

2. Extract content: Read each note and extract:

   • H1 headings → slide titles
   • H2 headings → slide section markers
   • Key paragraphs → slide body text
   • Images/embeds → slide visuals
   • Bullet lists → slide bullet points

3. Map to slides: One H1 or H2 section per slide. If a section is too long (>200 words), split into multiple slides.

4. Generate canvas: Follow the same build workflow as /canvas present [topic], using extracted content instead of Claude-generated content.

5. Report: "Created presentation from [N] source notes → [M] slides."

---

Add Slide (/canvas present add slide [content])

Add a new slide to an existing presentation canvas.

Workflow:

1. Read the existing presentation canvas.
2. Find the last slide group (highest y for vertical stack, highest x for horizontal).
3. Create a new slide group at the next position:
   • Vertical: y = last_slide_y + last_slide_height + 100
   • Horizontal: x = last_slide_x + last_slide_width + 100
4. Add content text node inside the new slide group.
5. Add edge from the previously-last slide to the new slide.
6. Write and validate.

---

Slide Content Guidelines

Each slide should follow the "one idea per slide" principle:

• Title: 3-8 words. Use H2 (##) for slide titles.
• Body: 2-5 bullet points OR 1-2 short paragraphs. Max 100 words per slide.
• Visual: One image or diagram per content slide. Place to the right of text.
• Callouts: Use Obsidian callouts for emphasis:

  > [!tip] Key Insight
  > The main takeaway in one sentence.
  

Mermaid in slides: Mermaid diagrams render natively in text nodes. Great for data slides:

## Revenue Growth

```mermaid
graph LR
    Q1["Q1: $1.2M"] --> Q2["Q2: $1.8M"]
    Q2 --> Q3["Q3: $2.4M"]
    Q3 --> Q4["Q4: $3.1M"]

---

## Integration with Media Skills

When the user requests images for slides:

1. **banana**: Generate hero images, backgrounds, illustrations.
   - Prompt pattern: "[slide topic], presentation slide style, clean, professional"
   - Add as file node inside the slide group (half-width, right-aligned)

2. **svg**: Generate charts, diagrams, icons.
   - Best for data visualization slides
   - Add as file node with viewBox-based sizing

3. **Mermaid**: Native in text nodes — no external skill needed.
   - Best for flowcharts, sequence diagrams, gantt charts inside slides

If media skills are not installed, build text-only presentations and suggest: "Install `/banana` for AI-generated slide images."