Skip to content

feat: Add hyperframes skill for HTML-based video composition#22

Open
GanQiao1990 wants to merge 1 commit into
warpdotdev:mainfrom
GanQiao1990:add-hyperframes-skill
Open

feat: Add hyperframes skill for HTML-based video composition#22
GanQiao1990 wants to merge 1 commit into
warpdotdev:mainfrom
GanQiao1990:add-hyperframes-skill

Conversation

@GanQiao1990

Copy link
Copy Markdown

What

Adds a hyperframes skill for building video compositions, animations, title cards, overlays, captions, and scene transitions as HTML with GSAP timelines.

Why

HyperFrames is an HTML-based video composition framework where the source of truth is HTML+CSS+GSAP. This skill captures the essential workflow and rules for agents to author production-quality video compositions:

  • Composition structure — data attributes, timeline contract, standalone vs sub-compositions
  • Layout-before-animation — build the end-state first, then animate from invisible
  • Scene transitions — mandatory transitions between scenes, entrance-only animations
  • Animation guardrails — deterministic, synchronous, no infinite repeats
  • Captions — synced to audio with tone-adaptive styling
  • Quality checks — WCAG contrast audit and animation choreography verification

Skill format

Follows the Agent Skills standard with YAML frontmatter (name, description, license) and self-contained markdown instructions. Compatible with Warp AI agents and Oz.

Source

Adapted from the HyperFrames framework skill, condensed to a single self-contained SKILL.md covering the core authoring workflow.

Add HyperFrames skill for building video compositions, animations,
title cards, overlays, captions, and scene transitions as HTML with
GSAP timelines.

Covers composition structure, data attributes, timeline contract,
scene transitions, animation guardrails, layout-before-animation
workflow, captions, and quality checks.
Copilot AI review requested due to automatic review settings May 7, 2026 08:36

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new hyperframes agent skill to the repository, documenting an HTML+CSS+GSAP workflow for authoring deterministic, multi-scene video compositions with transitions, captions, and validation checks.

Changes:

  • Introduces .agents/skills/hyperframes/SKILL.md with authoring rules, timeline/data-attribute contracts, and guardrails.
  • Documents scene transition constraints, captioning guidance, and quality checks (contrast + animation-map).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


**Deterministic:** No `Math.random()`, `Date.now()`, or time-based logic. Use a seeded PRNG if needed.

**GSAP:** Only animate visual properties (`opacity`, `x`, `y`, `scale`, `rotation`, `color`, `backgroundColor`, `borderRadius`, transforms). Do NOT animate `visibility`, `display`, or call `video.play()`/`audio.play()`.
Comment on lines +209 to +213
- 700-900 weight for headlines, 300-400 for body
- Pair serif + sans (not two sans-serif families)
- Add `crossorigin="anonymous"` to external media
- For dynamic text overflow: `window.__hyperframes.fitTextFontSize(text, { maxWidth, fontFamily, fontWeight })`

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants