ozor-changelog-to-video

Ozor Changelog-to-Video Converter

Transform changelogs, release notes, and version updates into polished, ready-to-paste Ozor.ai video prompts. This skill reads structured change lists and produces scene-by-scene video prompts that announce updates in a visually compelling way.

Supported Input Types

• CHANGELOG.md — standard Keep a Changelog format
• GitHub Releases — release descriptions with tags
• Release notes — bullet-pointed feature lists
• Version summaries — "What's New" style documents
• Commit summaries — grouped commit messages for a release
• Jira/Linear release notes — exported issue lists

Workflow

Phase 1 — Parse the Changelog

Read the changelog and extract:

1. Version number — the release tag (e.g., v2.4.0)
2. Release date — when it shipped
3. Change categories — group changes by type:
   • New features — entirely new capabilities
   • Improvements — enhancements to existing features
   • Bug fixes — resolved issues
   • Breaking changes — anything that requires user action
   • Deprecations — features being phased out
4. Headline change — the single most impactful or user-requested change
5. Change count — total number of changes (used for duration estimation)

Phase 2 — Prioritize for Video

Not every changelog entry deserves a scene. Apply these rules:

Always include:

• The headline feature (biggest or most requested change)
• Any new feature that changes the user's workflow
• Breaking changes (users need to know)

Include if space allows:

• Significant improvements (performance, UX)
• Highly requested bug fixes

Skip for video (mention in notes):

• Minor bug fixes
• Internal refactors
• Dependency updates
• Documentation changes

Scene budget by change count (target ~1 scene per 3 seconds of video):

• 1–3 changes: 6–8 scenes (intro + 2–3 per change + summary + CTA)
• 4–7 changes: 10–15 scenes (intro + 2–3 per top change + summary + CTA)
• 8+ changes: 15–20 scenes (intro + 2–3 per top change + "and more" + CTA)

Phase 3 — Structure the Video

Use this proven structure for release videos:

1. Intro / Version Badge — Show the product name and version number with a clean animation. Set the tone: "What's new in [Product] [Version]"
2. Headline Feature (2–3 scenes) — The biggest change gets multiple scenes with the most visual attention:
   • Title / What it is — Feature name as headline with a one-sentence hook.
   • How it works / Visual — Show the feature in action: a UI walkthrough, animation, or diagram.
   • Impact / Benefit — Why this matters to the user. Show the outcome or result.
3. Additional Feature Scenes (2–3 scenes each) — Each prioritized change gets its own mini-sequence:
   • Title / What it is — Feature name and brief description.
   • Detail / Visual — Show what changed visually: before/after, demo, or diagram.
   • (Optional) Benefit — A short scene reinforcing the value if the change is significant enough.
4. Summary / "And More" — If changes were deprioritized, add a scene listing them briefly: "Plus: [fix 1], [fix 2], [improvement 1]"
5. CTA — "Update now", "Try it today", or "Read the full release notes at [URL]"

Phase 4 — Generate the Ozor Prompt

Output a complete, copy-pasteable prompt:

## Ozor Video Prompt

**Source:** [Product] [Version] changelog
**Video type:** Release notes / What's new
**Format:** 16:9 landscape
**Estimated duration:** [X] seconds
**Target audience:** [existing users / developers / team]

---

### Prompt (copy and paste into Ozor)

Create a [duration] release notes video for [Product] version [X.X].

[N] scenes:

(1) Version Badge — [Product] logo centered on [dark/light] background. Version number "[X.X]" appears with a subtle animation. Subtext: "[Release date] — [tagline or change count summary]".

(2) [Headline Feature Name] — Title card: feature name as bold headline. One-sentence hook: "[What this feature does in plain language]". [Visual: icon or graphic that represents the feature.]

(3) [Headline Feature Name] Detail — [Show the feature in action: UI walkthrough, screen recording style animation, or step-by-step diagram. Include exact on-screen text.]

(4) [Headline Feature Name] Impact — [Why this matters: show the outcome, time saved, or before/after comparison. On-screen text: "[Key benefit statement]".]

(5) [Feature 2 Name] — Title card: "[Feature name]" with one-line description. [Visual: icon, UI element, or metaphor.]

(6) [Feature 2 Name] Detail — [Visual demonstration of the feature: what it looks like in use, how it works, or a key screenshot-style frame. Include on-screen text.]

(7) [Feature 3 Name] — [Feature title + visual direction. For smaller features, a single scene combining title and demo is fine.]

[...continue for remaining features, 2–3 scenes per major feature, 1 scene for minor features...]

([N-1]) And More — Clean list of remaining changes: "[fix 1]", "[improvement 1]", "[fix 2]". Each appears with a check mark animation.

([N]) CTA — "[Update now / Try it today]" with [product URL]. Logo fade-out.

Style: [clean / modern / bold]. Background: [dark / light]. Accent color: [brand color].
Tone: [confident / excited / professional].
Audience: [who].

---

### Notes

- [Suggestions for assets to upload]
- [Changes that were deprioritized and could become a separate video]
- [Tips for iterating]

Adaptation Rules

If the changelog has only bug fixes:

• Frame as a reliability/quality update
• Lead with "We listened" or "Squashed bugs" messaging
• Group fixes thematically rather than listing each one
• Keep it short: 3–4 scenes max

If the changelog has a breaking change:

• Call it out prominently — users need to see this
• Use a visual warning indicator (color shift, icon)
• Explain what changed AND what the user needs to do
• Place it in scene 2 (right after intro) for visibility

If the changelog spans multiple versions:

• Combine into a "quarterly update" or "year in review" format
• Group by theme rather than version number
• Lead with the most impactful changes across all versions

If the changelog is from a GitHub Release:

• Extract the release title as the video headline
• Use the tag name as the version badge
• Parse markdown formatting for bullet points and headers

Quality Checklist

Before presenting the final prompt, verify:

• Version number is prominently displayed in scene 1
• The headline feature gets the most visual attention
• Breaking changes are clearly called out (if any)
• Each scene has exactly one change or idea
• On-screen text is short — feature names + one-line descriptions
• CTA tells the user exactly what to do
• No critical changes from the source were omitted without mention
• Deprioritized changes are listed in the Notes section

Rules

1. Every change that gets a scene must be visually described. "Show the new dashboard" is not enough — describe what the dashboard looks like, what's animated, what text appears.
2. Never invent features. Every change must come from the source changelog.
3. Prioritize user impact over technical impressiveness. A small UX fix that users requested is more video-worthy than a large internal refactor.
4. Keep it punchy. Release videos should be 30–60 seconds. A 30-second video should have ~8–10 scenes; a 60-second video should have ~15–18 scenes (roughly 1 scene per 3 seconds). Users want highlights, not documentation.
5. Version number must be visible. It appears in scene 1 and optionally in a persistent badge.