Skip to content

AbubakrChan/product-launch-motion / legacy

product-launch-motion-v1

Verified

Legacy v1 (voiceover-led, GSAP + HyperFrames). Use when making, directing or rescuing a product launch video, promo, teaser, demo reel, sizzle, feature-announcement film or animated product explainer built from code — and when an existing one looks basic, reads as a slideshow, has reveals that miss the voiceover, an invisible cursor, an inaudible sound effect, a clipped or too-quiet mix, or every video coming out looking the same. Covers SaaS, apps, hardware, e-commerce, dev tools, services. Keywords include motion design, storyboard, voiceover sync, kinetic typography, GSAP, HyperFrames, Remotion, film grain, LUFS, ffmpeg.

FileKindSize
CASE-STUDY.mdmarkdown12.8 KB
SKILL.mdskill md17.4 KB
assets/BRIEF.mdmarkdown3.0 KB
assets/STORYBOARD.mdmarkdown2.7 KB
assets/cues.example.jsonconfig3.2 KB
assets/film.example.jsonconfig3.4 KB
assets/frame-skeleton.htmlother17.3 KB
evals/BASELINE.mdmarkdown7.5 KB
evals/evals.jsonconfig5.3 KB
film-preview.webpbinary975.7 KB
references/01-renderer-contract.mdmarkdown14.8 KB
references/02-story-and-truth.mdmarkdown20.7 KB
references/03-word-locked-sync.mdmarkdown9.2 KB
references/04-motion-grammar.mdmarkdown19.6 KB
references/05-camera-3d-cursor.mdmarkdown12.4 KB
references/06-look-and-grade.mdmarkdown18.3 KB
references/07-sound-and-master.mdmarkdown10.3 KB
references/08-qa-and-direction.mdmarkdown11.7 KB
references/09-shot-catalog.mdmarkdown38.9 KB
references/10-traps.mdmarkdown14.6 KB
references/11-creative-direction.mdmarkdown17.4 KB
references/12-deliverables.mdmarkdown7.1 KB
scripts/assemble.mjsexecutablescript9.3 KB
scripts/level-sfx.mjsexecutablescript8.5 KB
scripts/master.shexecutablescript3.8 KB
scripts/transitions.mjsexecutablescript7.2 KB
scripts/verify-cue.shexecutablescript3.4 KB
scripts/wire-audio.mjsexecutablescript5.3 KB
scripts/wire-grade.mjsexecutablescript9.7 KB
scripts/word-timings.mjsexecutablescript4.6 KB
still-1.jpgbinary16.9 KB

scripts/verify-cue.sh

View on GitHub
#!/usr/bin/env bash
# verify-cue.sh — prove a sound cue is actually present in the film you are shipping.
#
# Law 6, operationalised. A cue can be correct in the source, present in the assembled
# index, and still contribute nothing to the mix — that is exactly how an inaudible typing
# effect survived a release. The composition is not evidence. The delivered file is.
#
# usage:
#   ./scripts/verify-cue.sh <master.mp4> <start_s> <dur_s> [previous-master.mp4]
#
# Prints two things:
#   1. WINDOW    mean and peak across the whole window (and the previous master's, if given)
#   2. ENVELOPE  peak per 100ms slice
#
# Read the ENVELOPE. A window peak only proves the cue is loud SOMEWHERE inside the window
# — it cannot see a cue that starts late. A levelled asset cut from a field recording often
# opens with room tone, so the sound lands hundreds of milliseconds after the animation it
# is supposed to punctuate. That defect passed a window-peak check in a real film: the peak
# was -1.4 dB and the first half of the typing was silent.
#
# For percussive cues (clicks, keystrokes, ticks) read PEAK, not mean: mean tells you a bed
# is present, peak tells you a transient is heard. A cue is audible when its transients land
# within roughly 12 dB of the narration in that window.

set -euo pipefail

# `--help` prints the header comment above — one source of truth for the usage text, and it
# exits 0 so wrapping this in a Makefile or CI job does not fail the build.
if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
  sed -n '2,/^$/p' "$0" | sed -E 's/^# ?//'
  exit 0
fi

FILE="${1:-}"
START="${2:-}"
DUR="${3:-}"
PREV="${4:-}"

if [[ -z "$FILE" || -z "$START" || -z "$DUR" ]]; then
  echo "usage: ./scripts/verify-cue.sh <master.mp4> <start_s> <dur_s> [previous-master.mp4]" >&2
  exit 1
fi
[[ -f "$FILE" ]] || { echo "no such file: $FILE" >&2; exit 1; }

measure() {
  ffmpeg -hide_banner -ss "$2" -t "$3" -i "$1" -vn -af volumedetect -f null /dev/null 2>&1 \
    | grep -E "mean_volume|max_volume" | sed -E 's/.*\] //' | tr '\n' ' '
}
peak_only() {
  ffmpeg -hide_banner -ss "$2" -t "$3" -i "$1" -vn -af volumedetect -f null /dev/null 2>&1 \
    | grep -E "max_volume" | sed -E 's/.*max_volume: //; s/ dB//'
}

END=$(awk -v s="$START" -v d="$DUR" 'BEGIN{printf "%.2f", s+d}')
printf 'window  %ss → %ss\n\n' "$START" "$END"

echo "WINDOW"
if [[ -n "$PREV" ]]; then
  [[ -f "$PREV" ]] || { echo "no such file: $PREV" >&2; exit 1; }
  printf '  %-26s %s\n' "$(basename "$PREV")" "$(measure "$PREV" "$START" "$DUR")"
fi
printf '  %-26s %s\n' "$(basename "$FILE")" "$(measure "$FILE" "$START" "$DUR")"

echo
echo "ENVELOPE (peak per 100ms — the cue should start where the animation starts)"
SLICES=$(awk -v d="$DUR" 'BEGIN{printf "%d", (d/0.1)+0.999}')
for ((i = 0; i < SLICES; i++)); do
  T=$(awk -v s="$START" -v i="$i" 'BEGIN{printf "%.3f", s + i*0.1}')
  P=$(peak_only "$FILE" "$T" 0.1)
  if [[ -n "$PREV" ]]; then
    PP=$(peak_only "$PREV" "$T" 0.1)
    printf '  t=%-8s %8s dB   (was %8s dB)\n' "$T" "$P" "$PP"
  else
    printf '  t=%-8s %8s dB\n' "$T" "$P"
  fi
done

echo
echo "If the first slices are much quieter than the rest, the cue starts LATE — the asset"
echo "probably has a silent head. Re-cut it from its first transient:"
echo "  node scripts/level-sfx.mjs <asset>            # auto-trims the head by default"
echo "If every slice is quiet, the SOURCE is too quiet for any cue volume to fix:"
echo "  node scripts/level-sfx.mjs <asset> --bed <narration dB in this window>"
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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall