ai-media-quality-review
AI media quality review
Review the actual downloaded file against its brief and source media. Resolve scripts/inspect_media.py relative to this installed skill's SKILL.md, not the user's project directory. Run that absolute script path when FFmpeg and FFprobe are available:
python3 /absolute/path/to/ai-media-quality-review/scripts/inspect_media.py /absolute/path/to/output.mp4 --output-dir /absolute/path/to/review
The script creates probe.json, review.json and a contact sheet, image preview or waveform. For video it also saves first-frame.jpg and last-frame.jpg from the first and final decoded frames; the contact sheet alone need not include those moments. It reports technical signals; it does not decide whether the creative result is good. A failed rerun clears an earlier review.json in a writable output directory before input and dependency checks. Other artifacts may remain from earlier runs; use only the artifacts listed in a newly successful report. Treat a nonzero exit or missing report as unverified, never as a clean result.
Apply the acceptance criteria
Read the original request and list the few required outcomes and protected details. Inspect the generated artifacts at full size and the intended delivery size.
- Image: composition, crop, identity, anatomy, hands, geometry, product/character details, required text and logos, unwanted text and visible artifacts.
- Video: first and last frames, intended action and camera, identity/object continuity, flicker, warping, abrupt cuts, actual dimensions, frame rate, duration and audio streams.
- Speech/music: listen through the full export; check intelligibility, pronunciation, last word or phrase, clipping, silence, mouth timing, cut points and synchronization.
Inspect first-frame.jpg and last-frame.jpg as well as the contact sheet. A gradual fade can darken a face without crossing the black-frame threshold; an empty black_segments list does not rule it out. Review contact-sheet flags in context. Intentional black or silent sections are not defects. A clean diagnostic report cannot prove smooth motion, accurate lip sync, good music or a compelling result. Full-speed viewing and listening remain required for those claims.