phase-slideshow

The slideshow phase generates a structured slide deck outline from .neuroflow/ contents — covering selected phases, analyses, figures, and key findings — ready to export as Markdown/reveal.js or a PowerPoint-compatible structured outline.

Approach

• Confirm scope (which phases), audience, talk length, and output format before loading any files
• Use flow.md files to navigate .neuroflow/ rather than reading all content up front
• Calibrate slide count and detail level to the stated talk length — do not pad or over-explain
• Synthesize, do not transcribe — a slide is a claim supported by evidence, not a file dump
• Flag figures by path but do not attempt to embed binary image files
• Build the Limitations slide from preregistration deviations and the limitations recorded in analysis summaries or the manuscript — never from .neuroflow/fails/ (team-internal feedback about neuroflow)
• A deck leaves the team: no local-tier content (sessions/, review/), fails/, finance/ or participant-identifying details on any slide (neuroflow-core → Sharing tiers)

Relevant skills

• neuroflow:neuroflow-core — read first; defines the command lifecycle and .neuroflow/ write rules
• neuroflow:notebooklm — when the user says "use NotebookLM" or wants AI-narrated slides / an audio walkthrough of the slides, route the output to the notebooklm skill instead of (or in addition to) generating Markdown/reveal.js; uploading the deck there is outbound data movement — show what will be uploaded and wait for the person's confirmation

Audience calibration

Audience	Approach
Specialist (same field)	Include technical detail in methods; abbreviations are fine
General neuroscience	Explain modality-specific methods briefly; avoid jargon in results
Mixed	Lead with big-picture framing; keep methods to one slide; emphasise findings
Non-scientists	One-sentence lay summary per section; no statistical notation without explanation

Slide count heuristic

Talk length	Target slides
5–10 min	8–12
15–20 min	15–22
30 min	25–30
45 min	32–40

If the user asks for more slides than the heuristic suggests, comply but note that the pace may be tight.

Output format guidance

Markdown / reveal.js

• Use YAML frontmatter with title, author, date, theme
• --- separates horizontal slides; -- separates vertical sub-slides within a section
• Recommended themes: white (light), black (dark), moon (dark, muted)
• Remind the user to install reveal.js or use Slidev for rendering

Structured text outline (PowerPoint / Keynote)

• Each slide block starts with [SLIDE]
• Use [TITLE], [BULLET], [IMAGE: path/to/figure], [SPEAKER NOTE] markers
• This format can be copied into a presentation app slide by slide
• Remind the user to replace [IMAGE: ...] markers with actual figure files

Workflow hints

• Save the deck to slides/slideshow-YYYY-MM-DD.md (a deliverable — never inside .neuroflow/); keep the working outline and speaker notes in .neuroflow/slideshow/ — confirm before writing
• If a same-date file exists, append -v2, -v3, etc.
• Keep bullet points to ≤ 6 words per line where possible — slides are prompts, not paragraphs

Slash command

/neuroflow:slideshow — runs this workflow as a slash command.