carvercat/carvercat-motion

Carvercat-Bewegungsgrafiken

Etwas nicht gefunden? references/INDEX.md beantwortet „Wo ist X“ für das gesamte Skill (Handwerk, App, Effekte, Zeichnung, Karten, Workflows, bekannte Probleme).

Funktioniert mit jedem Agenten, der die Carvercat-MCP-Tools aufrufen kann: Claude, GPT/Codex, Gemini oder einer Person, die mitliest. Nichts hier hängt von einem bestimmten Anbieter ab. Tool-Namen können ein Client-Präfix tragen (z. B. mcp__carvercat__carvercat_run).

0. Einheiten und die neue Oberfläche (zuerst lesen)

Alles, was Sie schreiben, ist in Designeinheiten: px vom oberen linken Rand des Frames mit y nach unten, Grad im Uhrzeigersinn, CSS-Farben und Easing, fontSize px, Zeiten als Frames, "1.5s" oder "500ms". Bauen Sie eine ganze Szene in einem validierten Aufruf (scene.apply, zuerst als Trockenlauf), wählen Sie Objekte mit CSS-ähnlichen Selektoren aus, verwenden Sie die Hilfsfunktionen (layout.*, text.fit, motion.apply, measure.*) und führen Sie carve.preflight {host} vor jedem Senden aus. Leitfaden: references/app/design-units.md. Alte Namen funktionieren noch für eine Version und sind dort einmalig aufgeführt; schreiben Sie sie nicht.

0b. Bevor Sie etwas anfassen

• Finden Sie die installierte Carvercat-App auf diesem Rechner und verwenden Sie den Ordner dieses Skills als installiert; für kreative Aufträge reicht dieses Skill aus. Verwenden Sie keinen festen historischen Pfad.
• carvercat_session (anhängen) dann carvercat_state: Überprüfen Sie den Build, das offene Projekt und die Komposition, bevor Sie etwas ändern. carvercat_list gibt die IDs.
• Bitten Sie die Person, während des Builds nicht in der App zu klicken: Ihr Kompositionswechsel leitet Ihre nächsten Befehle um.
• Löschen Sie niemals das Dokument eines Benutzers, um es neu aufzubauen. Speichern Sie das editierbare .carverproj am Zielort des Auftrags.

1. Planen Sie wie ein Bewegungsdesigner (Handwerk)

Lesen Sie nur, was der Auftrag braucht:

Bedarf	Lesen Sie
Dauern, Easing, die 12 Prinzipien, Choreografie, Taktung zur Musik, Anti-Patterns	references/craft/motion-principles.md; eine Seite pro Prinzip in references/craft/principles/
Schriftgrößen, Lesezeit, Eingangsstile, Betonung; gemessener Sperrsatz, Laufweite und Lint-Grenzwerte	references/craft/typography.md
Welcher Übergang, wie lange, die Übergabe am Schnitt	references/craft/transitions.md
Soundeffekte und Musik: ein Clip pro Ereignis, Pegel, Pop-/Whoosh-Spezifikationen	references/craft/sound-design.md
9:16 / soziale Sicherheitsbereiche, Konvertieren eines 16:9-Stücks	references/craft/vertical-and-safe-areas.md
Palettenrollen, Kontrast, Verläufe, Farbwerte	references/craft/colour.md
Das Bewegungssystem einer Marke: Easing-Familie, Dauern, charakteristische Bewegung, Markenpakete	references/craft/brand-systems.md
Blickfang, Lesereihenfolge, Raster, Hierarchie, Sicherheitsbereiche	references/craft/composition-and-layout.md
Ein Briefing lesen: Fakten, Frame-Budget, Stil, Rezept	references/craft/reading-a-brief.md
Welches Stilpaket für ein Briefing	references/craft/style-families.md
Gemessene Frame-Anzahlen pro Stil; die Review-Liste des Stils	references/craft/timing-by-style.md, references/craft/review-by-style.md
Warum eine Bewegung funktioniert: die 12 Prinzipien und mehr, Designgrundlagen, Techniken, Genres, Timing, Workflow, Zugänglichkeit, Geschichte (jede Seite endet mit der Umsetzung in Carvercat)	../wiki/README.md, Maschinenindex ../wiki/index.json

Überall gültige Regeln:

• Ein Held pro Szene.
• Unterstützende Elemente erscheinen mit Expo-Out oder verlangsamt.
• Ausgänge beschleunigen und dauern etwa 70 % der Eingangszeit.
• Staffeln Sie Nachbarn um 3–6 f.
• Jede Szene hat einen Eingang, eine gewisse Bewegung in der Mitte und einen Ausgang (niemals ein eingefrorener Stillstand).
• Text hält mindestens max(25 f, 10 f pro Wort) + 10 f. Carvercats Lint verlangt 17 Zeichen pro Sekunde (Leerzeichen nicht gezählt), mindestens 25 vollständig deckende Frames.

2. Bauen Sie zuerst aus der Musterbibliothek

patterns/README.md enthält 25 Voreinstellungen und 5 Vorlagen, alle auf 0.0.72 verifiziert mit gemessenen Überschwing- und Beruhigungsframes, sowie Rezepte für Push, Zoom-Through, Kartenstapel und Highlight-Sweep. Das Paket ist ../library/templates/motion-patterns/. Prüfen Sie, ob es installiert ist, mit library.list {query:"expo"}; falls nicht, installieren Sie es in den Benutzer-Bibliotheksordner (Hilfe > Bibliotheksordner oder library.folder, kopieren Sie es in templates/, dann library.reload; benötigt Carvercat 0.1.8+; siehe patterns/README.md). Vor 0.1.8 kann eine installierte App es nicht laden. Eine platzierte Vorlage wird zu einer verschachtelten Komposition – siehe die Patterns-README.

• Ein Objekt: preset.apply {name, id}, z. B. Rise - expo, Pop - spring, Stamp, Exit up - accelerate.
• Text: Words rise - expo, Letters cascade - spring, Lines reveal - decelerate und andere.
• Mehrere Objekte: library.place {name, frame} dann template.apply {id}. Z. B. Two-tone wipe, Colour iris, Lower third - accent bar, Logo - stamp reveal, Bar chart - grow.
• Ein ganzes mehrteiliges Stück in einer Komposition: patterns/promo-assembly.md.
• Stilpakete (gleiche Installation wie Motion Patterns): SaaS UI, Kinetic Typography, Data Viz, Corporate Brand, Minimal Luxury, Social Short-form 9:16, Cartoon Bounce, Funky, Futuristic HUD, Retro, Glitch, Sports, Explainer; wählen Sie eines mit references/craft/style-families.md. Sie benötigen Rethink Sans installiert (Text kann die app-gelieferten Schriften nicht verwenden, KI-136). Jedes hat ein Labor- und ein Showcase-Projekt unter ../categories/.
• Rezepte für häufige Briefings (SaaS-Launch, Sport-Score-Update, 9:16-Tipp-Reel, Jahresbericht-Eröffnung, Quartalsergebnisse, Luxus-Teaser, Erklär-Lektion, Kinetic-Quote-Reel, Kinder-Erklärvideo, Verkaufs-Promo, Tech-Trailer, Retro-Night, Musik-Teaser): Shot-Listen mit Frames und verifizierten Beispielprojekten, die nur aus Bibliotheksvorlagen erstellt wurden, in recipes/README.md.
• Eine exakte Kurve: ease: "cubic-bezier(a, b, c, d)" auf dem Key, der verlässt (patterns/custom-curves.md).
• Federn und Bounces: scripts/motion/curves.py bäckt sie in Keys ein.

3. Die App steuern

Grundregel (23. Okt. 2026): Erstellen und ändern Sie Szenen, indem Sie die .carverproj-JSON direkt bearbeiten, dann edit.open {force:true}. Eine ganze Szene geht auch über MCP in einem einzigen validierten, atomaren scene.apply; die Projektdatei ist jetzt carvercat/2 (px, y nach unten, Frames; jeder Speichervorgang schreibt sie, v1-Dateien öffnen sich immer noch), und der JSON-Weg unten beschreibt die ältere v1-Form (Brüche, y nach oben), die json_author/cc.py schreibt und die App noch lädt; für einen neuen Generator schreiben Sie carvercat/2 (cc_project.py, wie es die Rezept-Builder tun). Verwenden Sie MCP für die Schritte, die die Datei nicht kann (Text messen, Look, Speichern, Resolve-Transfer, Live-Tweaks). Verfahren und Fallbacks: references/app/json-authoring.md.

references/app/design-units.md ist der Arbeitsleitfaden: Einheiten, scene.apply, Selektoren, anim.set (Tweens, Easing, Staffelung), Effekte in CSS-Begriffen, Hilfsfunktionen, Headless-Notizen. references/app/mcp-essentials.md behandelt den Build -> Look -> Check-Zyklus, die wissenswerten Befehle und die Fallstricke, die Stunden kosten (clip.move überschreibt, IDs starten pro Komposition neu). Der maschinenlesbare Katalog ist carvercat://schema/design, carvercat://schema/commands und carvercat://schema/scene (das App-Repo schema/agent/json-schema/): Lesen Sie den Eintrag, bevor Sie einen unbekannten Schlüssel verwenden; raten Sie nie Argumente oder generierte Eintrags-IDs.

Verwenden Sie für scriptgesteuerte Arbeit die gepflegten Python-Skripte: ai/scripts/cc_client.py + cc_scene.py (references/app/creative-toolkit.md); die App hat auch einen eigenen Python-Helfer (carvercat_py). Effekte, Füllung/Strich, Verläufe, Farben, Transformationen, Staffelung und Pfadtrimmen sind in references/app/creative-controls.md. Ausstehende Pläne können mit scene.apply {dry_run: true} und measure.* überprüft werden; nichts wird neben dem Dokument gespeichert. Messen Sie tatsächlichen geformten Text; wählen Sie Schriftarten bewusst aus, einschließlich separater LTR-Zahlenläufe in gemischtem RTL-Text. Jedes Beispiel in den Leitfäden wird von ai/scripts/verify_examples.py gegen eine Headless-Carvercat ausgeführt.

3b. Effekte, Zeichnung, Karten und ganze Aufträge

Bedarf	Lesen Sie
Unschärfe, Glühen (mit Brenngrenzen), Schatten, Bewegungsunschärfe, Verläufe, Strich/Trim-Zeichnen, weiche Kanten und Masken-Feder, Textumriss, Staffelung, Masken	references/effects/README.md
Versteckte Kellerparameter, deren Promoten, Seile zwischen Parametern	references/effects/basement-promote-ropes.md
Alle Formen (Rechteck, Ellipse, Stern, Polygon, Pfad), Anordnen und Gruppieren	references/drawing/shapes.md
Figuren/Objekte aus Teilen: Anker als Gelenke, Parentierung, das Null-Objekt (object.new {kind: "null"}) als Dreh- oder Handhabe	references/drawing/rigging.md
Karten: Grenzen, Straßen, Pins, Routen, Ringe, Landmarken-Pop-ups, Pfeile, Zoom rein/raus	references/maps/maps.md
Untertitel + VO, RTL/Arabisch, Resolve-Übergabe, Export, der Auftragszyklus	references/workflows/
Etwas verhält sich falsch	references/known-issues.md

Überall gültige Effektregeln: glow-Stärke ≤ 0.8 (0.9 beschneidet, 1.0 brennt auf Weiß), der Radius legt die Lichthof-Reichweite fest; Unschärfe und Schatten nur für den Helden zur Tiefe; Trim-Zeichnen für Linien; softEdge von 2 bis 6 px für UI-Formen, 160 bis 320 px für Umgebungslicht (references/effects/soft-edge.md, mit der gefiederten Maskenenthüllung).

4. Prüfen, bevor Sie sagen, es ist fertig

• Schauen Sie sich den Eingang, die Haltezeit und den Ausgang an (carvercat_look). Messen Sie mit carvercat_inspect (timing, curves für Überschwingen und Beruhigen, lint, expect, qc für Blitze) und den Render-Hilfsfunktionen (measure.boxes, measure.overlaps {within: "safe"}, measure.contrast). Preflight mit carve.preflight {host} vor einem Senden.
• Gehen Sie references/craft/review-checklist.md durch: Geschichte, Timing, Text, UI, Übergänge, Look, Ton, Hygiene.
• Bauen Sie zuerst eine repräsentative Komposition, prüfen Sie sie, dann erweitern Sie sie. Rezepte sind Ausgangspunkte: Passen Sie Hierarchie, Bildmaterial und Timing an das Briefing und das Filmmaterial an. Sicherheitsgrenzen ersetzen nicht das visuelle Urteilsvermögen.
• Lags oder Audio-Unterversorgung: references/app/performance.md.

5. Tools außerhalb der App (scripts/motion/, Python 3, Standardbibliothek + ffmpeg)

• vo_align.py: Voice-Over → Wort- und Zeilenframes.
• sfx_kit.py / sfx_render.py: synthetisierte Soundeffekte (Pop, Whoosh-Hit, Tick, Impact...) → eine WAV pro Cue.
• music_bed.py: ein Teppich, der zum Schnitt passt; mix_check.py: Stem-LUFS und ein Referenzmix.
• reformat.py: ein 16:9-Projekt → 9:16-Kompositionen.
• carverproj.py: Projekt-JSON-Hilfsfunktionen (IDs, Keys).
• build_pattern_pack.py / comp_to_template.py: das Paket neu generieren.
• effects_param_tables.py: die Effektparameter-Tabelle neu generieren.
• ../maps/geo_paths.py / ../maps/map_overlay.py: reale Geografie → Pfade; Erklär-Overlay (Pins, Ringe, Routen, Karten, Pfeile).

6. Sicherheit und Auslieferung

Verwenden Sie Szenen-IDs (und Scene.component-Namensräume), sodass eine Überarbeitung dieselben Objekte aktualisiert: Wenden Sie dasselbe Dokument erneut an, und nur Unterschiede ändern sich. Stoppen Sie nach einer Ablehnung die Arbeit, die davon abhängt. Überprüfen Sie nach einem unbekannten Ergebnis Identität und Zustand, bevor Sie eine weitere Änderung vornehmen; wiederholen Sie niemals einen Schreib- oder Exportvorgang, dessen Ergebnis Sie nicht kennen. Resolve-Operationen benötigen die aktuelle Autorisierung des Benutzers; ohne diese nur nativ authorisieren und testen. Überprüfen Sie bei Autorisierung das tatsächliche Projekt, die Timeline und das Format, bewahren Sie die Originalbearbeitung und inspizieren Sie zusammengesetzte Samples. Die Einheit der Carvercat-Arbeit ist eine Komposition; eine Resolve-Timeline ist getrennt. Lesen Sie für Transferprüfung, Konsolidierung, Verschiebung und Neuverlinkung references/app/media-recovery.md; wo die Abdeckung der Bereinigungsreferenz unvollständig ist, behalten Sie die Dateien.

Credits und Lizenzen für die Ideen hinter den Handwerksreferenzen: SOURCES.md.