slide-copywriting

Slide Copywriting

Use this skill when writing slide headlines, bullets, labels, callouts, captions, speaker notes and source notes.

Headline Rules

Write the takeaway, not the topic.
Prefer specific verbs and numbers when supported.
Avoid vague titles such as "Overview", "Background", "Analysis".
Keep headlines short enough to fit.

Body Rules

Use 3-5 bullets at most for standard content slides.
Keep bullets parallel.
Use exact units and dates for numbers.
Move nuance into speaker notes.
Do not paste paragraphs from source material.

Visual Intent Rules

For charts, state the question the chart answers.
For tables, state what comparison matters.
For diagrams, state the relationship or flow.
For timelines, state the change or sequence.
For videos, state why the viewer should click/watch and what claim the video supports.

deck_spec Element Examples

{
  "type": "text",
  "role": "body",
  "text": ["Point one", "Point two"]
}

{
  "type": "image",
  "image_path": "materials/images/processed/hero-product-1600x900.jpg",
  "alt": "Product in use",
  "caption": "Optional short caption",
  "source": "materials/images/image_manifest.json#hero_product"
}

{
  "type": "chart_placeholder",
  "chart_type": "bar",
  "title": "Revenue growth is concentrated in two segments",
  "data_source": "materials/evidence_table.md#E12"
}

{
  "type": "video_link",
  "title": "Official product demo",
  "video_url": "https://example.com/demo",
  "thumbnail_path": "materials/media/thumbnails/demo.jpg",
  "caption": "Official demo video",
  "source": "materials/media/media_manifest.json#product_demo"
}

When a template is provided, include template mapping fields when useful:

{
  "id": "S04",
  "layout": "image_text",
  "template_layout": "template slide 5: image left + text right",
  "template_slots": ["headline", "visual", "body"]
}