Slide Management

Manage slide additions and deletions with automatic renumbering. The system handles file renaming, updates slides.md, and uses git-aware operations for tracked files.

How This Skill Works

This skill provides an interactive workflow for:

• Adding slides: Insert new slide at any position with automatic renumbering of subsequent slides
• Deleting slides: Remove slide and renumber remaining slides to close gaps
• Git awareness: Uses git mv for tracked files, regular mv for untracked files

Workflow

Step 1: Find and Display Current Slides

Use Bash to find slides.md:

find . -name "slides.md" -type f -not -path "*/node_modules/*" | head -1

Then use Read tool on slides.md and parse all slide entries.

CRITICAL - Gap Detection: After parsing slides, check for gaps in slide numbering:

• Extract all slide numbers from the parsed slides
• IMPORTANT: Ignore gaps at the beginning (e.g., slide 1 then slide 5 is OK - title then content)
• Only detect gaps in the MIDDLE of the sequence (e.g., slides 5, 6, 9, 10 - gap at 7-8)
• Check from the second slide onwards

Display current presentation structure to user:

📊 Current Presentation Structure (N slides)

Position 1 → Slide 1: Title Slide
             slides/01-title.md

Position 2 → Slide 5: Introduction
             slides/05-introduction.md

Position 3 → Slide 6: Main Topic
             slides/06-main-topic.md

... (show all slides with BOTH position and slide number)

CRITICAL - Always show both:

• Position: The order in the list (1st, 2nd, 3rd...)
• Slide number: The number in the filename and comment

If gaps are detected in the middle, add a warning:

⚠️  Numbering gaps detected in middle: [7, 8]
(Note: Gap at beginning preserved - typically title at 1, content starts at 5+)
You can fix middle gaps with the renumber operation.

Important: The renumber operation:

• PRESERVES the gap between slide 1 and slide 2 (e.g., 1→5 stays as 1→5)
• FIXES gaps in the middle sequence (e.g., 5,6,9,10 becomes 5,6,7,8)
• This is by design: title slides often need separation from content slides

Step 2: Ask What to Do

Use AskUserQuestion to ask the user what they want to do.

IMPORTANT: Dynamically build the options list based on whether gaps exist:

If gaps detected, offer 4 options:

- question: "What would you like to do with the slides?"
- header: "Action"
- multiSelect: false
- options:
  1. label: "Fix gaps"
     description: "Close middle gaps (preserves beginning gap like 1→5 for title separation)"
  2. label: "Add slide"
     description: "Insert a new slide at any position"
  3. label: "Delete slide"
     description: "Remove a slide"
  4. label: "View only"
     description: "Just browsing the current structure"

If no gaps detected, offer 3 options:

- question: "What would you like to do with the slides?"
- header: "Action"
- multiSelect: false
- options:
  1. label: "Add slide"
     description: "Insert a new slide at any position with automatic renumbering"
  2. label: "Delete slide"
     description: "Remove a slide and renumber remaining slides"
  3. label: "View only"
     description: "Just browsing the current structure"

If user chooses "View only", end the skill.

If user chooses "Fix gaps", go to Step 2b.

Step 2b: Fix Gaps Flow (if user chose "Fix gaps")

2b.1: Show Impact and Confirm

Display what will happen:

🔧 Fix Numbering Gaps

Current middle gaps: [7, 8]
Beginning gap: 1 → 5 (preserved)

This will close middle gaps while preserving the beginning gap:
- Slide 1 → Slide 1 (no change - title)
- Slide 5 → Slide 5 (no change - beginning gap preserved)
- Slide 6 → Slide 6 (no change)
- Slide 9 → Slide 7 (gap closed)
- Slide 10 → Slide 8 (gap closed)
... (show all renumbering)

Result: Slides will be 1, 5-N with no middle gaps

Ask for confirmation:

- question: "Proceed with renumbering?"
- header: "Confirm"
- multiSelect: false
- options:
  1. label: "Yes, fix gaps"
     description: "Renumber all slides to be sequential"
  2. label: "Cancel"
     description: "Keep current numbering"

If user cancels, return to Step 2.

2b.2: Execute Renumber Script

Use Bash to execute:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/manage-slides.py renumber

Capture both stdout and stderr, check exit code.

2b.3: Show Results

If successful:

✅ Gaps Fixed Successfully

Renumbered slides:
- Slide 9 → Slide 7 (slides/07-advanced.md)
- Slide 10 → Slide 8 (slides/08-conclusion.md)
... (show all renumbered)

Beginning gap preserved: Slide 1 → Slide 5
Total slides: N (numbered 1, 5-N with no middle gaps)

Then offer next action:

- question: "What would you like to do next?"
- header: "Next"
- multiSelect: false
- options:
  1. label: "Add slide"
     description: "Insert a new slide"
  2. label: "Delete slide"
     description: "Remove a slide"
  3. label: "Done"
     description: "Finish managing slides"

Step 3a: Delete Flow (if user chose "Delete slide")

3a.1: Ask Which Slide to Delete

CRITICAL - Slide Number vs Position:

• The user thinks in terms of SLIDE NUMBERS (what they see: "Slide 24")
• The script requires POSITION (where in the list: 1st, 2nd, 3rd)
• You MUST convert slide number → position before calling the script

Generate options dynamically from the slide list you parsed. For each slide, create an option showing BOTH:

- question: "Which slide would you like to delete?"
- header: "Slide"
- multiSelect: false
- options:
  [Generate options for each slide. Use position as label, show slide number and title:]

  label: "1"
  description: "Slide 1: Title Slide (slides/01-title.md)"

  label: "2"
  description: "Slide 5: Architecture Overview (slides/05-architecture-overview.md)"

  label: "3"
  description: "Slide 6: Main Topic (slides/06-main-topic.md)"

Store the mapping: When user selects an option, the label gives you the POSITION to pass to the script.

3a.2: Ask About Renumbering

Ask if user wants to renumber after deletion:

- question: "Should remaining slides be renumbered to close gaps?"
- header: "Renumber"
- multiSelect: false
- options:
  1. label: "Yes, renumber"
     description: "Make slides sequential (1, 2, 3, ...) with no gaps"
  2. label: "No, leave gaps"
     description: "Keep slide numbers unchanged (may create gaps)"

3a.3: Show Impact and Confirm

CRITICAL: User selected a position. Look up the slide at that position to get its slide number.

Calculate and show the impact based on renumber choice:

If renumbering:

⚠️ Confirm Deletion

Deleting: Position [P] → Slide [N]: [Title]
File: slides/0N-[slug].md

Impact (with renumbering):
- All slides after position [P] will be renumbered sequentially
- All slides will be sequential (1, 2, 3, ...) with no gaps
- Affects [X] slides total

If not renumbering:

⚠️ Confirm Deletion

Deleting: Position [P] → Slide [N]: [Title]
File: slides/0N-[slug].md

Impact (without renumbering):
- Slide will be removed
- Remaining slides keep their current numbers
- This may create or enlarge a gap in numbering

Then ask for confirmation:

- question: "Proceed with deletion?"
- header: "Confirm"
- multiSelect: false
- options:
  1. label: "Yes, delete"
     description: "Remove slide [with/without renumbering]"
  2. label: "Cancel"
     description: "Keep all slides unchanged"

If user cancels, return to Step 2.

3a.4: Execute Delete Script

CRITICAL: The script expects POSITION (1-indexed position in list), NOT slide number!

Use Bash to execute the Python script with the POSITION:

If renumbering:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/manage-slides.py delete [POSITION] --renumber

If not renumbering:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/manage-slides.py delete [POSITION]

Where [POSITION] is the position the user selected (from the label in step 3a.1).

Capture both stdout and stderr.

Check exit code:

• Exit code 0: Success
• Exit code > 0: Error (show error message from stderr)

3a.5: Show Results

If successful, show summary:

✅ Slide Deleted Successfully

Removed:
- Slide [N]: [Title]
- File: slides/0N-[slug].md

Renumbered:
- Slide [N+1] → Slide [N]
- Slide [N+2] → Slide [N+1]
... (show all renumbered slides)

Total slides: [M-1] (was [M])

If error, show error message and offer to retry or cancel.

Then offer next action:

- question: "What would you like to do next?"
- header: "Next"
- multiSelect: false
- options:
  1. label: "Delete another"
     description: "Remove another slide"
  2. label: "Add slide"
     description: "Insert a new slide"
  3. label: "Done"
     description: "Finish managing slides"

Step 3b: Add Flow (if user chose "Add slide")

3b.1: Ask Position

CRITICAL - Position vs Slide Number:

• Ask for POSITION in the list (1st, 2nd, 3rd...)
• Show what slide is currently at each position

Generate position options (1 through N+1):

- question: "Where should the new slide be inserted?"
- header: "Position"
- multiSelect: false
- options:
  [Generate options for all valid positions, showing current slide at each:]

  label: "1"
  description: "At beginning (before current position 1 → Slide 1: Title)"

  label: "2"
  description: "After position 1 (before current position 2 → Slide 5: Introduction)"

  label: "3"
  description: "After position 2 (before current position 3 → Slide 6: Main Topic)"

  ...

  label: "[N+1]"
  description: "At end (after last slide)"

The user selects a POSITION, which is what the script expects.

3b.2: Ask Title and Layout

Ask for both title and layout in one question set:

Question 1:
- question: "What should the slide title be?"
- header: "Title"
- multiSelect: false
- options:
  1. label: "Enter custom title"
     description: "Type your slide title in the Other field"

(User will use "Other" option to enter their custom title)

Question 2:
- question: "Which layout should the slide use?"
- header: "Layout"
- multiSelect: false
- options:
  1. label: "default"
     description: "Standard layout"
  2. label: "center"
     description: "Centered content"
  3. label: "two-cols"
     description: "Two columns side by side"
  4. label: "image-right"
     description: "Content on left, image on right"
  5. label: "quote"
     description: "Large quote display"
  6. label: "cover"
     description: "Cover/title slide style"

Extract the custom title from the "Other" response.

3b.3: Ask About Renumbering

Ask if user wants to renumber after addition:

- question: "Should all slides be renumbered to be sequential?"
- header: "Renumber"
- multiSelect: false
- options:
  1. label: "Yes, renumber"
     description: "Make all slides sequential (1, 2, 3, ...) with no gaps"
  2. label: "No, use gaps"
     description: "Insert at position, may create or use existing gaps"

3b.4: Show Preview and Confirm

Generate slug from title (lowercase, hyphens, max 40 chars) and show preview based on renumber choice:

If renumbering:

📋 New Slide Preview

Position: [N]
Title: [User's title]
Layout: [Selected layout]
Filename: slides/0N-[generated-slug].md

Impact (with renumbering):
- New slide will be inserted at position [N]
- Current slides [N] through [M] will become [N+1] through [M+1]
- All slides will be sequential (1, 2, 3, ...) with no gaps
- Affects [X] slides

If not renumbering:

📋 New Slide Preview

Position: [N]
Title: [User's title]
Layout: [Selected layout]
Filename: slides/0N-[generated-slug].md

Impact (without renumbering):
- New slide will be inserted at position [N]
- Slide number will fit into existing sequence/gaps
- May create or use existing gaps in numbering

Ask for confirmation:

- question: "Create this slide?"
- header: "Confirm"
- multiSelect: false
- options:
  1. label: "Yes, create"
     description: "Add slide [with/without renumbering]"
  2. label: "Cancel"
     description: "Don't make changes"

If cancelled, return to Step 2.

3b.5: Execute Add Script

CRITICAL: The script expects POSITION (1-indexed position in list), NOT slide number!

Use Bash to execute with the POSITION from step 3b.1:

If renumbering:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/manage-slides.py add [POSITION] \
  --title "[User's title]" \
  --layout [layout] \
  --renumber

If not renumbering:

python3 ${CLAUDE_PLUGIN_ROOT}/scripts/manage-slides.py add [POSITION] \
  --title "[User's title]" \
  --layout [layout]

Where [POSITION] is the position the user selected (from the label in step 3b.1).

Capture output and check exit code.

3b.6: Show Results and Next Steps

If successful:

✅ Slide Created Successfully

Added:
- Slide [N]: [Title]
- File: slides/0N-[slug].md
- Layout: [layout]

Renumbered:
- Old Slide [N] → Slide [N+1]
- Old Slide [N+1] → Slide [N+2]
... (show renumbered slides)

Total slides: [M+1] (was [M])

Then offer next actions:

- question: "What would you like to do next?"
- header: "Next"
- multiSelect: false
- options:
  1. label: "Edit new slide"
     description: "Open slide [N] for editing with /slidev:edit"
  2. label: "Add another"
     description: "Add another slide"
  3. label: "Done"
     description: "Finish managing slides"

If user chooses "Edit new slide", invoke the edit command:

Use SlashCommand tool: "/slidev:edit [N]"

Error Handling

When the Python script returns a non-zero exit code:

1. Capture stderr output
2. Extract error message
3. Display user-friendly error:

❌ Operation Failed

Error: [Parsed error message]

Details: [Technical details if helpful]

Then ask:

- question: "How should we proceed?"
- header: "Action"
- multiSelect: false
- options:
  1. label: "Try again"
     description: "Retry the operation"
  2. label: "Cancel"
     description: "Return to main menu"
  3. label: "Show full error"
     description: "Display complete error output for debugging"

Important Notes

• CRITICAL - Position vs Slide Number:

  • POSITION: Order in the list (1st slide, 2nd slide, 3rd slide...)
  • SLIDE NUMBER: Number in filename and comment (Slide 1, Slide 5, Slide 6...)
  • If there are gaps, these are DIFFERENT! Example: slides [1, 5, 6, 7] means position 2 = slide 5
  • The script always expects POSITION, never slide number
  • The skill must convert user's slide number selection to position before calling script

• Gap handling:

  • Gaps at beginning are PRESERVED (e.g., slide 1 then slide 5 is OK for title + content)
  • Gaps in middle are DETECTED and offered for fixing (e.g., slides 5, 6, 9, 10 - gaps 7-8)
  • The renumber operation preserves beginning gap but fixes middle gaps
  • Example: [1, 5, 6, 9, 10] becomes [1, 5, 6, 7, 8] (1→5 preserved, middle gaps fixed)

• Git awareness: The script automatically detects git-tracked files and uses git mv for them

• Rollback on error: If any operation fails, all changes are automatically rolled back

• Validation: Position ranges are validated before execution

• Atomic operations: Backup is created before any changes, restored on error

Edge Cases

Deleting slide 1:

• Warn that all slides will be renumbered
• Show what the new first slide will be

Adding at end (position N+1):

• No renumbering needed, just append
• Optimize for this case

Number overflow (>99):

• Script enforces max 99 slides
• Error message suggests splitting presentation

Example Interaction

Example 1: Add slide with sequential numbering

User invokes skill:

📊 Current Presentation Structure (5 slides)

Position 1 → Slide 1: Title Slide
             slides/01-title.md
Position 2 → Slide 2: Introduction
             slides/02-introduction.md
Position 3 → Slide 3: Main Topic
             slides/03-main-topic.md
Position 4 → Slide 4: Examples
             slides/04-examples.md
Position 5 → Slide 5: Conclusion
             slides/05-conclusion.md

What would you like to do?
> User chooses: "Add slide"

Where should the new slide be inserted?
> User chooses: label "3" (description: "After position 2, before position 3 → Slide 3: Main Topic")

What should the slide title be?
> User enters: "Architecture Overview"

Which layout?
> User chooses: "two-cols"

Should all slides be renumbered?
> User chooses: "Yes, renumber"

📋 New Slide Preview

Position: 3
Title: Architecture Overview
Layout: two-cols
Filename: slides/03-architecture-overview.md

Impact (with renumbering):
- New slide will be inserted at position 3
- Current slides 3-5 will become 4-6
- All slides will be sequential with no gaps
- Affects 3 slides

Create this slide?
> User confirms: "Yes, create"

[Script executes: python3 manage-slides.py add 3 --title "Architecture Overview" --layout two-cols --renumber]

✅ Slide Created Successfully

Added:
- Slide 3: Architecture Overview
- File: slides/03-architecture-overview.md
- Layout: two-cols

Renumbered:
- Old Slide 3 (Main Topic) → Slide 4
- Old Slide 4 (Examples) → Slide 5
- Old Slide 5 (Conclusion) → Slide 6

Total slides: 6 (was 5)

What next?
> User chooses: "Edit new slide"

[Invokes /slidev:edit 3]

Example 2: Delete slide with gaps

User invokes skill:

📊 Current Presentation Structure (4 slides)

Position 1 → Slide 1: Title
             slides/01-title.md
Position 2 → Slide 5: Introduction
             slides/05-introduction.md
Position 3 → Slide 6: Main Topic
             slides/06-main-topic.md
Position 4 → Slide 7: Conclusion
             slides/07-conclusion.md

⚠️  Numbering gaps detected in middle: [none]
(Note: Gap between slide 1 and 5 is preserved - typically title then content)

What would you like to do?
> User chooses: "Delete slide"

Which slide would you like to delete?
> User chooses: label "3" (description: "Slide 6: Main Topic (slides/06-main-topic.md)")

Should remaining slides be renumbered to close gaps?
> User chooses: "No, leave gaps"

⚠️ Confirm Deletion

Deleting: Position 3 → Slide 6: Main Topic
File: slides/06-main-topic.md

Impact (without renumbering):
- Slide will be removed
- Remaining slides keep their current numbers
- This may create or enlarge a gap in numbering

Proceed with deletion?
> User confirms: "Yes, delete"

[Script executes: python3 manage-slides.py delete 3]

✅ Slide Deleted Successfully

Removed:
- Position 3 → Slide 6: Main Topic
- File: slides/06-main-topic.md

Current slides:
- Position 1 → Slide 1: Title
- Position 2 → Slide 5: Introduction
- Position 3 → Slide 7: Conclusion

⚠️  Numbering gaps detected in middle: [6]

Total slides: 3 (was 4)

Tools Available

• Read: Read slides.md and slide files
• Bash: Execute manage-slides.py script
• SlashCommand: Invoke /slidev:edit if user wants to edit new slide
• AskUserQuestion: Interactive workflow questions

Use this skill whenever users need to reorganize, add, or remove slides from their presentation. The automatic renumbering ensures the presentation structure remains clean and sequential.