Skip to content

rlaope/oh-my-hermes / .claude/agent-skills/omh-show-reel

omh-show-reel

Unverified

[omh] Video to make from an idea or a product: an explainer, motion…

FileKindSize
SKILL.mdskill md12.6 KB
references/art-direction.mdmarkdown9.4 KB
references/assets-and-rights.mdmarkdown1.9 KB
references/audio-production.mdmarkdown5.0 KB
references/brief-and-locales.mdmarkdown5.2 KB
references/craft-audio.mdmarkdown19.9 KB
references/craft-brief.mdmarkdown12.2 KB
references/craft-design.mdmarkdown15.5 KB
references/craft-engine.mdmarkdown26.5 KB
references/craft-images.mdmarkdown9.3 KB
references/craft-qa.mdmarkdown13.2 KB
references/craft-story.mdmarkdown20.6 KB
references/craft-techniques-2.mdmarkdown15.2 KB
references/craft-techniques.mdmarkdown22.6 KB
references/craft-workflow.mdmarkdown32.3 KB
references/cut-sheet.mdmarkdown8.3 KB
references/game-capture.mdmarkdown1.8 KB
references/genres.mdmarkdown4.8 KB
references/kinetic-type.mdmarkdown6.7 KB
references/launch-film.mdmarkdown5.4 KB
references/motion-techniques.mdmarkdown4.3 KB
references/procedure.mdmarkdown17.0 KB
references/render-qa-delivery.mdmarkdown12.2 KB
references/renderer-adapter.mdmarkdown9.4 KB
references/source-package.mdmarkdown1.4 KB
references/storyboard-and-evidence.mdmarkdown6.5 KB
toolkit/LICENSE.upstreamother1.1 KB
toolkit/README.mdmarkdown18.7 KB
toolkit/assets/engine/engine.jsscript21.6 KB
toolkit/assets/engine/fx.jsscript20.9 KB
toolkit/assets/engine/index.htmlother3.0 KB
toolkit/assets/engine/scenes.jsscript12.7 KB
toolkit/assets/sfx_presets.jsonconfig3.3 KB
toolkit/examples/README.mdmarkdown744 B
toolkit/examples/music-spec.jsonconfig372 B
toolkit/examples/timing.jsonconfig146 B
toolkit/scripts/codex_ref_image.shscript2.6 KB
toolkit/scripts/contact_sheet.pyscript8.7 KB
toolkit/scripts/eleven.pyscript19.5 KB
toolkit/scripts/finish.pyscript8.0 KB
toolkit/scripts/font-coverage.mjsscript2.8 KB
toolkit/scripts/mix.pyscript9.5 KB
toolkit/scripts/motion_check.pyscript11.3 KB
toolkit/scripts/music_tools.pyscript29.4 KB
toolkit/scripts/narrate.pyscript12.5 KB
toolkit/scripts/new_project.pyscript10.5 KB
toolkit/scripts/preflight.pyscript5.6 KB
toolkit/scripts/prep_images.pyscript5.8 KB
toolkit/scripts/qa_check.pyscript7.1 KB
toolkit/scripts/render.mjsscript22.6 KB
toolkit/scripts/synth_music.pyscript6.4 KB
toolkit/scripts/timeline.pyscript16.6 KB
toolkit/scripts/tools/cutout.swiftscript1.8 KB
toolkit/upstream-manifest.jsonconfig20.3 KB

references/audio-production.md

View on GitHub
# Local score, cue-aligned SFX, stems and honest audio gates

Choose muted/music-only/narration/narration+bed/SFX from the brief, not from the
conversation language. No default voice, provider, STT, download or paid call.
The opt-in `eleven.py`/`narrate.py` (narration, SFX, music, STT) and
`codex_ref_image.sh` run only when the user asks for them with their own
`ELEVENLABS_API_KEY` or signed-in codex; they refuse without it, and the film
falls back to local music and on-screen text.
Each run that reaches ElevenLabs or codex (`eleven.py`, `narrate.py`,
`codex_imagegen_batch.sh`, `codex_ref_image.sh`, and the `codex exec` script
review and concept candidates, with a spend-only cap set in calls) spends the user's own
subscription credits or plan usage, so it goes through `omh-spend-gate` before
it runs: show the target (which lines, voice and model, or which SFX, music, STT
or image job and its length) and the expected credits read from the provider's
own price for that model. The estimates in `references/craft-brief.md` are only
a rough guide; where no price gives a figure, the card says the cost is unknown
and the gate's spend-only cap applies. Run it only after the person's typed yes
to that card. That yes is the exact-target approval for that run and nothing
wider; a regenerated line, a new take or a changed voice is a new card.
`eleven.py check` and `eleven.py voices` only read the account and spend nothing.
Audio comes before scenes: music beats and narration words set the picture's
times. Craft depth (voices, music plans, SFX design, mix targets) is in
`references/craft-audio.md`. `music_tools.py analyze` reads tempo, downbeats and
hits from the chosen track; `timeline.py script.json --music-analysis` turns them
into `barN`/`music.hitN`/`music.dropN` cues and `reel/timeline.js` for
`REEL.cue`/`bar`/`beat`/`level`.

Fit the passage the film uses with `music_tools.py analyze FILE --bpm HINT
--start SECONDS --window SECONDS [--out analysis.json]`. `--bpm` constrains the
tempo/phase search to within ±8% of the hint, without folding it into a slower
tempo band. `--start` and `--window` bound the fitted stretch; they are not a
source-audio trim or a film start delay. Without `--bpm`, tempo selection retains
its existing behavior and `alternatives` lists half/double-tempo candidates in
60–200 BPM. Inspect those when a beat grid appears to follow every second accent.

Read `grid_strength` (0..1) and review
`warning: "tempo hint disagrees with the track"` if an unconstrained fit is
clearly stronger. A forced hint must not hide
a poor grid. `drops` contains up to three time-ordered `{t, rise, bar}` rows:
`rise` compares loudness over two bars after a downbeat to one bar before it.
Choose a useful musical turn with actual listening when available, not the ratio
alone. `timeline.py` carries `drops` into its music timeline and produces
`music.drop1..N`, shifted by the music start offset just like `barN`. Use these
cue IDs for scene/SFX anchors; recompile after changing the track or its start.
Read `references/kinetic-type.md` only for a selected kinetic launch/teaser's
beat-sheet and source-trim formula.

Read `toolkit/README.md` and `scripts/synth_music.py`, `mix.py`, `qa_check.py`
relative to that toolkit. The local seeded score is a modest fallback: section
notes/energy/BPM and tick/boom/whoosh events are parameters, not a musical-quality
promise. Licensed imported local music is equally valid; record its rights/hash.

Timeline cues are explicit IDs with seconds/frame indices or acyclic after+offset,
or script.json scenes/SFX placed on music and narration cues. A narration cue comes
from the provider's character alignment of the approved tts text; never derive a
screen event by guessing where a substring is spoken without that alignment. Audio events use numeric `at` or an exact cue ID and start/peak/end anchor.
Measure the PCM event anchor and A/V cue against decoded frames, not a guessed
hearing result. Unknown cues, missing required tracks, corrupt or wrong-rate audio
must fail closed before a usable final mix. Muted cannot silently discard tracks.

Mix uses explicit stereo 16-bit PCM WAV in one declared sample rate; host decode/
resample is a separate observed action. Retain narration/bed/SFX stems, authored
gain automation, speech-aware bed ducking and recovery outside speech. Compare
speech/non-speech intervals numerically, then listen to the actual final encoded
mix if that capability is observed. A sample limiter is not true-peak certification.
`--ffmpeg` on mix measures loudness, not normalization; master explicitly and
measure post-AAC LUFS/true peak with the chosen policy. No parse/decode/tool failure
becomes zero or a PASS. Silent/nonfinite required-audio metrics are HOLD.

Keep synthesis, mastering, final-AAC measurements, STT, pronunciation review and
listening as different observations. STT only when speech exists and separately
approved tooling is available; it never proves naturalness, consent or listening.
A musical accent must support the shot/cut, not mask every change with a boom.
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