Agent skill

HyperFrames Animation

by heygen-com in heygen-com/hyperframes

Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

Apache-2.0Auto-check passedMedia & Creative

Install HyperFrames Animation

skills CLI
$ npx skills add heygen-com/hyperframes --skill hyperframes-animation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install heygen-com/hyperframes hyperframes-animation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/heygen-com/hyperframes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hyperframes-animation .claude/skills/hyperframes-animation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hyperframes-animation
GitHub stars
58k
Used in
3 other repos
Token cost
~2.1k tokens
SKILL.md length
692 words
Files
127 (incl. scripts, references)
Skills in repo
32
Repo updated
First seen
Licence
Apache-2.0

At a glance

Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

  • Adding motion to a HyperFrames composition from a few atomic rules
  • SKILL.md covers Default: compose atomic rules, Load a blueprint when, Routing and Picking a runtime, plus 3 more sections
  • Calls node and npx
  • Starting from a multi-phase blueprint such as a brand reveal

What it does

This skill keeps all HyperFrames animation knowledge in one place: atomic rules that act as small motion recipes, blueprints that are multi-phase scene templates, scene-to-scene transitions, broader motion-design techniques, and adapters that document the API of each runtime. The composition contract itself, covering data attributes, sub-compositions and determinism, sits in a separate hyperframes-core skill.

The default route is to pick two to four rules from a rules index and join them with one paused GSAP timeline, which the skill says is faster and produces less code than starting from a blueprint. A blueprint is loaded only when a scene matches a ready-made multi-phase template, such as a brand reveal or social proof, or when a four- or five-phase choreography needs runnable reference code. A routing table points the agent to the right index for rules, blueprints, transitions and techniques.

Adapters cover seven runtimes: GSAP, Lottie, Three.js, Anime.js, CSS keyframes, the Web Animations API and TypeGPU. The description also lists an audit of an existing composition's choreography as an animation map and 24 named text-animation effects, and says compositions use a single paused timeline that is seek-safe and deterministic.

When your agent uses it

  • Adding motion to a HyperFrames composition from a few atomic rules
  • Starting from a multi-phase blueprint such as a brand reveal
  • Authoring a CSS-driven transition between two clips
  • Looking up GSAP, Lottie or Three.js specifics for a HyperFrames scene
  • Auditing the choreography of an existing composition

Example prompts

  • “Animate the title card in my HyperFrames composition with a staggered fade-up on one paused GSAP timeline.”
  • “Use the brand-reveal blueprint for the intro scene of this product video.”
  • “Add a CSS-driven transition between the first and second clips.”
  • “Audit the choreography of my composition and give me an animation map.”

Requirements

  • A HyperFrames project

What it can do on your machine

Read from SKILL.md and the folder at commit f6b3821. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/, which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

HyperFrames Animation loads about 2.1k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 161 tokens; SKILL.md has 692 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~161
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from heygen-com/hyperframes at commit f6b3821, republished under its Apache-2.0 licence (© heygen-com). 692 words, ~2,110 tokens.

Download SKILL.mdSave it as .claude/skills/hyperframes-animation/SKILL.md (or your agent's skills folder). This skill also uses 126 other files; get the full folder from GitHub.
name
hyperframes-animation
description
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.

Plugin installs: Before setup or freshness commands, follow plugin execution rules when this skill is inside a HyperFrames plugin. Standalone installs keep the update instructions below.

HyperFrames Animation

All motion knowledge in one skill: rules (atomic recipes), blueprints (multi-phase scene templates), transitions (scene-to-scene), techniques (broader motion-design patterns), and adapters (per-runtime APIs).

For the composition contract (data attributes, sub-compositions, determinism) see hyperframes-core.

Default: compose atomic rules

Pick 2-4 rules from rules-index.md, glue them together with a single paused GSAP timeline, done. This is faster and produces less code than starting from a blueprint.

Load a blueprint when

  • The scene matches an existing pre-designed multi-phase template (brand-reveal, social-proof, etc.) and reusing its phase pipeline saves real authoring time
  • You want runnable ground-truth code for a complex 4-5 phase choreography

Blueprints live in blueprints-index.md. Each entry points to blueprints/<id>.md (recipe). Do not read it speculatively; load it when you've already decided you need scene-level orchestration.

Routing

Want to…Read
Pick an atomic motion pattern by trigger / tagrules-index.md
Read one rule's full HTML / CSS / GSAP reciperules/<name>.md
Pick a multi-phase scene templateblueprints-index.md
Read one blueprint's full recipeblueprints/<id>.md
Author a scene transition (CSS-driven, between two clips)transitions/overview.md, transitions/catalog.md
Look up a broader motion-design techniquetechniques.md
Motion blur — shutter smear on an element, and when not to use itreferences/motion-blur.md
Analyze an existing composition's animation mapscripts/animation-map.mjs
GSAP API — timeline / tweens / position parametersadapters/gsap.md
GSAP — drop-in effect recipesrules/gsap-effects.md
GSAP — transforms / perfadapters/gsap-transforms-and-perf.md
GSAP — eases / staggeradapters/gsap-easing-and-stagger.md
GSAP — timeline / labelsadapters/gsap-timeline-and-labels.md
Lottie / dotLottie (After Effects exports, window.__hfLottie)adapters/lottie.md
Character animation (walk cycle, mascot, jointed puppet, gestures)adapters/lottie.md → Characters
Three.js / WebGL (3D scenes, AnimationMixer, hf-seek)adapters/three.md
Anime.js (window.__hfAnime)adapters/animejs.md
CSS keyframes (animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API (element.animate(), currentTime seek)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, compute pipelines)adapters/typegpu.md
HTML-as-texture + WebGL/GLSL post-fx (capture live DOM via drawElementImage)adapters/html-in-canvas-patterns.md
Named text-animation effects (24 IDs via external animate-text skill)adapters/animate-text.md

Picking a runtime

  • GSAP is the default for 95% of motion work — covers timeline orchestration, transforms, easing, stagger. All atomic rules in this skill are GSAP-based.
  • Lottie when an asset has its own pre-baked timeline (typically After Effects exports), including characters that walk, gesture or react.
  • Three.js for 3D scenes, camera motion, shader-driven visuals.
  • Anime.js for lightweight tweening when GSAP is overkill.
  • CSS for simple repeated motifs, decoration, shimmer — no JavaScript animation cost.
  • WAAPI for native browser keyframes without a GSAP dependency.
  • TypeGPU / WebGPU for GPU-rendered canvases (particles, liquid glass, custom shaders).

Multiple runtimes can coexist in one composition. Each registers its instances on the runtime-specific global so HyperFrames can seek all of them in one pass.

Show full SKILL.md (261 more words)Show less

Critical Constraints

Prerequisite: hyperframes-core → One paused timeline + Non-negotiable rules (single paused timeline, data-duration governs length, no Math.random / Date.now / performance.now, no repeat: -1 without a finite root data-duration, no page-load gsap.set on later-scene clips, no display or raw visibility tweens, and register the timeline only after it is fully built, including when the build runs inside an async callback such as document.fonts.ready). GSAP autoAlpha and zero-duration visibility sets at explicit timeline boundaries remain allowed by core. Use those exceptions only on non-clip elements or wrappers inside a clip; the framework owns .clip lifecycle. Don't restate the full contract here.

Animation-craft additions on top of core's contract:

  • Pre-calculated layout constants — never derive positions from getBoundingClientRect() at tween time. Tween-time DOM measurements desync because the renderer samples in parallel; compute coordinates once at composition setup and reuse.
  • Spatial motion uses GSAP transform aliases only (x, y, scale, rotation). Core's allowlist also permits opacity / color / backgroundColor / borderRadius for non-spatial property tweens — but never width / height / top / left for layout changes.

Scripts

bash
node <SKILL_DIR>/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

Reads every GSAP timeline registered on window.__timelines, enumerates tweens, samples bboxes, computes flags, outputs animation-map.json. Use it to audit choreography (dead zones, stagger consistency, lifecycle warnings) after authoring.

animation-map.mjs resolves helper packages from the current project first, then can bootstrap the bundled HyperFrames package version. Set HYPERFRAMES_SKILL_PKG_VERSION=<version> only when running the skill outside the bundled CLI/skill install and you need to pin that bootstrap version explicitly.

See Also

  • hyperframes-core — composition structure, data attributes, sub-compositions, deterministic render contract
  • hyperframes-creative — palettes, typography, narration, beat planning (non-animation creative direction)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

© heygen-com, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 126 other files (scripts, references) in skills/hyperframes-animation of heygen-com/hyperframes.

  • SKILL.md
  • adapters/animate-text.md
  • adapters/animejs.md
  • adapters/css-animations.md
  • adapters/gsap-easing-and-stagger.md
  • adapters/gsap-timeline-and-labels.md
  • adapters/gsap-transforms-and-perf.md
  • adapters/gsap.md
  • adapters/html-in-canvas-patterns.md
  • adapters/lottie.md
  • adapters/three.md
  • adapters/typegpu.md
  • adapters/waapi.md
  • blueprints-index.md
  • blueprints/agent-progress-theater.md
  • blueprints/camera-journey.md
  • blueprints/comparison-split.md
  • blueprints/constellation-hub.md
  • blueprints/cta-morph-press.md
  • … and 108 more

Open the folder on GitHubat commit f6b3821

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in heygen-com/hyperframes, which our catalogue first saw on October 7, 2026.

Compare with similar skills

HyperFrames Animation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

HyperFrames Animation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
HyperFrames Animation this skillheygen-com/hyperframes58k3 repos~2.1kAutomated safety check: PassApache-2.0
Hyperframes Animationchmonitor/chmonitor2982 repos~1.8kAutomated safety check: PassGPL-3.0
Guizang Product Video Skillop7418/guizang-product-video-skill696—~1.1kAutomated safety check: PassAGPL-3.0
Yuv Viral Videohoodini/ai-agents-skills282—~7.5kAutomated safety check: NotesNone
Noti Tiktok Full Textnotivn/AIEV126—~4.8kAutomated safety check: PassMIT
SVG Character Animationcalesthio/OpenMontage65k—~421Automated safety check: PassMIT

Similar skills

  • Hyperframes Animation

    chmonitor/chmonitor

    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…

    298 GitHub starsUsed in 2 repos~1.8k tokens
    Media & CreativeAuto-check passed
  • Guizang Product Video Skill

    op7418/guizang-product-video-skill

    制作代码驱动的软件产品宣传片和版本更新片(product promo、release notes video、changelog promo)。从真实功能和产品设计出发定方向,用真实组件、GSAP/Three.js 动效、原创配乐和动作音效完成影片,每支片子的视觉手法都从产品本身推导,不套模板。

    696 GitHub stars~1.1k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • Yuv Viral Video

    hoodini/ai-agents-skills

    Edit any selfie or screen-share footage into a viral short-form video in YUV.AI's signature style — Apple-style liquid-glass cards (real CSS backdrop-filter), dark-mode polish, MrBeast-paced cuts…

    282 GitHub stars~7.5k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Build a Vietnamese vertical TikTok explainer in the "MỔ XẺ PAPER AI" (AI paper dissection) format with HyperFrames (HTML/CSS/GSAP → MP4), Noti.vn style.

    126 GitHub stars~4.8k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed
  • SVG Character Animation

    calesthio/OpenMontage

    Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

    65k GitHub stars~421 tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • Build a Vietnamese landscape 16:9 YouTube video (1920×1080) with HyperFrames (HTML/CSS/GSAP → MP4), keeping the Noti.vn/GĐT branding inherited from noti-tiktok-vn.

    126 GitHub stars~5.6k tokensUpdated 8 days ago
    Media & CreativeAuto-check passed

More from heygen-com/hyperframes

All 32 skills in this repo
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    58k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed
  • Embedded Video Captions

    heygen-com/hyperframes

    Adds captions to a single-subject talking-head video without editing the footage, from plain subtitles to cinematic text placed behind the speaker.

    58k GitHub starsUsed in 3 repos~8.6k tokens
    Auto-check passed
  • Weekly Changelog Video

    heygen-com/hyperframes

    Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.

    58k GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Faceless Explainer Video

    heygen-com/hyperframes

    Turns an article, notes or a topic brief into an explainer video whose visuals are invented per scene, built frame by frame in HyperFrames with no footage.

    58k GitHub starsUsed in 3 repos~7.5k tokens
    Auto-check: notes
  • Figma to HyperFrames

    heygen-com/hyperframes

    Imports Figma assets, brand tokens, components and motion into a HyperFrames video composition, using the Figma REST API with a connector or native export for shaders.

    58k GitHub starsUsed in 3 repos~4.5k tokens
    Auto-check: notes
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    58k GitHub starsUsed in 3 repos~5.2k tokens
    Auto-check passed

Questions about HyperFrames Animation

What does HyperFrames Animation do?

Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime. This skill keeps all HyperFrames animation knowledge in one place: atomic rules that act as small motion recipes, blueprints that are multi-phase scene templates, scene-to-scene transitions, broader motion-design techniques, and adapters that document the API of each runtime. The composition contract itself, covering data attributes, sub-compositions and determinism, sits in a separate hyperframes-core skill.

When should I use HyperFrames Animation?

HyperFrames Animation fits situations like: adding motion to a HyperFrames composition from a few atomic rules; starting from a multi-phase blueprint such as a brand reveal; authoring a CSS-driven transition between two clips; looking up GSAP, Lottie or Three.js specifics for a HyperFrames scene.

How do I install HyperFrames Animation in Claude Code?

Run `npx skills add heygen-com/hyperframes --skill hyperframes-animation -a claude-code`. Or copy the skill folder (skills/hyperframes-animation in heygen-com/hyperframes) into .claude/skills/hyperframes-animation in your project. Claude Code loads it when a task matches its description.

How do I install HyperFrames Animation in Codex?

Run `npx skills add heygen-com/hyperframes --skill hyperframes-animation -a codex`. Or copy the skill folder (skills/hyperframes-animation in heygen-com/hyperframes) into .agents/skills/hyperframes-animation in your project. Codex loads it when a task matches its description.

Can I use HyperFrames Animation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add heygen-com/hyperframes --skill hyperframes-animation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hyperframes-animation, .gemini/skills/hyperframes-animation, .github/skills/hyperframes-animation and .opencode/skills/hyperframes-animation in your project.

What does HyperFrames Animation need to run?

Going by SKILL.md and its folder, HyperFrames Animation needs the command-line tools its instructions call (node and npx). Our summary lists: A HyperFrames project.

Does HyperFrames Animation access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is HyperFrames Animation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does HyperFrames Animation use?

HyperFrames Animation is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does HyperFrames Animation use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.5k tokens, read only when the agent opens those files.

What are the alternatives to HyperFrames Animation?

Skills that share tags, products or a category with HyperFrames Animation: Hyperframes Animation (chmonitor/chmonitor, 298 stars), Guizang Product Video Skill (op7418/guizang-product-video-skill, 696 stars), Yuv Viral Video (hoodini/ai-agents-skills, 282 stars) and Noti Tiktok Full Text (notivn/AIEV, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains HyperFrames Animation?

heygen-com (a GitHub organization) maintains it in heygen-com/hyperframes, which has 58,020 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 7, 2026.

Source: heygen-com/hyperframes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.