My Slidev + Claude workflow for AI-native presentations

slidev-presentation-skill.md

Slidev Presentation Skill Create and iterate on Slidev presentations with Hi Marley branding

Create and iterate on presentations using Slidev with Hi Marley branding.

When Working on Presentations

Project details (colors, patterns, commands) are in ~/work/presentations/.claude/CLAUDE.md. This skill covers the creative process.

Voice & Visual Philosophy

Avoid Text-Heavy Slides

• Don't default to text-only slides - they feel barren and dry
• Slides with personal photos (kids, family, team), imagery, or emotional content are more engaging
• When a slide feels "texty," ask: "Can this be shown visually instead?"

Ask for Visual Assets

When creating slides that would benefit from imagery, proactively ask the user:

• "Do you have a photo that captures this moment/feeling?"
• "Would a short video clip work here?"
• "Is there a personal image that connects to this point?"

Early Hooks for Big Vision Presentations

When presenting transformational concepts (like Agentic OS), include tangible hooks early to help the audience feel "I need to pay attention":

• Specific before/after examples: "10 days → 10 minutes"
• Relatable pain points being solved: "That thing you've been stuck on? Unblocked."
• Concrete tasks that connect to the bigger vision

Pattern for vision decks:

1. Open with a specific, tangible win (not abstract vision)
2. Show the "how" with relatable examples
3. Then expand to the bigger picture

Process

1. Search Past Presentations First

Before creating new slides, always search existing presentations for reusable content:

# Search all presentations for a topic
grep -ri "topic" ~/work/presentations/*/slides.md

# Find slides about specific subjects (with context)
grep -B5 -A30 "# Topic" ~/work/presentations/*/slides.md

# List all slide titles across presentations
grep "^# " ~/work/presentations/*/slides.md

2. Create or Navigate to Presentation

For new presentations, create the directory and copy boilerplate from a recent one (see CLAUDE.md in presentations repo for setup details).

3. Iterate with Hot Reload

• Start dev server: npm run dev
• Edit slides.md - changes appear instantly
• Commit frequently with descriptive messages

4. Ask for Feedback

Present drafts and ask:

• "Does this flow make sense?"
• "Is this slide too text-heavy?"
• "Do you have an image for this?"

Iteration Patterns

Common feedback and how to respond:

• "Make it more provocative" - Sharpen the hook, take a stronger stance
• "Too much text" - Find an image, split into multiple slides, or use v-click to reveal progressively
• "Missing the why" - Add context slide before the what
• "Feels generic" - Add personal anecdote or specific example