Skip to content

datit309/supergraph / plugins/supergraph/skills/video-demo

video-demo

Flagged

Films a web app as narrated, zooming, cursor-driven demo videos with retina screenshots, either from a repo it builds and mocks or from a live URL as it is served. Use when the user asks for a demo video, product video, walkthrough, screencast, screen recording of an app or of a URL, hero or landing-page footage, app screenshots for a website, "show off this feature", "record a demo of <url>", or wants to add, re-film, re-narrate or fix a demo scene.

FileKindSize
LICENSEother1.0 KB
README.mdmarkdown1.6 KB
SKILL.mdskill md8.9 KB
engine/pin-build.mjsexecutablescript4.0 KB
engine/playwright.demo.tsscript4.8 KB
engine/run.mjsexecutablescript5.1 KB
engine/serve.mjsexecutablescript3.7 KB
engine/studio/actor.tsscript23.5 KB
engine/studio/config.tsscript13.4 KB
engine/studio/define.tsscript5.9 KB
engine/studio/overlay.tsscript12.0 KB
engine/studio/preview.tsscript7.0 KB
engine/studio/ready.tsscript3.6 KB
engine/studio/recorder.tsscript23.1 KB
engine/studio/run-id.tsscript1.8 KB
engine/studio/scene.tsscript6.0 KB
engine/studio/stage.tsscript5.4 KB
engine/studio/stitch.tsscript11.0 KB
engine/studio/voice.tsscript17.3 KB
examples/roadmap-search-poster.pngbinary187.3 KB
package-lock.jsonmanifest2.2 KB
package.jsonmanifest407 B
references/capture.mdmarkdown10.7 KB
references/config.mdmarkdown14.3 KB
references/mocking.mdmarkdown8.8 KB
references/narration.mdmarkdown8.1 KB
references/runs.mdmarkdown14.7 KB
references/scenes.mdmarkdown10.4 KB
references/troubleshooting.mdmarkdown20.3 KB
scripts/demoexecutablescript303 B
scripts/doctor.shexecutablescript4.6 KB
scripts/gaps.mjsexecutablescript5.7 KB
scripts/install-voice.shexecutablescript2.1 KB
scripts/install.shexecutablescript3.9 KB
scripts/probe-fps.mjsexecutablescript8.7 KB
scripts/say.shexecutablescript4.1 KB
scripts/scaffold.mjsexecutablescript11.4 KB
template/demo/demo.config.tsscript6.0 KB
template/demo/mock.tsscript4.1 KB
template/demo/scenes/smoke.scene.tsscript1.9 KB
template/demo/ui.tsscript1.1 KB

scripts/doctor.sh

View on GitHub
#!/usr/bin/env bash
set -uo pipefail

# Checks what a studio run actually depends on, and for each miss prints the
# one command that fixes it, rather than a stack trace three steps into
# filming. Voice (uv + the Kokoro model) is advisory: a missing model films
# silent by design, so only the capture path is fatal here.

SKILL="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
FATAL=0

ok()   { printf '  ok    %s\n' "$1"; }
warn() { printf '  warn  %s\n' "$1"; printf '        fix: %s\n' "$2"; }
fail() { printf '  fail  %s\n' "$1"; printf '        fix: %s\n' "$2"; FATAL=1; }

NODE_VERSION=$(node --version 2>/dev/null || true)
if [ -z "$NODE_VERSION" ]; then
  fail "node not found" "install Node >= 22.18"
else
  ver="${NODE_VERSION#v}"
  major="${ver%%.*}"
  minor="${ver#*.}"; minor="${minor%%.*}"
  if [ "$major" -gt 22 ] || { [ "$major" -eq 22 ] && [ "$minor" -ge 18 ]; }; then
    ok "node $NODE_VERSION"
  else
    fail "node $NODE_VERSION is older than 22.18 (the config files are loaded as TypeScript directly, via Node's own type stripping)" "install Node >= 22.18, e.g. nvm install 22.18"
  fi
fi

PLATFORM="$(uname -s)"
case "$PLATFORM" in
  Darwin)
    ok "platform macOS (tested platform)"
    ;;
  Linux)
    ok "platform Linux (supported: encodes with libx264, no hardware encoder path)"
    ;;
  *)
    warn "platform $PLATFORM is not supported" "nice, VideoToolbox, uv and the path handling here all assume a POSIX shell; use macOS or Linux"
    ;;
esac

if command -v ffmpeg >/dev/null 2>&1; then
  ok "ffmpeg $(ffmpeg -version 2>/dev/null | head -n1 | awk '{print $3}')"
  ENCODERS=$(ffmpeg -hide_banner -encoders 2>/dev/null)
else
  fail "ffmpeg not found" "$SKILL/scripts/install.sh installs it"
  ENCODERS=""
fi

HAS_VT=0; HAS_X264=0
printf '%s' "$ENCODERS" | grep -q "h264_videotoolbox" && HAS_VT=1
printf '%s' "$ENCODERS" | grep -q "libx264" && HAS_X264=1

# What the recorder will actually pick: VideoToolbox on macOS when it's there,
# libx264 everywhere else. Reported as one conclusion, not two encoder checks,
# so a mismatch between "installed" and "the one this run will use" can't hide.
if [ "$PLATFORM" = "Darwin" ] && [ "$HAS_VT" -eq 1 ]; then
  ok "will encode with h264_videotoolbox (hardware)"
elif [ "$HAS_X264" -eq 1 ]; then
  if [ "$PLATFORM" = "Darwin" ]; then
    warn "no h264_videotoolbox; will fall back to libx264 (slower at 4K)" "reinstall ffmpeg with VideoToolbox support, or accept DEMO_ENCODER=x264"
  else
    ok "will encode with libx264"
  fi
else
  fail "no h264 encoder ffmpeg can use (need h264_videotoolbox or libx264)" "$SKILL/scripts/install.sh, or reinstall ffmpeg with h264 support"
fi

if command -v nice >/dev/null 2>&1; then
  ok "nice available (the encoder runs niced below the browser during a film)"
else
  warn "nice not found; the encoder will run at normal priority, competing with the browser for CPU while filming" "POSIX systems ship nice; this is expected only on an unsupported platform"
fi

PLAYWRIGHT_CACHES=("$HOME/Library/Caches/ms-playwright" "$HOME/.cache/ms-playwright")
if [ -n "${PLAYWRIGHT_BROWSERS_PATH:-}" ]; then
  PLAYWRIGHT_CACHES=("$PLAYWRIGHT_BROWSERS_PATH" "${PLAYWRIGHT_CACHES[@]}")
fi
CHROMIUM_DIR=""
for dir in "${PLAYWRIGHT_CACHES[@]}"; do
  if [ -d "$dir" ] && find "$dir" -maxdepth 1 -type d -name "chromium-*" 2>/dev/null | grep -q .; then
    CHROMIUM_DIR="$dir"
    break
  fi
done
if [ -n "$CHROMIUM_DIR" ]; then
  ok "playwright chromium installed ($CHROMIUM_DIR)"
else
  fail "playwright chromium not installed" "npx playwright install chromium"
fi

if command -v uv >/dev/null 2>&1; then
  ok "uv $(uv --version 2>/dev/null)"
else
  warn "uv not found (only needed to install the local voice)" "curl -LsSf https://astral.sh/uv/install.sh | sh"
fi


# The engine's own runtime, which install.sh puts here. Nothing about the app
# being filmed is checked: that is discovery, not a dependency.
if [ -d "$SKILL/node_modules/@playwright/test" ]; then
  ok 'engine installed'
else
  fail 'engine not installed' "$SKILL/scripts/install.sh"
fi

if [ -L "$SKILL/node_modules/video-demo" ]; then
  ok 'workspaces can resolve video-demo/*'
else
  fail 'the video-demo self-link is missing' "$SKILL/scripts/install.sh"
fi

VOICE_HOME="${DEMO_VOICE_HOME:-$HOME/.cache/demo-voice}"
if [ -f "$VOICE_HOME/.venv/bin/python" ] && [ -f "$VOICE_HOME/kokoro.onnx" ] && [ -f "$VOICE_HOME/voices.bin" ]; then
  ok "kokoro voice model installed ($VOICE_HOME)"
else
  warn "no voice model at $VOICE_HOME (films silent until installed)" "scripts/install-voice.sh"
fi

if [ "$FATAL" -ne 0 ]; then
  printf '\n  fatal checks failed above; fix them before filming.\n'
  exit 1
fi

printf '\n  every fatal check passed.\n'
exit 0
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated 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: 194kUpdated Claude CodeCodexVerifiedInstall