Communitygithub.com

assafkip/claude-video-editor

Référence d'animations GSAP pour HyperFrames. Couvre gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), paramètre de position, labels, imbrication, contrôle de lecture) et performances (transformations, will-change, quickTo). À utiliser pour écrire des animations GSAP dans les compositions HyperFrames.

Qu'est-ce que claude-video-editor ?

Cette compétence fournit une référence complète sur GSAP (GreenSock Animation Platform) conçue pour une utilisation avec HyperFrames dans des environnements d'agents IA comme Claude Code, Cursor ou Codex. Elle couvre les méthodes de tween de base (`gsap.to()`, `from()`, `fromTo()`, `set()`), les propriétés communes (durée, délai, easing, stagger, répétition), les alias de transformation (x, y, scale, rotation) et les bonnes pratiques telles que l'utilisation de `autoAlpha` plutôt que `opacity`. Des fonctionnalités avancées comme les valeurs basées sur des fonctions, `gsap.matchMedia()` pour le responsive et l'accessibilité, ainsi que la gestion des timelines (paramètre de position, labels, imbrication) sont expliquées en détail. La compétence met également l'accent sur les optimisations de performances (préférer les transformations et l'opacité, utiliser `will-change`, `gsap.quickTo()` et `stagger`), avec des conseils explicites sur ce qu'il faut éviter, comme l'animation de propriétés de mise en page ou l'utilisation conjointe de `svgOrigin` et `transformOrigin`. Un lien vers un fichier d'effets prêts à l'emploi est également inclus.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/skills/gsap

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

GSAP

Méthodes de Tween Fondamentales

  • gsap.to(cibles, vars) — anime de l'état actuel vers vars. La plus courante.
  • gsap.from(cibles, vars) — anime de vars vers l'état actuel (entrées).
  • gsap.fromTo(cibles, fromVars, toVars) — début et fin explicites.
  • gsap.set(cibles, vars) — applique immédiatement (durée 0).

Utilisez toujours les noms de propriétés en camelCase (ex. backgroundColor, rotationX).

Variables Communes

  • duration — secondes (par défaut 0.5).
  • delay — secondes avant le début.
  • ease — "power1.out" (par défaut), "power3.inOut", "back.out(1.7)", "elastic.out(1, 0.3)", "none".
  • stagger — nombre 0.1 ou objet : { amount: 0.3, from: "center" }, { each: 0.1, from: "random" }.
  • overwrite — false (par défaut), true, ou "auto".
  • repeat — nombre ou -1 pour infini. yoyo — alterne la direction avec la répétition.
  • onComplete, onStart, onUpdate — fonctions de rappel.
  • immediateRender — par défaut true pour from()/fromTo(). Mettez false sur les tweens ultérieurs ciblant la même propriété+élément pour éviter l'écrasement.

Transformations et CSS

Préférez les alias de transformation de GSAP plutôt que la chaîne transform brute :

Propriété GSAPÉquivalent
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y en %
scale, scaleX, scaleYscale
rotationrotate (deg)
rotationX, rotationYrotation 3D
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — préférez-le à opacity. À 0 : définit également visibility: hidden.
  • Variables CSS — "--hue" : 180.
  • svgOrigin (SVG uniquement) — origine dans l'espace de coordonnées SVG global. Ne pas combiner avec transformOrigin.
  • Rotation directionnelle — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" ou séparé par des virgules ; supprime les styles en ligne à la fin.
  • Valeurs relatives — "+=20", "-=10", "*=2".

Valeurs Basées sur des Fonctions

gsap.to(".item", {
  x: (i, cible, cibles) => i * 50,
  stagger: 0.1,
});

Easing

Easing intégrés : power1–power4, back, bounce, circ, elastic, expo, sine. Chacun a .in, .out, .inOut.

Valeurs par Défaut

gsap.defaults({ duration: 0.6, ease: "power2.out" });

Contrôle des Tweens

const tween = gsap.to(".box", { x: 100 });
tween.pause();
tween.play();
tween.reverse();
tween.kill();
tween.progress(0.5);
tween.time(0.2);

gsap.matchMedia() (Responsive + Accessibilité)

Exécute la configuration uniquement lorsqu'une requête média correspond ; s'annule automatiquement lorsqu'elle cesse de correspondre.

let mm = gsap.matchMedia();
mm.add(
  {
    isDesktop: "(min-width: 800px)",
    reduceMotion: "(prefers-reduced-motion: reduce)",
  },
  (contexte) => {
    const { isDesktop, reduceMotion } = contexte.conditions;
    gsap.to(".box", {
      rotation: isDesktop ? 360 : 180,
      duration: reduceMotion ? 0 : 2,
    });
  },
);

Timelines

Créer une Timeline

const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
tl.to(".a", { x: 100 }).to(".b", { y: 50 }).to(".c", { opacity: 0 });

Paramètre de Position

Le troisième argument contrôle le placement :

  • Absolu : 1 — à 1s
  • Relatif : "+=0.5" — après la fin ; "-=0.2" — avant la fin
  • Label : "intro", "intro+=0.3"
  • Alignement : "<" — même début que le précédent ; ">" — après la fin du précédent ; "<0.2" — 0,2s après le début du précédent
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // même début que .a
tl.to(".c", { opacity: 0 }, "<0.2"); // 0,2s après le début de .b

Labels

tl.addLabel("intro", 0);
tl.to(".a", { x: 100 }, "intro");
tl.addLabel("outro", "+=0.5");
tl.play("outro");
tl.tweenFromTo("intro", "outro");

Options de Timeline

  • paused: true — crée en pause ; appelez .play() pour démarrer.
  • repeat, yoyo — s'appliquent à toute la timeline.
  • defaults — variables fusionnées dans chaque tween enfant.

Imbrication de Timelines

const master = gsap.timeline();
const child = gsap.timeline();
child.to(".a", { x: 100 }).to(".b", { y: 50 });
master.add(child, 0);

Contrôle de Lecture

tl.play(), tl.pause(), tl.reverse(), tl.restart(), tl.time(2), tl.progress(0.5), tl.kill().


Performances

Préférez la Transformation et l'Opacité

Animer x, y, scale, rotation, opacity reste sur le compositeur. Évitez width, height, top, left lorsque les transformations obtiennent le même effet.

will-change

will-change: transform;

Uniquement sur les éléments qui s'animent réellement.

gsap.quickTo() pour les Mises à Jour Fréquentes

let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
  yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });
conteneur.addEventListener("mousemove", (e) => {
  xTo(e.pageX);
  yTo(e.pageY);
});

Stagger plutôt que Plusieurs Tweens

Utilisez stagger au lieu de tweens séparés avec des délais manuels.

Nettoyage

Mettez en pause ou tuez les animations hors écran.


Références (chargées à la demande)

  • references/effects.md — Effets prêts à l'emploi : texte machine à écrire, visualiseur audio. Lisez lorsque vous avez besoin de modèles d'effets prêts à l'emploi pour HyperFrames.

Bonnes Pratiques

  • Utilisez des noms de propriétés en camelCase ; préférez les alias de transformation et autoAlpha.
  • Préférez les timelines à l'enchaînement avec delay ; utilisez le paramètre de position.
  • Ajoutez des labels avec addLabel() pour un séquencement lisible.
  • Passez les paramètres par défaut dans le constructeur de la timeline.
  • Stockez la valeur de retour du tween/timeline lors du contrôle de la lecture.

À Ne Pas Faire

  • Animer les propriétés de mise en page (width/height/top/left) lorsque les transformations suffisent.
  • Utiliser à la fois svgOrigin et transformOrigin sur le même élément SVG.
  • Enchaîner des animations avec delay lorsqu'une timeline peut les séquencer.
  • Créer des tweens avant que le DOM n'existe.
  • Sauter le nettoyage — tuez toujours les tweens lorsqu'ils ne sont plus nécessaires.

Individual skills in this repo

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

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

assafkip/claude-video-editor

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

assafkip/claude-video-editor

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

assafkip/claude-video-editor

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

Skills associés