Communitygithub.com

MattiaIppoliti/tia-skills

Steuere den Remotion CLI-Entwicklungszyklus: Scaffold, Studio, Typprüfung, Kompositionen, Standbildtests, Einzel- und Batch-Rendering, Bundle, Lambda- und Cloud Run-Rendering, Benchmarking, Versionen, Upgrade und GPU-Prüfungen. Verwende es auch zur Diagnose von Build- oder Rendering-Fehlern oder wenn eine Fähigkeit gesucht wird, die das eingestellte HyperFrames CLI besaß.

Was ist tia-skills?

Dieses Skill ermöglicht es einem KI-Agenten, den gesamten Entwicklungszyklus der Remotion CLI zu steuern, von der initialen Projektgenerierung über die Typüberprüfung, Studio-Vorschau, Standbildtests, Einzel- und Batch-Rendering bis hin zum AWS Lambda- oder Cloud Run-Rendering. Die dokumentierte Befehle `npx remotion` dienen als maßgebliche Referenz – Flags ändern sich zwischen Releases, daher ist die Ausgabe von `--help` vorrangig vor jeglicher Liste. Das Skill beschreibt detailliert die optimale Iterationsschleife (Scaffold → Typprüfung → Liste → Standbildtest → Studio → Rendern → Remote-Ship), gibt aber auch konkrete Tipps zur Leistungssteigerung (z.B. `--jpeg` oder Anpassung von `--concurrency`) und zur Fehlerdiagnose (z.B. hängende Renders aufgrund nicht freigegebener `delayRender()`-Handles). Zusätzlich zeigt das Skill die Migration vom eingestellten HyperFrames CLI zu Remotion auf und enthält eine Tabelle, die alte `hyperframes`-Befehle den entsprechenden Remotion-Äquivalenten gegenüberstellt. Plattformen: CLI, Studio, Lambda, Cloud Run.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/hyperframes-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

Remotion CLI

Das Werkzeug ist remotion, aus @remotion/cli. Jeder Befehl wird mit npx remotion <command> ausgeführt, und jeder davon bündelt zuerst das Projekt, sodass sich ein Typfehler oder ein schlechter Import eher als Bündelungsfehler und nicht als Render-Fehler äußert.

npx remotion --help und npx remotion <command> --help sind die maßgebliche Quelle für Flags. Flags ändern sich zwischen den Releases; lies die Hilfeausgabe, anstatt einer Liste (auch dieser hier) zu vertrauen. Das Folgende beschreibt die Schleife und die Fehlermodi, keine Flag-Referenz.

Die Schleife

PhaseBefehlGrund
Scaffoldnpx create-video@latest --blankSchreibt passende package.json, remotion.config.ts, tsconfig
Typprüfungnpx tsc --noEmitDas günstigste Hindernis; erfasst Schema-/Prop-Drift vor jedem Render
Listenpx remotion compositionsBestätigt, dass die id, die du rendern willst, tatsächlich existiert
Standbildtestnpx remotion still <id> out/probe.png --frame=<n>Sekunden, nicht Minuten; das Arbeitstier der Iteration
Überprüfungnpx remotion studioÜbergib es dem Benutzer; er scrubbt und bearbeitet Props selbst
Rendernnpx remotion render <id> out/video.mp4Erst nachdem der Benutzer zugestimmt hat
Remote ausliefernnpx remotion bundle → npx remotion lambda render <url> <id>Verteiltes Rendern; erfordert bereitgestellte AWS-Infrastruktur

Standbilder testen vor dem Rendern

Ein vollständiger Render einer 45-sekündigen 1080p-Komposition dauert Minuten. Ein Standbild dauert Sekunden und beantwortet die meisten Fragen: Ist der Text im Bild, wurde das Asset geladen, stimmt die Farbe. Teste den Mittelpunkt jeder Szene, schau dir jedes Bild an und rendere erst dann.

npx remotion still launch out/s1.png --frame=45
npx remotion still launch out/s2.png --frame=180

Melde niemals eine Komposition als funktionierend aufgrund eines erfolgreichen Bundles. Sieh dir Pixel an.

Studio ist die Überprüfungsfläche, nicht dein Debugger

npx remotion studio stellt das Projekt mit einer Timeline, einem Props-Editor (gesteuert durch das Zod-Schema) und frame-genauer Sicht bereit. Übergib es dem Benutzer zur Freigabe. Für deine eigene Verifikation bevorzugst du still-Tests: Sie sind skriptbar und du kannst dir die Ausgabe ansehen, ohne den Benutzer bitten zu müssen, zu beschreiben, was er sieht.

Props übergeben

--props akzeptiert einen JSON-String oder einen Pfad zu einer JSON-Datei und überschreibt defaultProps:

npx remotion render launch out/video.mp4 --props='{"productName":"Acme"}'

Ein Prop, das das Zod-Schema der Komposition nicht besteht, führt zu einem lauten Render-Fehler. Das ist der Sinn der Schema-Deklaration, also halte sie genau.

Batch-Rendering

Es gibt keinen Batch-Unterbefehl. Schleife in der Shell über IDs oder Prop-Payloads:

for id in $(npx remotion compositions --quiet); do
  npx remotion render "$id" "out/$id.mp4"
done

Für viele Render einer Komposition über einen Datensatz hinweg bevorzuge renderMedia() aus @remotion/renderer in einem Node-Skript: Es bündelt einmal statt einmal pro Render, was die Wanduhrzeit dominiert.

Render-Leistung

  • --concurrency=<n> setzt parallele Worker. Der Standard ist die Hälfte der CPU-Kerne, gedeckelt bei 8; das Maximum ist die Anzahl der Kerne, und mehr zu verlangen ist ein Fehler, keine Begrenzung. Auf einem Arbeitsspeicher-knappen Gerät senkt es die Zahl, was Crashes behebt, die wie Renderer-Fehler aussehen.
  • --jpeg (anstelle des standardmäßigen PNG-Frame-Formats) ist eine große Beschleunigung, wenn die Komposition keine Transparenz beibehält.
  • npx remotion benchmark misst einen echten Render, verwende es also, um eine Änderung der Parallelität oder des Codecs zu rechtfertigen, anstatt zu raten.
  • npx remotion gpu meldet, was der Browser tatsächlich beschleunigen wird. Es lohnt sich, dies zu überprüfen, bevor man einen Shader oder einen schweren Filter für einen langsamen Render verantwortlich macht.

Fehlerdiagnose

SymptomWahrscheinliche Ursache
Bündelung schlägt fehlEin Typfehler oder ein schlechter Import. Führe npx tsc --noEmit für die lesbare Version des gleichen Fehlers aus.
„Keine Komposition mit der ID …“Die id in Root.tsx unterscheidet sich von der übergebenen. npx remotion compositions klärt das.
Render hängt, dann ZeitüberschreitungEin delayRender() ohne passendes continueRender(). Jeder Delay-Handle muss freigegeben werden.
Jeder Frame sieht aus wie Frame 0Eine CSS-Animation/Transition oder requestAnimationFrame. Der Renderer erhöht die Browser-Uhr nicht.
Animation stroboskopiert oder flackert von Frame zu FrameUnseeded Math.random(). Verwende random(seed) stattdessen.
Bewegung funktioniert beim Vorwärts-Scrubben, bricht bei SprungZustandsgesteuerte Animation. Leite stattdessen von useCurrentFrame() ab.
Asset 404 nur in einem Lambda- oder gebündelten RenderEin hartcodierter Pfad anstelle von staticFile().
Versionsfehler, der keinen Sinn ergibtNicht übereinstimmende Remotion-Pakete. npx remotion versions meldet die Abweichung.
Arbeitsspeicherüberlauf mitten im RenderParallelität zu hoch für die Maschine. Senke --concurrency.

Gib die tatsächliche Fehlerausgabe an, wenn du einen Fehler meldest. Paraphrasiere keinen Stacktrace.

Wo die Fähigkeiten des eingestellten HyperFrames CLI geblieben sind

Das alte hyperframes CLI bündelte Autoren-, Medien- und QA-Befehle, die die Remotion-CLI nicht hat. Nichts unten ist ein Remotion-Befehl, versuche also nicht, sie auszuführen:

Eingestellter BefehlWo die Fähigkeit jetzt lebt
initnpx create-video@latest --blank, dann /hyperframes-core → references/project-structure.md
lint, check, layout, validatenpx tsc --noEmit plus still-Tests. Der data-*-Vertrag, den diese Tore durchgesetzt haben, ist weg.
snapshot, compare, grade-comparenpx remotion still bei gewählten Frames; vergleiche die PNGs mit deinen eigenen Werkzeugen.
preview, play, presentnpx remotion studio
add, catalog/hyperframes-registry
capture/product-launch-video (Seitenaufnahme) und /media-use
tts, transcribe, remove-background/media-use
beats, keyframes/hyperframes-creative (Beat-Planung), /hyperframes-keyframes
cloud, publishnpx remotion bundle + remotion lambda / remotion cloudrun, oder eigenes Hosting
skills, docs, upgrade, doctorDiese Skills sind in diesem Repo bereitgestellt; npx remotion upgrade und npx remotion versions

Wenn dich ein Workflow-Skill oder eine Referenzdatei dennoch anweist, npx hyperframes <irgendwas> auszuführen, ist diese Anweisung veraltet. Führe das Remotion-Äquivalent aus der obigen Tabelle aus und sage in deiner Zusammenfassung, dass du auf einen veralteten Zeiger gestoßen bist, damit er behoben werden kann.

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

MattiaIppoliti/tia-skills

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

Verwandte Skills