Skip to content

Diogenesoftoronto/keating / video/keating-surface-tour/.agents/skills/hyperframes-creative

hyperframes-creative

Verified

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

FileKindSize
SKILL.mdskill md5.8 KB
frame-presets/biennale-yellow/FRAME.mdmarkdown17.4 KB
frame-presets/biennale-yellow/caption-skin.htmlother8.1 KB
frame-presets/biennale-yellow/frame-showcase.htmlother34.1 KB
frame-presets/blockframe/FRAME.mdmarkdown15.9 KB
frame-presets/blockframe/caption-skin.htmlother8.3 KB
frame-presets/blockframe/frame-showcase.htmlother37.9 KB
frame-presets/blue-professional/FRAME.mdmarkdown16.8 KB
frame-presets/blue-professional/caption-skin.htmlother8.2 KB
frame-presets/blue-professional/frame-showcase.htmlother38.2 KB
frame-presets/bold-poster/FRAME.mdmarkdown15.6 KB
frame-presets/bold-poster/caption-skin.htmlother8.6 KB
frame-presets/bold-poster/frame-showcase.htmlother31.6 KB
frame-presets/broadside/FRAME.mdmarkdown15.9 KB
frame-presets/broadside/caption-skin.htmlother8.4 KB
frame-presets/broadside/frame-showcase.htmlother33.1 KB
frame-presets/capsule/FRAME.mdmarkdown16.8 KB
frame-presets/capsule/caption-skin.htmlother8.3 KB
frame-presets/capsule/frame-showcase.htmlother42.0 KB
frame-presets/cartesian/FRAME.mdmarkdown16.9 KB
frame-presets/cartesian/caption-skin.htmlother8.2 KB
frame-presets/cartesian/frame-showcase.htmlother34.5 KB
frame-presets/cobalt-grid/FRAME.mdmarkdown16.9 KB
frame-presets/cobalt-grid/caption-skin.htmlother8.7 KB
frame-presets/cobalt-grid/frame-showcase.htmlother45.9 KB
frame-presets/code-editorial/FRAME.mdmarkdown20.1 KB
frame-presets/code-editorial/caption-skin.htmlother8.3 KB
frame-presets/code-editorial/fonts/EBGaramond-400.woff2binary21.2 KB
frame-presets/code-editorial/fonts/EBGaramond-700.woff2binary22.5 KB
frame-presets/code-editorial/fonts/Inter-400.woff2binary23.1 KB
frame-presets/code-editorial/fonts/Inter-700.woff2binary23.8 KB
frame-presets/code-editorial/fonts/JetBrainsMono-400.woff2binary20.7 KB
frame-presets/code-editorial/fonts/JetBrainsMono-700.woff2binary21.4 KB
frame-presets/code-editorial/fonts/OFL-eb-garamond.txtmarkdown4.4 KB
frame-presets/code-editorial/fonts/OFL-inter.txtmarkdown4.4 KB
frame-presets/code-editorial/fonts/OFL-jetbrains-mono.txtmarkdown4.4 KB
frame-presets/code-editorial/frame-showcase.htmlother42.7 KB
frame-presets/coral/FRAME.mdmarkdown18.5 KB
frame-presets/coral/caption-skin.htmlother8.3 KB
frame-presets/coral/frame-showcase.htmlother35.6 KB
frame-presets/creative-mode/FRAME.mdmarkdown19.1 KB
frame-presets/creative-mode/caption-skin.htmlother8.3 KB
frame-presets/creative-mode/frame-showcase.htmlother37.8 KB
frame-presets/daisy-days/FRAME.mdmarkdown17.0 KB
frame-presets/daisy-days/caption-skin.htmlother8.4 KB
frame-presets/daisy-days/frame-showcase.htmlother41.3 KB
frame-presets/editorial-forest/FRAME.mdmarkdown16.6 KB
frame-presets/editorial-forest/caption-skin.htmlother8.3 KB
frame-presets/editorial-forest/frame-showcase.htmlother36.0 KB
palettes/bold-energetic.mdmarkdown417 B
palettes/clean-corporate.mdmarkdown410 B
palettes/dark-premium.mdmarkdown389 B
palettes/jewel-rich.mdmarkdown394 B
palettes/monochrome.mdmarkdown454 B
palettes/nature-earth.mdmarkdown399 B
palettes/neon-electric.mdmarkdown380 B
palettes/pastel-soft.mdmarkdown392 B
palettes/warm-editorial.mdmarkdown411 B
references/audio-reactive.mdmarkdown3.0 KB
references/beat-direction.mdmarkdown13.3 KB
references/composition-patterns.mdmarkdown5.6 KB
references/data-in-motion.mdmarkdown1.2 KB
references/design-adherence.mdmarkdown1.4 KB
references/design-picker.mdmarkdown11.9 KB
references/design-spec.mdmarkdown10.3 KB
references/house-style.mdmarkdown5.0 KB
references/motion-principles.mdmarkdown8.7 KB
references/narration.mdmarkdown3.4 KB
references/prompt-expansion.mdmarkdown5.6 KB
references/story-spine.mdmarkdown3.2 KB
references/typography.mdmarkdown14.1 KB
references/video-composition.mdmarkdown4.2 KB
references/visual-styles.mdmarkdown11.7 KB
scripts/contrast-report.mjsscript20.8 KB
scripts/extract-audio-data.pyscript6.3 KB
scripts/package-loader.mjsscript13.2 KB
scripts/package-loader.test.mjsscript2.5 KB
templates/design-picker.htmlother43.1 KB

references/audio-reactive.md

View on GitHub
# Audio-Reactive Animation

Drive visuals from music, voice, or sound. Any GSAP-animatable property can respond to pre-extracted audio data.

## Audio Data Format

```js
var AUDIO_DATA = {
  fps: 30,
  totalFrames: 900,
  frames: [{ bands: [0.82, 0.45, 0.31, ...] }, ...]
};
```

- `frames[i].bands[]` — frequency band amplitudes, 0-1. Index 0 = bass, higher = treble.
- Each band normalized independently across the full track.

## Mapping Audio to Visuals

| Audio signal           | Visual property                   | Effect                     |
| ---------------------- | --------------------------------- | -------------------------- |
| Bass (bands[0])        | `scale`                           | Pulse on beat              |
| Treble (bands[12-14])  | `textShadow`, `boxShadow`         | Glow intensity             |
| Overall amplitude      | `opacity`, `y`, `backgroundColor` | Breathe, lift, color shift |
| Mid-range (bands[4-8]) | `borderRadius`, `width`           | Shape morphing             |

Any GSAP-tweenable property works — `clipPath`, `filter`, SVG attributes, CSS custom properties.

## Content, Not Medium

Audio provides **timing and intensity**. The visual vocabulary comes from the narrative.

**Never add:** equalizer bars, spectrum analyzers, waveform displays, musical notes clip art, generic particle systems, rainbow color cycling, strobing white on beats, abstract pulsing orbs.

**Instead:** Let content guide the visual and audio drive its behavior. Bass makes warmth _swell_. Treble sharpens _contrast_. The visual choice comes from "what does this piece feel like?"

## Sampling Pattern

Audio reactivity requires per-frame sampling via a `for` loop with `tl.call()`, not a single tween:

```js
// ✅ Correct — sample every frame
for (var f = 0; f < AUDIO_DATA.totalFrames; f++) {
  tl.call(
    (function (frame) {
      return function () {
        draw(frame);
      };
    })(AUDIO_DATA.frames[f]),
    [],
    f / AUDIO_DATA.fps,
  );
}

// ❌ Wrong — single tween, doesn't react to audio
gsap.to(".el", { scale: 1.2, duration: totalDuration });
```

Without per-frame sampling, the composition doesn't actually react to audio.

## textShadow Gotcha

`textShadow` on a parent container with semi-transparent children (e.g., inactive caption words at `rgba(255,255,255,0.3)`) renders a visible glow rectangle behind all children. Fix: apply `scale` to the container for beat pulse, but apply `textShadow` to individual active words only.

## Guidelines

- **Subtlety for text** — 3-6% scale variation, soft glow. Heavy pulsing makes text unreadable.
- **Go bigger on non-text** — backgrounds and shapes can handle 10-30% swings.
- **Match the energy** — corporate = subtle; music video = dramatic.
- **Deterministic** — pre-extracted data, no Web Audio API, no runtime analysis.

## Constraints

- All audio data must be pre-extracted (use `extract-audio-data.py` from this skill's `scripts/`)
- No `Math.random()` or `Date.now()`
- Audio reactivity runs on the same GSAP timeline as everything else
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall