Skip to content

Makkov-design/makkov-harness / skills/hyperframes

hyperframes

Verified

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

FileKindSize
LICENSEother10.5 KB
SKILL.mdskill md7.5 KB
assets/frame-presets/biennale-yellow/FRAME.mdmarkdown17.4 KB
assets/frame-presets/biennale-yellow/caption-skin.htmlother7.9 KB
assets/frame-presets/biennale-yellow/frame-showcase.htmlother34.1 KB
assets/frame-presets/blockframe/FRAME.mdmarkdown15.9 KB
assets/frame-presets/blockframe/caption-skin.htmlother8.1 KB
assets/frame-presets/blockframe/frame-showcase.htmlother37.9 KB
assets/frame-presets/blue-professional/FRAME.mdmarkdown16.8 KB
assets/frame-presets/blue-professional/caption-skin.htmlother8.1 KB
assets/frame-presets/blue-professional/frame-showcase.htmlother38.2 KB
assets/frame-presets/bold-poster/FRAME.mdmarkdown15.6 KB
assets/frame-presets/bold-poster/caption-skin.htmlother8.5 KB
assets/frame-presets/bold-poster/frame-showcase.htmlother31.6 KB
assets/frame-presets/broadside/FRAME.mdmarkdown15.9 KB
assets/frame-presets/broadside/caption-skin.htmlother8.2 KB
assets/frame-presets/broadside/frame-showcase.htmlother33.1 KB
assets/frame-presets/capsule/FRAME.mdmarkdown16.8 KB
assets/frame-presets/capsule/caption-skin.htmlother8.2 KB
assets/frame-presets/capsule/frame-showcase.htmlother42.0 KB
assets/frame-presets/cartesian/FRAME.mdmarkdown16.9 KB
assets/frame-presets/cartesian/caption-skin.htmlother8.1 KB
assets/frame-presets/cartesian/frame-showcase.htmlother34.5 KB
assets/frame-presets/cobalt-grid/FRAME.mdmarkdown16.9 KB
assets/frame-presets/cobalt-grid/caption-skin.htmlother8.6 KB
assets/frame-presets/cobalt-grid/frame-showcase.htmlother45.9 KB
assets/frame-presets/code-editorial/FRAME.mdmarkdown20.1 KB
assets/frame-presets/code-editorial/caption-skin.htmlother8.1 KB
assets/frame-presets/code-editorial/fonts/EBGaramond-400.woff2binary21.2 KB
assets/frame-presets/code-editorial/fonts/EBGaramond-700.woff2binary22.5 KB
assets/frame-presets/code-editorial/fonts/Inter-400.woff2binary23.1 KB
assets/frame-presets/code-editorial/fonts/Inter-700.woff2binary23.8 KB
assets/frame-presets/code-editorial/fonts/JetBrainsMono-400.woff2binary20.7 KB
assets/frame-presets/code-editorial/fonts/JetBrainsMono-700.woff2binary21.4 KB
assets/frame-presets/code-editorial/fonts/OFL-eb-garamond.txtmarkdown4.4 KB
assets/frame-presets/code-editorial/fonts/OFL-inter.txtmarkdown4.4 KB
assets/frame-presets/code-editorial/fonts/OFL-jetbrains-mono.txtmarkdown4.4 KB
assets/frame-presets/code-editorial/frame-showcase.htmlother42.7 KB
assets/frame-presets/coral/FRAME.mdmarkdown18.5 KB
assets/frame-presets/coral/caption-skin.htmlother8.1 KB
assets/frame-presets/coral/frame-showcase.htmlother35.6 KB
assets/frame-presets/creative-mode/FRAME.mdmarkdown19.1 KB
assets/frame-presets/creative-mode/caption-skin.htmlother8.2 KB
assets/frame-presets/creative-mode/frame-showcase.htmlother37.8 KB
assets/frame-presets/daisy-days/FRAME.mdmarkdown17.0 KB
assets/frame-presets/daisy-days/caption-skin.htmlother8.3 KB
assets/frame-presets/daisy-days/frame-showcase.htmlother41.3 KB
assets/frame-presets/editorial-forest/FRAME.mdmarkdown16.6 KB
assets/frame-presets/editorial-forest/caption-skin.htmlother8.2 KB
assets/frame-presets/editorial-forest/frame-showcase.htmlother36.0 KB
references/captions.mdmarkdown4.9 KB
references/film.mdmarkdown7.1 KB
references/format.mdmarkdown12.7 KB
references/look.mdmarkdown5.9 KB
references/motion.mdmarkdown11.9 KB
references/overlays.mdmarkdown2.5 KB
references/plugin-installation.mdmarkdown3.0 KB
references/review.mdmarkdown5.2 KB
references/runtimes.mdmarkdown3.9 KB
references/skill-lifecycle.mdmarkdown3.7 KB
references/sound.mdmarkdown4.4 KB
references/spec.mdmarkdown5.9 KB
references/story.mdmarkdown11.2 KB
references/storyboard-format.mdmarkdown6.5 KB
references/storyboard.mdmarkdown4.0 KB
references/types/3d.mdmarkdown1.6 KB
references/types/character.mdmarkdown1.6 KB
references/types/data.mdmarkdown1.3 KB
references/types/explainer.mdmarkdown3.0 KB
references/types/launch.mdmarkdown4.6 KB
references/types/music.mdmarkdown1.6 KB
references/types/vertical.mdmarkdown1.6 KB
scripts/bake-basemap.mjsscript17.7 KB
scripts/cli-version.jsonconfig46 B
scripts/lib/main-module.mjsscript479 B
scripts/lib/main-module.test.mjsscript2.2 KB
scripts/locate.mjsscript8.0 KB
scripts/plugin-cli.mjsscript3.7 KB
scripts/plugin-cli.test.mjsscript6.2 KB

references/sound.md

View on GitHub
<!-- Changed by makkov-harness (see NOTICE at the repository root); the original is HeyGen's, Apache-2.0. -->
# Sound

Sound is half of how a film feels, and the viewer notices a silent one before any frame. Every judge of frames misses it, so plan it on purpose.

## 1. The default

- **A film over about 15 s that tells something** (launch, explainer, recap, PR video) gets a music bed and sounds on its visible actions, unless the person asked for silence or it is made to play muted (a looping background, a feed that autoplays without sound: then the type and the pictures carry it alone).
- **A voiceover** only when the request or the source calls for one (`SKILL.md`).
- **Each storyline says its sound** in one line (`story.md` §2): the bed's feel and tempo, the one moment the music changes, which actions get effects, or silence and why.
- **Short pieces** (a title card, a sting under 10 s, captions or overlays on footage that has its own sound) follow the request and the footage.

## 2. The clock

- **Narrated**: the voice is the clock. Time each beat's start to its anchor word; text lands on the word that says it.
- **Music only**: the music is the clock. Land the payoff and the mark on its strong beats (`npx hyperframes beats`, then `film.md` "On music"); cuts follow the motion, not the drums.
- Let the sound act out the story when it fits: the old way sits near silence, the music opens when the product appears; the music holds back until the payoff.

## 3. Music

The person's own track first, as given. Else search the catalog (`/media-use`, `bgm`) with the film's feel and tempo, not its subject ("tense minimal pulse building to a bright drop, 120 bpm"), and read a few results before keeping one. With no catalog, Openverse's music (Jamendo, `category=music`, `license=cc0,by` only) is a free option; add a CC BY track's credit to the project's `CREDITS.md`. Enter at the track's strongest bar, not a quiet intro; end on a bar line with a short fade under the end card.

With no music source (no `heygen` sign-in and no local model), deliver silent and say so in one line with how to add one. Do not spend the run building an audio chain or writing music in code: nobody can hear whether it is good.

## 4. Effects

Few and exact: every effect has a cause on screen, and too many read as a template.

Take real recordings first: the `/media-use` audio engine (`audio.mjs --only sfx`, see its Sound effects section) searches [Openverse](https://openverse.org) for each cue (CC0 and CC BY only, mostly Freesound), then falls back to the bundled library. Name each cue by what makes the sound (`paper sheet slide`, `mechanical keyboard tap`), not by its mood. Generate a sound only for a cue that has no real recording, or when the person asks; keep `assets/sfx/CREDITS.md` with the project (it lists the CC BY sounds; CC0 ones need no credit and leave it unwritten) and put those credits wherever the video is published.

| Sound             | Only on                                        |
| ----------------- | ---------------------------------------------- |
| click             | a real cursor click on screen                  |
| whoosh            | a scene cut, or a large card moving fast       |
| soft key tick     | text arriving letter by letter or line by line |
| pop               | a badge, chip or number landing                |
| riser into impact | the payoff or the mark, once in the film       |

- Place a clip so its peak lands one frame after its picture (light arrives before sound; a sound early feels wrong sooner than one late): `npx hyperframes audio <file> --json` reports where it hits, and most files peak after their start.
- Each hit sits 3-6 dB over the bed; a bed with most of its energy under 150 Hz plays as nothing on a phone speaker.
- Rotate two or three takes of a repeated sound; the same whoosh on every cut is the most common tell.
- Over strong music, a typing-heavy film can drop the clicks and keys. No synthesised tones, chimes or dings.

## 5. Levels

Music under a voice sits around 0.14 volume; nothing clips (AI audio often does). Keep each file's true peak at −1 dBTP or lower and the mix around −16 to −14 LUFS for social, `npx hyperframes normalize-audio` to match levels (`/media-use`). Check the rendered file with `npx hyperframes audio <video> --json`: sound present, hits where the picture hits, loudness in range. Say in the delivery note that it was measured, not heard (`review.md` §4).
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall