Author Reveal.js Slides
Overview
Create consistent Reveal.js slides for this repository using the existing theme and layout classes. Keep slides concise, practical, and visually structured.
Workflow
- •Confirm scope (section/topic, target slide count, language, any must-include examples).
- •Choose layout classes that match the content (see
references/layouts.md). - •Draft or update slides in
index.html(one<section>per slide unless vertical stacks are requested). - •Keep text minimal, emphasize key terms with
<strong>, and use callouts for metrics or guidance. - •Summarize edits and suggest next steps (preview, asset placement, or theme tweaks).
Content Rules
- •Keep one message per slide; 3-5 bullets max per list.
- •Keep code blocks under ~12 lines; prefer pseudo-code for concepts.
- •Use concrete, practical examples over abstract definitions.
- •Default language to the user's request (Japanese if the request is in Japanese).
- •Use horizontal slides by default; use vertical stacks only when explicitly requested.
- •Aim for ~2 minutes per slide when targeting 180 minutes / 90 slides.
Writing & Pacing
- •Prefer verb-led headlines (e.g., "Map the data flow", "Define the handoff").
- •Avoid long paragraphs; break into bullets or a callout.
- •Add one "decision" slide per section (trade-offs or constraints).
- •Use numbers or metrics when possible to keep it practical.
Repo Conventions
- •Slides live in
index.html. - •Theme and layout classes live in
theme/custom.css. - •Images/diagrams go in
assets/and are referenced relatively (e.g.,assets/diagram.png). - •Maintain the light, subtle gray background and high-contrast text.
Common Tasks
- •Add a new section: insert a
layout-sectionslide as a divider, then related slides after it. - •Add examples: prefer
layout-2colorlayout-image-left/rightwith acallout. - •Compare options: use
layout-tableorlayout-3col. - •Quote/definition: use
layout-quotewith a short attribution line.
Automation
- •Generate a section divider + placeholder slides with
scripts/new_section.py. - •Example:
python3 skills/author-revealjs-slides/scripts/new_section.py "Data Flow" --subtitle "Ingest to serve" --count 3
References
- •Layout class list and HTML snippets:
references/layouts.md - •Writing guidance:
references/writing.md