| name | regenerate-mario-promo |
| description | Regenerate the verified Stable Retro versus SuperMarioBros-Nes-turbo Level 1-1 promotional video and README GIF preview. Use when asked to rebuild, refresh, rerun, or update the Mario throughput comparison, its exact shared GymRec trajectory, local benchmark numbers, verification evidence, final tracked MP4, or animated GIF preview. |
Regenerate Mario Promo
Produce one Git-eligible MP4 from an isolated GymRec recording, exact two-backend replay verification, and the repository's canonical matched benchmark.
Run
- Read the root
SPECS.md with $specs-author and read .codex/skills/autoresearch-speed/SKILL.md plus its SPECS.md before benchmarking.
- Confirm that
../gymrec is the intended GymRec checkout and that the explicit --rom-path or Stable Retro-compatible RETRO_DATA_PATH tree resolves to the canonical ROM. Do not use or replace the user's normal ~/.gymrec dataset.
- Run from the repository root:
.venv/bin/python .codex/skills/regenerate-mario-promo/scripts/regenerate.py
- Keep the command under observation. The five-pair Stable Retro baseline is intentionally much slower than Turbo and can take several minutes.
- Inspect
media/mario-promo/work/verification-report.json, media/mario-promo/work/canonical-benchmark/report.md, and preview frames. Report any failed parity, trajectory, load, sample-count, or speedup gate instead of presenting the video as verified.
- Generate the README GIF preview from the final MP4.
- Return
media/mario-promo/mario-throughput-comparison.mp4 and media/mario-promo/mario-throughput-comparison.gif. Do not stage or publish unless the user asks.
GIF Preview
Generate the tracked GIF after the final MP4 is verified. Keep temporary palette files in the ignored work directory:
ffmpeg -y -loglevel error -i media/mario-promo/mario-throughput-comparison.mp4 \
-vf 'crop=1280:548:0:80,fps=12,scale=640:-2:flags=lanczos,palettegen=max_colors=96:stats_mode=diff' \
-frames:v 1 media/mario-promo/work/mario-throughput-comparison-palette.png
ffmpeg -y -loglevel error -i media/mario-promo/mario-throughput-comparison.mp4 \
-i media/mario-promo/work/mario-throughput-comparison-palette.png \
-filter_complex '[0:v]crop=1280:548:0:80,fps=12,scale=640:-2:flags=lanczos[video];[video][1:v]paletteuse=dither=none' \
media/mario-promo/mario-throughput-comparison.gif
The crop intentionally removes the MP4's headline and verification footnotes so
the README preview shows only the two labeled gameplay panels. Confirm the GIF
is 640×274 at 12 FPS and inspect an early, mid-run, and final frame. Keep the
GIF Git-eligible because README.md embeds it; keep all other generated assets
ignored.
Guarantees
- Record the public
hf://tsilva/SuperMarioBros-Nes-v0_Level1-1 deterministic policy through GymRec's supermariobrosnes-turbo backend.
- Isolate recordings under the ignored work directory; never mutate
~/.gymrec.
- Cut the shared action stream at the first Level 1-1 to Level 1-2 transition.
- Require both backends to use the same ROM, seed, one-frame skip, zero sticky-action probability, action array, and
Level1-1 state.
- Require equal completion steps, raw observation frames, rewards, terminal flags, and common semantic info fields.
- Derive the displayed speed ratio from the repository's matched canonical shape-1 benchmark, excluding video encoding.
- Time-compress Turbo gameplay by the measured paired SPS ratio and hold its final frame while Stable Retro remains at 1x recorded gameplay speed.
- Abort before replacing the final MP4 when verification or benchmark correctness fails.
Options
Use --gymrec-root, --rom-path, or --final-output only when the corresponding location differs. Use --reuse-recording or --reuse-benchmark only to resume a known-good interrupted run whose work artifacts were produced by this script.
