Communitygithub.com

beimeibeile/Remotion-Steuerungs-Skill

Professioneller Skill zur codegesteuerten Videoanimation mit Remotion. Präzise 2D-Animationen mit React/TypeScript, native Unterstützung für transparenten Hintergrund (Alpha-Kanal). Ausgabe von WebM/MOV mit Alpha-Kanal. Ideal für Vorlagenmaterial, UI-Animationen, Textanimationen und 2D-Charakteranimationen.

Was ist Remotion-Steuerungs-Skill?

Dieser Skill ermöglicht die präzise, programmgesteuerte Erstellung von 2D-Animationen und Videos mittels des React-basierten Frameworks Remotion. Er bietet native Unterstützung für die Ausgabe mit transparentem Hintergrund (Alpha-Kanal), was ihn ideal für die Produktion von Overlays, UI-Animationen und Vorlagenmaterial macht, das nahtlos in andere Videos integriert werden kann. Der Skill umfasst eine umfangreiche Bibliothek an vorgefertigten Komponenten für Charakter-, Text-, Übergangs- und Effekt-Animationen, die über einen JSON-basierten Template-Mechanismus gesteuert werden können. Er bietet sowohl eine CLI als auch eine HTTP-API zur Steuerung und Rendering, sowie automatisierte Qualitätskontrolle zur Sicherstellung der Alpha-Kanal-Integrität und anderer Parameter. Im Gegensatz zu KI-gesteuerter Generierung (ComfyUI) oder 3D-Animation (Blender) liegt der Fokus auf vollständig kontrollierbaren, deterministischen 2D-Animationen, die sich perfekt für die Integration in professionelle Video-Workflows, wie z.B. mit CapCut-Vorlagen, eignen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add beimeibeile/Remotion-controls-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Remotion-Steuerungs-Skill?

Ein professioneller Skill zur codegesteuerten Videoanimation mit Remotion. Remotion ist ein auf React basierendes Videoerstellungs-Framework, das es ermöglicht, jedes Bild präzise mit Code zu steuern und nativ transparente Hintergründe zu rendern.

Kernfähigkeiten

FähigkeitBeschreibung
Transparenter HintergrundNative Alpha-Kanal-Unterstützung, Ausgabe von WebM (VP9) / MOV (ProRes 4444) mit transparentem Video
Codegenaue SteuerungPräzise Steuerung von Position, Skalierung, Rotation, Transparenz und Easing-Kurven mit React/TypeScript
API-ServiceHTTP-API zum Empfangen von Animationsbefehlen und Ausgeben von Videodateien
VorlagenbibliothekVoreingestellte Animationsvorlagen (Charakter-, UI-, Textanimationen, Übergangseffekte)
QualitätskontrolleAutomatische Prüfung von Bildrate, Auflösung, Bitrate und Alpha-Kanal-Integrität
SelbstlernendErfassung von Rendering-Parametern und Bewertungen zur Optimierung von Voreinstellungen

Abgrenzung zu ComfyUI / Blender

SkillKernvorteilAnwendungsszenarien
ComfyUI-SteuerungKI-Generierung (Bild/Video/Audio), kreativ aber unkontrollierbarGenerierung von Charakteren, Szenen, Effektvideos
Blender-Steuerung3D-Animation, Physiksimulation, hochwertiges Rendering3D-Charakteranimation, Produktpräsentationen, physikalische Effekte
Remotion-Steuerung2D-Code-Animation, präzise steuerbar, transparenter HintergrundVorlagenmaterial, UI-Animationen, Textlayouts, 2D-Charakteranimation

Schnellstart

1. Abhängigkeiten installieren

cd remotion-project
npm install

2. Video mit transparentem Hintergrund rendern

# CLI-Methode
npx remotion render src/index.ts MeineKomposition out/video.webm --transparent

# API-Methode
python remotion_controls.py render --composition MeineKomposition --output out/video.webm --transparent

3. API-Dienst starten

python remotion_controls.py serve --port 8765

Hinweise zum Rendern mit transparentem Hintergrund (Verifizierter Prozess)

Remotion unterstützt nativ transparente Hintergründe, aber die --transparent-Kodierung über die CLI führt zum Verlust des Alpha-Kanals (für WebM VP8/VP9 und MOV ProRes verifiziert).

Korrigierter Prozess (PIT-024):

  1. PNG-Sequenz rendern: npx remotion render src/index.ts Komposition out/frames --sequence (Ausgabe von PNG mit Alpha-Kanal)
  2. ffmpeg-komprimieren zu ProRes 4444:
    ffmpeg -y -framerate 30 -i out/frames/%04d.png \
      -c:v prores_ks -profile:v 4 -pix_fmt yuva444p12le \
      out/animation.mov
    
  3. Alpha-Kanal prüfen: python verify_animation.py out/animation.mov

Wichtig für die CapCut-Integration (PIT-024):

  • add_media_safe importiert ProRes 4444 mov und führt zum Verlust des Alpha-Kanals (durch Transkodierung in H.264 mp4, was 66 MB auf 0,07 MB reduziert)
  • Manueller Import erforderlich: Kopiere das mov direkt in das materials-Verzeichnis des Projekts → Erstelle ein VideoMaterial → Registriere es in materials.videos → Erstelle ein VideoSegment(material=anim_material) → Führe add_segment aus

Qualitätsstandard für Animationsmaterial

Vollständiger Standard in QUALITY_STANDARD.md.

Harte Kriterien für qualitativ hochwertiges Animationsmaterial:

  • Alpha-Kanal erhalten (yuva444p12le)
  • ProRes 4444 Kodierung (profile=4)
  • Auflösung, Bildrate und Dauer gemäß Konfiguration
  • Inhaltsabdeckung ≥ 50% (10-Punkt-Abtastung)
  • Angemessene Dateigröße (≤ 15 MB/s)

Automatisierte Prüfung:

python verify_animation.py <Animationsdatei> --duration 20 --width 1080 --height 1920

Komponentenbibliothek für Basis-Animationen

Befindet sich in remotion-project/src/components/, alle Komponenten unterstützen transparenten Hintergrund.

Charakter- und Bewegungskomponenten

KomponenteBeschreibung
CharacterSpriteCharakter-Sprites: Multi-Posen-Wechsel, Keyframe-Animation für Position/Skalierung/Rotation/Transparenz
MotionPathBewegungspfade: Lineare/Bezier/Elastische/Springende Bewegung
FlashEffectWeissblitz-Effekt: Schnelles Einblenden, langsames Ausblenden
ShakeEffectWackeleffekt: Zufälliges Wackeln mit abnehmender Amplitude
FadeEffectEin-/Ausblenden: Steuerbare Dauer für Ein- und Ausblenden
PopEffectPop-Up-Effekt: Elastisch skalierendes Einblenden
SlideEffectSchiebe-Effekt: Gleitendes Ein-/Ausblenden aus vier Richtungen

Textanimations-Komponenten (TextAnimations.tsx)

KomponenteBeschreibungAnwendungsszenarien
TextRevealZeichenweise Einblendung: Schreibmaschine/Einblenden/Hochschieben/LinksschiebenErzählstimme, Dialoge, Titel-Intro
TextPopPoppende Schrift: Skalierung/Rotation/SpringenBetonung von Schlüsselwörtern, Beat
TextWaveWellenschrift: Zeichenweise sinusförmiges SchwebenStilistischer Spaß, Hintergrundmusik-Rhythmus
TextGlitchGlitch-Stil: RGB-Trennung + ZitternTechnologie-Look, Glitch-Art, Übergänge
TextGradientVerlauf mit fließendem Licht: Farbverlauf + ScheinwerferTitel, Markennamen, hochwertiger Look
KineticTextDynamisches Layout: Mehrzeilige kombinierte AnimationEröffnungstitel, Abspann

Übergangseffekte (TransitionEffects.tsx)

KomponenteBeschreibungAnwendungsszenarien
FadeTransitionEin-/Ausblendübergang (in/out/inOut)Allgemeine Übergänge, emotionale Übergänge
SlideTransitionSchiebeübergang (oben/unten/links/rechts)Szenenwechsel, Inhaltswechsel
ZoomTransitionZoomübergang (Heranzoomen/Wegzoomen)Betonung von Punkten, Kamera-Heranfahrt
WipeTransitionWischübergang (oben/unten/links/rechts/diagonal)Kreative Übergänge, Stilisierung
BlurTransitionUnschärfeübergang (zuerst unscharf, dann scharf)Traumhafte Übergänge, Rückblenden
GlitchTransitionGlitch-Übergang (RGB-Trennung + Scanlinien)Technologie-Look, Glitch-Art

Impact-Effekte (ImpactEffects.tsx)

KomponenteBeschreibungAnwendungsszenarien
PunchImpactSchlag-Impact (Schockwelle + Sterne + Weissblitz)Kampf, Schlag, Kollision
ImpactFlashImpact-Blitz (schneller Weissblitz)Harte Schläge, Explosionen, Beat
ParticleBurstPartikelexplosion (Sterne/Funken/Splitter)Feiern, Explosionen, Impact
ShockwaveSchockwelle (mehrere sich ausbreitende Ringe)Energieentladung, Explosion, Erschütterung
SpeedLinesGeschwindigkeitslinien (radial)Hochgeschwindigkeits-Impact, Sprint, Combo

Anwendungsbeispiel:

import { PunchImpact, ParticleBurst, FadeTransition } from "./components";

// Kampfszene
<PunchImpact startFrame={90} x={540} y={800} scale={1.2} />
<ParticleBurst startFrame={90} x={540} y={800} count={16} particleType="star" />
<FadeTransition direction="in" duration={15} startFrame={0} color="#1a1a2e" />

Anwendungsbeispiel:

import { CharacterSprite, FlashEffect, TextReveal, TextPop } from "./components";

<CharacterSprite
  poses={[
    { name: "idle", image: "/doubao_normal.png", frameRange: [0, 90],
      position: [{frame: 0, x: 0, y: 0}, {frame: 90, x: 100, y: 0}] },
    { name: "falling", image: "/doubao_falling.png", frameRange: [90, 150] },
  ]}
  width={250} height={250}
/>
<FlashEffect startFrame={90} duration={10} />
<TextReveal text="Wurde getroffen!" fontSize={56} startFrame={95} revealType="typewriter" />
<TextPop text="Autsch!" fontSize={72} color="#ff6b6b" startFrame={110} popType="bounce" />

Projektstruktur

remotion-controls-skill/
├── SKILL.md                    # Diese Datei
├── QUALITY_STANDARD.md         # Qualitätsstandard für Animationsmaterial
├── verify_animation.py         # Automatisiertes Prüfwerkzeug
├── remotion_controls.py        # Hauptsteuerungsskript (CLI/API)
├── .env.example                # Beispiel-Umgebungsvariablen
├── .gitignore
├── capabilities/
│   ├── cap_api_wrapper/        # Remotion API-Wrapper
│   ├── cap_animation_renderer/ # Animations-Renderer
│   ├── cap_template_library/   # Animationsvorlagen-Bibliothek
│   ├── cap_quality_control/    # Qualitätskontrolle
│   └── cap_self_evolution/     # Selbstlernende Evolution
├── remotion-project/           # Remotion Projekt
│   ├── src/
│   │   ├── components/         # Basis-Animation-Komponentenbibliothek
│   │   │   ├── CharacterSprite.tsx
│   │   │   ├── MotionPath.tsx
│   │   │   ├── Effects.tsx
│   │   │   └── index.ts
│   │   ├── AnimationTemplate.tsx  # JSON-gesteuerte Animationsvorlage
│   │   ├── Root.tsx
│   │   └── index.ts
│   ├── public/                 # Statische Materialien (Charakter-/Prop-Bilder)
│   └── package.json
└── out/                        # Rendering-Ausgabe

Fähigkeitsmodule

cap_api_wrapper — Remotion API-Wrapper

  • render_media(): Video rendern (Unterstützung für transparenten Hintergrund)
  • render_still(): Einzelnes Standbild rendern
  • select_composition(): Verfügbare Composition-Liste abrufen
  • get_props_schema(): Props-Definition für eine Composition abrufen

cap_animation_renderer — Animations-Renderer

  • Eingabe von Animationsbefehlen (JSON) → Ausgabe von Video mit transparentem Hintergrund
  • Unterstützt Keyframe-Animation (Position/Skalierung/Rotation/Transparenz)
  • Unterstützt Easing-Kurven (ease-in/ease-out/ease-in-out/linear/spring)
  • Unterstützt Mehrschicht-Komposition

cap_template_library — Animationsvorlagen-Bibliothek

  • Charakter-Animation-Vorlagen (Doubao wird getroffen, Emotionswechsel usw.)
  • UI-Animation-Vorlagen (Button-Klick, Seitenwechsel usw.)
  • Text-Animation-Vorlagen (Schreibmaschine, Ein-/Ausblenden, Springen usw.)
  • Übergangs-Vorlagen (Ein-/Ausblenden, Schieben, Zoomen usw.)

cap_quality_control — Qualitätskontrolle

  • Bildratenprüfung (24/30/60 fps)
  • Auflösungsprüfung (1080p/4K)
  • Alpha-Kanal-Integritätsprüfung
  • Vergleich der Videodauer mit Erwartung
  • Prüfung auf angemessene Dateigröße

cap_self_evolution — Selbstlernende Evolution

  • Aufzeichnung von Rendering-Parametern und Bewertungen
  • Optimierung von Voreinstellungen
  • Generierung von Best-Practice-Dokumenten
  • Bestenliste für Vorlageneffekte

Umgebungsvariablen

REMOTION_PROJECT_PATH=./remotion-project
REMOTION_OUTPUT_DIR=./output
REMOTION_DEFAULT_FPS=30
REMOTION_DEFAULT_WIDTH=1080
REMOTION_DEFAULT_HEIGHT=1920
REMOTION_API_PORT=8765

Integration mit ai-video-editor

Der Remotion-Steuerungs-Skill dient als Animationsmaterial-Erstellungswerkzeug für den ai-video-editor:

  1. Die Direktoren-Engine des ai-video-editors gibt Animationsbefehle aus
  2. Der Remotion-Steuerungs-Skill empfängt die Befehle und rendert Videos mit transparentem Hintergrund
  3. Die Videos mit transparentem Hintergrund werden als Animationsmaterialschicht für CapCut-Vorlagen verwendet
  4. Nach dem Ersetzen des Hintergrunds durch den Benutzer überlagert sich die Animation perfekt

Hinweise

  • Remotion erfordert Node.js 18+ Umgebung
  • Für transparente Hintergrundvideos wird das WebM-Format empfohlen (gute CapCut-Kompatibilität)
  • Das Rendern langer Videos ist zeitaufwändig; es wird empfohlen, in Segmenten zu rendern und dann zu kombinieren
  • Vermeiden Sie CSS-Filter in Animationen (einige Filter unterstützen keine transparenten Hintergründe)

Verwandte Skills