RetroConvert: Safe Batch Video to CRT-Ready SD MP4

    1

    Safely batch-convert video folders into 640x480 CRT-ready MP4s with verification and 4:3 cropping.

    $3

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    RetroConvert: Safe Batch Video to CRT-Ready SD MP4

    Example session with this skill installed

    Convert everything on my SD card at /Volumes/RETROTV so it plays on the CRT. The card is almost full.

    • Read your context and instructions
    • Compiled the retroconvert

    Summary

    Dry run done on /Volumes/RETROTV. Nothing has been changed yet. 144 files need converting, 375 are already SD and will be left alone, and 2 are broken.

    Dry run

    FilesNotes
    To convert14461.2 GB of sources
    Already SD375640x480 or smaller, left alone (no quality loss)
    Broken2Unreadable, not deleted. Listed in skipped.txt

    Broken files

    • Season 02/S02E07.avi (0 bytes)
    • Promos/fall-2004-lineup.mp4 (truncated)

    Your call before I start

    The card is nearly full, so I recommend

    in-place: each file is replaced as soon as its new version passes every check (duration within 2%, at most 640x480, no upscale), which frees space as it goes. The alternative, --out ~/Desktop/done --keep-sources, keeps every original but needs about twice the space.

    Reply "in place" or "keep originals". I won't touch a file until you do.

    Then

    • I'll run it in the background with the default job count (your Mac looks idle) and keep it awake.
    • I'll report from runs/<timestamp>/status.tsv when it finishes: OK and FAIL counts, space freed, and why anything failed (failures keep their originals).
    • Re-copy the 2 broken files from wherever they came from; they can't be converted as they are.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Bulk-converting high-definition video for vintage hardware often results in failed playback or accidental data loss. This skill manages the RetroConvert bash script to safely transcode video folders into CRT-compatible 640x480 MP4 files while protecting your source media.

    What it does

    • Safety-first transcoding: Executes dry runs to verify file counts and readability before touching a single bit of data.
    • Smart cropping: Scales widescreen content to fill 4:3 tubes without letterboxing, while padding extreme aspect ratios to prevent distortion.
    • Verification gate: Only deletes source files after confirming the output matches duration, dimensions, and playback standards.
    • System optimization: Manages CPU load with background job control and prevents system sleep during long encode queues.
    • Resumable workflows: Safely handles interruptions, skipping completed files on restart to save time and compute.

    How it works

    1. Initial Audit: Runs a dry run on the target directory to categorize files as convertible, already SD, or unreadable.
    2. Strategy Selection: Prompts for a choice between in-place replacement (space-saving) or separate output directory with original retention.
    3. Queue Management: Configures job counts and priority levels based on current system usage.
    4. Log Analysis: Parses status.tsv and failed.txt post-run to report successes, specific failures, and recovered disk space.

    Frameworks & tools

    Requires macOS with ffmpeg and ffprobe installed via Homebrew. Built to interface with the RetroConvert bash script for FieldStation42, Raspberry Pi composite output, and CRT television setups.

    Why this beats prompting it yourself

    Writing ffmpeg flags for 4:3 cropping and verification is error-prone and often leads to broken aspect ratios or lost files. This skill automates the validation logic that ensures every output file actually plays on vintage hardware before the source is removed.

    Use cases

    • SD Card Prep: Formatting a full microSD card for a FieldStation42 or Raspberry Pi media box.
    • Library Compression: Shrinking high-res archives into low-bitrate SD versions for local playback on old hardware.
    • Failure Recovery: Diagnosing unreadable files or ffmpeg errors by analyzing run logs and build artifacts.
    • Space Management: Safely replacing large HD files with SD equivalents on storage-constrained devices.

    Known limitations

    Requires macOS. Does not support hardware acceleration via VideoToolbox to maintain compatibility. High-res sources must be accessible via the local filesystem.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Workflow Automation.

    macOS only (bash 3.2, caffeinate). Needs ffmpeg and ffprobe. Software encoding only: VideoToolbox gave no speed gain and broke concurrent jobs. Output is fixed at 640x480 H.264 MP4 for CRTs; it isn't a general-purpose converter.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 5 days ago

    Accounts
    GitHub
    Software
    GitFFmpegffprobe

    Permissions

    Terminal / Shell
    Read Files
    Write Files
    Listed5 days ago

    What's inside

    Frequently Asked Questions

    Two ways. The skill always runs a dry run first and asks you to choose between in-place conversion (each original is deleted once its new file passes every check) and keeping originals (--out with --keep-sources). It never picks in-place for you. And the script itself only deletes a source after its output passes: duration within 2%, at most 640x480, even dimensions, no upscale. Unreadable sources and failed conversions are never deleted.

    This skill requires a macOS environment with ffmpeg and ffprobe installed via Homebrew, as it is optimized for local media management and vintage hardware workflows.

    The skill: a SKILL.md that teaches your agent the safe workflow (dry run, your choice of mode, job count, background run, log report), the script's guarantees and its rules. The RetroConvert script itself is free on GitHub (github.com/hotdog-face/RetroConvert); you clone it separately.

    Yes, Retroconvert features a resumable workflow that performs an initial audit of your directory, allowing it to skip already-converted files and pick up exactly where it left off.

    Unlike generic prompts, this skill uses a "safety-first" verification gate that compares output duration and dimensions against the source to guarantee compatibility with devices like the Raspberry Pi or FieldStation42.

    The skill is designed to scale widescreen content to fill a 4:3 frame while using intelligent padding for extreme aspect ratios to prevent image distortion on vintage tubes.

    New in Workflow Automation