Communitygithub.com

MattiaIppoliti/tia-skills

Ein benutzerdefiniertes HyperFrames-Composing erstellen oder bearbeiten, wenn kein spezialisierter Workflow passt oder BRIEF.md den 'flow: companion' setzt.

Was ist tia-skills?

Dieses Skill ermöglicht es, längere oder multi-szenische Videoprojekte, Brand- und Sizzle-Reels, Montagen, statische Loops, Titelcards, Footage-Remixe und freie Kompositionen mit HyperFrames zu erstellen oder zu bearbeiten. Es wird verwendet, wenn der Workflow 'general-video' lautet oder der 'flow' auf 'companion' gesetzt ist. Das Skill unterstützt die Erstellung von HTML-basierten Kompositionen (Legacy-Contract) und leitet bei neuen Projekten über das `/hyperframes`-Skill. Es integriert Medien-Assets via `/media-use`, Figma-Designs via `/figma` und folgt einem strukturierten Workflow (Projektzustand prüfen, Run-Shape interpretieren, Komposition ausführen). Wichtig: Das Skill befindet sich noch im Portierungsprozess zu Remotion; der alte HTML/GSAP-Output sollte nicht direkt in Remotion-Projekten verwendet werden, sondern nur das handwerkliche Können (Story, Schnitt, Design) übernommen werden.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

⚠ Vertragsstatus: Noch nicht nach Remotion portiert

Das Ausgabeframework dieses Stacks ist Remotion + React (/hyperframes-core). Dieses Skill beschreibt noch die ausgemusterte HTML + data-* + pausierte-GSAP-Timeline- Pipeline, und seine gebündelten Skripte geben weiterhin index.html in diesem Vertrag aus.

Bis es portiert ist:

  • Führen Sie nicht npx hyperframes <irgendwas> aus – diese CLI ist ausgemustert. /hyperframes-cli bildet jeden alten Befehl auf sein Remotion-Äquivalent ab.
  • Kopieren Sie nicht sein data-*-Markup oder GSAP-Timeline-Code in ein Remotion-Projekt.
  • Übernehmen Sie sein handwerkliches Können: Story-Form, Schnitt-Rhythmus, visuelles Design, die Entscheidungen darüber, was auf dem Bildschirm erscheint. Dieser Teil ist framework-unabhängig und deshalb ist dieses Skill noch hier.
  • Drücken Sie das Ergebnis durch den Vertrag von /hyperframes-core aus: <Composition>, <Sequence> und Werte, die von useCurrentFrame() abgeleitet werden.

Erwähnen Sie in Ihrer Zusammenfassung, wenn Sie diesen Umstand umgehen mussten, damit der Port abgeschlossen werden kann.

Allgemeines Video

Bevor Sie sich auf diesen Workflow verlassen, führen Sie Folgendes aus:

npx hyperframes skills update general-video

Ein erfolgreicher No-op bedeutet, dass das Skill aktuell ist. Zeigen Sie einen Update-Fehler an, anstatt aus dem Gedächtnis fortzufahren.

1. Anwendung von übergreifenden Quelladaptern

  • Medien: Für alle Audio-, Bild-, Symbol-, Logo-, Sprach-, Grading-, LUT-, Behandlungs-/Effekt-, Untertitel- oder Medienoperations-Bedarfe laden Sie /media-use und folgen Sie ../media-use/references/resolve.md (auflösen, übernehmen, wiederverwenden) und ../media-use/references/setup-providers.md (Anbieter, Authentifizierung). Vages Footage-Feedback und benannte Styles verwenden ../media-use/references/media-treatments.md vor der Bearbeitung; improvisieren Sie keine unterstützten Medien-Effekte mit CSS/SVG/Opazität. Führen Sie vor der ersten authentifizierten Anbieteraktion npx hyperframes auth status aus und geben Sie dessen Ausgabe wörtlich weiter. Wenn abgemeldet, wenden Sie die Hürde in ../hyperframes-core/references/brief-contract.md an: kollaborativ wartet auf Anmeldung oder eine explizite Offline-Entscheidung; autonom gibt den Status an und fährt mit einem verfügbaren Offline-Anbieter fort. Zeigen Sie einen Blocker an, wenn kein Offline-Anbieter eine erforderliche Fähigkeit erfüllen kann. Die lokale Übernahme allein erfordert keine Authentifizierungshürde.
  • Figma: Wenn es sich bei einer Eingabe um eine figma.com-URL handelt, führen Sie zuerst /figma aus. Bauen Sie aus dessen exportierten Assets, Tokens, Komponenten oder Storyboard-Frames auf. Verwenden Sie keine rohen Figma-Connector-Aufrufe, da diese die SVG-Bereinigung, die Medienherkunft und die Marken-Token-Bindung überspringen.

Diese Adapter ändern nicht den von /hyperframes ausgewählten Workflow.

2. Vom Projektstatus aus starten

Wenden Sie die erste passende Zeile an; werten Sie keine niedrigeren Statuszeilen aus:

StatusAktion
Spezifische BearbeitungBearbeitung vornehmen, bestehende Projektentscheidungen beibehalten, dann betroffene Prüfungen erneut ausführen. Discovery nicht wiederholen.
BRIEF.md existiertLesen. Wenn workflow einen anderen Workflow benennt und flow nicht companion ist, übergeben. Keine Brief-Fragen stellen.
Kein Brief, aber hyperframes.json oder STORYBOARD.md existiertVon Dateien und gespeicherten Präferenzen fortsetzen. BRIEF.md nur aus bekannten Fakten nachtragen.
Neuerstellung/hyperframes und seine Intentschicht ausführen. Nur für workflow: general-video oder flow: companion hierher zurückkehren.

Wählen Sie für ein neues Projekt einen kebab-case-Verzeichnisnamen aus dem Brief und erstellen Sie das Gerüst, bevor Sie den Brief schreiben:

npx hyperframes init "videos/<projekt>" --non-interactive --example=blank --skill=general-video

Schreiben Sie dann BRIEF.md im Projektstammverzeichnis unter Verwendung von ../hyperframes-core/references/brief-format.md. In einem bestehenden Projekt ist das Stammverzeichnis das Verzeichnis, das hyperframes.json enthält. Zeichnen Sie nur die bestätigten präferenzgestützten Felder auf, die vom Brief-Format benannt werden, und verwenden Sie node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; zeichnen Sie niemals abgeleitete Standardwerte auf. Hier ist <MEDIA_DIR> das installierte /media-use-Skill-Verzeichnis und <PROJECT_ROOT> das Verzeichnis, das hyperframes.json enthält. Wenn die Intentschicht ein Rezept übernommen hat, wenden Sie es jetzt mit node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> an und fragen Sie nicht erneut.

3. Die Ausführungsform interpretieren

Verwenden Sie nur die kanonischen Begriffe aus ../hyperframes-core/references/brief-contract.md:

FeldBedeutungAuswirkung
flowWer steuertautomation: Route wählen und ausführen. companion: Gemeinsam im Gespräch erstellen.
storyboardOb das Board eine Review-Oberfläche istyes: Plan- und Skizzen-Review durchführen. no: Ohne Board bauen.
abgeleiteter modeWie Checkpoint-Hürden funktionierenDem Brief-Contract folgen. Den Benutzer niemals bitten, einen Modus zu benennen.

Erfinden Sie keine Synonyme für diese Zustände. Ein laufendes „Bau es einfach“-Signal wird von der Intentschicht behandelt und kommt als flow: automation, storyboard: no an.

  • Für flow: automation wählen Sie die Route und geben Sie sie in einer Zeile im ersten Fortschrittsupdate an.
  • Führen Sie bei einer spezifischen Bearbeitung die Bearbeitung durch, ohne eine neue Route zu erfinden.

Für einen harten Schnitt, Trim, Splice oder eine Neuanordnung von vorhandenem Footage duplizieren Sie dieselbe Videoquelle in mehrere Clip-Elemente. Setzen Sie auf jeder Kopie den Quellbereich mit data-media-start plus data-duration, dann die autorisierte Platzierung/Reihenfolge mit data-start. Separat erstelltes Audio folgt den identischen Clip-Bereichen und dem Timing auf passenden <audio>-Elementen. /hyperframes-core besitzt diese zeitliche Bearbeitung; verwenden Sie /hyperframes-keyframes nur für visuelle Eigenschaftsanimationen wie Zoom, Punch, Schwenk, Zuschnitt, Maske oder clip-path auf einem inneren Wrapper. Kopieren Sie die vollständigen Verträge aus ../hyperframes-core/references/editing-recipes.md.

Companion-Flow

Wenn flow: companion:

  • Lesen Sie BRIEF.md und gleichen Sie akzeptierte ## Assets und ## Customizations mit Projekt-Artefakten ab. Schließen Sie akzeptierte Arbeiten ab, die noch ausstehen; lassen Sie abgeschlossene Arbeiten in Ruhe; bieten Sie eine akzeptierte Fähigkeit nicht erneut an, als wäre sie neu.
  • Kommen Sie als Regisseur, nicht als Auftragnehmer. Ein Benutzer, der sich für Companion entschieden hat, hat sich für Beteiligung und Qualität entschieden; die ehrliche Antwort ist die beste Version, die Sie entwerfen können, nicht die kleinste, die Sie verteidigen können. Der erste Plan ist die Deckenbehandlung: der Handlungsbogen (das nächstgelegene Genre-Linse leihen – Menü § Genre-Linsen), die Designspezifikation, die Bewegungsbehandlung jeder Szene mit Namen zitiert (§ 5's Plan-Disziplin), die Übergänge, die Audio-Identität – Musik und Sound-Marken oder bewusste Stille – das Material des Benutzers platziert und ein gestalteter Anfang und Schluss. Sagen Sie, was jede Ebene in einer Zeile hinzufügt; markieren Sie die teuren (Renderzeit, Anmeldung, Abrechnung), während Sie sie nennen. Der Benutzer kürzt eine Behandlung herunter; sie sollten niemals eine Zustimmung für Zustimmung zusammensetzen müssen.
  • Die Decke gehört dem Konzept, nicht dem Werkzeugkasten. Jede Ebene muss der Botschaft des Briefs dienen – eine Behandlung, die jedes Video auf die gleiche Weise einkleiden würde, ist Dekoration. Handwerk erhebt sich zur Decke; Inhalt wächst nie über das hinaus, was gefragt wurde (§ 6).
  • Zwischen Checkpoints funktioniert ../hyperframes/references/capability-menu.md in beide Richtungen. Als Triggerliste: Bieten Sie eine relevante Fähigkeit an, wenn der Benutzer seine Eingabe erwähnt oder der Bau seine Notwendigkeit erreicht. Als Upgrade-Kanal jedes Durchlaufs: Ein Plan-, Skizzen- oder Bau-Checkpoint kann ein oder zwei verfolgte Angebote tragen, die auf Material gerichtet sind, das der Benutzer gerade ansieht („Szene 3's Statistik möchte die Count-up-Behandlung“). Lesen Sie es, bevor Sie anbieten; geben Sie niemals den vollständigen Katalog aus.
  • Nachdem der Benutzer eine Fähigkeit akzeptiert hat, erstellen Sie sein Artefakt und zeichnen Sie die Entscheidung sofort im passenden Abschnitt des BRIEF.md-Körpers auf. Überschreiben Sie ein Frontmatter-Feld und zeichnen Sie die bestätigte Präferenz nur auf, wenn der Benutzer sie explizit ändert.
  • Behalten Sie die gleichen Storyboard-, Validierungs-, Endvorschau- und Render-Freigabe-Hürden bei. Companion ändert, wer steuert, nicht, was Qualität erfordert.

4. Erforderliches Wissen vor jeder Phase laden

Diese Lesevorgänge sind obligatorisch, wenn ihre Bedingung zutrifft:

BedingungVor dem Handeln lesen
Jegliches Kompositions-HTML oder Szenen-Layout/hyperframes-core; references/determinism-rules.md für dessen Layout-Vertrag verwenden
Jegliche nicht-triviale Erstellung oder visuelle Behandlung/hyperframes-creative → references/house-style.md und references/video-composition.md
Jegliche Bewegung, Animation oder Szenen-Übergang/hyperframes-animation; seiner Weiterleitung zu den passenden Regeln, Adaptern, Blaupausen oder Übergangsreferenzen folgen
storyboard: yes../hyperframes-core/references/storyboard-format.md und ../hyperframes-core/references/review-loop.md
Jegliches Medien-Asset oder -Operation, einschließlich Erzählung, Hintergrundmusik, Soundeffekte, Untertitel, Grading oder Transformationen/media-use; für Framework-Wiedergabe und Platzierung auch /hyperframes-core → references/media.md lesen
Multi-Szenen-Montage../hyperframes-core/references/production-loop.md
flow: companion, vor dem ersten Plan/hyperframes-creative → references/story-spine.md und references/house-style.md; das nächstgelegene Genre-Linse und das vollständige ../hyperframes/references/capability-menu.md – die Deckenbehandlung wird daraus entworfen, nicht erinnert
Ein Companion-Fähigkeitsangebot, Capture, Beat-Raster, generatives Video, Karte, Veröffentlichung oder Cross-Workflow-Fähigkeit../hyperframes/references/capability-menu.md
Eine Designspezifikation existiert, vor der endgültigen Freigabe/hyperframes-creative → references/design-adherence.md

Ersetzen Sie diese Lesevorgänge nicht durch Erinnerung. Progressive Offenlegung spart Kontext nur, wenn die passende Referenz tatsächlich geladen wird.

5. Die Komposition ausführen

Verwenden Sie diese Abhängigkeitsreihenfolge. Überspringen Sie eine Phase nur, wenn ihre Eingabe fehlt.

  1. Plan. Geben Sie den Zuschauerbogen, die Struktur, den Rhythmus und den Dauer-Treiber an. Verwenden Sie eine Datei für eine kurze einzelne Szene; verwenden Sie Unterkompositionen für drei oder mehr harte Szenenschnitte oder jede wiederverwendete Szene. Lesen Sie /hyperframes-creative → references/story-spine.md für erzählte Bögen, references/beat-direction.md für Rhythmus und /hyperframes-core → references/project-structure.md für die Struktur. Erweitern Sie bei einem offenen Multi-Szenen-Brief den Prompt durch /hyperframes-creative → references/prompt-expansion.md. Ein Multi-Szenen-Plan zitiert die Form jeder Szene: eine Blaupausen-ID aus /hyperframes-animation → blueprints-index.md, wenn eine passt, oder die benannten Regeln, die er aus rules-index.md komponiert, wenn keine passt – Bewegungsnamen stammen aus diesen Indizes, niemals erfunden. Die Story-Wahrheit entscheidet, welche Szenen existieren; das Zitat kleidet sie ein. Ein Multi-Szenen-Plan wird auch als Dispatch-Artefakt aufgezeichnet: ein ## Frame N-Block pro Szene in STORYBOARD.md – status: outline, eine deklarierte src:, das Blaupausen/Regeln-Zitat und der Beat-Text – auch wenn storyboard: no. Der Block ist die Dispatch-Einheit; das Board ist nur die Review-Oberfläche.
  2. Plan bei Bedarf überprüfen. Für storyboard: yes führen Sie den gemeinsamen Review-Zyklus über diese Blöcke aus. Für storyboard: no fahren Sie fort, ohne das Board zu öffnen. Wenn eine Plan-Pause trotzdem eintritt,

… [für die Übersetzung gekürzt]

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

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

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

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