Communitygithub.com

thevibethinker/n5os-ode

Erstelle Videos programmatisch mit React mithilfe von Remotion. Projekte anlegen, Kompositionen schreiben und MP4s rendern. Zo-optimierter Wrapper um die offiziellen Remotion-Agent-Fähigkeiten.

Was ist n5os-ode?

Dieses Skill ermöglicht es dir, programmatisch Videos mit React und Remotion zu erstellen. Du kannst Projekte anlegen, Kompositionen definieren, Animationen auf Frame-Basis steuern und die Videos als MP4 rendern. Es ist speziell für die Zo-Plattform optimiert und bietet einen benutzerfreundlichen CLI-Wrapper um die offiziellen Remotion-Kompetenzen. Der Fokus liegt auf datengesteuerten Inhalten wie Charts und personalisierten Videos, nicht auf generativer KI-Videoproduktion. Alle Animationen müssen mit `useCurrentFrame()` erstellt werden; CSS-Animationen sind nicht erlaubt. Das Skill unterstützt gängige Schnittmuster wie Einblendungen, Spring-Animationen und gestaffelte Elemente und ermöglicht Batch-Rendering über `/zo/ask`. Die Projekte werden im Verzeichnis `Sites/<name>/` abgelegt, und die gerenderten Videos landen im Unterordner `out/`. Node.js wird vorausgesetzt, ist aber in Zo bereits verfügbar.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thevibethinker/n5os-ode/tree/HEAD/Skills/remotion

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Verwendung

Verwende dieses Skill, wenn:

  • Du programmatisch Videos aus Code erstellst (nicht generative KI-Videos)
  • Du datengesteuerte Videoinhalte (Diagramme, Statistiken, personalisierte Videos) erstellst
  • Du Batch-Videos aus Vorlagen und Daten produzierst
  • Du animierte Social-Media-Inhalte (TikTok, Reels, Shorts) erstellst
  • Du Produkt-/Erklärvideos mit präziser Kontrolle erstellst

Kurzanleitung

1. Neues Projekt anlegen

python3 Skills/remotion/scripts/remotion_cli.py new mein-video --template blank
cd Sites/mein-video

2. Komposition schreiben

Bearbeite src/Composition.tsx – hier wird dein Video als React-Komponente definiert.

3. In der Studio-Vorschau ansehen

python3 Skills/remotion/scripts/remotion_cli.py studio mein-video

4. Als MP4 rendern

python3 Skills/remotion/scripts/remotion_cli.py render mein-video --output output.mp4

Kernkonzepte

Kompositionen

Eine Komposition definiert Maße, Dauer und Bildrate deines Videos:

<Composition
  id="MeinVideo"
  component={MeineKomponente}
  durationInFrames={300}  // 10 Sekunden bei 30fps
  fps={30}
  width={1920}
  height={1080}
/>

Frame-basierte Animation

ALLE Animationen MÜSSEN useCurrentFrame() verwenden. CSS-Animationen sind VERBOTEN.

const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });

Sequenzen

Verwende <Sequence>, um das Erscheinen von Elementen zeitlich zu steuern:

<Sequence from={30} durationInFrames={60}>
  <Titel />
</Sequence>

Regelverweise

Lies diese für detaillierte Muster (geladen aus den übergeordneten Remotion-Fähigkeiten):

RegelBeschreibung
references/animations.mdGrundlagen der frame-basierten Animation
references/timing.mdSprings, Easing, Interpolationskurven
references/compositions.mdDefinieren von Kompositionen, Standbildern, Ordnern
references/sequencing.mdZeitliche Steuerung und Anordnung von Elementen
references/videos.mdEinbetten von Videos – Trimmen, Lautstärke, Geschwindigkeit
references/audio.mdAudiobehandlung – Import, Trimmen, Lautstärke
references/assets.mdBilder, Schriften, statische Dateien
references/transitions.mdSzenenübergänge
references/text-animations.mdTypografie-Animationsmuster
references/charts.mdDatenvisualisierungsmuster
references/display-captions.mdTikTok-artige Untertitel

CLI-Befehle

# Projektverwaltung
python3 Skills/remotion/scripts/remotion_cli.py new <name> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <name>
python3 Skills/remotion/scripts/remotion_cli.py render <name> [--composition ID] [--output pfad]
python3 Skills/remotion/scripts/remotion_cli.py list

# Rendering-Optionen
--composition ID    # Bestimmte Komposition rendern (Standard: erste)
--output PFAD       # Ausgabedateipfad (Standard: out/video.mp4)
--fps N             # Bildrate überschreiben
--width N           # Breite überschreiben
--height N          # Höhe überschreiben
--codec CODEC       # h264, h265, vp8, vp9, prores (Standard: h264)

Häufige Muster

Ein-/Ausblenden

const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();

const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;

Spring-Animation (natürliche Bewegung)

const scale = spring({
  frame,
  fps,
  config: { damping: 200 }, // Sanft, kein Nachschwingen
});

Gestaffelte Elemente

{items.map((item, i) => (
  <Sequence key={i} from={i * 10}>
    <Item data={item} />
  </Sequence>
))}

Datengesteuertes Video

type VideoProps = { titel: string; stats: number[] };

export const DatenVideo: React.FC<VideoProps> = ({ titel, stats }) => {
  // Basierend auf Props animieren
};

// In Root.tsx:
<Composition
  id="DatenVideo"
  component={DatenVideo}
  defaultProps={{ titel: "Q4-Ergebnisse", stats: [10, 20, 30] }}
  // ...
/>

Integration mit Zo

Batch-Rendering

Verwende /zo/ask, um mehrere Videos parallel zu rendern:

for row in data:
    # Jeder Aufruf rendert mit anderen Props
    await render_video(row)

Ausgabeverzeichnis

Projekte liegen in Sites/<name>/ zur Konsistenz mit Zos Site-System. Gerenderte Videos werden in Sites/<name>/out/ abgelegt.

Einschränkungen

  • Keine CSS-Animationen – Sie werden nicht korrekt gerendert
  • Keine Tailwind-Animation-Klassen – Gleiches Problem
  • Nur frame-basiert – Alle Bewegung über useCurrentFrame()
  • CPU-intensiv – Rendern benötigt Zeit; komplexe Videos = längeres Rendern
  • Node.js erforderlich – Remotion benötigt eine Node-Umgebung (in Zo bereits verfügbar)

Verwandte Skills