Communitygithub.com

Hownameee/short-videos

Remotion-Markup für Interaktivität strukturieren

Was ist short-videos?

Dieses Skill beschreibt, wie Remotion-Markup geschrieben werden muss, damit die Remotion Studio-Oberfläche interaktive Bearbeitungsfunktionen wie Anklicken, Drag-and-Drop, Größenänderung, Drehung und CSS-Stilbearbeitung erkennt und ermöglicht. Es erklärt, wie man mit `Interactive.withSchema()` wiederverwendbare, interaktive Komponenten erstellt, die eigene Zeitleisten erhalten, und wie man Schemafelder definiert, um nur die gewünschten Eigenschaften editierbar zu machen. Das Skill behandelt Best Practices wie das Verwenden von Inline-Styles, animieren mit `interpolate()` direkt im Markup, das Benennen von Elementen mit aussagekräftigen `name`-Props und das Registrieren von Komponenten als eigenständige Compositionen für die Studio-Zeitleiste. Es ist für Entwickler gedacht, die mit Remotion Videos erstellen und diese im Remotion Studio interaktiv bearbeitbar machen möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/remotion-interactivity

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

short-videos preview

Dokumentation

Was macht short-videos?

Durch das Schreiben von Remotion-Markup in einer bestimmten Art und Weise ist das Remotion Studio in der Lage, die Struktur des Codes zu erkennen und ihn interaktiv zu machen:

  • Elemente können durch Anklicken ausgewählt werden
  • Drag-and-Drop, Größenänderung und Drehung sind möglich
  • CSS-Stile können bearbeitet werden
  • Keyframes und Easing-Werte sind editierbar

Wenn das Markup für das Studio zu komplex ist, um es interaktiv zu machen, werden die Werte ausgegraut.

Bevorzuge interaktive Komponenten mit eigenen Zeitleisten

Verwende Interactive.withSchema({wrapInSequence: true}) für benutzerdefinierte Szenen, Karten, Titel und andere visuelle Komponenten, deren Props pro Instanz bearbeitbar sein sollen. Lege aussagekräftige Inhalts- und Darstellungssteuerungen in einem InteractivitySchema offen. Behalte dekorative Implementierungsdetails innerhalb der Komponente.

Die Komponente muss style akzeptieren und an eine visuelle Wurzel weiterleiten. Behalte eine gemeinsame Wurzel bei, wenn Transformationen, Zuschnitt oder Deckkraft alle ihre Ebenen betreffen sollen. Glätte redundante innere Wrapper, wenn ihre Stile auf ein vorhandenes Element verschoben werden können, ohne das Layout oder die Animation zu verändern.

import type React from 'react';
import {Interactive, type InteractivitySchema} from 'remotion';

type LowerThirdProps = {
  readonly children: string;
  readonly accentColor: string;
  readonly style?: React.CSSProperties;
};

const LowerThirdInner: React.FC<LowerThirdProps> = ({
  children,
  accentColor,
  style,
}) => {
  return (
    <Interactive.Div
      style={{
        position: 'absolute',
        left: 80,
        bottom: 80,
        display: 'flex',
        alignItems: 'center',
        gap: 20,
        backgroundColor: 'white',
        borderRadius: 16,
        padding: '20px 32px',
        color: 'black',
        fontFamily: 'Helvetica, Arial, sans-serif',
        fontSize: 48,
        fontWeight: 600,
        ...style,
      }}
    >
      <div
        style={{
          width: 8,
          alignSelf: 'stretch',
          borderRadius: 4,
          backgroundColor: accentColor,
        }}
      />
      {children}
    </Interactive.Div>
  );
};

const lowerThirdSchema = {
  children: {type: 'text-content', default: '', description: 'Text'},
  accentColor: {
    type: 'color',
    default: '#0b84f3',
    description: 'Akzentfarbe',
  },
} as const satisfies InteractivitySchema;

export const LowerThird = Interactive.withSchema({
  Component: LowerThirdInner,
  componentName: '<LowerThird>',
  schema: lowerThirdSchema,
  wrapInSequence: true,
});

Das Weiterleiten des injizierten style innerhalb der Komponente ist erforderlich; halte editierbare Stile inline an der Aufrufstelle der Komponente.

Schemafelder auswählen

Jeder Schlüssel im Schema ist ein Prop, das das Studio an der Aufrufstelle lesen und bearbeiten kann. Props, die nicht im Schema sind, funktionieren weiterhin, sind aber im Studio nicht bearbeitbar. Schlüssel können Punktnotation verwenden, z. B. style.color.

TypVerwendung fürKeyframable
text-contentText, z. B. ein TitelNein
numberZahlen, mit optionalen min, max, step, integerJa
booleanEin/Aus-SchalterJa (halten)
colorCSS-FarbstringsJa
enumEine Auswahl zwischen variants, jede mit eigenem verschachteltem SchemaOpt-in (halten)
arrayListen von Zahlen, Farben, Enums und mehrNein
assetMedienquellen, mit optionalem assetTypeNein
font-familyCSS-SchriftfamilieNein
font-weightSchriftstärkeJa
translate, scale, rotation-css, rotation-degrees, transform-originTransformationenJa
uv-coordinateEin normalisierter [x, y]-Punkt auf dem ElementJa
svg-pathSVG-PfaddatenJa
remotion-captionsCaption[]-DatenNein
hiddenEin Wert, der aus den Steuerelementen herausgehalten wird—

Jedes Feld benötigt einen default-Wert und sollte eine description haben, die das Studio als Beschriftung anzeigt. Setze keyframable: false, um ein statisches Steuerelement anzuzeigen.

Lege Inhalt und pro-Instanz-Darstellung offen, wie z. B. den Text und eine Akzentfarbe. Füge keine Felder für style.translate, style.scale, style.rotate, style.transformOrigin und style.opacity hinzu: wrapInSequence: true fügt sie bereits hinzu.

Um CSS-Eigenschaften der Wurzel pro Instanz bearbeitbar zu machen, verteile die integrierten Schemafragmente:

const cardSchema = {
  ...Interactive.textSchema, // style.color, style.fontSize, style.fontWeight, ...
  ...Interactive.backgroundSchema, // style.backgroundColor
  ...Interactive.borderRadiusSchema, // style.borderRadius, ...
} as const satisfies InteractivitySchema;

Ebenfalls verfügbar: Interactive.borderSchema und Interactive.captionsSchema für Komponenten, die Untertitel akzeptieren. Siehe InteractivitySchema für alle Optionen.

Registriere wiederverwendbare Komponenten als verbundene Compositionen

Registriere wesentliche Szenen und wiederverwendbare Komponenten mit eigenen Ebenen oder Animationen als eigenständige Compositionen. Das Studio nennt diese verbundene Compositionen: Sie können in einer eigenen Zeitleiste geöffnet werden, während sie dieselbe Komponentenimplementierung mit dem übergeordneten Video teilen.

Registriere denselben exportierten Komponentenverweis, den das übergeordnete Element rendert. Für das obige Beispiel verwende component={LowerThird}, nicht LowerThirdInner oder einen Inline-Wrapper. Mit wrapInSequence: true ist kein zusätzliches <Sequence> für die Verbindung erforderlich.

import {Composition} from 'remotion';
import {LowerThird} from './LowerThird';

export const RemotionRoot = () => (
  <Composition
    id="LowerThird"
    component={LowerThird}
    width={1280}
    height={720}
    fps={30}
    durationInFrames={30}
    defaultProps={{
      children: 'Jane Doe, Product Designer',
      accentColor: '#0b84f3',
    }}
  />
);

Wähle eine eindeutige ID, repräsentative Inline-Standardwerte und für die Vorschau der Komponente geeignete Abmessungen, fps und Dauer. Die Registrierungsstandardwerte kopieren nicht automatisch Props von einer übergeordneten Instanz. Siehe verbundene Compositionen für Registrierungs- und Extraktionsdetails.

Setze Timing direkt auf die Komponente

Vermeide ein separates <Sequence> um eine Komponente, die bereits Timing-Props akzeptiert. Integrierte interaktive Komponenten und benutzerdefinierte Komponenten, die mit wrapInSequence: true erstellt wurden, können name, from, durationInFrames, trimBefore, playbackRate und premountFor direkt empfangen.

<LowerThird
  name="Lower third"
  from={30}
  durationInFrames={90}
  accentColor="#0b84f3"
>
  Jane Doe, Product Designer
</LowerThird>

Wenn du eine redundante Sequenz entfernst, verschiebe ihr Timing und ihren Namen auf das Kind. Bewahre vorhandenes Timing des Kindes; überschreibe oder verdopple keine Offsets nicht. Ein useCurrentFrame()-Aufruf innerhalb der Komponente liest ihren lokalen Frame, während ein Stilausdruck an der Aufrufstelle immer noch den Frame des Aufrufers verwendet. Bewahre diese Unterscheidung beim Verschieben von Animationsstilen.

Behalte ein <Sequence> bei, wenn es gemeinsames Timing für mehrere Geschwister bereitstellt, Abmessungen für useVideoConfig() überschreibt oder eine Komponente umschließt, die kein Timing verarbeitet. Behalte <Series.Sequence> für aufeinanderfolgendes Layout und <TransitionSeries.Sequence> für Übergänge bei; direkte from-Props ersetzen diese Verhaltensweisen nicht.

Gib jedem einzeln bearbeitbaren Element einen eigenen JSX-Knoten

Das Studio bearbeitet den JSX-Quellknoten, der ein Element erstellt hat. Wenn mehrere Laufzeitelemente vom selben JSX-Knoten stammen, teilen sie sich ein Quellbearbeitungsziel.

Für jede Composition-Registrierung, jedes Clip, jede Szene, jede Ebene oder Sequenz, die eigenständig bearbeitbar sein soll, schreibe einen separaten JSX-Knoten und behalte seine editierbaren Props auf diesem Knoten. Dies gilt für <Composition>, <Still>, integrierte Medienkomponenten, <Sequence>, <Series.Sequence>, <TransitionSeries.Sequence> und benutzerdefinierte Komponenten.

Zum Beispiel autorisiere eine editierbare Zeitleiste wie folgt:

<Series>
  <Series.Sequence name="Einführung" durationInFrames={90}>
    <Introduction />
  </Series.Sequence>
  <Series.Sequence name="Demo" durationInFrames={150}>
    <Demo />
  </Series.Sequence>
</Series>

Ein .map() oder eine andere programmatische Schleife würde mehrere Laufzeitelemente aus einem JSX-Quellknoten erstellen. Das ist angemessen für wiederholte Ausgabe, die absichtlich als eine Vorlage gesteuert wird, wie z. B. Visualisierungsbalken oder Partikel. Es ist nicht angemessen, wenn die Instanzen unabhängige IDs oder Namen, Props, Metadaten, Timing, Reihenfolge, Löschung oder Duplizierung im Studio benötigen.

Mache ein HTML-Element mit Interactive interaktiv

Jedes HTML- und SVG-Element (außer <Img>, es ist bereits interaktiv) wie <div> kann mit Interactive interaktiv gemacht werden:

<Interactive.Div
  name="Grußkarte"
  style={{fontSize: 80, padding: 24}}
>
  Hallo
</Interactive.Div>

Dies ermöglicht das Setzen von Stilen und Keyframes im Studio. Sei vernünftig, wenn eine Komponente viele Elemente hat, könnte die Zeitleiste unübersichtlich werden.

Bevorzuge Inline-Text

Wenn Text festgelegt und nur einmal verwendet wird, schreibe ihn direkt innerhalb des interaktiven Elements, anstatt ihn in eine Konstante zu extrahieren.

// 👍 Fester Text bleibt editierbar
<Interactive.Div name="Titel">
  Remotion Best Practices
</Interactive.Div>

Verwende ein Prop oder eine Variable nur, wenn der Text dynamisch oder wiederverwendet wird.

Gib interaktiven Elementen einen beschreibenden Namen

Füge ein name-Prop zu Elementen hinzu, um sie leicht identifizierbar zu machen. Vermeide berechnete Namen, gib sie fest ein.

<>
  <Interactive.Div name="Heldentitel" style={{fontSize: 80}}>
    Launch day
  </Interactive.Div>
  <Img name="Avatar" src="https://remotion.media/image.jpeg" />
  <Video name="Hintergrund" src="https://remotion.media/video.mp4" />
  <Interactive.Div name="Titel">
    Launch day
  </Interactive.Div>
</>

Behalte alle CSS-Stile inline

Der beste Weg ist, einfach ein einfaches Objekt an style zu übergeben - keine Verweise auf Konstanten, kein Object Spreading, keine Mathematik.

<Interactive.Div
  style={{
    fontSize: 80,
    color: 'red',
  }}
>
  Hallo Welt!
</Interactive.Div>
const baseStyle = useMemo(() => {
  return {
    fontSize: 12 // ❌ Nicht-Inline-Stile werden nicht unterstützt
  }
}, []);

<Interactive.Div
  style={{
    ...baseStyle, // ❌ Spreading wird nicht unterstützt
    color: ROT, // ❌ Verweise auf Konstanten werden nicht unterstützt
    scale: frame * 10 // ❌ Mathematik wird nicht unterstützt
  }}
>
  Hallo Welt!
</Interactive.Div>

Animiere mit interpolate()

Schreibe Animationen als Inline-interpolate()-Aufrufe auf die Eigenschaft, die sich ändert. Der Ausgabebereich, das Easing, die Extrapolation und die output-Eigenschaft sollten fest codierte Werte verwenden.

Der Eingabebereich kann zusätzlich durationInFrames, fps, width und height verwenden, die direkt aus useVideoConfig() destrukturiert wurden. Bloße Bezeichner wie durationInFrames, Multiplikation mit einer Zahl wie 2 * fps oder fps * 2 und Subtraktion einer Zahl wie durationInFrames - 1 werden unterstützt.

const {fps, durationInFrames} = useVideoConfig();

// 👍 Inline-Werte können standardisiert und keyframed werden
<Interactive.Div
  name="Produktkarte"
  style={{
    color: 'white',
    fontSize: 80,
    scale: interpolate(frame, [0, fps], [0, 1], {
      easing: Easing.spring({damping: 200}),
      output: 'perceptual-scale',
      extrapolateLeft: 'clamp',
      extrapolateRight: 'clamp'
    }),
    rotate: interpolate(frame, [0, 1 * fps], ['0deg', '20deg'], {
      easing: Easing.spring({damping: 200}),
      extrapolateLeft: 'clamp',
      extrapolateRight: 'clamp'
    }),
    translate: interpolate(
      frame,
      [durationInFrames - 30, durationInFrames],
      ['0px 0px', '0px 120px'],
      {
        easing: Easing.spring({damping: 200}),
        output: 'perceptual-scale',
        extrapolateLeft: 'clamp',
        extrapolateRight: 'clamp'
      }
    ),
  }}
/>
const translateY = interpolate(frame, [0, 30], [0, 120]); // ❌ Mathematik sollte direkt im Markup sein

<Interactive.Div
  name="Produktkarte"
  style={{
    translate: translateY, // ❌ Nur Inline-interpolate()-Aufrufe werden unterstützt,
    rotate: interpolate(frame, [start, start + 10], [0, Math.PI]), // ❌ Kann keine Mathematik mit beliebigen Variablen verwenden, kann keine Konstanten verwenden
    scale: interpolate(anyVariable, [0, 30], [0, 1]) // ❌ Kann nur die `frame`-Variable interpretieren.
  }}
/>

Halte SVG-Pfade …

[abgeschnitten für Übersetzung]

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

Verwandte Skills