vcr-debugger

Diagnose VCR manifest failures and inspect frame-level rendering state.

22|Updated Feb 10, 2026

Search Tags:#troubleshooting #rendering #video #manifest #debugger #vcr

Ready to run

npx skills add https://github.com/coltonbatts/VCR --skill vcr-debugger

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: vcr-debugger
Source: https://github.com/coltonbatts/VCR/tree/main/.skills/vcr-debugger
Command: npx skills add https://github.com/coltonbatts/VCR --skill vcr-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users quickly diagnose and fix issues encountered when working with VCR (Video Component Renderer), ensuring that manifests are valid and renders are correct.

Core Features & Use Cases

Manifest Validation: Checks the structure and integrity of VCR scene manifests.
Frame Inspection: Allows detailed inspection of the state of a specific frame within a scene.
Render Reproduction: Enables rendering of individual frames for isolated debugging.
Runtime Health Check: Verifies the health and configuration of the VCR environment.
Determinism Reporting: Generates reports to investigate inconsistencies in rendering output.
Use Case: When a VCR render produces a blank output or an unexpected visual, this Skill provides a systematic approach to pinpoint the exact cause, whether it's a typo in the manifest, an invalid asset path, or a backend configuration issue.

Quick Start

Use the vcr-debugger skill to check the manifest file 'my_scene.vcr'.

Frequently Asked Questions about vcr-debugger

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I debug a VCR manifest that fails to render a scene?▼

To debug a VCR manifest that fails to render, validate the scene structure using manifest checks and inspect frame-level state to pinpoint structural typos or invalid asset paths causing the render failure.

Why does my VCR render produce a blank or unexpected visual output?▼

A VCR render produces blank or unexpected visuals due to manifest validation errors, invalid asset paths, or backend configuration issues, which you can isolate by reproducing individual frame renders and inspecting the exact frame state.

How do I inspect the state of a specific frame in a VCR scene?▼

You inspect the state of a specific frame in a VCR scene by using frame inspection and dump commands to extract detailed frame-level data, allowing you to analyze rendering inconsistencies at an exact point in the timeline.

Can I render a single frame from a VCR scene for isolated debugging?▼

Yes, you can render a single frame from a VCR scene for isolated debugging by executing a targeted render-frame command, which reproduces the visual output of that specific frame without processing the entire scene.

How do I check the runtime health of my VCR environment?▼

You check the runtime health of your VCR environment by running a doctor command that verifies the health and configuration of the VCR backend, ensuring the runtime environment is correctly set up for rendering.

How do I investigate non-deterministic rendering output in VCR?▼

You investigate non-deterministic rendering output in VCR by generating a determinism report, which analyzes rendering inconsistencies and highlights variations across multiple runs of the same scene manifest.