How do I install the Validation Diff Gifs skill?

Run npx skillmds@latest add isaac-sim/validation-diff-gifs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Validation Diff Gifs safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Validation Diff Gifs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Validation Diff Gifs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Validation Diff Gifs?

isaac-sim (@isaac-sim) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Validation Diff Gifs by isaac-sim — Agent Skill

Name: Validation Diff Gifs
Author: isaac-sim

Validation Diff Gifs

Generate pixel-difference GIF animations comparing benchmark validation captures against golden images. Use when the user asks to visualize validation failures, compare captured vs golden images, generate diff GIFs, or debug image tolerance issues.

isaac-sim 82a49df 2 files · 6.3 KB Updated Sep 17, 2026

File contents

Validation Difference GIFs

Generate per-camera GIF animations showing the pixel-wise difference between captured benchmark images and their golden references. Useful for debugging validation tolerance failures.

Prerequisites

ImageMagick (composite, convert) must be available on PATH.
A completed validation capture run with matching directory structure to the golden data.

Paths

Captures and golden data live under the Isaac Sim build release directory:

standalone_examples/benchmarks/validation/captures/<run_name>/
standalone_examples/benchmarks/validation/golden_data/<benchmark_name>/

Both share a parallel directory tree (e.g. Robots/Robot_0/.../front_hawk/left/camera_left/rgb/).

Usage

Find the latest capture

ls -td standalone_examples/benchmarks/validation/captures/benchmark_robots_nova_carter_ros2_*/ | head -1

Run the script

The bundled script is resolved via ${CLAUDE_SKILL_DIR}; falls back to the canonical repo path skills/validation-diff-gifs/scripts/:

bash "${CLAUDE_SKILL_DIR:-skills/validation-diff-gifs}/scripts/generate_diff_gifs.sh" \
    <captured_run_dir> \
    <golden_benchmark_dir> \
    [amplify] [fps]

Argument	Default	Description
`captured_run_dir`	(required)	Root of the capture run
`golden_benchmark_dir`	(required)	Root of the golden data for the benchmark
`amplify`	`10`	Multiply pixel differences by this factor for visibility
`fps`	`5`	Frame rate for the output GIF

Example

LATEST=$(ls -td standalone_examples/benchmarks/validation/captures/benchmark_robots_nova_carter_ros2_*/ | head -1)
GOLDEN="standalone_examples/benchmarks/validation/golden_data/benchmark_robots_nova_carter_ros2"

bash "${CLAUDE_SKILL_DIR:-skills/validation-diff-gifs}/scripts/generate_diff_gifs.sh" "$LATEST" "$GOLDEN"

Output

For each rgb/ directory under the capture, a diff_animation.gif is written alongside the captured PNGs:

<captured_run_dir>/Robots/.../front_hawk/left/camera_left/rgb/diff_animation.gif

Black pixels = identical between captured and golden
Brighter pixels = larger difference (amplified by the amplify factor)

Interpreting results

Uniform low-level noise across the frame → rendering non-determinism (likely acceptable)
Bright regions concentrated on object edges → sub-pixel movement differences
Entire frame bright → wrong timestamp match or completely different camera pose
One camera consistently worse than others → possible per-camera issue (tick rate, initialization)

---name: validation-diff-gifsdescription: Generate pixel-difference GIF animations comparing benchmark validation captures against golden images. Use when the user asks to visualize validation failures, compare captured vs golden images, generate diff GIFs, or debug image tolerance issues.---# Validation Difference GIFsGenerate per-camera GIF animations showing the pixel-wise difference between captured benchmark images and their golden references. Useful for debugging validation tolerance failures.## Prerequisites- ImageMagick (`composite`, `convert`) must be available on `PATH`.- A completed validation capture run with matching directory structure to the golden data.## PathsCaptures and golden data live under the Isaac Sim build release directory:```standalone_examples/benchmarks/validation/captures/<run_name>/standalone_examples/benchmarks/validation/golden_data/<benchmark_name>/```Both share a parallel directory tree (e.g. `Robots/Robot_0/.../front_hawk/left/camera_left/rgb/`).## Usage### Find the latest capture```bashls -td standalone_examples/benchmarks/validation/captures/benchmark_robots_nova_carter_ros2_*/ | head -1```### Run the scriptThe bundled script is resolved via `${CLAUDE_SKILL_DIR}`; falls back to the canonical repo path `skills/validation-diff-gifs/scripts/`:```bashbash "${CLAUDE_SKILL_DIR:-skills/validation-diff-gifs}/scripts/generate_diff_gifs.sh" \ <captured_run_dir> \ <golden_benchmark_dir> \ [amplify] [fps]```| Argument | Default | Description ||---|---|---|| `captured_run_dir` | (required) | Root of the capture run || `golden_benchmark_dir` | (required) | Root of the golden data for the benchmark || `amplify` | `10` | Multiply pixel differences by this factor for visibility || `fps` | `5` | Frame rate for the output GIF |### Example```bashLATEST=$(ls -td standalone_examples/benchmarks/validation/captures/benchmark_robots_nova_carter_ros2_*/ | head -1)GOLDEN="standalone_examples/benchmarks/validation/golden_data/benchmark_robots_nova_carter_ros2"bash "${CLAUDE_SKILL_DIR:-skills/validation-diff-gifs}/scripts/generate_diff_gifs.sh" "$LATEST" "$GOLDEN"```## OutputFor each `rgb/` directory under the capture, a `diff_animation.gif` is written alongside the captured PNGs:```<captured_run_dir>/Robots/.../front_hawk/left/camera_left/rgb/diff_animation.gif```- **Black pixels** = identical between captured and golden- **Brighter pixels** = larger difference (amplified by the `amplify` factor)## Interpreting results- Uniform low-level noise across the frame → rendering non-determinism (likely acceptable)- Bright regions concentrated on object edges → sub-pixel movement differences- Entire frame bright → wrong timestamp match or completely different camera pose- One camera consistently worse than others → possible per-camera issue (tick rate, initialization)

Frequently asked questions